llm-api-gateway-cli 1.0.4 → 1.0.6

package/cli-claude-code.js

@@ -24,7 +24,9 @@ import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 
 import { loadDotEnv, DEFAULT_BASE_URL, sessionBaggage } from './lib/common.js';
-import { resolveConfig, KEY_HINT } from './lib/config.js';
+import { resolveConfig, keyHint } from './lib/config.js';
+// CLI 侧语言（只覆盖命令行输出；Web 界面与手册页仍是中文）。默认 zh，见 lib/i18n.js
+import { pick, setLang, resolveLang, LANG_FLAG } from './lib/i18n.js';
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 loadDotEnv(SCRIPT_DIR); // 先加载 .env，让 GATEWAY_MODEL 等环境变量参与默认值计算
@@ -32,7 +34,7 @@ loadDotEnv(SCRIPT_DIR); // 先加载 .env，让 GATEWAY_MODEL 等环境变量参
 const DEFAULT_MODEL = process.env.GATEWAY_MODEL || 'qwen3:8b';
 const DEFAULT_HAIKU = 'qwen3:8b-nothink';
 
-const HELP = `用法：node cli-claude-code.js [选项] [-- claude 参数...]
+const HELP_ZH = `用法：node cli-claude-code.js [选项] [-- claude 参数...]
 
 选项（本脚本自身）：
   -k, --key <sk-密钥>         网关发放的密钥（可用环境变量 SK/GATEWAY_KEY/ANTHROPIC_AUTH_TOKEN 或 .env）
@@ -45,12 +47,38 @@ const HELP = `用法：node cli-claude-code.js [选项] [-- claude 参数...]
       --smoke                仅做一次 /v1/messages 连通性自检后退出，不拉起 claude
       --print-env            仅打印要注入的环境变量，不拉起 claude
       --config               打印 CC Switch / CC GUI 可直接粘贴的 JSON 配置
+      --lang <zh|en>         输出语言（默认 zh，也可用环境变量 LLM_GATEWAY_LANG）
   -h, --help                 显示帮助
 
 透传：\`--\` 之后的参数原样交给 claude，例如：
   node cli-claude-code.js -- -p "你好" --model deepseek-v4-pro
 `;
 
+const HELP_EN = `Usage: node cli-claude-code.js [options] [-- claude args...]
+
+Options (this script's own):
+  -k, --key <sk-key>         gateway API key (or env SK/GATEWAY_KEY/ANTHROPIC_AUTH_TOKEN, or .env)
+      --base-url <url>       gateway base URL (default ${DEFAULT_BASE_URL})
+  -m, --model <model>        ANTHROPIC_MODEL, the main model (default ${DEFAULT_MODEL})
+      --opus-model <model>   ANTHROPIC_DEFAULT_OPUS_MODEL (default: same as --model)
+      --sonnet-model <model> ANTHROPIC_DEFAULT_SONNET_MODEL (default: same as --model)
+      --haiku-model <model>  ANTHROPIC_DEFAULT_HAIKU_MODEL (default ${DEFAULT_HAIKU})
+      --small-fast-model <model> ANTHROPIC_SMALL_FAST_MODEL, background fast model (default: same as haiku)
+      --smoke                run one /v1/messages connectivity check, then exit; do not launch claude
+      --print-env            only print the environment variables to inject; do not launch claude
+      --config               print JSON config ready to paste into CC Switch / CC GUI
+      --lang <zh|en>         output language (default zh; env LLM_GATEWAY_LANG)
+  -h, --help                 show this help
+
+Passthrough: everything after \`--\` is handed to claude unchanged, e.g.:
+  node cli-claude-code.js -- -p "hello" --model deepseek-v4-pro
+`;
+
+/** 大段帮助取词必须在**调用时**（模块顶层调 pick 会早于 setLang，永远拿到中文） */
+function help() {
+  return pick(HELP_ZH, HELP_EN);
+}
+
 // ---------- 参数解析：本脚本自己的参数 vs 透传给 claude 的参数 ----------
 // 注意这里不能直接用 lib/common.js 的 parseArgs：本脚本要把「不认识的参数」
 // 原样透传给 claude，而通用解析器会把它们吃掉。
