@cc-x/cc-x 0.3.0

package/dist/config/store.js

@@ -0,0 +1,235 @@
+/**
+ * 配置存取层：读写 ~/.cc-mini/providers.json，生成默认配置，构造 env map。
+ *
+ * 铁律：这里写的是工具自己的数据文件（providers.json），**绝不**碰 ~/.claude/*。
+ * 格式与现版 PowerShell 完全兼容；写入 UTF-8 无 BOM、2 空格缩进。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { KNOWN_KEYS } from './types.js';
+export { KNOWN_KEYS } from './types.js';
+/** 解析存储路径。`storeDir` 来自 --store-dir（测试用），默认 ~/.cc-mini。 */
+export function resolveStorePaths(storeDir) {
+    const dir = storeDir && storeDir.trim() ? storeDir : join(homedir(), '.cc-mini');
+    return { dir, file: join(dir, 'providers.json') };
+}
+const nonEmpty = (v) => typeof v === 'string' && v.trim() !== '';
+/**
+ * 默认配置：官方 + DeepSeek + 智谱GLM + 小米MiMo（密钥空）。
+ * 官方档带 `builtin: 'official'`（评审①），其它供应商是专有名词、不翻译。
+ */
+export function defaultStore() {
+    return {
+        current: '官方',
+        lang: 'zh',
+        providers: [
+            { name: '官方', note: '', builtin: 'official', env: {} },
+            {
+                name: 'DeepSeek',
+                note: '',
+                env: {
+                    ANTHROPIC_BASE_URL: 'https://api.deepseek.com/anthropic',
+                    ANTHROPIC_DEFAULT_OPUS_MODEL: 'deepseek-v4-pro',
+                    ANTHROPIC_DEFAULT_SONNET_MODEL: 'deepseek-v4-pro',
+                    ANTHROPIC_DEFAULT_HAIKU_MODEL: 'deepseek-v4-flash',
+                    CLAUDE_CODE_EFFORT_LEVEL: 'max',
+                },
+            },
+            {
+                name: '智谱GLM',
+                note: '',
+                env: {
+                    ANTHROPIC_BASE_URL: 'https://open.bigmodel.cn/api/anthropic',
+                    ANTHROPIC_DEFAULT_OPUS_MODEL: 'GLM-4.7',
+                    ANTHROPIC_DEFAULT_SONNET_MODEL: 'GLM-4.7',
+                    ANTHROPIC_DEFAULT_HAIKU_MODEL: 'glm-4.5-air',
+                },
+            },
+            {
+                name: '小米MiMo',
+                note: '',
+                env: {
+                    ANTHROPIC_BASE_URL: 'https://api.xiaomimimo.com/anthropic',
+                    ANTHROPIC_DEFAULT_OPUS_MODEL: 'mimo-v2.5-pro',
+                    ANTHROPIC_DEFAULT_SONNET_MODEL: 'mimo-v2.5-pro',
+                    ANTHROPIC_DEFAULT_HAIKU_MODEL: 'mimo-v2.5-pro',
+                },
+            },
+        ],
+    };
+}
+/**
+ * 把任意解析结果规整为合法 Store。
+ *
+ * 字段级**宽松容错**（缺 lang / 缺 note / 缺 builtin / 缺 env 都不报错），保证老用户文件零迁移；
+ * 但结构级**严格校验**：顶层必须是对象、`providers` 必须是数组、每个配置的 name/env 结构必须合法
+ * —— 否则抛 StoreError('format')。
+ * 这是为了堵住「语法合法但结构损坏的 JSON 被静默规整成空 providers、用户一保存就覆盖丢数据」的坑（[P1]）。
+ */
+function normalizeStore(raw, file) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        throw new StoreError('format', file);
+    const obj = raw;
+    if (!Array.isArray(obj.providers))
+        throw new StoreError('format', file);
+    const providers = obj.providers.map((p) => normalizeProvider(p, file));
+    const lang = obj.lang === 'en' ? 'en' : obj.lang === 'zh' ? 'zh' : undefined;
+    const current = typeof obj.current === 'string' ? obj.current : (providers[0]?.name ?? '');
+    return { current, ...(lang ? { lang } : {}), providers };
+}
+function normalizeProvider(raw, file) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        throw new StoreError('format', file);
+    const p = raw;
+    if (typeof p.name !== 'string')
+        throw new StoreError('format', file);
+    if (p.note !== undefined && typeof p.note !== 'string')
+        throw new StoreError('format', file);
+    if (p.builtin !== undefined && typeof p.builtin !== 'string')
+        throw new StoreError('format', file);
+    if (p.env !== undefined && (!p.env || typeof p.env !== 'object' || Array.isArray(p.env))) {
+        throw new StoreError('format', file);
+    }
+    const name = p.name;
+    const note = typeof p.note === 'string' ? p.note : '';
+    const builtin = typeof p.builtin === 'string' ? p.builtin : undefined;
+    const env = {};
+    if (p.env) {
+        for (const [k, v] of Object.entries(p.env)) {
+            if (typeof v !== 'string')
+                throw new StoreError('format', file);
+            env[k] = v;
+        }
+    }
+    return { name, note, ...(builtin ? { builtin } : {}), env };
+}
+export class StoreError extends Error {
+    kind;
+    file;
+    constructor(kind, file) {
+        super(`store ${kind} error: ${file}`);
+        this.kind = kind;
+        this.file = file;
+        this.name = 'StoreError';
+    }
+}
+/** 读配置；文件不存在则生成默认并落盘后返回；文件不可用则抛 StoreError（绝不覆盖）。 */
+export function loadStore(paths) {
+    let text;
+    try {
+        text = readFileSync(paths.file, 'utf-8'); // [P2] 权限/磁盘/EISDIR 等
+    }
+    catch (e) {
+        if (e.code !== 'ENOENT')
+            throw new StoreError('read', paths.file);
+        const store = defaultStore();
+        saveStore(paths, store);
+        return store;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new StoreError('parse', paths.file);
+    }
+    return normalizeStore(parsed, paths.file); // [P1] 结构校验在内部，失败抛 'format'
+}
+/**
+ * 只读探测 lang，**不生成文件**（用于 --help/--version 在 parse 前定语言，避免副作用）。
+ * 文件不存在/解析失败都返回 undefined。
+ */
+export function peekStoreLang(paths) {
+    try {
+        if (!existsSync(paths.file))
+            return undefined;
+        const raw = JSON.parse(readFileSync(paths.file, 'utf-8'));
+        return raw.lang === 'en' ? 'en' : raw.lang === 'zh' ? 'zh' : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 写配置：UTF-8 无 BOM、2 空格缩进（Node 默认 utf-8 不带 BOM，与现版一致）。 */
+export function saveStore(paths, store) {
+    if (!existsSync(paths.dir))
+        mkdirSync(paths.dir, { recursive: true });
+    writeFileSync(paths.file, `${JSON.stringify(store, null, 2)}\n`, 'utf-8');
+}
+/**
+ * 是否官方档。优先认稳定标识 `builtin === 'official'`（评审①）；
+ * 老文件没有 builtin 时，仅将「中文名为官方 + env 为空」视为官方档。
+ * 这样旧数据仍兼容，而手动填了第三方地址/密钥的同名配置不会被误判为登录态。
+ */
+export function isOfficial(p) {
+    if (p.builtin)
+        return p.builtin === 'official';
+    return p.name === '官方' && Object.keys(p.env).length === 0;
+}
+/**
+ * [P1] 编辑保存后修正身份：官方档（builtin='official' = 登录态、空 env）一旦被配成真实第三方
+ * （env 非空，有了 base/key 等），就清掉 builtin —— 否则会继续被当登录态、跳过缺密钥警告。
+ */
+export function reconcileBuiltin(p) {
+    if (p.builtin === 'official' && Object.keys(p.env).length > 0) {
+        delete p.builtin;
+    }
+}
+/** 删除配置等操作后修正默认指向：优先剩余官方档，其次第一项；没有配置则置空。 */
+export function reconcileCurrent(store) {
+    if (store.providers.some((p) => p.name === store.current))
+        return;
+    store.current = (store.providers.find(isOfficial) ?? store.providers[0])?.name ?? '';
+}
+/** 取配置的 env map（即 provider.env，保证非空对象）。 */
+export function getProviderEnvMap(p) {
+    return p.env ?? {};
+}
+/**
+ * 由一组字段构造 provider.env：按 KNOWN_KEYS 顺序、丢弃空白值。
+ * 对齐现版 Build-ProviderEnv。`[1m]` 等后缀属于自由文本，原样保留（见 plan §3.1.1）。
+ */
+export function buildProviderEnv(fields) {
+    const env = {};
+    for (const key of KNOWN_KEYS) {
+        const v = fields[key];
+        if (nonEmpty(v))
+            env[key] = v.trim();
+    }
+    return env;
+}
+export function getProviderState(p) {
+    const map = getProviderEnvMap(p);
+    const effort = nonEmpty(map.CLAUDE_CODE_EFFORT_LEVEL) ? map.CLAUDE_CODE_EFFORT_LEVEL : undefined;
+    if (isOfficial(p))
+        return { key: 'official', ...(effort ? { effort } : {}) };
+    const hasTok = nonEmpty(map.ANTHROPIC_AUTH_TOKEN);
+    const hasKey = nonEmpty(map.ANTHROPIC_API_KEY);
+    const key = !hasTok && !hasKey ? 'noKey' : hasKey ? 'apiKey' : 'hasToken';
+    return { key, ...(effort ? { effort } : {}) };
+}
+/** 按 name 找配置。 */
+export function findProvider(store, name) {
+    return store.providers.find((p) => p.name === name);
+}
+/**
+ * 名称去重：同名被【其它】配置占用时追加 “ 2/3/…”。`exclude` 是正在编辑的本条（排除自身）。
+ * 对齐现版 Resolve-UniqueName。
+ */
+export function resolveUniqueName(store, name, exclude) {
+    const existing = store.providers.filter((p) => p !== exclude).map((p) => p.name);
+    if (!existing.includes(name))
+        return name;
+    let i = 2;
+    while (existing.includes(`${name} ${i}`))
+        i += 1;
+    return `${name} ${i}`;
+}
+/** 语言：providers.json 的 lang 字段，缺省视为 zh。 */
+export function getLang(store) {
+    return store.lang === 'en' ? 'en' : 'zh';
+}
+export function setLang(store, lang) {
+    store.lang = lang;
+}

package/dist/config/types.js

@@ -0,0 +1,16 @@
+/**
+ * 数据层共享类型与常量。
+ *
+ * 数据格式必须与现版 PowerShell 完全兼容（老用户的 ~/.cc-mini/providers.json 能直接读）。
+ * 详见 docs/npm-rewrite-plan.md §3。
+ */
+/** 受管的 7 个环境变量（工具只动这些，其它一律不碰）。详见 plan §2。 */
+export const KNOWN_KEYS = [
+    'ANTHROPIC_BASE_URL',
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_API_KEY',
+    'ANTHROPIC_DEFAULT_OPUS_MODEL',
+    'ANTHROPIC_DEFAULT_SONNET_MODEL',
+    'ANTHROPIC_DEFAULT_HAIKU_MODEL',
+    'CLAUDE_CODE_EFFORT_LEVEL',
+];

package/dist/env/default.js

@@ -0,0 +1,42 @@
+/**
+ * 设为默认（Set-Default）—— 持久化用户环境变量，仅影响新开终端、不动运行中会话。
+ *
+ * 对 7 个受管键：目标配置有值的写值，没值的清除（vals 里记 null）。然后 store.current=name 并存盘。
+ * 平台分叉是唯一有平台差异的地方：Windows 走注册表+广播，Unix 走 rc 文件 marker 块。
+ * `--default-scope process` = 不落盘 dry-run（评审⑥）：照常算 vals、更新 store，但跳过系统持久化。
+ */
+import { KNOWN_KEYS, getProviderEnvMap, saveStore } from '../config/store.js';
+import { persistUnix } from './persist-unix.js';
+import { persistWindows } from './persist-windows.js';
+/** 每个受管键 → 值或 null（清除）。对齐现版 Set-Default 里的 $vals 构造。 */
+export function computeManagedVals(p) {
+    const map = getProviderEnvMap(p);
+    const vals = {};
+    for (const k of KNOWN_KEYS) {
+        const v = map[k];
+        vals[k] = typeof v === 'string' && v.trim() !== '' ? v : null;
+    }
+    return vals;
+}
+export function setDefault(paths, store, p, scope) {
+    const vals = computeManagedVals(p);
+    const dryRun = scope === 'process';
+    const result = { scope, dryRun };
+    let persisted = true;
+    if (!dryRun) {
+        if (process.platform === 'win32') {
+            result.windows = persistWindows(vals);
+            persisted = result.windows.ok;
+        }
+        else {
+            result.unix = persistUnix(vals);
+            persisted = !result.unix.unsupported; // fish 未写入 → 不算持久化成功
+        }
+    }
+    // [P1] 仅当持久化成功（或 dry-run）才改默认指向并落盘，避免「报失败却已改默认」的不一致。
+    if (dryRun || persisted) {
+        store.current = p.name;
+        saveStore(paths, store);
+    }
+    return result;
+}

package/dist/env/persist-unix.js

@@ -0,0 +1,72 @@
+/**
+ * macOS / Linux 持久化：在 shell 启动文件里维护一个 marker 块（幂等，可重复重写）。
+ *
+ *   # >>> xx >>>
+ *   export ANTHROPIC_BASE_URL='https://...'
+ *   ...只导出当前配置用到的受管键...
+ *   # <<< xx <<<
+ *
+ * 每次「设为默认」整体重写该块 —— 自动清除上个默认里多余的 export。语义与 Windows 一致：
+ * 只影响新开终端、不动运行中会话（rc 文件仅在新交互 shell 启动时加载）。
+ * fish 语法不同（set -gx），v1 不支持，由调用方据 `kind==='fish'` 给提示（评审/plan §4.2）。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname } from 'node:path';
+import { join as posixJoin } from 'node:path/posix';
+const BEGIN = '# >>> xx >>>';
+const END = '# <<< xx <<<';
+/** 单引号包裹值，按 shell 规则转义内部单引号（'\'' 收尾再起）。 */
+function shQuote(v) {
+    return `'${v.split("'").join("'\\''")}'`;
+}
+/** 生成 marker 块文本（只含非空键，按传入顺序）。 */
+export function buildBlock(vals) {
+    const lines = [BEGIN];
+    for (const [k, v] of Object.entries(vals)) {
+        if (v !== null && v !== '')
+            lines.push(`export ${k}=${shQuote(v)}`);
+    }
+    lines.push(END);
+    return lines.join('\n');
+}
+const BLOCK_RE = /# >>> xx >>>[\s\S]*?# <<< xx <<</;
+/** 把 marker 块写进/替换进指定 rc 文件（纯 fs，可测）。返回写入的文件路径。 */
+export function writeMarkerBlock(file, vals) {
+    const block = buildBlock(vals);
+    let text = existsSync(file) ? readFileSync(file, 'utf-8') : '';
+    if (BLOCK_RE.test(text)) {
+        text = text.replace(BLOCK_RE, block);
+    }
+    else {
+        const sep = text === '' || text.endsWith('\n') ? '' : '\n';
+        text = `${text}${sep}${text === '' ? '' : '\n'}${block}\n`;
+    }
+    const dir = dirname(file);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(file, text, 'utf-8');
+    return file;
+}
+/** 据 $SHELL basename + 平台选 rc 文件。 */
+export function rcTargetFor(shellPath, platform, home) {
+    // 这些是 Unix-destined 路径，用 posix join 保证宿主无关（生产仅在 Unix 上运行）。
+    const base = (shellPath ?? '').split('/').pop() ?? '';
+    if (base === 'zsh')
+        return { file: posixJoin(home, '.zshrc'), kind: 'zsh' };
+    if (base === 'fish')
+        return { file: posixJoin(home, '.config', 'fish', 'config.fish'), kind: 'fish' };
+    if (base === 'bash') {
+        // macOS 登录 shell 读 .bash_profile；Linux 交互非登录读 .bashrc。
+        return { file: posixJoin(home, platform === 'darwin' ? '.bash_profile' : '.bashrc'), kind: 'bash' };
+    }
+    return { file: posixJoin(home, '.profile'), kind: 'sh' };
+}
+/** 设为默认的 Unix 实现：选 rc 文件并重写 marker 块（fish 跳过）。 */
+export function persistUnix(vals) {
+    const target = rcTargetFor(process.env.SHELL, process.platform, homedir());
+    if (target.kind === 'fish')
+        return { kind: 'fish', unsupported: true, file: target.file };
+    writeMarkerBlock(target.file, vals);
+    return { kind: target.kind, file: target.file };
+}

package/dist/env/persist-windows.js

@@ -0,0 +1,49 @@
+/**
+ * Windows 持久化：直写 HKCU\Environment + 单次 WM_SETTINGCHANGE 广播。
+ *
+ * 评审③：钉 `powershell.exe`（5.1，Windows 必然存在），不用 `pwsh`（7+，可能没装）。
+ * 逻辑搬自现版 Set-UserEnv-Fast + Invoke-EnvBroadcast：注册表瞬时写入、最后只广播一次（100ms 短超时、
+ * SMTO_ABORTIFHUNG 跳过挂死窗口），避免「逐个 setx 广播 7 次、每窗口等 1s」的拖慢。
+ *
+ * 键值通过环境变量传 JSON 给子进程、用 ConvertFrom-Json 解析 —— 彻底避开命令行注入/引号转义。
+ */
+import { spawnSync } from 'node:child_process';
+const PS_SCRIPT = String.raw `
+$ErrorActionPreference = 'Stop'
+$m = $env:CCX_ENV_PAYLOAD | ConvertFrom-Json
+$reg = 'HKCU:\Environment'
+foreach ($p in $m.PSObject.Properties) {
+  if ($null -eq $p.Value -or $p.Value -eq '') {
+    Remove-ItemProperty -Path $reg -Name $p.Name -ErrorAction SilentlyContinue
+  } else {
+    Set-ItemProperty -Path $reg -Name $p.Name -Value $p.Value -Type String
+  }
+}
+$sig = @'
+using System;
+using System.Runtime.InteropServices;
+public static class CcxNative {
+  [DllImport("user32.dll", SetLastError=true, CharSet=CharSet.Unicode)]
+  static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);
+  public static void Notify() {
+    UIntPtr r;
+    SendMessageTimeout((IntPtr)0xffff, 0x001A, UIntPtr.Zero, "Environment", 0x0002, 100, out r);
+  }
+}
+'@
+Add-Type -TypeDefinition $sig
+[CcxNative]::Notify()
+`;
+/** 把一组受管键写进/删出 HKCU\Environment，并广播一次环境变更。 */
+export function persistWindows(vals) {
+    const res = spawnSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', PS_SCRIPT], {
+        env: { ...process.env, CCX_ENV_PAYLOAD: JSON.stringify(vals) },
+        stdio: ['ignore', 'ignore', 'pipe'],
+        windowsHide: true,
+    });
+    if (res.error)
+        return { ok: false, error: res.error.message };
+    if (res.status !== 0)
+        return { ok: false, error: (res.stderr?.toString() || '').trim() || `exit ${res.status}` };
+    return { ok: true };
+}

