@forcome/ai-cli (fai)

Forcome AI 门户命令行——默认指向 https://ai.forcome.com，透传官方 @lobehub/cli（lh）。 员工无需每次 --server；装好直接 fai login 走钉钉扫码授权。

安装（开发员工）

npm i -g @forcome/ai-cli
fai login            # 浏览器钉钉扫码授权（首次）
fai agent list       # 列助理
fai gen text -m newapi/gpt-5.5 --stream "你好"   # 生成文本（必须显式 newapi 模型 + --stream）

自动化 / CI（headless）

Web 登录 → 设置 → API Keys 建一个 key：

LOBEHUB_CLI_API_KEY=<key> fai gen text -m newapi/gpt-5.5 --stream "..."

API key 模式仅支持 tRPC 命令（agent / gen / provider / model）；file 类命令走 /webapi/* 不接受 API key，需先 fai login。

覆盖默认服务器（staging / 自建）

LOBEHUB_SERVER=https://staging.forcome.com fai login

已知限制（phase 1）

• lh gen text 默认模型 openai/gpt-4o-mini 在本门户不可用（ENABLED_OPENAI=0）——必须 -m newapi/<model>，且加 --stream（非 stream 模式 server 返 SSE 流致 JSON 解析失败）。可用模型见 fai model list newapi。
• fai agent run（实时 agent 执行）、fai connect（设备配对）依赖未部署的 agent-gateway / device-gateway，暂不支持。

排障

• lh login 的授权 URL 是 http://192.168.16.157/...（内网 IP）→ nginx /oidc/ location 强制头丢了，见 troubleshooting §8.109。
• fai: command not found 或 未找到 lh 命令 → 先 npm i -g @lobehub/cli（fai 依赖它）。
• agent list 报 procedure not found → CLI 与 server tRPC 版本漂移，pin 与当前 server 同源的 @lobehub/cli。

实现

不改 lh 源码——本包仅设置 LOBEHUB_SERVER 默认值后 spawn('lh', argv) 透传，@lobehub/cli 作为 dependency 自动跟随上游升级。