@@ -65,6 +93,7 @@ const WITH_VALUE = {
   '--small-fast-model': 'smallFastModel',
   '-k': 'key',
   '-m': 'model',
+  ...LANG_FLAG, // --lang <zh|en>：本脚本自己消费，不透传给 claude
 };
 const FLAG = {
   '--smoke': 'smoke',
@@ -154,6 +183,7 @@ async function smoke(baseUrl, key, model) {
   const url = `${baseUrl.replace(/\/+$/, '')}/v1/messages`;
   // 用流式请求自检：Claude Code 实际走的就是 /v1/messages 的 SSE 流，最能反映真实可用性
   // max_tokens 给足：本地 thinking 模型（如 qwen3:8b）会先把额度花在 reasoning 上，太小则看不到正文
+  // 正文这句是**发给网关的请求内容**（不是给人看的输出），一律保持中文，不随 --lang 变
   const body = { model, max_tokens: 256, messages: [{ role: 'user', content: '你好，请用一句话回复' }], stream: true };
   let res;
   try {
@@ -167,12 +197,12 @@ async function smoke(baseUrl, key, model) {
       body: JSON.stringify(body),
     });
   } catch (e) {
-    console.error(`[smoke] 连接异常: ${e?.message || e}`);
+    console.error(pick(`[smoke] 连接异常: ${e?.message || e}`, `[smoke] connection error: ${e?.message || e}`));
     return false;
   }
   if (!res.ok) {
     const text = await res.text();
-    console.error(`[smoke] 失败 HTTP ${res.status}: ${text.slice(0, 300)}`);
+    console.error(pick(`[smoke] 失败 HTTP ${res.status}: ${text.slice(0, 300)}`, `[smoke] failed HTTP ${res.status}: ${text.slice(0, 300)}`));
     return false;
   }
 
@@ -210,10 +240,13 @@ async function smoke(baseUrl, key, model) {
     }
   }
   if (!started) {
-    console.error('[smoke] 失败：未收到 message_start 事件');
+    console.error(pick('[smoke] 失败：未收到 message_start 事件', '[smoke] failed: no message_start event received'));
     return false;
   }
-  console.error(`[smoke] 成功 model=${model} 回复="${reply.slice(0, 40)}"`);
+  console.error(pick(
+    `[smoke] 成功 model=${model} 回复="${reply.slice(0, 40)}"`,
+    `[smoke] ok model=${model} reply="${reply.slice(0, 40)}"`,
+  ));
   return true;
 }
 
