@wayfarer35/ccs 0.2.2

package/dist/i18n.js

@@ -0,0 +1,195 @@
+import { readJSON, writeJSON, CONFIG_FILE } from './config.js';
+export const LOCALES = [
+    { value: 'en', label: 'English' },
+    { value: 'zh-CN', label: '简体中文' },
+];
+const SUPPORTED = LOCALES.map((l) => l.value);
+/** 读取 ~/.ccs/config.json（不存在则空对象）。 */
+export function getConfig() {
+    return readJSON(CONFIG_FILE, {}) || {};
+}
+/** 合并写入 ~/.ccs/config.json。 */
+export function setConfig(patch) {
+    const next = { ...getConfig(), ...patch };
+    writeJSON(CONFIG_FILE, next);
+    return next;
+}
+/**
+ * 语言探测顺序：config.locale → LC_ALL → LC_MESSAGES → LANG → 'en'。
+ * 形如 zh_CN / zh_TW / zh-Hans 均归为 zh-CN，其余归 en。
+ */
+export function detectLocale() {
+    const cfg = getConfig();
+    if (cfg.locale && SUPPORTED.includes(cfg.locale))
+        return cfg.locale;
+    const envVal = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || '';
+    return /^zh/i.test(envVal) ? 'zh-CN' : 'en';
+}
+const DICT = {
+    // ---------- generic ----------
+    'common.cancelled': { en: 'Cancelled', 'zh-CN': '已取消' },
+    'common.yes': { en: 'Yes', 'zh-CN': '是' },
+    'common.no': { en: 'No', 'zh-CN': '否' },
+    // ---------- errors ----------
+    'error.unknownArg': { en: 'Unknown argument: {arg}', 'zh-CN': '未知参数: {arg}' },
+    'error.generic': { en: 'Error: {msg}', 'zh-CN': '错误: {msg}' },
+    'error.invalidName': { en: 'Invalid config name: {name}', 'zh-CN': '非法配置名: {name}' },
+    'error.exists': { en: 'Already exists: {name}. Use `ccs edit {name}` to modify, or pick another name.', 'zh-CN': '已存在: {name}。用 ccs edit {name} 修改，或换个名字。' },
+    'error.notFound': { en: 'Not found: {name}', 'zh-CN': '未找到: {name}' },
+    'error.providerMissing': {
+        en: 'Provider config not found: {name}\nRun `ccs list` to see available configs, or `ccs create` to create one.',
+        'zh-CN': '未找到供应商配置: {name}\n运行 ccs list 查看可用配置，或 ccs create 创建。',
+    },
+    'error.claudeBin': {
+        en: 'claude executable not found: {bin}\nMake sure Claude Code is installed, or set CCS_CLAUDE_BIN.',
+        'zh-CN': '未找到 claude 可执行文件: {bin}\n请确认 Claude Code 已安装，或用 CCS_CLAUDE_BIN 指定路径。',
+    },
+    'error.jsonParse': { en: 'Failed to parse JSON: {file}\n{msg}', 'zh-CN': '解析 JSON 失败: {file}\n{msg}' },
+    // ---------- usage ----------
+    'usage.createName': { en: 'Usage: ccs create [name]', 'zh-CN': '用法: ccs create [name]' },
+    'usage.editName': { en: 'Usage: ccs edit <name> [--raw]', 'zh-CN': '用法: ccs edit <name> [--raw]' },
+    'usage.removeName': { en: 'Usage: ccs remove <name>', 'zh-CN': '用法: ccs remove <name>' },
+    'usage.showName': { en: 'Usage: ccs show <name>', 'zh-CN': '用法: ccs show <name>' },
+    // ---------- list ----------
+    'list.empty': {
+        en: 'No provider configs yet. Run `ccs create` or `ccs init` to create one.',
+        'zh-CN': '暂无供应商配置。运行 ccs create 或 ccs init 创建。',
+    },
+    'list.header': { en: 'Available provider configs:', 'zh-CN': '可用供应商配置:' },
+    'list.summary': {
+        en: '{count} total. Use `ccs <name>` to launch, or just `ccs` to pick interactively.',
+        'zh-CN': '共 {count} 个。用 ccs <name> 启动，或直接 ccs 交互选择。',
+    },
+    'list.lastUsed': { en: 'last used', 'zh-CN': '上次使用' },
+    // ---------- presets ----------
+    'presets.header': { en: 'Available presets:', 'zh-CN': '可用预设:' },
+    'presets.fillUrl': { en: '(Base URL required)', 'zh-CN': '(需填写 Base URL)' },
+    'presets.footer': {
+        en: 'Use `ccs create` and pick a built-in provider to create from a preset.',
+        'zh-CN': '用 ccs create 并选择内置供应商来快速创建。',
+    },
+    'presets.userFile': { en: 'Custom/override presets: ~/.ccs/presets.json', 'zh-CN': '自定义/覆盖预设: ~/.ccs/presets.json' },
+    // ---------- create flow ----------
+    'create.kindTitle': { en: 'Create provider config', 'zh-CN': '创建供应商配置' },
+    'create.kindPrompt': { en: 'Built-in provider or custom?', 'zh-CN': '选择内置供应商或自定义' },
+    'create.kindBuiltin': { en: 'Built-in provider (preset prefilled, name customizable)', 'zh-CN': '内置供应商（预填预设，名称可自定义）' },
+    'create.kindCustom': { en: 'Custom (your own name, blank form)', 'zh-CN': '自定义（自定义名称，空白表单）' },
+    'create.builtinPrompt': { en: 'Select a built-in provider', 'zh-CN': '选择内置供应商' },
+    'create.namePrompt': { en: 'Config name (default: {default})', 'zh-CN': '配置名（默认: {default}）' },
+    'create.customNamePrompt': { en: 'Config name (e.g. glm / deepseek / myprov)', 'zh-CN': '配置名 (如 glm / deepseek / myprov)' },
+    'create.customNameValidate': { en: 'Name cannot be empty', 'zh-CN': '名称不能为空' },
+    'create.created': { en: 'Created: {file}', 'zh-CN': '已创建: {file}' },
+    // ---------- edit / remove ----------
+    'edit.title': { en: 'Edit provider config: {name}', 'zh-CN': '编辑供应商配置: {name}' },
+    'edit.updated': { en: 'Updated: {file}', 'zh-CN': '已更新: {file}' },
+    'remove.title': { en: 'Remove provider config: {name}', 'zh-CN': '删除供应商配置: {name}' },
+    'remove.confirm': { en: 'Confirm remove {name}?', 'zh-CN': '确认删除 {name}?' },
+    'remove.done': { en: 'Removed: {name}', 'zh-CN': '已删除: {name}' },
+    // ---------- form ----------
+    'form.baseUrl': { en: 'Base URL (ANTHROPIC_BASE_URL)', 'zh-CN': 'Base URL (ANTHROPIC_BASE_URL)' },
+    'form.baseUrlValidate': { en: 'Base URL cannot be empty', 'zh-CN': 'Base URL 不能为空' },
+    'form.placeholderUrl': { en: 'https://...', 'zh-CN': 'https://...' },
+    'form.apiKeyKeep': { en: 'API Key (leave empty to keep current)', 'zh-CN': 'API Key (留空保留原值)' },
+    'form.apiKey': { en: 'API Key', 'zh-CN': 'API Key' },
+    'form.model': { en: 'Default model (ANTHROPIC_MODEL)', 'zh-CN': '默认模型 (ANTHROPIC_MODEL)' },
+    'form.modelValidate': { en: 'Model cannot be empty', 'zh-CN': '模型不能为空' },
+    'form.tier': { en: 'Default tier (settings.model)', 'zh-CN': '默认档位 (settings.model)' },
+    'form.aliasesPrompt': { en: 'Use tier-alias mode? (Yes: settings.model=opus + per-tier ANTHROPIC_DEFAULT_*_MODEL, /model switches between them. No: single ANTHROPIC_MODEL.)', 'zh-CN': '使用档位别名模式？（是：settings.model=opus + 各档位 ANTHROPIC_DEFAULT_*_MODEL，可用 /model 切换；否：单一 ANTHROPIC_MODEL）' },
+    'form.aliasModel': { en: '{tier} model ({var})', 'zh-CN': '{tier} 模型 ({var})' },
+    // ---------- options (tab 3) ----------
+    'form.optionsAttribution': { en: 'Enable CLAUDE_CODE_ATTRIBUTION_HEADER? (adds attribution to git commits)', 'zh-CN': '启用 CLAUDE_CODE_ATTRIBUTION_HEADER？（向 git 提交追加归属信息）' },
+    'form.optionsNonEssential': { en: 'Enable CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC? (disables telemetry/analytics traffic)', 'zh-CN': '启用 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC？（禁用遥测/分析流量）' },
+    'form.optionsAutoCompact': { en: 'Auto-compact window in tokens (CLAUDE_CODE_AUTO_COMPACT_WINDOW)', 'zh-CN': '自动压缩窗口（token 数，CLAUDE_CODE_AUTO_COMPACT_WINDOW）' },
+    'form.autoCompactValidate': { en: 'Enter a positive integer', 'zh-CN': '请输入正整数' },
+    'form.autoCompactPlaceholder': { en: '200000', 'zh-CN': '200000' },
+    // ---------- tab navigation ----------
+    'tab.apikey': { en: 'API Key', 'zh-CN': 'API Key' },
+    'tab.models': { en: 'Models', 'zh-CN': '模型' },
+    'tab.options': { en: 'Options', 'zh-CN': '其他配置' },
+    'tab.review': { en: 'Review', 'zh-CN': '预览/提交' },
+    'tab.preview': { en: 'Preview', 'zh-CN': '预览' },
+    'tab.submit': { en: 'Submit', 'zh-CN': '提交保存' },
+    'tab.cancel': { en: 'Cancel', 'zh-CN': '取消' },
+    'tab.filled': { en: 'filled', 'zh-CN': '已填' },
+    'tab.unfilled': { en: 'not filled', 'zh-CN': '未填' },
+    'tab.previewTitle': { en: 'Preview (secrets redacted)', 'zh-CN': '配置预览（密钥已遮蔽）' },
+    'tab.submitConfirm': { en: 'Save this provider config?', 'zh-CN': '保存该供应商配置？' },
+    // ---------- inline form field labels & help ----------
+    'form.fBaseUrl': { en: 'Base URL', 'zh-CN': 'Base URL' },
+    'form.fToken': { en: 'API Key', 'zh-CN': 'API Key' },
+    'form.fTokenKeep': { en: 'API Key (leave empty to keep current)', 'zh-CN': 'API Key (留空保留原值)' },
+    'form.fTokenKept': { en: '(keeping current)', 'zh-CN': '(保留原值)' },
+    'form.fAliases': { en: 'Tier-alias mode', 'zh-CN': '档位别名模式' },
+    'form.fModel': { en: 'Default model', 'zh-CN': '默认模型' },
+    'form.fTier': { en: 'Default tier', 'zh-CN': '默认档位' },
+    'form.fAliasShort': { en: '{tier} model', 'zh-CN': '{tier} 模型' },
+    'form.fAttr': { en: 'Attribution header (CLAUDE_CODE_ATTRIBUTION_HEADER)', 'zh-CN': '归属信息 (CLAUDE_CODE_ATTRIBUTION_HEADER)' },
+    'form.fNonEss': { en: 'Disable non-essential traffic (CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC)', 'zh-CN': '禁用非必要流量 (CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC)' },
+    'form.fAutoCompact': { en: 'Auto-compact window (CLAUDE_CODE_AUTO_COMPACT_WINDOW)', 'zh-CN': '自动压缩窗口 (CLAUDE_CODE_AUTO_COMPACT_WINDOW)' },
+    'form.fEffort': { en: 'Reasoning effort (CLAUDE_CODE_EFFORT_LEVEL)', 'zh-CN': '推理强度 (CLAUDE_CODE_EFFORT_LEVEL)' },
+    'form.fAuthMethod': { en: 'Auth Method', 'zh-CN': '认证方式' },
+    'form.authToken': { en: 'Auth Token (ANTHROPIC_AUTH_TOKEN)', 'zh-CN': 'Auth Token (ANTHROPIC_AUTH_TOKEN)' },
+    'form.apiUrlKey': { en: 'API Key (ANTHROPIC_API_KEY)', 'zh-CN': 'API Key (ANTHROPIC_API_KEY)' },
+    'form.fCustomParams': { en: 'Custom Params (JSON)', 'zh-CN': '自定义参数 (JSON)' },
+    'form.customParamsValidate': { en: 'Custom params JSON is invalid', 'zh-CN': '自定义参数 JSON 格式无效' },
+    'form.customParamsHint': { en: 'Extra env key-value pairs as JSON, e.g. {"allowed_openai_params": {"max_tokens": 8192}}', 'zh-CN': '额外 env 键值对 JSON，例如 {"allowed_openai_params": {"max_tokens": 8192}}' },
+    'form.spaceHint': { en: '(Space to change)', 'zh-CN': '(空格切换)' },
+    'tab.next': { en: 'Next →', 'zh-CN': '下一个 →' },
+    'form.acHint': { en: '↑↓=pick Enter=use', 'zh-CN': '↑↓=选 Enter=用' },
+    'form.help': {
+        en: 'Tab=switch tab  ↑↓=field (↑↓=pick model on model fields)  ←→=cursor (in text)  Space=toggle/cycle  n=next tab  Enter=next/accept/submit  Esc=cancel',
+        'zh-CN': 'Tab=切标签  ↑↓=切字段(模型字段上 ↑↓=选模型)  ←→=光标(文本内)  Space=开关/切换  n=下一标签  Enter=下一步/采纳/提交  Esc=取消',
+    },
+    // ---------- preview / edit loop ----------
+    'preview.title': { en: 'Preview (secrets redacted)', 'zh-CN': '配置预览（密钥已遮蔽）' },
+    'preview.prompt': { en: 'Save, re-edit the form, or edit raw JSON?', 'zh-CN': '保存、重新编辑表单，还是编辑原始 JSON？' },
+    'preview.save': { en: 'Save', 'zh-CN': '保存' },
+    'preview.reedit': { en: 'Re-edit form', 'zh-CN': '重新编辑表单' },
+    'preview.editRaw': { en: 'Edit raw JSON in $EDITOR', 'zh-CN': '在 $EDITOR 中编辑原始 JSON' },
+    'preview.rawParseError': { en: 'Raw JSON invalid, keeping previous result. {msg}', 'zh-CN': '原始 JSON 解析失败，保留上一次结果。{msg}' },
+    // ---------- use ----------
+    'use.select': { en: 'Select a provider', 'zh-CN': '选择供应商' },
+    'use.direct': { en: 'direct', 'zh-CN': 'direct' },
+    'use.directHint': { en: 'Claude Code default config (no provider merge)', 'zh-CN': 'Claude Code 默认配置（不走供应商）' },
+    'use.create': { en: 'create', 'zh-CN': 'create' },
+    'use.createHint': { en: 'Create a new provider', 'zh-CN': '创建新供应商' },
+    'use.edit': { en: 'edit', 'zh-CN': 'edit' },
+    'use.editHint': { en: 'Edit an existing config', 'zh-CN': '修改已有配置' },
+    'use.remove': { en: 'remove', 'zh-CN': 'remove' },
+    'use.removeHint': { en: 'Remove a config', 'zh-CN': '删除配置' },
+    'use.editSelect': { en: 'Select a config to edit', 'zh-CN': '选择要修改的配置' },
+    'use.removeSelect': { en: 'Select a config to remove', 'zh-CN': '选择要删除的配置' },
+    // ---------- picker (ink search-select) ----------
+    'picker.placeholder': { en: 'type to filter providers...', 'zh-CN': '输入过滤供应商...' },
+    'picker.noMatch': { en: 'no match', 'zh-CN': '无匹配' },
+    'picker.providers': { en: 'Providers ({count})', 'zh-CN': '供应商配置 ({count})' },
+    'picker.actions': { en: 'Actions', 'zh-CN': '操作' },
+    'picker.help': { en: 'type=filter providers  ↑↓=select  Tab=jump region  Enter=confirm  Esc=cancel', 'zh-CN': '输入=过滤供应商  ↑↓=选择  Tab=跳转区域  Enter=确认  Esc=取消' },
+    // ---------- common / show / init ----------
+    'common.openEditor': { en: 'Opening ~/.claude/settings.json (common config) in editor...', 'zh-CN': '在编辑器中打开 ~/.claude/settings.json (通用配置)...' },
+    'common.createdEmpty': { en: 'Created empty settings file: {file}', 'zh-CN': '已创建空配置文件: {file}' },
+    // ---------- launch / dry-run ----------
+    'launch.willRun': { en: 'Will run: {cmd}', 'zh-CN': '将执行: {cmd}' },
+    'launch.dryTmp': { en: '(settings file: {file} — the provider config itself, passed directly to --settings; dry-run does not launch or create any file)', 'zh-CN': '（配置文件: {file}，即 provider 配置本身，直接作为 --settings 目标；dry-run 不启动、不创建文件）' },
+    'launch.dryDirect': { en: '(direct mode: no merge, no temp file — uses ~/.claude/settings.json as-is)', 'zh-CN': '（direct 模式：不合并、无临时文件，直接用 ~/.claude/settings.json）' },
+    // ---------- config ----------
+    'config.localeSet': { en: 'Locale set to {locale}', 'zh-CN': '语言已设为 {locale}' },
+    'config.localeCurrent': { en: 'Current locale: {locale}', 'zh-CN': '当前语言: {locale}' },
+    'config.localeInvalid': { en: 'Invalid locale. Choose from: {opts}', 'zh-CN': '无效语言。可选: {opts}' },
+    'config.localePrompt': { en: 'Select language', 'zh-CN': '选择语言' },
+    'config.unknownKey': { en: 'Unknown config key: {key}. Try `ccs config locale`.', 'zh-CN': '未知配置项: {key}。试试 ccs config locale。' },
+};
+/**
+ * 翻译。t(key, { name: 'foo' }) 替换 {name}。
+ */
+export function t(key, vars) {
+    const entry = DICT[key];
+    const locale = detectLocale();
+    let s = entry ? (entry[locale] ?? entry.en ?? key) : key;
+    if (vars) {
+        for (const [k, v] of Object.entries(vars)) {
+            s = s.replaceAll(`{${k}}`, String(v));
+        }
+    }
+    return s;
+}

