@cc-x/cc-x 0.3.0

package/dist/index.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * cc-x —— Claude Code API 切换器（命令：xx）
+ *
+ * 入口：解析 CLI 参数 → 分派到 CLI 路径（--list / xx <name> / -s）或交互菜单（TUI）。
+ *
+ * 铁律：绝不写 Claude Code 配置文件；API 切换只动 7 个受管环境变量。详见 CLAUDE.md / plan §2。
+ */
+import { createRequire } from 'node:module';
+import { Command, Option } from 'commander';
+import { launchSession, warnIfNoKey } from './actions.js';
+import { loadStore, peekStoreLang, resolveStorePaths, StoreError } from './config/store.js';
+import { loadPresets } from './config/presets.js';
+import { setDefault } from './env/default.js';
+import { providerDisplayName, resolveLang, setLang, T } from './i18n/index.js';
+import { noteSuffix, stateLabel } from './ui/format.js';
+import { openMenu } from './ui/menus.js';
+import { padDisplay } from './utils/display.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+/** 从 argv 里轻量预读一个带值参数（`--name v` 或 `--name=v`），用于 parse 前定语言。 */
+function peekArg(argv, name) {
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === name)
+            return argv[i + 1];
+        if (a && a.startsWith(`${name}=`))
+            return a.slice(name.length + 1);
+    }
+    return undefined;
+}
+function main() {
+    // help/version 在 commander parse 时就打印，故须**在建命令前**定好语言：
+    // --lang > providers.json 的 lang（只读探测，不生成文件）> 环境 > 默认 zh。
+    const argv = process.argv;
+    const earlyLang = peekArg(argv, '--lang');
+    const lang = earlyLang === 'en' ? 'en' : earlyLang === 'zh' ? 'zh' : undefined;
+    const storeLang = peekStoreLang(resolveStorePaths(peekArg(argv, '--store-dir')));
+    setLang(resolveLang(lang, storeLang));
+    const program = new Command();
+    program
+        .name('xx')
+        .description(T('cli.desc'))
+        .helpOption('-h, --help', T('cli.opt.help'))
+        .version(pkg.version, '-v, --version', T('cli.opt.version'))
+        .argument('[name]', T('cli.arg.name'))
+        .option('-s, --session', T('cli.opt.session'))
+        .option('-l, --list', T('cli.opt.list'))
+        .option('--store-dir <dir>', T('cli.opt.storeDir'))
+        .addOption(
+    // [P1] 严格校验：拼错（如 proces）直接报错退出，不静默回退到危险的持久化路径。
+    new Option('--default-scope <scope>', T('cli.opt.defaultScope')).choices(['user', 'process']).default('user'))
+        .addOption(new Option('--lang <lang>', T('cli.opt.lang')).choices(['zh', 'en']))
+        .action(async (name, raw) => {
+        await dispatch(name, normalizeOpts(raw));
+    });
+    void program.parseAsync();
+}
+function normalizeOpts(raw) {
+    const scope = raw.defaultScope === 'process' ? 'process' : 'user';
+    const lang = raw.lang === 'en' ? 'en' : raw.lang === 'zh' ? 'zh' : undefined;
+    return { ...raw, defaultScope: scope, lang };
+}
+/** 按参数把请求分派到对应路径。 */
+async function dispatch(name, opts) {
+    const paths = resolveStorePaths(opts.storeDir);
+    let store;
+    try {
+        store = loadStore(paths);
+    }
+    catch (e) {
+        if (e instanceof StoreError) {
+            // store 不可用，按 --lang/环境定语言（拿不到 store.lang）。绝不重建、不动用户数据。
+            setLang(resolveLang(opts.lang));
+            const head = e.kind === 'read' ? 'error.storeRead' : e.kind === 'format' ? 'error.storeFormat' : 'error.storeCorrupt';
+            console.error(`  ${T(head, e.file)}`);
+            console.error(`  ${T('error.storeCorruptHint')}`);
+            process.exitCode = 1;
+            return;
+        }
+        throw e;
+    }
+    // 语言：--lang > providers.json lang > 环境 > 默认 zh。在产出任何文案前先定好。
+    setLang(resolveLang(opts.lang, store.lang));
+    if (opts.list) {
+        runList(store);
+        return;
+    }
+    if (name) {
+        const target = store.providers.find((p) => p.name === name);
+        if (!target) {
+            console.error(`  ${T('error.notFound', name)}`);
+            console.error(`  ${T('error.existing', store.providers.map((p) => p.name).join(', '))}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.session)
+            launchSession(target);
+        else
+            runDefault(paths, store, target, opts.defaultScope);
+        return;
+    }
+    await openMenu(paths, store, opts.defaultScope, pkg.version, loadPresets(opts.storeDir));
+}
+/** `--list`：列出所有配置及状态。官方档显示名走 i18n（评审①），其余原样。 */
+function runList(store) {
+    const cur = store.providers.find((p) => p.name === store.current);
+    console.log('');
+    console.log(`  ${T('list.default', cur ? providerDisplayName(cur) : store.current)}`);
+    for (const p of store.providers) {
+        const mark = p.name === store.current ? '▶' : ' ';
+        console.log(`   ${mark} ${padDisplay(providerDisplayName(p), 18)}[${stateLabel(p)}]${noteSuffix(p)}`);
+    }
+    console.log('');
+}
+/** 设为默认：写用户环境变量（或 dry-run）+ 更新 store.current。 */
+function runDefault(paths, store, p, scope) {
+    warnIfNoKey(p);
+    const name = providerDisplayName(p);
+    const r = setDefault(paths, store, p, scope);
+    if (r.dryRun) {
+        console.log(`  ${T('default.done', name)}`);
+        console.log(`  ${T('default.dryRun')}`);
+        return;
+    }
+    if (r.windows && !r.windows.ok) {
+        console.error(`  ${T('default.failed', r.windows.error ?? '')}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (r.unix?.unsupported) {
+        console.error(`  ${T('default.fishUnsupported')}`);
+        return;
+    }
+    console.log(`  ${T('default.done', name)}`);
+    if (r.unix)
+        console.log(`  ${T('default.unixWrote', r.unix.file)}`);
+}
+main();

package/dist/ui/edit.js

@@ -0,0 +1,149 @@
+/**
+ * 三级 · 编辑表单（对齐现版 Edit-Form）：一屏显示全部字段，选序号改单项。
+ *
+ * 新需求（plan §7）：密钥行默认掩码 `********`，提供「👁 显示/隐藏密钥明文」开关——
+ * 仅影响本表单的**显示**，不改数据、不持久化；默认隐藏防肩窥。输入态（readValue secret）另算。
+ */
+import { buildProviderEnv, getProviderEnvMap, reconcileBuiltin, resolveUniqueName, } from '../config/store.js';
+import { T } from '../i18n/index.js';
+import { pickAuth, pickBaseUrl, pickEffort, pickProvider, pickProviderUrl } from './pickers.js';
+import { selectMenu } from './select.js';
+import { readText, readValue } from './text.js';
+function fromProvider(p) {
+    const m = getProviderEnvMap(p);
+    const usesApiKey = Boolean(m.ANTHROPIC_API_KEY && m.ANTHROPIC_API_KEY.trim());
+    return {
+        name: p.name,
+        note: p.note ?? '',
+        base: m.ANTHROPIC_BASE_URL ?? '',
+        auth: usesApiKey ? 'API_KEY' : 'AUTH_TOKEN',
+        token: (usesApiKey ? m.ANTHROPIC_API_KEY : m.ANTHROPIC_AUTH_TOKEN) ?? '',
+        opus: m.ANTHROPIC_DEFAULT_OPUS_MODEL ?? '',
+        sonnet: m.ANTHROPIC_DEFAULT_SONNET_MODEL ?? '',
+        haiku: m.ANTHROPIC_DEFAULT_HAIKU_MODEL ?? '',
+        effort: m.CLAUDE_CODE_EFFORT_LEVEL ?? '',
+    };
+}
+/** 编辑 `prov`（就地修改）；保存返回 true，放弃返回 false。 */
+export async function editForm(prov, store, catalog) {
+    const W = fromProvider(prov);
+    let showSecret = false;
+    let start = 0;
+    for (;;) {
+        const v = (x) => (x === '' ? T('empty.paren') : x);
+        const keyDisp = W.token === '' ? T('empty.paren') : showSecret ? W.token : '********';
+        const rows = [
+            { action: 'provider', label: `${T('edit.field.provider')}: ${v(W.name)}` },
+            { action: 'note', label: `${T('edit.field.note')}: ${v(W.note)}` },
+            { action: 'base', label: `${T('edit.field.base')}: ${v(W.base)}` },
+            { action: 'auth', label: `${T('edit.field.auth')}: ${W.auth}` },
+            { action: 'key', label: `${T('edit.field.key')}: ${keyDisp}` },
+            { action: 'opus', label: `${T('edit.field.opus')}: ${v(W.opus)}` },
+            { action: 'sonnet', label: `${T('edit.field.sonnet')}: ${v(W.sonnet)}` },
+            { action: 'haiku', label: `${T('edit.field.haiku')}: ${v(W.haiku)}` },
+            { action: 'effort', label: `${T('edit.field.effort')}: ${v(W.effort)}` },
+            { action: 'toggle', label: showSecret ? T('edit.toggleSecretHide') : T('edit.toggleSecretShow') },
+            { action: 'sep', label: '' },
+            { action: 'save', label: T('edit.save') },
+            { action: 'discard', label: T('edit.discard') },
+        ];
+        const sel = await selectMenu({ title: T('edit.title'), items: rows.map((r) => r.label), start, hint: T('edit.hint') });
+        if (sel < 0)
+            return false; // Esc / q = 放弃
+        start = sel;
+        switch (rows[sel]?.action) {
+            case 'provider': {
+                const pp = await pickProvider(catalog, W.name);
+                if (pp === 'custom') {
+                    const name = await readText(`  ${T('edit.customName')}`);
+                    if (name && name.trim())
+                        W.name = name.trim();
+                }
+                else if (pp) {
+                    W.name = pp.name;
+                    W.auth = pp.auth;
+                    W.base = await pickProviderUrl(pp, W.base);
+                    if (pp.models.opus)
+                        W.opus = pp.models.opus;
+                    if (pp.models.sonnet)
+                        W.sonnet = pp.models.sonnet;
+                    if (pp.models.haiku)
+                        W.haiku = pp.models.haiku;
+                    if (pp.effort)
+                        W.effort = pp.effort;
+                }
+                break;
+            }
+            case 'note': {
+                const note = await readText(`  ${T('edit.noteInput')}`);
+                if (note === '-')
+                    W.note = '';
+                else if (note && note.trim())
+                    W.note = note.trim();
+                break;
+            }
+            case 'base':
+                W.base = await pickBaseUrl(W.base, store, catalog);
+                break;
+            case 'auth':
+                W.auth = await pickAuth(W.auth);
+                break;
+            case 'key': {
+                const r = await readValue(T('edit.field.key').trim(), W.token, true);
+                if (r.changed)
+                    W.token = r.value;
+                break;
+            }
+            case 'opus': {
+                const r = await readValue(T('edit.field.opus').trim(), W.opus);
+                if (r.changed)
+                    W.opus = r.value;
+                break;
+            }
+            case 'sonnet': {
+                const r = await readValue(T('edit.field.sonnet').trim(), W.sonnet);
+                if (r.changed)
+                    W.sonnet = r.value;
+                break;
+            }
+            case 'haiku': {
+                const r = await readValue(T('edit.field.haiku').trim(), W.haiku);
+                if (r.changed)
+                    W.haiku = r.value;
+                break;
+            }
+            case 'effort':
+                W.effort = await pickEffort(W.effort);
+                break;
+            case 'toggle':
+                showSecret = !showSecret; // 仅切换显示，不改数据、不持久化
+                break;
+            case 'save': {
+                if (W.name.trim() === '') {
+                    console.log(`  ${T('edit.nameEmpty')}`);
+                    break;
+                }
+                const fields = {
+                    ANTHROPIC_BASE_URL: W.base,
+                    ANTHROPIC_DEFAULT_OPUS_MODEL: W.opus,
+                    ANTHROPIC_DEFAULT_SONNET_MODEL: W.sonnet,
+                    ANTHROPIC_DEFAULT_HAIKU_MODEL: W.haiku,
+                    CLAUDE_CODE_EFFORT_LEVEL: W.effort,
+                };
+                if (W.auth === 'API_KEY')
+                    fields.ANTHROPIC_API_KEY = W.token;
+                else
+                    fields.ANTHROPIC_AUTH_TOKEN = W.token;
+                prov.name = resolveUniqueName(store, W.name.trim(), prov);
+                prov.env = buildProviderEnv(fields);
+                prov.note = W.note;
+                reconcileBuiltin(prov); // [P1] 官方档被配成第三方后清掉 builtin 身份
+                return true;
+            }
+            case 'discard':
+                return false;
+            default:
+                break; // sep
+        }
+    }
+}

package/dist/ui/format.js

@@ -0,0 +1,21 @@
+/**
+ * 列表/菜单行的文案格式化（--list 与 TUI 菜单共用，避免重复）。
+ */
+import { getProviderState } from '../config/store.js';
+import { T } from '../i18n/index.js';
+/** 配置的状态文案（语义枚举 → 当前语言；effort 原样附加）。 */
+export function stateLabel(p) {
+    const s = getProviderState(p);
+    const base = s.key === 'official'
+        ? T('state.login')
+        : s.key === 'noKey'
+            ? T('state.noKey')
+            : s.key === 'apiKey'
+                ? T('state.apiKey')
+                : T('state.hasKey');
+    return s.effort ? `${base} · effort=${s.effort}` : base;
+}
+/** 备注后缀（有备注才显示）。 */
+export function noteSuffix(p) {
+    return p.note ? `  — ${p.note}` : '';
+}

package/dist/ui/menus.js

@@ -0,0 +1,133 @@
+/**
+ * 三级菜单：主菜单 ↔ 动作菜单 ↔ 编辑表单（M4）。
+ *
+ * 主菜单：列表 + 排序（Shift+↑↓/PgUp/PgDn）+ 记忆选中 + 新增 + 语言切换 + 退出。
+ * 动作菜单：本次启用 / 设为默认（绿条 toast）/ 编辑 / 删除（二次确认）/ 返回。
+ * 编辑表单见 ui/edit.ts（含密钥明文切换）。
+ */
+import { createInterface } from 'node:readline';
+import { launchSession } from '../actions.js';
+import { isOfficial, reconcileCurrent, saveStore } from '../config/store.js';
+import { setDefault } from '../env/default.js';
+import { getLang, providerDisplayName, setLang, T } from '../i18n/index.js';
+import { padDisplay } from '../utils/display.js';
+import { editForm } from './edit.js';
+import { noteSuffix, stateLabel } from './format.js';
+import { selectMenu } from './select.js';
+async function readLine(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ans = await new Promise((res) => rl.question(prompt, res));
+    rl.close();
+    return ans.trim();
+}
+/** 一级 · 主菜单。布局：[profiles…] '' 新增 语言 '' 退出。 */
+export async function openMenu(paths, store, scope, version, catalog) {
+    let sel = 0;
+    for (;;) {
+        const n = store.providers.length;
+        const buildItems = () => {
+            const labels = store.providers.map((p) => {
+                const dft = p.name === store.current ? T('menu.default') : '';
+                return `${padDisplay(providerDisplayName(p), 16)}${padDisplay(dft, 8)}[${stateLabel(p)}]${noteSuffix(p)}`;
+            });
+            return [...labels, '', T('menu.newProfile'), T('menu.language'), '', T('menu.exit')];
+        };
+        const onMove = (from, to) => {
+            const ps = store.providers;
+            const a = ps[from];
+            const b = ps[to];
+            if (a && b) {
+                ps[from] = b;
+                ps[to] = a;
+                saveStore(paths, store);
+            }
+            return buildItems();
+        };
+        sel = await selectMenu({
+            title: T('menu.mainTitle', version),
+            items: buildItems(),
+            colors: { [n + 1]: 'yellow' },
+            start: sel,
+            movableCount: n,
+            onMove,
+            hint: T('menu.mainHint'),
+        });
+        if (sel < 0 || sel === n + 4)
+            return; // 退出 / Esc / q
+        if (sel === n + 1) {
+            // 新增配置
+            const prov = { name: '', env: {} };
+            if (await editForm(prov, store, catalog)) {
+                store.providers.push(prov);
+                saveStore(paths, store);
+                sel = store.providers.length - 1; // 光标落到新配置
+            }
+        }
+        else if (sel === n + 2) {
+            // 语言切换：即时切并写回 store.lang
+            const next = getLang() === 'zh' ? 'en' : 'zh';
+            setLang(next);
+            store.lang = next;
+            saveStore(paths, store);
+        }
+        else if (sel < n) {
+            const target = store.providers[sel];
+            if (target)
+                await actionMenu(paths, store, target, scope, catalog);
+            if (sel >= store.providers.length)
+                sel = Math.max(0, store.providers.length - 1); // 删除后夹取
+        }
+    }
+}
+/** 二级 · 动作菜单（循环停留；返回/删除已确认才回一级）。 */
+async function actionMenu(paths, store, p, scope, catalog) {
+    let sel = 0;
+    let flash;
+    for (;;) {
+        const dft = p.name === store.current ? T('menu.default') : '';
+        const title = `${T('action.titlePrefix')}${providerDisplayName(p)}${dft}${noteSuffix(p)}    [${stateLabel(p)}]`;
+        const items = [T('action.session'), T('action.setDefault'), T('action.edit'), T('action.delete'), T('action.back')];
+        sel = await selectMenu({ title, items, start: sel, ...(flash ? { status: flash } : {}), hint: T('action.hint') });
+        flash = undefined;
+        if (sel === 0) {
+            launchSession(p);
+        }
+        else if (sel === 1) {
+            flash = applyDefault(paths, store, p, scope);
+        }
+        else if (sel === 2) {
+            const old = p.name;
+            if (await editForm(p, store, catalog)) {
+                if (store.current === old)
+                    store.current = p.name; // 改了名/供应商时同步默认指向
+                saveStore(paths, store);
+            }
+        }
+        else if (sel === 3) {
+            if (isOfficial(p))
+                console.log(`  ${T('action.deleteOfficialWarn')}`);
+            const ans = await readLine(`  ${T('action.deleteConfirm', providerDisplayName(p))}`);
+            if (ans === 'y' || ans === 'Y') {
+                store.providers = store.providers.filter((x) => x !== p);
+                reconcileCurrent(store);
+                saveStore(paths, store);
+                return;
+            }
+        }
+        else {
+            return; // 返回 / q / Esc
+        }
+    }
+}
+/** 设为默认并返回一行 toast 文案。 */
+function applyDefault(paths, store, p, scope) {
+    const name = providerDisplayName(p);
+    const r = setDefault(paths, store, p, scope);
+    if (r.dryRun)
+        return `${T('default.done', name)}  ${T('default.dryRun')}`;
+    if (r.windows && !r.windows.ok)
+        return T('default.failed', r.windows.error ?? '');
+    if (r.unix?.unsupported)
+        return T('default.fishUnsupported');
+    return T('default.done', name);
+}

package/dist/ui/pickers.js

@@ -0,0 +1,93 @@
+/**
+ * 编辑表单里的各 picker（供应商 / API 地址 / 认证字段 / effort），对齐现版 Pick-*。
+ */
+import { getProviderEnvMap } from '../config/store.js';
+import { T } from '../i18n/index.js';
+import { padDisplay } from '../utils/display.js';
+import { selectMenu } from './select.js';
+import { readText } from './text.js';
+/** 选供应商：从目录选一个 / 自定义手填名 / 不改。 */
+export async function pickProvider(catalog, current) {
+    const names = catalog.map((p) => p.name);
+    const items = [...names, T('pick.provider.custom'), T('pick.noChange')];
+    const sel = await selectMenu({
+        title: T('pick.provider.title', current || T('pick.provider.none')),
+        items,
+        hint: T('pick.hint'),
+    });
+    if (sel < 0 || sel === items.length - 1)
+        return null;
+    if (sel === names.length)
+        return 'custom';
+    return catalog[sel] ?? null;
+}
+/** 供应商有多个地址时让用户选一个；只有一个直接用，无地址保持原值。 */
+export async function pickProviderUrl(preset, current) {
+    const urls = preset.urls;
+    if (urls.length === 0)
+        return current;
+    if (urls.length === 1)
+        return urls[0]?.url ?? current;
+    const labels = urls.map((u) => `${padDisplay(u.label, 12)} ${u.url || T('empty.paren')}`);
+    const items = [...labels, T('pick.noChange')];
+    const sel = await selectMenu({ title: T('pick.providerUrl.title', preset.name), items, hint: T('pick.hint') });
+    if (sel < 0 || sel === items.length - 1)
+        return current;
+    return urls[sel]?.url ?? current;
+}
+/** 选 API 地址：目录所有 url + 已有配置用过的 url + 手动输入 + 不修改。 */
+export async function pickBaseUrl(current, store, catalog) {
+    const entries = [];
+    const seen = new Set();
+    for (const p of catalog) {
+        for (const u of p.urls) {
+            const tag = p.urls.length > 1 ? `${p.name}/${u.label}` : p.name;
+            entries.push({ label: `${padDisplay(tag, 20)} ${u.url || T('empty.paren')}`, url: u.url });
+            seen.add(u.url);
+        }
+    }
+    for (const prov of store.providers) {
+        const u = getProviderEnvMap(prov).ANTHROPIC_BASE_URL;
+        if (u && u.trim() && !seen.has(u)) {
+            seen.add(u);
+            entries.push({ label: `${padDisplay(T('pick.base.existing', prov.name), 20)} ${u}`, url: u });
+        }
+    }
+    const items = [...entries.map((e) => e.label), T('pick.manual'), T('pick.noChange')];
+    const sel = await selectMenu({ title: T('pick.base.title', current || T('empty.paren')), items, hint: T('pick.hint') });
+    if (sel < 0 || sel === items.length - 1)
+        return current;
+    if (sel < entries.length)
+        return entries[sel]?.url ?? current;
+    const v = await readText(`  ${T('pick.base.manualInput')}`);
+    if (v === undefined || v === '')
+        return current;
+    if (v === '-')
+        return '';
+    return v.trim();
+}
+/** 选认证字段：AUTH_TOKEN / API_KEY / 不改。 */
+export async function pickAuth(current) {
+    const items = [T('pick.auth.token'), T('pick.auth.apikey'), T('pick.noChange')];
+    const sel = await selectMenu({ title: T('pick.auth.title', current), items, hint: T('pick.hint') });
+    if (sel === 0)
+        return 'AUTH_TOKEN';
+    if (sel === 1)
+        return 'API_KEY';
+    return current;
+}
+const EFFORT_OPTS = ['low', 'medium', 'high', 'xhigh', 'max', 'auto'];
+/** 选 effort 思考档：low…auto / 留空 / 不改。 */
+export async function pickEffort(current) {
+    const items = [...EFFORT_OPTS, T('pick.effort.empty'), T('pick.noChange')];
+    const sel = await selectMenu({
+        title: T('pick.effort.title', current || T('empty.paren')),
+        items,
+        hint: T('pick.effort.hint'),
+    });
+    if (sel < 0 || sel === items.length - 1)
+        return current;
+    if (sel === EFFORT_OPTS.length)
+        return '';
+    return EFFORT_OPTS[sel] ?? current;
+}