mcpField
P
pinyin

pinyin

github.com/mnhkahnドキュメント0121 回インストール2 日前に更新
リポジトリ

pinyin について

pinyinは、中国語テキストをピンインに変換し、文字練習用シートを作るコマンドラインツールです。テキストをローカルで処理し、ピンインのヒントと米字格を含むA4 PDFをページ分割して生成します。

主な機能

  1. 01中国語テキストのピンイン変換
  2. 02練習シートPDFの生成
  3. 03米字格入りA4レイアウト
  4. 04ファイルまたはstdinから入力
  5. 05指定パスへのPDF保存

活用シーン

  1. 01漢字のピンイン確認
  2. 02書き取り練習シートの作成
  3. 03テキストファイルから練習シート生成
  4. 04学習者向け練習ページの印刷

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mnhkahn/cyeam-cli --skill pinyin

インストール後、Claude Code で/pinyinを入力して読み込まれたか確認します。

詳細

ピンインを見て漢字を書く

概要

中国語のテキストをピンインに変換し、「ピンインを見て漢字を書く」練習用紙の PDF（米字格付き）を生成します。変換処理はローカルで行われます。CLI のデフォルトの利用状況統計と更新通知に関するネットワークリクエスト、および無効にする方法については、以下のインストール手順をご覧ください。

cyeam pinyin "你好世界"                   # 获取每个字的拼音
cyeam pinyin sheet "你好世界"              # 生成练习纸（PDF base64）
cyeam pinyin sheet --out practice.pdf "你好世界"  # 保存 PDF 到文件

PDF モードの使い方

ファイルまたは stdin からも同じ練習用紙を生成できます。

printf '%s' '你好' | cyeam pdf --mode pinyin -o practice.pdf
cyeam pdf words.txt --mode pinyin -o practice.pdf

A4 縦向きで、ピンインのヒント、空白の米字格、下部の訂正欄が含まれます。空白、改行、句読点で語句を区切ります。長い語句は自動的に分割され、長いテキストは切り捨てずに自動で改ページされます。漢字が含まれていない場合はエラーを返します。PDF モードの中国語タイトルには、システムで使用可能な中国語フォントが必要です。多音字は文脈を確認してください。

インストール

インストールする前に、以下のコマンドをお読みください。例では v1.1.4 に固定しており、latest には追従しません。ダウンロードするのは実行可能プログラムのアーカイブです。 CLI をインストールする必要がある場合にのみ実行してください。コマンドを呼び出すたびにインストールを繰り返す必要はありません。

macOS / Linux：検証後、ユーザーディレクトリにインストール

Bash または Zsh で実行してください。curl、tar、install、および shasum または sha256sum が必要です。 スクリプトは macOS / Linux の arm64 または x86_64 を自動選択します。それ以外のプラットフォームでは処理を停止します。

(
  set -eu
  version='v1.1.4'
  case "$(uname -s)/$(uname -m)" in
    Darwin/arm64)
      asset='cyeam_Darwin_arm64.tar.gz'
      sha256='06b5af004ab4f0f05d5829ea6bd18b97c4449c262af7df14c67175f7d3cb29db' ;;
    Darwin/x86_64)
      asset='cyeam_Darwin_x86_64.tar.gz'
      sha256='107342bb9d2fa444b96155c468e71b8cc63e0f5ad0acc784698afe221548efa6' ;;
    Linux/aarch64|Linux/arm64)
      asset='cyeam_Linux_arm64.tar.gz'
      sha256='ed87697f3948bead67b585e9881c3bef20e8d2d903beb5b125587281a5091c5b' ;;
    Linux/x86_64)
      asset='cyeam_Linux_x86_64.tar.gz'
      sha256='873d6805fab8ab56540bb034aaf2f57f12eb672fcabd322ebe401e8250a5966d' ;;
    *) echo '不支持的平台，请查看固定版本的 Release。' >&2; exit 1 ;;
  esac
  workdir=$(mktemp -d)
  trap 'rm -rf "$workdir"' EXIT
  cd "$workdir"
  curl --fail --show-error --silent --location --proto '=https' --proto-redir '=https' \
    --output "$asset" "https://github.com/mnhkahn/cyeam-cli/releases/download/$version/$asset"
  printf '%s  %s\n' "$sha256" "$asset" > expected.sha256
  if command -v sha256sum >/dev/null 2>&1; then
    sha256sum -c expected.sha256
  else
    shasum -a 256 -c expected.sha256
  fi
  # set -e 确保下载或校验失败时，不会解压或安装。
  tar -xzf "$asset" cyeam
  mkdir -p "$HOME/.local/bin"
  install -m 0755 cyeam "$HOME/.local/bin/cyeam"
  CYEAM_CLI_NO_UPDATE_NOTIFIER=1 "$HOME/.local/bin/cyeam" --no-analytics version
)