package/dist/inkPrompts.d.ts

@@ -0,0 +1,25 @@
+export interface InkSelectOption<T> {
+    value: T;
+    label: string;
+    hint?: string;
+}
+export interface InkSelectParams<T> {
+    message: string;
+    options: ReadonlyArray<InkSelectOption<T>>;
+    initialValue?: T;
+}
+export interface InkTextParams {
+    message: string;
+    placeholder?: string;
+    initialValue?: string;
+    validate?: (value: string) => string | Error | undefined;
+}
+export interface InkConfirmParams {
+    message: string;
+    active?: string;
+    inactive?: string;
+    initialValue?: boolean;
+}
+export declare function inkSelect<T>(opts: InkSelectParams<T>): Promise<T>;
+export declare function inkText(opts: InkTextParams): Promise<string>;
+export declare function inkConfirm(opts: InkConfirmParams): Promise<boolean>;

package/dist/inkPrompts.js

@@ -0,0 +1,176 @@
+import { Box, render, Text, useInput, useStdout } from 'ink';
+import React, { useEffect, useState } from 'react';
+import { Cancel } from './tui.js';
+import { clearScreen } from './screen.js';
+const h = React.createElement;
+// ---------- shared helpers ----------
+function insertAt(s, idx, ch) { return s.slice(0, idx) + ch + s.slice(idx); }
+function eraseBack(s, idx) { return idx > 0 ? s.slice(0, idx - 1) + s.slice(idx) : s; }
+function useBlink(deps) {
+    const [on, setOn] = useState(true);
+    useEffect(() => {
+        const id = setInterval(() => setOn((b) => !b), 530);
+        return () => clearInterval(id);
+    }, []);
+    useEffect(() => { setOn(true); }, deps);
+    return on;
+}
+// ---------- inkSelect ----------
+function SelectApp({ message, options, initialIndex, onDone, onCancel }) {
+    const [index, setIndex] = useState(initialIndex);
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.return || input === ' ') {
+            onDone(options[index].value);
+            return;
+        }
+        if (key.upArrow) {
+            setIndex((i) => (i - 1 + options.length) % options.length);
+            return;
+        }
+        if (key.downArrow) {
+            setIndex((i) => (i + 1) % options.length);
+            return;
+        }
+    });
+    return h(Box, { flexDirection: 'column' }, h(Text, { color: 'cyan', bold: true }, message), ...options.map((opt, i) => {
+        const sel = i === index;
+        const style = sel ? { backgroundColor: 'cyan', color: 'black' } : {};
+        return h(Box, { key: i, flexDirection: 'row' }, h(Text, style, `${sel ? '▸ ' : '  '}${opt.label}`), opt.hint ? h(Text, sel ? { backgroundColor: 'cyan', color: 'black' } : { dimColor: true }, `  ${opt.hint}`) : null);
+    }), h(Text, { dimColor: true }, '↑↓=select  Enter=confirm  Esc=cancel'));
+}
+export async function inkSelect(opts) {
+    const { message, options } = opts;
+    const arr = [...options];
+    if (!arr.length)
+        throw new Cancel();
+    let initialIndex = 0;
+    if (opts.initialValue !== undefined) {
+        const i = arr.findIndex((o) => o.value === opts.initialValue);
+        if (i >= 0)
+            initialIndex = i;
+    }
+    return new Promise((resolve, reject) => {
+        let inst;
+        const onDone = (v) => { inst.unmount(); resolve(v); };
+        const onCancel = () => { inst.unmount(); reject(new Cancel()); };
+        const App = SelectApp;
+        clearScreen();
+        inst = render(h(App, { message, options: arr, initialIndex, onDone, onCancel }));
+    });
+}
+// ---------- inkText ----------
+function TextApp({ message, placeholder, initial, validate, onDone, onCancel }) {
+    const [value, setValue] = useState(initial);
+    const [cursor, setCursor] = useState(initial.length);
+    const [error, setError] = useState(null);
+    const { stdout } = useStdout();
+    const cols = stdout && stdout.columns ? stdout.columns : 60;
+    const blinkOn = useBlink([cursor]);
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.return) {
+            if (validate) {
+                const r = validate(value);
+                if (typeof r === 'string') {
+                    setError(r);
+                    return;
+                }
+                if (r instanceof Error) {
+                    setError(r.message);
+                    return;
+                }
+            }
+            onDone(value);
+            return;
+        }
+        setError(null);
+        if (key.leftArrow) {
+            setCursor((c) => Math.max(0, c - 1));
+            return;
+        }
+        if (key.rightArrow) {
+            setCursor((c) => Math.min(value.length, c + 1));
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setValue((v) => { const nv = eraseBack(v, cursor); setCursor((c) => Math.max(0, c - 1)); return nv; });
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            let s = '';
+            for (const ch of input) {
+                if (ch.charCodeAt(0) >= 32)
+                    s += ch;
+            }
+            if (s) {
+                setValue((v) => insertAt(v, cursor, s));
+                setCursor((c) => c + s.length);
+            }
+        }
+    });
+    const cur = Math.min(cursor, value.length);
+    const charAt = value.slice(cur, cur + 1);
+    const cursorNode = blinkOn ? h(Text, { color: 'cyan' }, '▏') : h(Text, null, charAt || ' ');
+    return h(Box, { flexDirection: 'column' }, h(Text, { color: 'cyan', bold: true }, message), h(Box, { flexDirection: 'row' }, value
+        ? h(Text, null, h(Text, { color: 'cyan' }, value.slice(0, cur)), cursorNode, h(Text, { color: 'cyan' }, value.slice(cur + 1)))
+        : h(Text, { dimColor: true }, placeholder ?? '')), error ? h(Text, { color: 'red' }, '✗ ' + error) : null, h(Text, { dimColor: true }, 'type value  Enter=confirm  Esc=cancel'));
+}
+export async function inkText(opts) {
+    const { message, initialValue = '' } = opts;
+    return new Promise((resolve, reject) => {
+        let inst;
+        const onDone = (v) => { inst.unmount(); resolve(v); };
+        const onCancel = () => { inst.unmount(); reject(new Cancel()); };
+        const props = { message, initial: initialValue, onDone, onCancel };
+        if (opts.placeholder !== undefined)
+            props.placeholder = opts.placeholder;
+        if (opts.validate !== undefined)
+            props.validate = opts.validate;
+        clearScreen();
+        inst = render(h(TextApp, props));
+    });
+}
+// ---------- inkConfirm ----------
+function ConfirmApp({ message, active, inactive, initial, onDone, onCancel }) {
+    const [val, setVal] = useState(initial);
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.return) {
+            onDone(val);
+            return;
+        }
+        if (key.leftArrow || key.rightArrow || input === ' ' || input === 'y' || input === 'n') {
+            if (input === 'y') {
+                setVal(true);
+                return;
+            }
+            if (input === 'n') {
+                setVal(false);
+                return;
+            }
+            setVal((v) => !v);
+            return;
+        }
+    });
+    return h(Box, { flexDirection: 'column' }, h(Box, { flexDirection: 'row' }, h(Text, { color: 'cyan', bold: true }, message + ' '), h(Text, val ? { backgroundColor: 'green', color: 'black' } : { dimColor: true }, val ? `[Y] ${active}` : `[ ] ${active}`), h(Text, null, '  '), h(Text, !val ? { backgroundColor: 'red', color: 'black' } : { dimColor: true }, !val ? `[N] ${inactive}` : `[ ] ${inactive}`)), h(Text, { dimColor: true }, 'y/n or ←→=toggle  Enter=confirm  Esc=cancel'));
+}
+export async function inkConfirm(opts) {
+    const { message, active = 'Yes', inactive = 'No', initialValue = false } = opts;
+    return new Promise((resolve, reject) => {
+        let inst;
+        const onDone = (v) => { inst.unmount(); resolve(v); };
+        const onCancel = () => { inst.unmount(); reject(new Cancel()); };
+        clearScreen();
+        inst = render(h(ConfirmApp, { message, active, inactive, initial: initialValue, onDone, onCancel }));
+    });
+}