package/dist/env/session.js

@@ -0,0 +1,44 @@
+/**
+ * 本次启用（Session-Launch）—— 进程级、阅后即焚。
+ *
+ * 1) 对 7 个受管键：有值 set，没值 delete（只动这 7 个）。
+ * 2) 找到 claude（which；Windows 上是 claude.cmd，评审②）。
+ * 3) spawn 且 stdio:inherit —— 子进程继承真实控制台句柄，天然没有现版 PowerShell 的
+ *    「stdin 被包成管道 → claude 误判非交互」问题。
+ * 4) Windows 不能直接 spawn .cmd（Node 的 EINVAL 防护），用 shell:true 经 cmd.exe 启动并对路径加引号。
+ */
+import { spawnSync } from 'node:child_process';
+import which from 'which';
+import { KNOWN_KEYS, getProviderEnvMap } from '../config/store.js';
+/** 把目标配置的受管环境变量套到当前进程（有值 set、没值 delete，只动这 7 个）。 */
+export function applyManagedEnv(p) {
+    const map = getProviderEnvMap(p);
+    for (const key of KNOWN_KEYS) {
+        const v = map[key];
+        if (typeof v === 'string' && v.trim() !== '')
+            process.env[key] = v;
+        else
+            delete process.env[key];
+    }
+}
+/** 在 PATH 中定位 claude；找不到返回 null。Windows 下通常解析到 claude.cmd。 */
+export function resolveClaude() {
+    return which.sync('claude', { nothrow: true });
+}
+/**
+ * 套环境 + 启动 claude，阻塞直到其退出。调用方负责在前后打印 banner / 处理 claudeMissing。
+ * @param claudePath 可注入（测试用）；缺省走 resolveClaude()。
+ */
+export function sessionLaunch(p, claudePath) {
+    applyManagedEnv(p);
+    const bin = claudePath ?? resolveClaude();
+    if (!bin)
+        return { claudeMissing: true, status: null };
+    const isWin = process.platform === 'win32';
+    // Windows：经 cmd.exe 启动以兼容 .cmd 包装，路径加引号防空格；Unix：直接 exec 解析后的真实路径。
+    const file = isWin ? `"${bin}"` : bin;
+    const res = spawnSync(file, [], { stdio: 'inherit', shell: isWin });
+    if (res.error)
+        return { spawnError: res.error, status: null };
+    return { status: res.status };
+}