@@ -225,13 +258,16 @@ function runClaude(passthrough, env) {
   if (!r.error) return r.status ?? 0;
   // Windows 下 npm 安装的 claude 是 .cmd shim，直接 spawn 会报 ENOENT/EINVAL → 回退 shell 解析
   if (r.error.code !== 'ENOENT' && r.error.code !== 'EINVAL') {
-    console.error(`[错误] 启动 claude 失败: ${r.error.message}`);
+    console.error(pick(`[错误] 启动 claude 失败: ${r.error.message}`, `[error] failed to launch claude: ${r.error.message}`));
     return 1;
   }
   const cmd = ['claude', ...passthrough].map((s) => (/[\s"&|<>]/.test(s) ? JSON.stringify(s) : s)).join(' ');
   const r2 = spawnSync(cmd, { env, stdio: 'inherit', shell: true });
   if (r2.error) {
-    console.error('[错误] 未找到 claude 命令：请先安装 Claude Code（npm install -g @anthropic-ai/claude-code）');
+    console.error(pick(
+      '[错误] 未找到 claude 命令：请先安装 Claude Code（npm install -g @anthropic-ai/claude-code）',
+      '[error] claude command not found: install Claude Code first (npm install -g @anthropic-ai/claude-code)',
+    ));
     return 1;
   }
   return r2.status ?? 0;
@@ -241,9 +277,12 @@ function runClaude(passthrough, env) {
 
 async function main() {
   const { opts, passthrough } = parseArgs(process.argv.slice(2));
+  // 语言要在**任何输出之前**定下来：--help / 报错 / 横幅都按它取词。
+  // 注意 --lang 已在 WITH_VALUE 里，不会被当成 claude 的参数透传出去
+  setLang(resolveLang(opts, process.env));
 
   if (opts.help) {
-    console.log(HELP);
+    console.log(help());
     return;
   }
 
@@ -254,7 +293,7 @@ async function main() {
   );
 
   if (!key) {
-    console.error(`[错误] ${KEY_HINT}`);
+    console.error(`${pick('[错误]', '[error]')} ${keyHint()}`);
     process.exit(1);
   }
 
@@ -306,10 +345,18 @@ async function main() {
     return;
   }
 
-  process.stderr.write(`[gateway] 启动 Claude Code：base=${baseUrl} model=${env.ANTHROPIC_MODEL}\n`);
+  process.stderr.write(pick(
+    `[gateway] 启动 Claude Code：base=${baseUrl} model=${env.ANTHROPIC_MODEL}\n`,
+    `[gateway] launching Claude Code: base=${baseUrl} model=${env.ANTHROPIC_MODEL}\n`,
+  ));
   // 把会话 id 显式打出来（与另外三个入口的提示一致），否则任务树里对不上是哪一次启动
   const sid = /session\.id=([A-Za-z0-9._-]+)/.exec(String(env.ANTHROPIC_CUSTOM_HEADERS || ''));
-  if (sid) process.stderr.write(`[gateway] 会话 ${sid[1]}（W3C baggage: session.id）\n`);
+  if (sid) {
+    process.stderr.write(pick(
+      `[gateway] 会话 ${sid[1]}（W3C baggage: session.id）\n`,
+      `[gateway] session ${sid[1]} (W3C baggage: session.id)\n`,
+    ));
+  }
   const code = runClaude(passthrough, env);
   process.exit(code);
 }

package/cli-openai.js

@@ -28,14 +28,16 @@ import readline from 'node:readline';
 import { randomUUID } from 'node:crypto';
 
 import { loadDotEnv, parseArgs, sessionBaggage, DEFAULT_BASE_URL } from './lib/common.js';
-import { resolveConfig, fail, KEY_HINT } from './lib/config.js';
+import { resolveConfig, fail, keyHint } from './lib/config.js';
+// CLI 侧语言（只覆盖命令行输出；Web 界面与手册页仍是中文）。默认 zh，见 lib/i18n.js
+import { pick, setLang, resolveLang, LANG_FLAG } from './lib/i18n.js';
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 loadDotEnv(SCRIPT_DIR); // 先加载 .env，让 GATEWAY_MODEL 等环境变量参与默认值计算
 
 const DEFAULT_MODEL = process.env.GATEWAY_MODEL || 'qwen3:8b';
 
-const HELP = `用法：node cli-openai.js [选项] [提示词]
+const HELP_ZH = `用法：node cli-openai.js [选项] [提示词]
 
 选项：
   -p, --prompt <文本>      单轮提问内容（省略则读位置参数 / 标准输入）
@@ -49,9 +51,33 @@ const HELP = `用法：node cli-openai.js [选项] [提示词]
       --json               输出完整原始响应（非流式）
       --list-models        列出上游可用模型
   -i, --interactive        进入多轮交互（REPL）
+      --lang <zh|en>       输出语言（默认 zh，也可用环境变量 LLM_GATEWAY_LANG）
   -h, --help               显示帮助
 `;
 
+const HELP_EN = `Usage: node cli-openai.js [options] [prompt]
+
+Options:
+  -p, --prompt <text>      one-shot prompt (falls back to the positional argument / stdin)
+  -s, --system <text>      system prompt
+  -m, --model <model>      model name (default ${DEFAULT_MODEL})
+  -k, --key <sk-key>       gateway API key (or env SK/GATEWAY_KEY/OPENAI_API_KEY, or .env)
+      --base-url <url>     gateway base URL (default ${DEFAULT_BASE_URL})
+      --temperature <v>    sampling temperature
+      --max-tokens <v>     max generated tokens
+      --no-stream          disable streaming output (on by default)
+      --json               print the full raw response (non-streaming)
+      --list-models        list available upstream models
+  -i, --interactive        multi-turn interactive mode (REPL)
+      --lang <zh|en>       output language (default zh; env LLM_GATEWAY_LANG)
+  -h, --help               show this help
+`;
+
+/** 大段帮助取词必须在**调用时**（模块顶层调 pick 会早于 setLang，永远拿到中文） */
+function help() {
+  return pick(HELP_ZH, HELP_EN);
+}
+
 // 值型选项：会消费下一个参数作为值；布尔型选项：不消费后续参数
 const VALUE_FLAGS = {
   '--prompt': 'prompt', '-p': 'prompt',
@@ -61,6 +87,7 @@ const VALUE_FLAGS = {
   '--base-url': 'base-url',
   '--temperature': 'temperature',
   '--max-tokens': 'max-tokens',
+  ...LANG_FLAG, // --lang <zh|en>：与另外三个入口同一份定义（lib/i18n.js）
 };
 const BOOL_FLAGS = {
   '--no-stream': 'no-stream',
@@ -86,23 +113,25 @@ function fmtUsage(u) {
   const p = u.prompt_tokens ?? '?';
   const c = u.completion_tokens ?? '?';
   const t = u.total_tokens ?? (Number.isFinite(p) && Number.isFinite(c) ? p + c : '?');
-  return `输入 ${p} / 输出 ${c} / 合计 ${t} tokens`;
+  return pick(`输入 ${p} / 输出 ${c} / 合计 ${t} tokens`, `input ${p} / output ${c} / total ${t} tokens`);
 }
 
 // ---------- 主流程 ----------
 
 async function main() {
   const args = parseArgs(process.argv.slice(2), VALUE_FLAGS, BOOL_FLAGS);
+  // 语言要在**任何输出之前**定下来：--help / 报错 / 横幅都按它取词
+  setLang(resolveLang(args, process.env));
 
   if (args.help) {
-    console.log(HELP);
+    console.log(help());
     return;
   }
 
   const { key, baseUrl, model, temperature, maxTokens } = resolveConfig(args, { defaultModel: DEFAULT_MODEL });
 
   if (!key) {
-    console.error(`[错误] ${KEY_HINT}`);
+    console.error(`${pick('[错误]', '[error]')} ${keyHint()}`);
     process.exit(1);
   }
 
@@ -111,7 +140,12 @@ async function main() {
   const sessionId = randomUUID();
   const baggage = sessionBaggage(sessionId);
   // 打到 stderr，便于在后台「任务树」里按这个 id 对号入座
-  if (baggage) process.stderr.write(`[gateway] 会话 ${sessionId}（W3C baggage: session.id）\n`);
+  if (baggage) {
+    process.stderr.write(pick(
+      `[gateway] 会话 ${sessionId}（W3C baggage: session.id）\n`,
+      `[gateway] session ${sessionId} (W3C baggage: session.id)\n`,
+    ));
+  }
 
   const client = new OpenAI({
     baseURL: `${baseUrl}/v1`,
@@ -123,7 +157,7 @@ async function main() {
     try {
       const res = await client.models.list();
       const ids = (res.data || []).map((m) => m.id);
-      console.log(ids.length ? ids.join('\n') : '(上游未返回模型列表)');
+      console.log(ids.length ? ids.join('\n') : pick('(上游未返回模型列表)', '(upstream returned no model list)'));
     } catch (e) {
       fail(e);
     }
@@ -141,7 +175,7 @@ async function main() {
   if (!prompt && args._.length) prompt = args._.join(' ');
   if (!prompt) prompt = await readStdin();
   if (!prompt) {
-    console.log(HELP);
+    console.log(help());
     return;
   }
 
@@ -189,10 +223,13 @@ async function chat(client, model, messages, { stream, temperature, maxTokens, j
 }
 
 async function repl(client, model, opts) {
-  console.error(`[gateway] 交互模式 model=${model}，输入文本提问，\`exit\` 退出`);
+  console.error(pick(
+    `[gateway] 交互模式 model=${model}，输入文本提问，\`exit\` 退出`,
+    `[gateway] interactive mode model=${model}; type a prompt, \`exit\` to quit`,
+  ));
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   const messages = [];
-  const ask = () => new Promise((resolve) => rl.question('你> ', resolve));
+  const ask = () => new Promise((resolve) => rl.question(pick('你> ', 'you> '), resolve));
   for (;;) {
     let line;
     try {
@@ -203,7 +240,7 @@ async function repl(client, model, opts) {
     if (!line) continue;
     if (/^(exit|quit)$/i.test(line)) break;
     messages.push({ role: 'user', content: line });
-    process.stdout.write('助手> ');
+    process.stdout.write(pick('助手> ', 'assistant> '));
     await chat(client, model, messages, { ...opts, json: false, exitOnError: false });
   }
   rl.close();