package/dist/launch.d.ts

@@ -0,0 +1,27 @@
+import type { ProviderSettings } from './types.js';
+/** 展示用：遮蔽疑似密钥的 env 值（仅保留末 4 位）。 */
+export declare function redactSettings(obj: ProviderSettings): ProviderSettings;
+export declare function whichClaude(): string;
+/**
+ * 打印 provider 配置片段与将要执行的命令，不启动 claude。
+ * `--settings` 直接指向 provider 配置文件本身——ccs 不再产出中间文件。
+ * 注意：展示的是 provider 片段，非 claude 最终加载的完整 settings（后者还会与
+ * ~/.claude/settings.json 深合，片段里未出现的 key 由下层继承）。
+ */
+export declare function dryRun(name: string, forwardedArgs?: string[]): void;
+/**
+ * 直接启动 claude，使用 Claude Code 默认配置（~/.claude/settings.json）。
+ * 不做合并、不写临时文件、不记录 lastUsed。
+ */
+export declare function launchDirect(forwardedArgs?: string[]): void;
+/**
+ * 打印 direct 模式将执行的命令，不启动。
+ */
+export declare function dryRunDirect(forwardedArgs?: string[]): void;
+/**
+ * 以 provider 配置文件作为 --settings 目标直接启动 claude（claude 自行与 ~/.claude/settings.json 深合）。
+ * 不解析 provider 对象、不写中间文件、不注入子进程 env——claude 加载 --settings 时自行读取 env。
+ * @param name  供应商名
+ * @param forwardedArgs  透传给 claude 的参数
+ */
+export declare function launch(name: string, forwardedArgs?: string[]): void;

