cyeam-cli

Cyeam CLI

ルール

このスキルでは、CLI 自体のインストール、更新、出力形式、および完全なコマンド一覧のみを説明します。各分野の具体的な使い方や注意事項は、それぞれの独立したスキル（live-broadcast、pinyin、calligraphy-composition、seal-script-ocr など）に記載されています。AI はコマンドを実行する前に、まずそれらのスキルを確認してください。

---

インストール

インストールする前に、以下のコマンドを確認してください。例では 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 ファイルを展開します。インストール時のチェックでは、統計と更新通知を無効にします。
• 書道の検索：mo guwen、mo char detail/composition/compose は、ユーザーが指定したテキスト、書体、合成オプションを https://www.cyeam.com/mo/api/* に送信します。合成画像は --out で指定したパスに書き込まれ、 既存のファイルが上書きされる場合があります。元の投稿に含まれる画像は Cloudinary などの画像 CDN から取得されることがあり、画像を表示する際にクライアントが該当 URL にリクエストを送信します。
• OCR：mo ocr <image> は指定されたローカルファイルを読み取り、認識処理のためにファイル名と画像の内容を https://www.cyeam.com/mo/api/ocr にアップロードします。ユーザーがその画像の認識を求めた場合にのみ実行してください。Microsoft へのログインは不要です。
• 使用状況の統計：デフォルトでは、コマンド名、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 によるスキルの同期も試みます。固定バージョンを維持する必要がある場合は実行せず、上記の手順でバージョンを選択してインストールしてください。

mo の処理に必要なネットワークリクエストのみを残すには、現在のシェルで以下を設定します。

export CYEAM_CLI_NO_ANALYTICS=1
export CYEAM_CLI_NO_UPDATE_NOTIFIER=1

ログイン方法

cyeam login                           # 登录 Microsoft 账号
cyeam logout                          # 退出登录
cyeam whoami                          # 查看当前登录状态

• ログインにはデバイスコードフローを使用します。コマンドは認証リンクと確認コードを表示し、デスクトップ環境があるマシンではブラウザーを自動的に開こうとします。
• デスクトップ環境のないサーバーでは、ブラウザーを開く処理はエラーを表示せずに失敗します。表示されたリンクと確認コードを使って任意のブラウザーで認証すれば、CLI が自動的にトークンを取得します。
• トークンはシステムのキーチェーン（macOS Keychain / Linux D-Bus）への保存が優先されます。利用できない場合は、自動的に ~/.cyeam/token.json に保存されます。

完全なコマンド一覧

cyeam version                          # 版本
cyeam update                           # 更新
cyeam tag minor|major [--dry-run]       # Git 版本标签 → 见 git-tag skill
cyeam login / logout / whoami          # Microsoft 登录
cyeam date holiday [YYYY-MM-DD]        # 节假日
cyeam tv ...                           # 直播 → 见 live-broadcast skill
cyeam news ...                         # 新闻 → 见 news skill
cyeam pinyin ...                       # 拼音 → 见 pinyin skill
cyeam phonetic <word>                  # 英语音标 → 见 phonetic skill
cyeam mo guwen/char ...                # 书法集字 → 见 calligraphy-composition skill
cyeam mo ocr <image>                  # 篆字识别 → 见 seal-script-ocr skill
cyeam roadbook ...                     # 路书 → 见 roadbook skill
cyeam cnote ...                        # 云笔记 → 见 cnote skill
cyeam mail ...                         # 多邮箱收发 → 见 mail skill
cyeam image ...                        # 图片转换 → 见 image skill
cyeam ai models [...]                  # AI免费模型 → 见 ai-models skill
cyeam trello ...                       # Trello任务看板 → 见 trello skill

すべてのコマンドは {"ok":true,"data":...,"_notice":{...}} という JSON エンベロープを出力します。コマンドの出力が有効な JSON の場合、data はネストされた JSON オブジェクトまたは配列になり、それ以外の場合は文字列になります。--pretty を追加すると、エンベロープを省略できます。