expert-cli

本地 CLI，让 Claude Code 调远端 Expert（AgentHub）平台的专业 agent 异步生成资产（图 / 音乐 / 视频 / 3D / 幻灯片），产出落到本地工作目录。配套 SKILL.md 教 Claude Code 何时、怎么用。

一键安装（用户）

npm i -g @a2hmarket/expert-cli && expert install && expert-login

expert install 把 SKILL.md 拷到 ~/.claude/skills/expert/（CC 自动发现）；expert-login 浏览器点确认拿 PAT。之后对 Claude 说「用 expert 生成…」即触发。

命令

expert install [--project]                   # 装 SKILL.md 到 CC skills 目录（无需登录）
expert list                                  # 列可调 agent
expert <serviceId> "<message>"               # 起会话发首条（后台跑）
expert --reply <sessionId> "<message>"       # 续同一会话（多轮，后台跑）
expert-login                                 # authcode 设备流授权（弹浏览器点确认）

每次 expert <…> / --reply = 跟某 agent 的一轮对话：连沙箱 → 发一条 → 等这轮结束 → 返回 {sessionId, assistantText, artifacts(已下载 localPath)} → 进程退出。专为 Claude Code 的 run_in_background 设计：进程退出时 CC 被自动唤醒读结果。生成耗时几分钟，务必后台跑。

设计要点

• 纯 CLI，无 MCP server：CC 的"后台进程退出自动唤醒"只在它自己 Bash 跑的进程上触发，MCP tool 给不了； 长生成 / 多轮必须靠这个，所以是 CLI 不是 MCP。
• 鉴权 = PAT：expert-login 复用平台 authcode 设备流，签发 PAT 落 ~/.expert/credentials.json， 之后所有调用带 Authorization: Bearer <pat>。零 dev-tools。
• 多轮 = 往同一沙箱 session 顺序发消息：沙箱保留对话上下文；agent 的澄清走纯文字，CC 读懂用 --reply 答。
• 抗断线：心跳 25s + 断线自动重连同 session（最多 6 次）+ 结束时从 /deliverables truth-sync 本轮新增产出（补 WS 漏帧 + 拿正确可下载 id）。

环境变量

| 变量 | 默认 | 说明 | |---|---|---| | EXPERT_API_BASE | prod edge | edge API base（acquire / list / 下载） | | EXPERT_USER_BASE | prod findu-user | authcode claim 轮询 | | EXPERT_FRONT_BASE | prod 前端 | authcode 确认页 | | EXPERT_TOKEN | — | 直接给 token（跳过 credentials 文件） | | EXPERT_HOME | ~/.expert | 凭证 + 产出目录 | | EXPERT_QUIET | — | =1 关进度日志 | | --staging flag | — | 切 staging 全套域名 |

开发

npm install && npm run build
expert list --staging