package/dist/launch.js

@@ -0,0 +1,108 @@
+import { spawnSync } from 'node:child_process';
+import { readProvider, providerFile, providerExists, setLastUsed, } from './config.js';
+import { t } from './i18n.js';
+/** 展示用：遮蔽疑似密钥的 env 值（仅保留末 4 位）。 */
+export function redactSettings(obj) {
+    const clone = JSON.parse(JSON.stringify(obj));
+    if (clone && typeof clone === 'object' && clone.env) {
+        for (const k of Object.keys(clone.env)) {
+            if (/TOKEN|KEY|SECRET|PASSWORD/i.test(k) && typeof clone.env[k] === 'string') {
+                const v = clone.env[k];
+                clone.env[k] = v.length > 4 ? `****${v.slice(-4)}` : '****';
+            }
+        }
+    }
+    return clone;
+}
+export function whichClaude() {
+    return process.env.CCS_CLAUDE_BIN || 'claude';
+}
+/**
+ * 清屏并擦除滚动缓冲，让 claude 接管一个干净窗口——视觉上与直接在命令行运行 claude 一致。
+ * 仅在交互式 TTY 下生效；非 TTY（管道/重定向）时跳过，避免向非终端写入转义序列。
+ */
+function clearScreen() {
+    if (process.stdout.isTTY) {
+        // \x1b[3J 清滚动缓冲，\x1b[H 光标归位，\x1b[2J 清可见屏幕。
+        process.stdout.write('\x1b[3J\x1b[H\x1b[2J');
+    }
+}
+/**
+ * 打印 provider 配置片段与将要执行的命令，不启动 claude。
+ * `--settings` 直接指向 provider 配置文件本身——ccs 不再产出中间文件。
+ * 注意：展示的是 provider 片段，非 claude 最终加载的完整 settings（后者还会与
+ * ~/.claude/settings.json 深合，片段里未出现的 key 由下层继承）。
+ */
+export function dryRun(name, forwardedArgs = []) {
+    const provider = readProvider(name);
+    if (!provider) {
+        throw new Error(t('error.providerMissing', { name }));
+    }
+    const file = providerFile(name);
+    const args = ['--settings', file, ...forwardedArgs];
+    console.log(JSON.stringify(redactSettings(provider), null, 2));
+    console.log(`\n${t('launch.willRun', { cmd: `${whichClaude()} ${args.join(' ')}` })}`);
+    console.log(t('launch.dryTmp', { file }));
+}
+/**
+ * 直接启动 claude，使用 Claude Code 默认配置（~/.claude/settings.json）。
+ * 不做合并、不写临时文件、不记录 lastUsed。
+ */
+export function launchDirect(forwardedArgs = []) {
+    const bin = whichClaude();
+    const args = [...forwardedArgs];
+    // 擦除 ccs 自身 TUI 残留，给 claude 一个干净窗口（等同命令行直接启动）。
+    clearScreen();
+    let res;
+    try {
+        res = spawnSync(bin, args, { stdio: 'inherit', env: process.env });
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            throw new Error(t('error.claudeBin', { bin }));
+        }
+        throw e;
+    }
+    if (res.status !== null && res.status !== 0) {
+        process.exitCode = res.status;
+    }
+}
+/**
+ * 打印 direct 模式将执行的命令，不启动。
+ */
+export function dryRunDirect(forwardedArgs = []) {
+    const bin = whichClaude();
+    const args = [...forwardedArgs];
+    console.log(t('launch.willRun', { cmd: `${bin} ${args.join(' ')}` }));
+    console.log(t('launch.dryDirect'));
+}
+/**
+ * 以 provider 配置文件作为 --settings 目标直接启动 claude（claude 自行与 ~/.claude/settings.json 深合）。
+ * 不解析 provider 对象、不写中间文件、不注入子进程 env——claude 加载 --settings 时自行读取 env。
+ * @param name  供应商名
+ * @param forwardedArgs  透传给 claude 的参数
+ */
+export function launch(name, forwardedArgs = []) {
+    if (!providerExists(name)) {
+        throw new Error(t('error.providerMissing', { name }));
+    }
+    const file = providerFile(name);
+    const bin = whichClaude();
+    const args = ['--settings', file, ...forwardedArgs];
+    setLastUsed(name);
+    // 擦除 ccs 自身 TUI 残留，给 claude 一个干净窗口（等同命令行直接启动）。
+    clearScreen();
+    let res;
+    try {
+        res = spawnSync(bin, args, { stdio: 'inherit', env: process.env });
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            throw new Error(t('error.claudeBin', { bin }));
+        }
+        throw e;
+    }
+    if (res.status !== null && res.status !== 0) {
+        process.exitCode = res.status;
+    }
+}

package/dist/picker.d.ts

@@ -0,0 +1,24 @@
+/** picker 的一项。 */
+export interface PickerItem<T> {
+    value: T;
+    label: string;
+    hint?: string;
+}
+export interface PickerOpts<T> {
+    message: string;
+    /** 可过滤、可滚动的列表（如供应商配置）。 */
+    items: ReadonlyArray<PickerItem<T>>;
+    /** 固定在下方、不过滤的操作项（如 direct/create/edit/remove）。 */
+    actions?: ReadonlyArray<PickerItem<T>>;
+    /** 初始高亮项（按值相等定位）。 */
+    initialValue?: T;
+    /** items 区最多可见行数，默认 5。 */
+    maxItems?: number;
+    /** 顶部状态横幅（如 edit/remove 后的 ✓ Updated xxx）；仅显示一个菜单周期。 */
+    statusMessage?: string;
+}
+/**
+ * 搜索选择器（ink）：items 区可过滤可滚动，actions 区固定不过滤。
+ * ↑↓ 选择、Enter 确认、Esc 取消（抛 Cancel）。
+ */
+export declare function runPicker<T>(opts: PickerOpts<T>): Promise<T>;