package/dist/i18n/index.js

@@ -0,0 +1,53 @@
+/**
+ * i18n 运行时：T() 翻译、当前语言、语言解析、供应商显示名。
+ *
+ * 语言来源优先级（plan §5）：
+ *   --lang 参数 > providers.json 的 lang 字段 > 环境 LC_ALL/LANG/LANGUAGE > 默认 zh。
+ */
+import { isOfficial } from '../config/store.js';
+import { messages } from './messages.js';
+let current = 'zh';
+/** 设置本次进程的界面语言（启动时按 resolveLang 的结果调用一次）。 */
+export function setLang(lang) {
+    current = lang;
+}
+export function getLang() {
+    return current;
+}
+/**
+ * 翻译：查目录取当前语言文案，按序替换 `{0}` `{1}` …。
+ * 缺 key 时返回 key 本身（便于一眼发现漏翻），缺当前语言时回退 zh。
+ */
+export function T(key, ...args) {
+    const m = messages[key];
+    if (!m)
+        return key;
+    let s = m[current] || m.zh || key;
+    args.forEach((a, i) => {
+        s = s.split(`{${i}}`).join(String(a));
+    });
+    return s;
+}
+/**
+ * 解析本次界面语言。`explicit` 来自 --lang，`storeLang` 来自 providers.json。
+ * 环境变量：含 `zh` → 中文；以 `en` 开头（如 en_US）→ 英文；其余默认 zh。
+ */
+export function resolveLang(explicit, storeLang) {
+    if (explicit)
+        return explicit;
+    if (storeLang)
+        return storeLang;
+    const env = (process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || '').toLowerCase();
+    if (env.includes('zh'))
+        return 'zh';
+    if (env.startsWith('en'))
+        return 'en';
+    return 'zh';
+}
+/**
+ * 配置的显示名：官方档显示翻译后的「官方/Official」（评审①：显示名与数据主键 `name` 解耦）；
+ * 其余是专有名词，原样显示 `name`。
+ */
+export function providerDisplayName(p) {
+    return isOfficial(p) ? T('provider.official') : p.name;
+}