一時ディレクトリと ~/.local/bin/cyeam のみを書き換えます（同名のプログラムがすでにある場合は置き換えます）。管理者権限は不要です。 システムディレクトリ、サービス、シェル設定は変更しません。現在のシェルで使用するには、次のようにします。

export PATH="$HOME/.local/bin:$PATH"

永続的に有効にする場合は、上記の行をシェル設定に自分で追加してください。 v1.1.4 のリリースページと checksums.txt でチェックサムを確認できます。固定バージョンにアップグレードする場合は、バージョン番号と対応する SHA-256 の両方を確認して置き換える必要があります。 チェックサムはリリースファイルの整合性を確認するためのものであり、独立した署名やセキュリティ監査に相当するものではありません。

外部リクエストと権限の用途
  • インストール時のダウンロード：GitHub から選択したアーカイブのみを、固定された Release からダウンロードします。GitHub はアセット CDN にリダイレクトする場合があります。 ダウンロード後、ドキュメントに記載された固定 SHA-256 を検証してから、単一の cyeam ファイルを展開します。インストール時のチェックでは、利用状況統計と更新通知を無効にします。
  • ピンインと練習用紙：ローカルの辞書とフォントを使用して、ユーザーが指定したテキストを処理します。テキストはアップロードされず、ログインも不要です。sheet --out と PDF モードの -o は指定したパスに書き込みます。既存のファイルが上書きされる場合があります。
  • 利用状況統計：デフォルトでは、コマンド名、CLI バージョン、システム情報、ランダムなインストール ID を https://us.i.posthog.com に送信します。サーバー側では、接続元 IP から地域を特定できる場合があります。コマンド引数、画像の内容、ログイン認証情報は送信しません。 ランダム ID は ~/.cyeam/analytics-id に保存されます。--no-analytics または CYEAM_CLI_NO_ANALYTICS=1 で無効にできます。
  • 更新通知：デフォルトでは、最新バージョンを GitHub に最大 24 時間ごとに確認し、結果を ~/.cyeam/update-state.json にキャッシュします。通知によってプログラムが置き換えられることはありません。CYEAM_CLI_NO_UPDATE_NOTIFIER=1 を設定すると無効になります。 cyeam update は明示的なアップグレードコマンドです。最新の Release をダウンロードして検証し、現在のプログラムを置き換えます。成功後には npx skills add による skills の同期も試みます。固定バージョンを維持する場合は実行せず、上記の手順に従って選択したバージョンをインストールしてください。

CLI の利用状況統計と更新通知を無効にするには（アプリケーション自体のネットワークリクエストには影響しません）、現在のシェルで次のように設定します。

export CYEAM_CLI_NO_ANALYTICS=1
export CYEAM_CLI_NO_UPDATE_NOTIFIER=1

出力

cyeam pinyin "你好" は JSON を返します。

{"ok":true,"data":"{\"pinyin\":[{\"char\":\"你\",\"pinyin\":\"nǐ\"},{\"char\":\"好\",\"pinyin\":\"hǎo\"}]}"}

cyeam pinyin sheet "你好" は、さらに "pdf" フィールド（PDF の base64 エンコード）を含みます。

注意事項

  • 完全にローカルで生成し、go-pinyin ライブラリと gofpdf を使用します。
  • 同梱フォントはわずか 21KB（pinyin-wenkai-light.ttf）で、バイナリファイルも小型です。
  • 練習用紙には、米字格（対角線付き）、ピンインのヒント、下部の訂正欄が含まれます。
  • 空白で区切られた語句は、自動的に改行して配置されます。

コメント

Markdown 対応