@wayfarer35/ccs 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 evan
+
+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,94 @@
+# ccs — Claude Code Switch
+
+支持 [Claude Code](https://docs.claude.com/en/docs/claude-code) 可以使用不同的配置
+
+ccs 将供应商配置单独存储，启动把「供应商配置」通过 `claude --settings`  添加到启动参数。由 claude 会将 `~/.claude/settings.json` 与供应商配置进行合并（`--settings` 优先级最高，同 key 覆盖下层）。
+
+> Bilingual: ccs 自动感知系统语言（中文/English），可用 `ccs config locale en|zh-CN` 手动设置。未设置时按 `LANG`/`LC_ALL` 自动判断，识别不到则回退English。
+
+## 为什么需要
+
+Claude Code 的供应商接入全靠 `env`（`ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_MODEL` / 各档位别名）。多供应商时只能手动改来改去，没法同时维护几套。`ccs` 把供应商配置拆成独立文件，按需启动；**通用配置直接复用 `~/.claude/settings.json`**，不重复维护 hooks/statusLine/theme 等。
+
+## 安装
+
+```bash
+npm install -g @wayfarer35/ccs
+```
+
+安装后即可使用 `ccs` 命令：
+
+```bash
+ccs --help
+```
+
+## 配置存放
+
+```
+~/.ccs/
+  providers/
+    deepseek-api.settings.json      供应商配置（env: BASE_URL/AUTH_TOKEN/MODEL/别名 + model）
+    myprov.settings.json
+  config.json                       ccs 自身设置（如语言 locale）
+  presets.json                      自定义/覆盖预设（可选）
+  .lastused                         记录上次选择（仅用于交互高亮）
+```
+
+每个 provider 文件都是标准的 Claude Code settings 片段。启动时 ccs 直接执行 `claude --settings ~/.ccs/providers/<name>.settings.json`。
+
+## 用法
+
+```bash
+ccs                      # 交互选择 供应商 / default / create 并启动（有配置时另含 edit / remove）
+ccs use                  # 同上：交互选择并启动
+ccs provider-name        # 直接用 供应商配置名称
+ccs provider-name --print "hi"   # 透传参数给 claude
+ccs provider-name --dry-run      # 打印片段与命令，不启动
+ccs list                 # 列出供应商
+ccs presets              # 列出可用预设
+ccs create               # 引导式创建（先选 内置/自定义，再填 Key）
+ccs create myprov        # 直接以自定义名称创建
+ccs edit provider-name    # 引导式编辑（预填当前值，回车保留）
+ccs edit provider-name --raw    # 用编辑器改原始 JSON
+ccs remove provider-name  # 删除
+ccs common               # 在编辑器中打开 ~/.claude/settings.json
+ccs show provider-name   # 查看供应商片段（密钥已遮蔽）
+ccs config locale zh-CN  # 设置语言（en | zh-CN）
+ccs -h                   # 帮助
+```
+
+
+### 自定义预设
+
+在 `~/.ccs/presets.json` 中按相同结构写入，可覆盖内置预设或新增：
+
+```json
+{
+  "myprov": {
+    "label": "我的供应商",
+    "baseUrl": "https://my.example.com/anthropic",
+    "model": "my-model",
+    "models": { "haiku": "my-fast", "sonnet": "my-model", "opus": "my-model", "fable": "my-model" },
+    "options": {
+      "attributionHeader": false,
+      "disableNonEssentialTraffic": true,
+      "autoCompactWindow": 200000
+    }
+  }
+}
+```
+
+- `model`：默认模型（`ANTHROPIC_MODEL`）。
+- `models`：各档位别名映射（`haiku/sonnet/opus/fable`，小写）。没有 `models` 的预设按「只预填 Base URL」处理，模型由用户填写。
+- `options`：可选，预填四项 `CLAUDE_CODE_*` 配置；省略时用默认值。
+
+## 环境变量
+
+- `CCS_CLAUDE_BIN`：指定 `claude` 路径（默认 `claude`）。
+- `EDITOR` / `VISUAL`：`--raw` 与 `ccs common` 使用的编辑器（默认 `vi`）。
+- `LANG` / `LC_ALL`：未通过 `ccs config locale` 设置语言时，据此自动感知。
+
+
+## 许可
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import type { SpawnSyncReturns } from 'node:child_process';
+export { main, cmdCreate, cmdEdit, cmdRemove, cmdCommon, cmdShow, cmdConfig, cmdConfigLocale, cmdList, cmdPresets, cmdUse, cmdLaunch, printHelp, validateName, nameValidator, };
+declare function main(): Promise<void>;
+declare function cmdLaunch(name: string, rest: string[]): void;
+declare function cmdUse(rest: string[]): Promise<void>;
+declare function cmdList(): void;
+declare function cmdPresets(): void;
+declare function validateName(name: string): void;
+/**
+ * 配置名校验器（供 inkText 的 validate 内联使用）。
+ * 检查非空、非法字符、重名——重名即时提示，引导用户改名而非直接失败。
+ * 返回错误消息字符串，或 undefined 表示通过。
+ */
+declare function nameValidator(v: string): string | undefined;
+declare function cmdCreate(rest: string[]): Promise<string | undefined>;
+declare function cmdEdit(rest: string[]): Promise<string | undefined>;
+declare function cmdRemove(rest: string[]): Promise<string | undefined>;
+declare function cmdCommon(): void;
+declare function cmdShow(rest: string[]): void;
+declare function cmdConfig(rest: string[]): Promise<void>;
+declare function cmdConfigLocale(val: string | undefined): Promise<void>;
+declare function printHelp(): void;
+export type { SpawnSyncReturns };

package/dist/cli.js

@@ -0,0 +1,490 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { existsSync, realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { listProviders, providerExists, providerFile, readProvider, writeJSON, removeProvider, getLastUsed, writeFileSyncSafe, CLAUDE_SETTINGS_FILE, } from './config.js';
+import { presetList } from './presets.js';
+import { providerFormWithPreview, chooseCreateMode, pickBuiltinPreset } from './form.js';
+import { launch, dryRun, launchDirect, dryRunDirect, redactSettings } from './launch.js';
+import { ui, Cancel } from './tui.js';
+import { t, detectLocale, setConfig, LOCALES } from './i18n.js';
+import { clearScreen } from './screen.js';
+import { getVersion } from './version.js';
+import { completeCandidates, completionScript, completionHelp } from './completion.js';
+// 版本号单一真源：运行时从 package.json 读取，不再硬编码。
+const VERSION = getVersion();
+const helpEn = `ccs ${VERSION} — Claude Code Switch
+
+Switch between multiple provider configs and launch Claude Code.
+
+Usage:
+  ccs                        Pick a provider / direct / create interactively, then launch
+  ccs <name> [args...]       Launch with the named provider; args forwarded to claude
+  ccs <name> --dry-run       Print provider config + command without launching
+  ccs use [args...]          Pick a provider interactively and launch
+  ccs list                   List provider configs
+  ccs presets                List built-in presets
+  ccs create [name]          Create a new config (duplicate names rejected; built-in prompts for a name, default = preset key)
+  ccs edit <name> [--raw]    Guided edit (--raw: edit raw JSON in $EDITOR)
+  ccs remove <name>          Remove a provider config
+  ccs common                 Edit common config (~/.claude/settings.json) in $EDITOR
+  ccs show <name>            Show provider config (secrets redacted)
+  ccs config [locale [en|zh-CN]]  Show/set language
+  ccs completion <bash|zsh>  Print shell completion script
+  ccs -h | --help            Help
+  ccs -v | --version         Version
+
+Storage:
+  ~/.claude/settings.json    Common config (provider-agnostic); ccs reads, never writes
+  ~/.ccs/providers/<name>.settings.json   Per-provider config
+  ~/.ccs/config.json         ccs settings (e.g. locale)
+  ~/.ccs/presets.json        Custom/override presets (optional)
+
+Environment:
+  CCS_CLAUDE_BIN             Path to claude binary (default: claude)
+  EDITOR / VISUAL            Editor for --raw / common (default: vi)
+  LANG / LC_ALL              Auto-detected for locale before ccs config locale is set
+
+Examples:
+  ccs create                 Pick built-in (e.g. deepseek-api) → only API key needed
+  ccs create myprov          Create a custom provider named myprov
+  ccs deepseek-api           Launch with deepseek-api
+  ccs deepseek-api --print "hi"   Forward args to claude
+  ccs show deepseek-api      Inspect provider config (secrets redacted)`;
+const helpZh = `ccs ${VERSION} — Claude Code Switch
+
+在多套供应商配置间切换并启动 Claude Code。
+
+用法:
+  ccs                        交互选择 供应商 / direct / create 并启动
+  ccs <name> [args...]       用指定供应商启动；args 透传给 claude
+  ccs <name> --dry-run       打印 provider 配置与命令，不启动
+  ccs use [args...]          交互选择供应商并启动
+  ccs list                   列出供应商配置
+  ccs presets                列出可用预设
+  ccs create [name]          创建新配置（重名将被拒绝；内置会询问配置名，默认取预设 key）
+  ccs edit <name> [--raw]    引导式编辑（--raw 用编辑器改原始 JSON）
+  ccs remove <name>          删除供应商配置
+  ccs common                 编辑通用配置（~/.claude/settings.json）
+  ccs show <name>            查看 provider 配置（密钥已遮蔽）
+  ccs config [locale [en|zh-CN]]  查看/设置语言
+  ccs completion <bash|zsh>  输出 shell 补全脚本
+  ccs -h | --help            帮助
+  ccs -v | --version         版本
+
+配置存放:
+  ~/.claude/settings.json    通用配置（与供应商无关）；ccs 只读不写
+  ~/.ccs/providers/<name>.settings.json  各供应商配置
+  ~/.ccs/config.json         ccs 设置（如语言）
+  ~/.ccs/presets.json        自定义/覆盖预设（可选）
+
+环境变量:
+  CCS_CLAUDE_BIN             指定 claude 可执行文件路径（默认 claude）
+  EDITOR / VISUAL            --raw / common 使用的编辑器（默认 vi）
+  LANG / LC_ALL              未设置语言时自动感知系统语言
+
+示例:
+  ccs create                 选内置（如 deepseek-api）→ 通常只需填 API Key
+  ccs create myprov          创建名为 myprov 的自定义供应商
+  ccs deepseek-api           直接用 deepseek-api 启动
+  ccs deepseek-api --print "hi"   透传参数给 claude
+  ccs show deepseek-api      查看 provider 配置（密钥已遮蔽）`;
+// 直接作为入口执行时才跑 main；被 import（如测试）时不自动运行。
+const isMain = (() => {
+    try {
+        return realpathSync(process.argv[1] ?? '') === fileURLToPath(import.meta.url);
+    }
+    catch {
+        return false;
+    }
+})();
+if (isMain)
+    main();
+export { main, cmdCreate, cmdEdit, cmdRemove, cmdCommon, cmdShow, cmdConfig, cmdConfigLocale, cmdList, cmdPresets, cmdUse, cmdLaunch, printHelp, validateName, nameValidator, };
+async function main() {
+    const argv = process.argv.slice(2);
+    const [cmd, ...rest] = argv;
+    try {
+        if (cmd === '-h' || cmd === '--help' || cmd === 'help')
+            return printHelp();
+        if (!cmd)
+            return await cmdUse(rest);
+        if (cmd === '-v' || cmd === '--version') {
+            console.log(VERSION);
+            return;
+        }
+        // 隐藏命令：供 shell 补全脚本回调，输出候选项（每行一个）。
+        if (cmd === '__complete') {
+            printCandidates(rest);
+            return;
+        }
+        switch (cmd) {
+            case 'list':
+            case 'ls': return cmdList();
+            case 'presets': return cmdPresets();
+            case 'create': {
+                await cmdCreate(rest);
+                return;
+            }
+            case 'edit': {
+                finishStandalone(await cmdEdit(rest));
+                return;
+            }
+            case 'remove':
+            case 'rm': {
+                finishStandalone(await cmdRemove(rest));
+                return;
+            }
+            case 'common': return cmdCommon();
+            case 'show': return cmdShow(rest);
+            case 'config': return await cmdConfig(rest);
+            case 'use': return await cmdUse(rest);
+            case 'completion': return cmdCompletion(rest);
+            default:
+                if (cmd.startsWith('-')) {
+                    // 裸 ccs 直接跟参数（如 `ccs --dangerously-skip-permissions`）：
+                    // 当作 `ccs use <args>` 处理——交互选供应商后透传给 claude。
+                    // （-h/--help/-v/--version 已在上面先行处理。）
+                    return cmdUse([cmd, ...rest]);
+                }
+                return cmdLaunch(cmd, rest);
+        }
+    }
+    catch (e) {
+        if (e instanceof Cancel) {
+            ui.cancel(t('common.cancelled'));
+            process.exit(1);
+        }
+        console.error(`\x1b[31m${t('error.generic', { msg: e.message })}\x1b[0m`);
+        process.exit(1);
+    }
+}
+// ---------- launch ----------
+/**
+ * 独立命令（ccs edit/remove）的终态输出：清屏后打印一行结果消息。
+ * 菜单循环（cmdUse）路径不走这里——那里由 picker 顶部横幅显示结果。
+ */
+function finishStandalone(msg) {
+    if (!msg)
+        return;
+    clearScreen();
+    console.log(msg);
+}
+function cmdLaunch(name, rest) {
+    const dry = rest.includes('--dry-run');
+    const forwarded = rest.filter((a) => a !== '--dry-run');
+    if (dry)
+        return dryRun(name, forwarded);
+    launch(name, forwarded);
+}
+function cmdLaunchDirect(rest) {
+    const dry = rest.includes('--dry-run');
+    const forwarded = rest.filter((a) => a !== '--dry-run');
+    if (dry)
+        return dryRunDirect(forwarded);
+    launchDirect(forwarded);
+}
+/**
+ * 让用户从现有配置中挑一个（用于菜单里的 edit / remove）。
+ * 无配置时提示并返回 null；取消（Esc）抛 Cancel 由调用方决定是否回菜单。
+ */
+async function pickExistingProvider(message) {
+    const names = listProviders();
+    if (!names.length) {
+        ui.log.message(t('list.empty'));
+        return null;
+    }
+    const last = getLastUsed();
+    const items = names.map((n) => ({
+        value: n,
+        label: n,
+        hint: n === last ? t('list.lastUsed') : '',
+    }));
+    return ui.picker({ message, items, initialValue: items[0].value });
+}
+async function cmdUse(rest) {
+    // 循环菜单：选供应商/direct/create 会启动并返回；
+    // 选 edit/remove 完成后回到菜单继续，子流程取消（Esc）也回菜单而非退出。
+    // statusMessage：edit/remove 完成后由下一轮 picker 顶部横幅显示一个周期。
+    let statusMessage;
+    for (;;) {
+        const names = listProviders();
+        const last = getLastUsed();
+        // 两个版块：供应商区（可过滤/可滚动）+ 操作区（固定不过滤）。
+        const items = [];
+        let initial;
+        for (const n of names) {
+            const v = { kind: 'provider', name: n };
+            items.push({ value: v, label: n, hint: n === last ? t('list.lastUsed') : '' });
+            if (n === last)
+                initial = v;
+        }
+        const actions = [
+            { value: { kind: 'direct' }, label: t('use.direct'), hint: t('use.directHint') },
+            { value: { kind: 'create' }, label: t('use.create'), hint: t('use.createHint') },
+        ];
+        if (names.length) {
+            actions.push({ value: { kind: 'edit' }, label: t('use.edit'), hint: t('use.editHint') }, { value: { kind: 'remove' }, label: t('use.remove'), hint: t('use.removeHint') });
+        }
+        // 默认高亮上次使用的供应商，否则第一项。
+        if (!initial)
+            initial = (items[0] ?? actions[0])?.value;
+        const pickerOpts = { message: t('use.select'), items, actions };
+        if (initial)
+            pickerOpts.initialValue = initial;
+        if (statusMessage)
+            pickerOpts.statusMessage = statusMessage;
+        const picked = await ui.picker(pickerOpts);
+        statusMessage = undefined; // 横幅只显示一个周期
+        if (picked.kind === 'provider')
+            return cmdLaunch(picked.name, rest);
+        if (picked.kind === 'direct')
+            return cmdLaunchDirect(rest);
+        if (picked.kind === 'create') {
+            // 创建完成后立即用新供应商启动；创建被取消则回菜单。
+            const created = await cmdCreate(rest);
+            if (created)
+                return cmdLaunch(created, rest);
+            continue;
+        }
+        if (picked.kind === 'edit') {
+            try {
+                const name = await pickExistingProvider(t('use.editSelect'));
+                if (name) {
+                    const msg = await cmdEdit([name]);
+                    if (msg)
+                        statusMessage = msg;
+                }
+            }
+            catch (e) {
+                if (e instanceof Cancel) {
+                    continue;
+                }
+                throw e;
+            }
+            continue;
+        }
+        if (picked.kind === 'remove') {
+            try {
+                const name = await pickExistingProvider(t('use.removeSelect'));
+                if (name) {
+                    const msg = await cmdRemove([name]);
+                    if (msg)
+                        statusMessage = msg;
+                }
+            }
+            catch (e) {
+                if (e instanceof Cancel) {
+                    continue;
+                }
+                throw e;
+            }
+            continue;
+        }
+    }
+}
+// ---------- listing ----------
+function cmdList() {
+    const names = listProviders();
+    if (!names.length) {
+        console.log(t('list.empty'));
+        return;
+    }
+    const last = getLastUsed();
+    console.log(t('list.header'));
+    for (const n of names)
+        console.log(`  ${n === last ? '*' : ' '} ${n}`);
+    console.log(`\n${t('list.summary', { count: names.length })}`);
+}
+function cmdPresets() {
+    const list = presetList();
+    console.log(t('presets.header'));
+    for (const p of list) {
+        console.log(`  ${p.key.padEnd(20)} ${p.label}  ${p.baseUrl || t('presets.fillUrl')}`);
+    }
+    console.log(`\n${t('presets.footer')}`);
+    console.log(t('presets.userFile'));
+}
+// ---------- completion ----------
+/** 隐藏命令 `ccs __complete <words...>`：逐行打印候选。 */
+function printCandidates(words) {
+    for (const c of completeCandidates(words))
+        console.log(c);
+}
+/** `ccs completion <shell>`：输出补全脚本或提示。 */
+function cmdCompletion(rest) {
+    const shell = rest[0];
+    if (!shell) {
+        console.log(completionHelp());
+        return;
+    }
+    const script = completionScript(shell);
+    if (!script) {
+        console.log(completionHelp(shell));
+        return;
+    }
+    process.stdout.write(script);
+}
+// ---------- create / edit / remove ----------
+function validateName(name) {
+    if (!name || /[\\/\s]/.test(name) || name.includes('..')) {
+        throw new Error(t('error.invalidName', { name }));
+    }
+}
+/**
+ * 配置名校验器（供 inkText 的 validate 内联使用）。
+ * 检查非空、非法字符、重名——重名即时提示，引导用户改名而非直接失败。
+ * 返回错误消息字符串，或 undefined 表示通过。
+ */
+function nameValidator(v) {
+    const name = (v || '').trim();
+    if (!name)
+        return t('create.customNameValidate');
+    if (/[\\/\s]/.test(name) || name.includes('..'))
+        return t('error.invalidName', { name });
+    if (providerExists(name))
+        return t('error.exists', { name });
+    return undefined;
+}
+async function cmdCreate(rest) {
+    const nameArg = rest[0];
+    let name;
+    let preset = null;
+    if (nameArg) {
+        // ccs create <name> → 用给定名称创建（自定义空白表单）
+        validateName(nameArg);
+        name = nameArg;
+    }
+    else {
+        // 交互：内置 or 自定义
+        const mode = await chooseCreateMode();
+        if (mode === 'builtin') {
+            const picked = await pickBuiltinPreset();
+            // 配置名默认取预设 key，可改——同一供应商可建多个账号配置
+            // （如 deepseek-api / deepseek-work），不再固定为预设名。
+            name = (await ui.inkText({
+                message: t('create.namePrompt', { default: picked.key }),
+                initialValue: picked.key,
+                validate: nameValidator,
+            })).trim();
+            preset = picked.preset;
+        }
+        else {
+            name = (await ui.inkText({
+                message: t('create.customNamePrompt'),
+                validate: nameValidator,
+            })).trim();
+        }
+    }
+    // create 永远新建：重名直接拒绝。修改既有配置请用 ccs edit，删除用 ccs remove。
+    // （交互流程已内联检测；此处兜底覆盖 ccs create <name> 直传名称的情况。）
+    if (providerExists(name)) {
+        throw new Error(t('error.exists', { name }));
+    }
+    const result = await providerFormWithPreview({ initial: {}, preset, title: t('create.kindTitle', { name }) });
+    writeJSON(providerFile(name), result);
+    clearScreen();
+    console.log(t('create.created', { file: providerFile(name) }));
+    return name;
+}
+async function cmdEdit(rest) {
+    const name = rest[0];
+    const raw = rest.includes('--raw');
+    if (!name) {
+        console.error(t('usage.editName'));
+        process.exit(1);
+    }
+    if (!providerExists(name)) {
+        console.error(t('error.notFound', { name }));
+        process.exit(1);
+    }
+    if (raw) {
+        editRaw(providerFile(name));
+        return undefined;
+    }
+    const initial = readProvider(name) || {};
+    const result = await providerFormWithPreview({ initial, title: t('edit.title', { name }) });
+    writeJSON(providerFile(name), result);
+    return t('edit.updated', { file: providerFile(name) });
+}
+async function cmdRemove(rest) {
+    const name = rest[0];
+    if (!name) {
+        console.error(t('usage.removeName'));
+        process.exit(1);
+    }
+    if (!providerExists(name)) {
+        console.error(t('error.notFound', { name }));
+        process.exit(1);
+    }
+    const ok = await ui.inkConfirm({ message: t('remove.confirm', { name }), initialValue: false });
+    if (!ok)
+        return undefined;
+    removeProvider(name);
+    return t('remove.done', { name });
+}
+function editRaw(file) {
+    const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+    spawnSync(editor, [file], { stdio: 'inherit' });
+}
+// ---------- common / show / config ----------
+function cmdCommon() {
+    // 通用配置直接用 ~/.claude/settings.json，ccs 只读不写。
+    if (!existsSync(CLAUDE_SETTINGS_FILE)) {
+        writeFileSyncSafe(CLAUDE_SETTINGS_FILE, '{}\n');
+        console.log(t('common.createdEmpty', { file: CLAUDE_SETTINGS_FILE }));
+    }
+    console.log(t('common.openEditor'));
+    const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+    spawnSync(editor, [CLAUDE_SETTINGS_FILE], { stdio: 'inherit' });
+}
+function cmdShow(rest) {
+    const name = rest[0];
+    if (!name) {
+        console.error(t('usage.showName'));
+        process.exit(1);
+    }
+    const settings = readProvider(name);
+    if (!settings) {
+        console.error(t('error.providerMissing', { name }));
+        process.exit(1);
+    }
+    console.log(JSON.stringify(redactSettings(settings), null, 2));
+}
+async function cmdConfig(rest) {
+    const [key, val] = rest;
+    if (key === 'locale')
+        return cmdConfigLocale(val);
+    if (!key) {
+        console.log(t('config.localeCurrent', { locale: detectLocale() }));
+        console.log(`  ccs config locale [${LOCALES.map((l) => l.value).join(' | ')}]`);
+        return;
+    }
+    console.error(t('config.unknownKey', { key }));
+    process.exit(1);
+}
+async function cmdConfigLocale(val) {
+    const valid = LOCALES.map((l) => l.value);
+    if (val) {
+        if (!valid.includes(val)) {
+            console.error(t('config.localeInvalid', { opts: valid.join(', ') }));
+            process.exit(1);
+        }
+        setConfig({ locale: val });
+        console.log(t('config.localeSet', { locale: val }));
+        return;
+    }
+    const current = detectLocale();
+    const picked = await ui.inkSelect({
+        message: t('config.localePrompt'),
+        options: LOCALES.map((l) => ({ value: l.value, label: l.label, hint: l.value === current ? t('list.lastUsed') : '' })),
+        initialValue: valid.includes(current) ? current : 'en',
+    });
+    setConfig({ locale: picked });
+    console.log(t('config.localeSet', { locale: picked }));
+}
+// ---------- help ----------
+function printHelp() {
+    const locale = detectLocale();
+    console.log(locale === 'zh-CN' ? helpZh : helpEn);
+}

package/dist/completion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 根据已输入词序列返回补全候选（已按当前光标词前缀过滤）。
+ *
+ * argv = 去掉 `ccs` 与 `__complete` 后的词，最后一个元素是当前光标词 cur（可为空串）。
+ *
+ * 注意：第一位置词同时容纳子命令与具名 provider（`ccs <name>` 直接启动），
+ * 这是该 CLI「子命令与 provider 名共享第一位置词空间」特性的自然映射。
+ */
+export declare function completeCandidates(argv: string[]): string[];
+/**
+ * bash 补全脚本。`eval "$(ccs completion bash)"` 后生效。
+ * ccs 不在 PATH 时静默不注册；__complete 出错时静默返回。
+ * 注意：模板字面量中所有 shell 的 ${...} 必须转义为 \${...}，避免被 JS 当成插值。
+ */
+export declare const bashCompletionScript = "# ccs bash completion\nif command -v ccs >/dev/null 2>&1; then\n  _ccs_bash_complete() {\n    local cur cands\n    cur=\"${COMP_WORDS[COMP_CWORD]}\"\n    # COMP_WORDS[1:] \u5DF2\u542B\u672B\u5C3E cur \u8BCD\uFF0C\u76F4\u63A5\u4F20\u7ED9 ccs __complete\n    cands=$(ccs __complete \"${COMP_WORDS[@]:1}\" 2>/dev/null) || return\n    COMPREPLY=($(compgen -W \"$cands\" -- \"$cur\"))\n  }\n  complete -F _ccs_bash_complete ccs\nfi\n";
+/**
+ * zsh 补全脚本。`eval "$(ccs completion zsh)"` 后生效（需 compinit 已加载）。
+ * ccs 不在 PATH 时静默不注册。
+ * 注意：模板字面量中所有 shell 的 ${...} 必须转义为 \${...}，避免被 JS 当成插值。
+ */
+export declare const zshCompletionScript = "# ccs zsh completion\nif command -v ccs >/dev/null 2>&1; then\n  _ccs_zsh_complete() {\n    local -a cands\n    # ${words[@]:1}\uFF1A\u53BB\u6389 ccs \u672C\u8EAB\uFF0C\u672B\u5C3E\u5373\u5F53\u524D\u8BCD\n    cands=(\"${(@f)$(ccs __complete \"${words[@]:1}\" 2>/dev/null)}\")\n    compadd -- \"$@\" \"${cands[@]}\"\n  }\n  compdef _ccs_zsh_complete ccs\nfi\n";
+/** 支持的 shell。 */
+export declare const SUPPORTED_SHELLS: readonly ["bash", "zsh"];
+/** 补全脚本按 shell 取；不支持时返回 null。 */
+export declare function completionScript(shell: string): string | null;
+/** `ccs completion` 无参/不支持的 shell 时的提示文本。 */
+export declare function completionHelp(shell?: string): string;