package/dist/i18n/messages.js

@@ -0,0 +1,143 @@
+export const messages = {
+    // —— CLI ——
+    'cli.desc': {
+        zh: 'Claude Code API 切换器：在官方账号与第三方 Anthropic 兼容 API 间切换。',
+        en: 'Claude Code API switcher: switch between the official account and third-party Anthropic-compatible APIs.',
+    },
+    'cli.arg.name': { zh: '目标配置名；省略则打开交互菜单', en: 'target profile name; omit to open the menu' },
+    'cli.opt.session': {
+        zh: '本次启用：仅当前终端设环境变量并启动 claude（阅后即焚）',
+        en: 'session: set env for this terminal only and launch claude',
+    },
+    'cli.opt.list': { zh: '列出所有配置及状态', en: 'list all profiles and their state' },
+    'cli.opt.storeDir': { zh: '覆盖配置存储目录（测试用，默认 ~/.cc-mini）', en: 'override store dir (testing; default ~/.cc-mini)' },
+    'cli.opt.defaultScope': {
+        zh: '设为默认写到哪：user(持久) / process(不落盘 dry-run，测试用)',
+        en: 'set-default scope: user (persist) / process (dry-run, testing)',
+    },
+    'cli.opt.lang': { zh: '本次界面语言：zh / en', en: 'UI language for this run: zh / en' },
+    'cli.opt.version': { zh: '显示版本号', en: 'show version' },
+    'cli.opt.help': { zh: '显示帮助', en: 'show help' },
+    // —— 列表 / 状态 ——
+    'list.default': { zh: '默认配置：{0}', en: 'Default: {0}' },
+    'state.login': { zh: '登录态', en: 'Logged in' },
+    'state.noKey': { zh: '密钥未填', en: 'No key' },
+    'state.apiKey': { zh: '密钥·API_KEY', en: 'Key · API_KEY' },
+    'state.hasKey': { zh: '密钥已设', en: 'Key set' },
+    // —— 供应商显示名（仅官方这种普通名词需要翻译；DeepSeek/GLM/MiMo 是专有名词不翻）——
+    'provider.official': { zh: '官方', en: 'Official' },
+    // —— 菜单通用 ——
+    'menu.prompt': { zh: '输入序号 (q 取消): ', en: 'Enter number (q to cancel): ' },
+    'menu.mainTitle': {
+        zh: 'cc-x v{0} · Claude Code API 切换器     （默认 = 新终端裸敲 claude 用的）',
+        en: 'cc-x v{0} · Claude Code API switcher     (default = used by bare `claude` in new terminals)',
+    },
+    'menu.mainHint': {
+        zh: '↑↓ 选择 · Enter 进入 · Shift+↑↓（或 PgUp/PgDn）排序 · q 退出',
+        en: '↑↓ move · Enter open · Shift+↑↓ (or PgUp/PgDn) reorder · q quit',
+    },
+    'menu.newProfile': { zh: '＋ 新增配置', en: '+ New profile' },
+    'menu.exit': { zh: '退出', en: 'Exit' },
+    'menu.default': { zh: '（默认）', en: '(default)' },
+    'menu.comingSoon': { zh: '（该功能下一步实现）', en: '(coming in the next step)' },
+    // —— 动作菜单 ——
+    'action.titlePrefix': { zh: '配置：', en: 'Profile: ' },
+    'action.session': {
+        zh: '本次启用    — 仅当前终端，立即启动 Claude（并行多终端推荐）',
+        en: 'Session    — this terminal only, launches Claude now (great for parallel terminals)',
+    },
+    'action.setDefault': {
+        zh: '设为默认    — 新终端裸敲 claude 默认用它（不影响运行中会话）',
+        en: 'Set default — used by bare claude in new terminals (running sessions unaffected)',
+    },
+    'action.edit': { zh: '编辑', en: 'Edit' },
+    'action.delete': { zh: '删除', en: 'Delete' },
+    'action.back': { zh: '返回', en: 'Back' },
+    'action.hint': { zh: '↑↓ 选择 · Enter 确认 · q 返回', en: '↑↓ move · Enter select · q back' },
+    'action.deleteConfirm': { zh: '确认删除 [{0}]? (y/N): ', en: 'Delete [{0}]? (y/N): ' },
+    'action.deleteOfficialWarn': { zh: '建议保留『官方』。', en: 'Keeping "Official" is recommended.' },
+    'menu.language': { zh: '🌐 切换到 English', en: '🌐 切换到中文' },
+    // —— 通用占位 ——
+    'empty.paren': { zh: '(空)', en: '(empty)' },
+    // —— 编辑表单 ——
+    'edit.title': { zh: '编辑配置 （↑↓ 选要改的项，Enter 进入；↓到底可选保存/放弃）', en: 'Edit profile (↑↓ pick a field, Enter to edit; save/discard at bottom)' },
+    'edit.hint': {
+        zh: '供应商：选后自动填地址/模型 · 备注随便写 · 回车=不改 · 输入 - =清空',
+        en: 'Provider: auto-fills url/models · Enter=keep · type "-" to clear',
+    },
+    'edit.current': { zh: '当前：{0}', en: 'current: {0}' },
+    'edit.inputHint': { zh: '回车=不改，输入=替换，- =清空', en: 'Enter=keep, type=replace, "-"=clear' },
+    'edit.field.provider': { zh: '供应商        ', en: 'Provider      ' },
+    'edit.field.note': { zh: '备注          ', en: 'Note          ' },
+    'edit.field.base': { zh: 'API 地址      ', en: 'API URL       ' },
+    'edit.field.auth': { zh: '认证字段      ', en: 'Auth field    ' },
+    'edit.field.key': { zh: 'API 密钥      ', en: 'API key       ' },
+    'edit.field.opus': { zh: 'opus  → 模型  ', en: 'opus  → model ' },
+    'edit.field.sonnet': { zh: 'sonnet→ 模型  ', en: 'sonnet→ model ' },
+    'edit.field.haiku': { zh: 'haiku → 模型  ', en: 'haiku → model ' },
+    'edit.field.effort': { zh: 'effort 思考档 ', en: 'effort level  ' },
+    'edit.toggleSecretShow': { zh: '👁  显示密钥明文（当前隐藏）', en: '👁  Show key in plaintext (now hidden)' },
+    'edit.toggleSecretHide': { zh: '🙈 隐藏密钥（当前明文）', en: '🙈 Hide key (now shown)' },
+    'edit.save': { zh: '保存并返回', en: 'Save & back' },
+    'edit.discard': { zh: '放弃修改', en: 'Discard' },
+    'edit.nameEmpty': { zh: '还没选供应商（或自定义名称），未保存。', en: 'No provider/name chosen yet; not saved.' },
+    'edit.customName': { zh: '自定义供应商名称（回车=不改）: ', en: 'Custom provider name (Enter=keep): ' },
+    'edit.noteInput': { zh: '备注（回车=不改，- =清空）: ', en: 'Note (Enter=keep, "-" clear): ' },
+    // —— Picker ——
+    'pick.hint': { zh: '↑↓ 选择 · Enter 确认 · q 不改', en: '↑↓ move · Enter select · q keep' },
+    'pick.noChange': { zh: '不修改', en: '(no change)' },
+    'pick.manual': { zh: '手动输入…', en: 'Enter manually…' },
+    'pick.provider.title': { zh: '供应商（当前：{0}）', en: 'Provider (current: {0})' },
+    'pick.provider.none': { zh: '(未选)', en: '(none)' },
+    'pick.provider.custom': { zh: '自定义（手动填名字）', en: 'Custom (type a name)' },
+    'pick.providerUrl.title': { zh: '{0} 有多个 API 地址，选一个', en: '{0} has multiple URLs, pick one' },
+    'pick.base.title': { zh: 'API 地址（当前：{0}）', en: 'API URL (current: {0})' },
+    'pick.base.existing': { zh: '(已有:{0})', en: '(used:{0})' },
+    'pick.base.manualInput': { zh: '手动输入 API 地址（回车=不改，- =清空）: ', en: 'Type API URL (Enter=keep, "-" clear): ' },
+    'pick.auth.title': { zh: '认证字段（当前：{0}）', en: 'Auth field (current: {0})' },
+    'pick.auth.token': { zh: 'AUTH_TOKEN  （Bearer，多数第三方中转）', en: 'AUTH_TOKEN  (Bearer, most 3rd-party relays)' },
+    'pick.auth.apikey': { zh: 'API_KEY  （x-api-key，官方/少数）', en: 'API_KEY  (x-api-key, official/few)' },
+    'pick.effort.title': { zh: 'effort 思考档（当前：{0}）', en: 'effort level (current: {0})' },
+    'pick.effort.empty': { zh: '留空（不设）', en: 'Leave empty' },
+    'pick.effort.hint': { zh: '越往后越深入；auto=模型默认 · q 不改', en: 'deeper to the right; auto=model default · q keep' },
+    // —— 错误 ——
+    'error.notFound': { zh: '找不到配置：{0}', en: 'Profile not found: {0}' },
+    'error.existing': { zh: '现有：{0}', en: 'Existing: {0}' },
+    'error.storeRead': { zh: '配置文件读取失败：{0}', en: 'Failed to read config file: {0}' },
+    'error.storeCorrupt': { zh: '配置文件解析失败（JSON 语法错误）：{0}', en: 'Failed to parse config file (invalid JSON): {0}' },
+    'error.storeFormat': { zh: '配置文件结构不正确（顶层须为对象、providers 须为数组且条目结构合法）：{0}', en: 'Config file has invalid structure (top-level must be an object, providers must be an array with valid profile entries): {0}' },
+    'error.storeCorruptHint': {
+        zh: '为避免误删，未对它做任何改动。请修复后重试；或删除该文件以重新生成默认配置（会丢失已填的密钥）。',
+        en: 'Left untouched to avoid data loss. Fix it and retry; or delete the file to regenerate defaults (loses any saved keys).',
+    },
+    // —— 本次启用（session）——
+    'session.noKey': { zh: '⚠ 配置 [{0}] 还没填密钥。', en: '⚠ Profile [{0}] has no key set.' },
+    'session.launch': {
+        zh: '▶ 本次启用：{0}（仅当前终端，不影响其它终端）',
+        en: '▶ Session: {0} (this terminal only; others unaffected)',
+    },
+    'session.starting': {
+        zh: '正在启动 Claude…（退出 Claude 后回到命令行）',
+        en: 'Launching Claude… (returns here after Claude exits)',
+    },
+    'session.noClaude': { zh: '未找到 claude 命令，请确认它在 PATH 中。', en: 'claude not found on PATH.' },
+    // —— 设为默认（default）——
+    'default.writing': { zh: '正在写入用户环境变量…', en: 'Writing user environment variables…' },
+    'default.done': {
+        zh: '✓ 已设为默认：{0}  ·  新开终端裸敲 claude 生效（不影响运行中会话）',
+        en: '✓ Default set: {0}  ·  effective in newly opened terminals (running sessions unaffected)',
+    },
+    'default.dryRun': {
+        zh: '（dry-run：--default-scope process，未改系统，仅更新存储）',
+        en: '(dry-run: --default-scope process; system untouched, store only)',
+    },
+    'default.unixWrote': {
+        zh: '已写入 {0}（新开终端生效；或 source 它立即生效）',
+        en: 'Wrote {0} (effective in new terminals; or source it now)',
+    },
+    'default.failed': { zh: '设为默认失败：{0}', en: 'Failed to set default: {0}' },
+    'default.fishUnsupported': {
+        zh: '⚠ 检测到 fish：v1 暂不支持「设为默认」，请手动设置或改用「本次启用」。',
+        en: '⚠ fish detected: "set default" is unsupported in v1; set manually or use session launch.',
+    },
+};