llm-api-gateway-cli 1.0.0

package/lib/config.js

@@ -0,0 +1,70 @@
+/**
+ * 统一配置解析（M1.5）
+ *
+ * 在这之前，四个 CLI 各写一份 .env 加载、参数解析、密钥读取与默认模型：
+ * cli-openai 认 OPENAI_API_KEY、cli-anthropic 认 ANTHROPIC_API_KEY、
+ * cli-claude-code 认 ANTHROPIC_AUTH_TOKEN，同一个 .env 换个入口就报「缺少密钥」。
+ * 这里把「--flag > 环境变量 > .env > 默认值」的优先级收成一处，
+ * 所有 CLI 都走 resolveConfig，保证问「密钥从哪来」只有一种答案。
+ */
+
+import { resolveKey, resolveBaseUrl, strArg } from './common.js';
+
+/** 缺密钥时的统一提示（各 CLI 文案一致，避免用户按提示改了还是不通） */
+export const KEY_HINT =
+  '缺少 sk- 密钥：可在 Web 界面「设置」里填，或执行 gateway-agent config set key sk-xxx（存 credentials.json，仅本用户可读）；'
+  + '也可以用 --key sk-xxx、环境变量 SK / GATEWAY_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY，或在 .env 中写 GATEWAY_KEY=sk-xxx';
+
+/**
+ * 数字参数：非法值（NaN / 布尔 / 空串）一律返回 undefined。
+ * 之前直接 Number(v) 会把 --temperature abc 变成 NaN 塞给上游，报错信息很难看懂。
+ */
+export function numArg(v) {
+  if (v === undefined || v === null || typeof v === 'boolean' || v === '') return undefined;
+  const n = Number(v);
+  return Number.isFinite(n) ? n : undefined;
+}
+
+/**
+ * 归一化配置。
+ *
+ * @param {object} args        parseArgs 的产物
+ * @param {object=} opts
+ * @param {string=}  opts.defaultModel      模型默认值（各 CLI 不同：如 cli-anthropic 也用它）
+ * @param {number=}  opts.defaultMaxTokens  最大 token 默认值（cli-anthropic 需要 4096）
+ * @param {object=}  opts.env               环境变量来源，测试可注入
+ * @returns {{key:string, baseUrl:string, model:string, workDir:string,
+ *            temperature:number|undefined, maxTokens:number|undefined, system:string|undefined}}
+ */
+export function resolveConfig(args = {}, { defaultModel = '', defaultMaxTokens, env = process.env } = {}) {
+  const maxTokens = numArg(args['max-tokens']) ?? defaultMaxTokens;
+  return {
+    key: resolveKey(args, env),
+    baseUrl: resolveBaseUrl(args, env),
+    // 顺序：--model > GATEWAY_MODEL > 该入口的默认模型
+    model: strArg(args.model) || strArg(env.GATEWAY_MODEL) || defaultModel,
+    workDir: strArg(args.cwd) || strArg(args['work-dir']) || '',
+    temperature: numArg(args.temperature),
+    maxTokens: Number.isFinite(maxTokens) && maxTokens > 0 ? maxTokens : undefined,
+    system: strArg(args.system) || undefined,
+  };
+}
+
+/** 把异常压成一行可读中文（上游错误、HTTP 状态、普通异常都覆盖） */
+export function errorMessage(e) {
+  const status = e?.status ?? e?.statusCode ?? '';
+  const message = e?.error?.message || e?.message || String(e);
+  return `[错误]${status ? ` HTTP ${status}` : ''}: ${message}`;
+}
+
+/**
+ * 统一的失败出口。
+ *
+ * 关键点：交互（REPL）里出错**不该杀进程** —— 一次请求失败就把整个会话结束掉，
+ * 用户得重新进来重新交代上下文。所以交互循环内传 exit:false，只打印并继续；
+ * 非交互（脚本/管道）保留退出码语义，否则 shell 判断不出成功失败。
+ */
+export function fail(e, { exit = true, stream = process.stderr } = {}) {
+  stream.write(`${errorMessage(e)}\n`);
+  if (exit) process.exit(1);
+}

package/lib/configcmd.js

