Agent Reach 診斷與安裝指令

Agent Reach 提供了一個簡潔直觀的命令行介面 (CLI)，讓開發者與 AI 代理能輕鬆管理網路讀寫通道。無論是進行初次的憑證安裝、測試特定社群平台的連線狀態，還是管理本地的敏感密鑰，都可以透過以下核心指令完成。

核心指令清單

1. agent-reach install

• 用途：初始化 Agent Reach 環境並引導安裝所需的憑證與驅動程式。
• 常用參數：
  • --env=auto — 自動偵測當前作業系統與安裝的 AI 代理主機 (如 Claude Code)。
  • --headless — 在無頭瀏覽器模式下安裝相依的 Chromium 核心。

2. agent-reach doctor

• 用途：對所有已配置的 13 個平台通道進行診斷。
• 效果：它會模擬向各個平台發送一次唯讀與寫入測試，並回報每一個通道的健全度 (Health Status) 與當前所使用的路由後端（如官方 API、網頁模擬或無頭瀏覽器）。
• 範例輸出：

  $ agent-reach doctor
  === Agent Reach Doctor ===
  [✓] Twitter: Connected (via Web-Fallback)
  [✓] YouTube: Connected (via API-Primary)
  [✓] GitHub: Connected (via API-Primary)
  [✗] Reddit: Failed (Error: Authentication expired)

3. agent-reach config

• 用途：管理和設定平台的認證 Token 與 API Key。
• 常用子指令：
  • agent-reach config set <platform> <key>=<value> — 寫入該平台的認證參數。
  • agent-reach config list — 列出當前所有配置的平台名稱（基於安全考量，Token 內容會被遮蔽，例如 ********）。

4. agent-reach post

• 用途：安全地向指定平台發佈內容。
• 常用參數：
  • --platform=<name> — 指定發佈平台（如 twitter 或 bilibili）。
  • --content="文字內容" — 發佈的文字內容。
  • --preview — 開啟安全模式本地預覽，而不實際發送。