@forcome/ai-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Forcome
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @forcome/ai-cli (`fai`)
+
+Forcome AI 门户命令行——默认指向 https://ai.forcome.com，透传官方 [`@lobehub/cli`](https://www.npmjs.com/package/@lobehub/cli)（`lh`）。
+员工无需每次 `--server`；装好直接 `fai login` 走钉钉扫码授权。
+
+## 安装（开发员工）
+
+```bash
+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：
+
+```bash
+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 / 自建）
+
+```bash
+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](../docs/troubleshooting.md)。
+- `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` 自动跟随上游升级。

package/bin/fai.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// @forcome/ai-cli bin 入口（命令 fai）
+// 默认指向 https://ai.forcome.com，透传给官方 @lobehub/cli (lh)。
+// 不用 isMain 守卫——本文件只作为 bin 运行（纯逻辑在 ../src/index.js）。
+
+import { spawn } from 'node:child_process';
+import { FORCOME_SERVER, resolveLhPath, resolveLhVersion } from '../src/index.js';
+
+// 默认指向 Forcome 门户（员工无需 --server）；env LOBEHUB_SERVER 可覆盖（staging 等）
+if (!process.env.LOBEHUB_SERVER) {
+  process.env.LOBEHUB_SERVER = FORCOME_SERVER;
+}
+
+const args = process.argv.slice(2);
+
+// wrapper 自身状态（不透传给 lh）
+if (args[0] === '--forcome-version') {
+  console.log(`forcome-ai-cli → ${process.env.LOBEHUB_SERVER} (wraps @lobehub/cli ${resolveLhVersion()})`);
+  process.exit(0);
+}
+
+// 自包含：resolve 打包的 lh 入口，用 node 跑
+let lhPath;
+try {
+  lhPath = resolveLhPath();
+} catch {
+  console.error('未找到 @lobehub/cli 依赖。重装：npm i -g @forcome/ai-cli');
+  process.exit(127);
+}
+
+// 透传：继承 stdio（交互/流式/颜色/TTY）与 exit code/signal
+const child = spawn(process.execPath, [lhPath, ...args], { stdio: 'inherit', env: process.env });
+
+child.on('error', (e) => {
+  console.error('启动 lh 失败：', e.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  process.exit(code ?? 0);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@forcome/ai-cli",
+  "version": "0.1.0",
+  "description": "Forcome AI 门户 CLI 薄壳——默认指向 ai.forcome.com，透传官方 @lobehub/cli (lh)",
+  "type": "module",
+  "license": "MIT",
+  "author": "Forcome",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Forcome-Database/Forcome-AI.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/Forcome-Database/Forcome-AI/tree/master/cli#readme",
+  "bugs": {
+    "url": "https://github.com/Forcome-Database/Forcome-AI/issues"
+  },
+  "keywords": [
+    "lobehub",
+    "lobehub-cli",
+    "ai",
+    "cli",
+    "forcome"
+  ],
+  "bin": {
+    "fai": "./bin/fai.js"
+  },
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test src/index.test.js",
+    "smoke": "node bin/fai.js --forcome-version"
+  },
+  "dependencies": {
+    "@lobehub/cli": "0.0.37"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.js

@@ -0,0 +1,27 @@
+// @forcome/ai-cli — 纯导出模块（无副作用，可被测试/bin 入口 import）
+// 默认指向 https://ai.forcome.com，resolve 打包的 @lobehub/cli（自包含，不依赖全局 PATH lh）。
+
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+export const FORCOME_SERVER = 'https://ai.forcome.com';
+
+/** 解析目标 server：env LOBEHUB_SERVER 优先，否则默认 Forcome 门户。 */
+export function resolveServerUrl() {
+  return process.env.LOBEHUB_SERVER || FORCOME_SERVER;
+}
+
+/** 从依赖解析官方 lh 入口（自包含，不依赖全局 PATH）。 */
+export function resolveLhPath() {
+  return require.resolve('@lobehub/cli/dist/index.js');
+}
+
+/** 取打包的 lh 版本（诊断/展示用，失败返 unknown）。 */
+export function resolveLhVersion() {
+  try {
+    return require('@lobehub/cli/package.json').version;
+  } catch {
+    return 'unknown';
+  }
+}

package/src/index.test.js

@@ -0,0 +1,15 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveServerUrl, FORCOME_SERVER } from './index.js';
+
+test('resolveServerUrl 默认指向 Forcome 门户', () => {
+  delete process.env.LOBEHUB_SERVER;
+  assert.equal(resolveServerUrl(), FORCOME_SERVER);
+  assert.equal(resolveServerUrl(), 'https://ai.forcome.com');
+});
+
+test('resolveServerUrl 受 LOBEHUB_SERVER env 覆盖（staging 等）', () => {
+  process.env.LOBEHUB_SERVER = 'https://staging.forcome.com';
+  assert.equal(resolveServerUrl(), 'https://staging.forcome.com');
+  delete process.env.LOBEHUB_SERVER;
+});