@@ -0,0 +1,230 @@
+/**
+ * `gateway-agent config …` 与 REPL 里的 `/config` 共用这一份实现。
+ *
+ * 为什么不让两处各写一遍：这两条路最容易漂 —— 命令行能改、页面改不了，
+ * 或者一边校验严格一边宽松。校验与读写统一走 lib/settings.js，
+ * 这里只负责「把结果排成人能看的样子」。
+ *
+ * 最要紧的一条是**「来源」列**：用户改了配置却没生效，八成是被环境变量或命令行
+ * flag 盖住了。与其让他反复改文件试，不如直接告诉他当前生效值来自哪里。
+ *
+ * 密钥（`key`）走**另一条路**：它不进 config.json，而是写 `<数据根>/credentials.json`（仅属主可读），
+ * 所以 `set key` 不是「被拒绝」，而是「写到另一个文件」。命令行的说法与 Web 设置面板完全一致 ——
+ * 这也是「不用手写 .env 就能用」的落点。
+ */
+
+import {
+  resolveSettings,
+  writeSettings,
+  unsetSettings,
+  settingsFilePath,
+  getByPath,
+  defaultValueOf,
+  unknownKeyError,
+  SETTINGS_SCHEMA,
+} from './settings.js';
+import { clearSecret, keyRow, secretFilePath, secretSourceText, writeSecret } from './secrets.js';
+
+const SOURCE_LABEL = { flag: '命令行', env: '环境变量', file: '配置文件', default: '内置默认' };
+/** 密钥的来源只有三层（它不在 config.json 里），所以单独一套标签 */
+const SECRET_SOURCE_LABEL = { flag: '命令行 --key', env: '环境变量', file: '密钥文件', default: '未配置' };
+
+/** CLI 传进来的值是字符串；这里粗切一下，`set system 你是助手 请简短` 的剩余部分都算值 */
+export function splitConfigArg(arg) {
+  const text = typeof arg === 'string' ? arg.trim() : '';
+  if (!text) return [];
+  return text.split(/\s+/);
+}
+
+const show = (v) => {
+  if (v === null || v === undefined) return '（未设）';
+  if (Array.isArray(v)) return v.length ? `${v.length} 项` : '（空）';
+  if (typeof v === 'string') return v.length > 40 ? `${v.slice(0, 39)}…` : v || '（空串）';
+  return String(v);
+};
+
+/** 当前生效值是不是被更高优先级盖住了 —— `set` 之后最容易踩的坑 */
+function overrideWarning(resolved, key) {
+  const source = resolved.sources[key];
+  const entry = SETTINGS_SCHEMA.find((e) => e.key === key);
+  if (source === 'flag') return `注意：当前生效值来自命令行参数（${entry?.flag || key}），它优先于配置文件，你写的值现在不会生效。`;
+  if (source === 'env') return `注意：当前生效值来自环境变量 ${entry?.env}，它优先于配置文件，你写的值现在不会生效。`;
+  return '';
+}
+
+/**
+ * 执行一条 config 命令。
+ * @returns {{code:number, out:string, err:string}}
+ */
+export function configCommand(argv = [], { env = process.env, file = settingsFilePath(env), secretFile = secretFilePath(env) } = {}) {
+  const [action = 'list', key, ...rest] = argv;
+  const resolved = () => resolveSettings({ file, env, args: null });
+  const secretRow = () => keyRow({ env, file: secretFile, args: null });
+
+  if (action === 'help' || action === '--help' || action === '-h') return { code: 0, out: configHelp(), err: '' };
+
+  if (action === 'path') {
+    const r = resolved();
+    const s = secretRow();
+    return {
+      code: 0,
+      out:
+        `${r.file}\n${r.exists ? '（已存在）' : '（还没有这份文件；set 一次就会创建）'}\n` +
+        `${s.file}\n${s.hasKey ? `（已存在，${s.mask}，来自${secretSourceText(s.source)}）` : '（还没有；config set key sk-xxx 或页面设置里填）'}\n`,
+      err: '',
+    };
+  }
+
+  if (action === 'list' || action === 'ls') {
+    const r = resolved();
+    // 密钥行排在最前：它是「能不能用」的前提，而它不在 config.json 里，单独标出来免得用户去文件里翻
+    const secret = secretRow();
+    const rows = [
+      ['配置项', '当前值', '来源'],
+      ['key', secret.hasKey ? `${secret.mask}（存 ${secret.file}）` : '（未配置）', SECRET_SOURCE_LABEL[secret.source] || secret.source],
+      ...SETTINGS_SCHEMA.map((e) => {
+        const row = [e.key, show(getByPath(r.values, e.key)), SOURCE_LABEL[r.sources[e.key]] || r.sources[e.key]];
+        if (e.restart) row[0] = `${e.key} *`;
+        return row;
+      }),
+    ];
+    const w = [0, 1, 2].map((i) => Math.max(...rows.map((row) => [...row[i]].length)));
+    const body = rows.map((row, i) => row.map((c, ci) => pad(c, w[ci])).join('  ').trimEnd()).join('\n');
+    const warns = [...r.warnings, ...[secret.warning].filter(Boolean)];
+    const warn = warns.length ? `\n\n[警告]\n${warns.map((x) => `  ${x}`).join('\n')}` : '';
+    return {
+      code: 0,
+      out:
+        `${body}\n\n` +
+        `来源：命令行 > 环境变量 > 配置文件 > 内置默认。带 * 的改了要重启服务才生效。\n` +
+        `配置文件：${r.file}${r.exists ? '' : '（还没有，用 config set 创建）'}\n` +
+        `密钥不入配置文件：key 存在 ${secret.file}（仅本用户可读），环境变量 / --key 给的密钥优先于它。\n` +
+        `改某项：gateway-agent config set <键> <值>；改回来：config unset <键>${warn}\n`,
+      err: '',
+    };
+  }
+
+  if (action === 'get') {
+    if (!key) return { code: 1, out: '', err: '用法：gateway-agent config get <键>\n' };
+    if (key === 'key') {
+      const s = secretRow();
+      const lines = [
+        // 明文永不回显：命令行输出经常被贴进 issue / 日志
+        `key = ${s.hasKey ? s.mask : '（未配置）'}`,
+        `  来源      ${SECRET_SOURCE_LABEL[s.source] || s.source}`,
+        `  存放      ${s.file}${s.fileMode ? `（权限 ${s.fileMode.toString(8)}）` : ''}`,
+        '  说明      密钥不写进 config.json；这里只回掩码，明文请回网关后台重新生成',
+        '  环境变量  SK / GATEWAY_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY',
+        '  命令行    --key',
+        s.warning ? `  警告      ${s.warning}` : '',
+      ].filter(Boolean);
+      return { code: 0, out: `${lines.join('\n')}\n`, err: '' };
+    }
+    const entry = SETTINGS_SCHEMA.find((e) => e.key === key);
+    if (!entry) return { code: 1, out: '', err: `${unknownKeyError(key)}\n` };
+    const r = resolved();
+    const lines = [
+      `${key} = ${JSON.stringify(getByPath(r.values, key))}`,
+      `  来源      ${SOURCE_LABEL[r.sources[key]] || r.sources[key]}`,
+      `  内置默认  ${JSON.stringify(defaultValueOf(entry))}`,
+      `  说明      ${entry.desc}`,
+      entry.env ? `  环境变量  ${entry.env}` : '',
+      entry.flag ? `  命令行    ${entry.flag}` : '',
+      entry.restart ? '  注意      改这项需要重启服务才生效' : '',
+    ].filter(Boolean);
+    return { code: 0, out: `${lines.join('\n')}\n`, err: '' };
+  }
+
+  if (action === 'set') {
+    if (!key || rest.length === 0) return { code: 1, out: '', err: '用法：gateway-agent config set <键> <值>（字符串带空格时整段都要写上）\n' };
+    const value = rest.join(' ');
+    // 密钥：写 credentials.json，不碰 config.json（红线没变，只是换了落点）
+    if (key === 'key') {
+      try {
+        const w = writeSecret(value, { file: secretFile });
+        const s = secretRow();
+        const override = s.source === 'env' || s.source === 'flag'
+          ? '\n注意：当前进程的密钥来自环境变量 / --key，它优先于这个文件，你写的值现在不会生效。'
+          : '';
+        const perm = w.mode ? `（权限 ${w.mode.toString(8)}）` : '（Windows：靠用户目录 ACL）';
+        return {
+          code: 0,
+          out: `已写入 ${w.file}${perm}：key = ${s.mask}${w.warning ? `\n${w.warning}` : ''}${override}\n`,
+          err: '',
+        };
+      } catch (e) {
+        return { code: 1, out: '', err: `${e.message}\n` };
+      }
+    }
+    try {
+      const res = writeSettings({ [key]: value }, { file });
+      const r = resolved();
+      const warn = overrideWarning(r, key);
+      const entry = SETTINGS_SCHEMA.find((e) => e.key === key);
+      const restart = entry?.restart ? '\n（这项要重启服务才生效）' : '';
+      const shown = show(getByPath(r.values, key));
+      return {
+        code: 0,
+        out: `已写入 ${res.file}：${key} = ${shown}${restart}${warn ? `\n${warn}` : ''}\n`,
+        err: '',
+      };
+    } catch (e) {
+      return { code: 1, out: '', err: `${e.message}\n` };
+    }
+  }
+
+  if (action === 'unset' || action === 'rm') {
+    if (!key) return { code: 1, out: '', err: '用法：gateway-agent config unset <键>\n' };
+    if (key === 'key') {
+      const cleared = clearSecret({ file: secretFile });
+      const s = secretRow();
+      const still = s.hasKey ? `当前生效的仍是${SECRET_SOURCE_LABEL[s.source] || s.source}的密钥：${s.mask}` : '现在没有可用的密钥了。';
+      return {
+        code: 0,
+        out: `${cleared.removed ? `已删掉 ${cleared.file}，` : `本来就没有 ${cleared.file}，`}${still}\n`,
+        err: '',
+      };
+    }
+    try {
+      const res = unsetSettings([key], { file });
+      const r = resolved();
+      const now = show(getByPath(r.values, key));
+      const warn = overrideWarning(r, key);
+      if (!res.removed.length) {
+        return { code: 0, out: `${key} 本来就没在配置文件里，现在用的仍是${SOURCE_LABEL[r.sources[key]] || r.sources[key]}的值：${now}${warn ? `\n${warn}` : ''}\n`, err: '' };
+      }
+      return { code: 0, out: `已从 ${res.file} 删掉 ${key}，现在生效的是：${now}${warn ? `\n${warn}` : ''}\n`, err: '' };
+    } catch (e) {
+      return { code: 1, out: '', err: `${e.message}\n` };
+    }
+  }
+
+  return { code: 1, out: '', err: `未知子命令 ${action}\n\n${configHelp()}` };
+}
+
+/** 中文对齐：按显示宽度补齐（中文算两格），否则表格会歪 */
+function pad(text, width) {
+  const s = String(text);
+  const w = [...s].reduce((n, ch) => n + (ch.charCodeAt(0) > 0x2e80 ? 2 : 1), 0);
+  return s + ' '.repeat(Math.max(0, width - w));
+}
+
+export function configHelp() {
+  return `用法：gateway-agent config <子命令>
+
+  list              列出所有配置项、当前值与来源（默认）
+  get <键>          查看某一项（含默认值、说明、对应的环境变量与命令行选项）
+  set <键> <值>     写入配置文件（原子写；写错会明确报错并列出可用键）
+  unset <键>        删掉某一项，回到内置默认
+  path              打印配置文件与密钥文件的路径
+
+配置文件的路径可用环境变量 LLM_GATEWAY_CONFIG 覆盖。
+优先级：命令行 > 环境变量 > 配置文件 > 内置默认 —— list 的「来源」列就是告诉你当前生效值来自哪一层。
+
+密钥（key）走另一条路：config set key sk-xxx 会写 <数据根>/credentials.json（仅本用户可读），
+**不写进 config.json**；命令行 / 环境变量 / .env 给的密钥优先于它。get key 只回掩码，明文不回显。
+Web 界面「设置」里的密钥输入框写的是同一个文件 —— 命令行与界面不会各存一处。
+
+REPL 里同一套：/config、/config set <键> <值>、/config get <键>、/config unset <键>
+`;
+}