@wayfarer35/ccs 0.2.2

package/dist/picker.js

@@ -0,0 +1,153 @@
+import { Box, render, Text, useInput, useStdout } from 'ink';
+import React, { useEffect, useMemo, useState } from 'react';
+import { t } from './i18n.js';
+import { Cancel } from './tui.js';
+import { clearScreen } from './screen.js';
+const h = React.createElement;
+function PickerApp({ message, items, actions, initialIndex, maxItems, statusMessage, onDone, onCancel }) {
+    const [filter, setFilter] = useState('');
+    const [index, setIndex] = useState(initialIndex);
+    const { stdout } = useStdout();
+    const cols = stdout && stdout.columns ? stdout.columns : 60;
+    // items 区按 label+hint 大小写不敏感包含匹配；actions 区不过滤。
+    const filtered = useMemo(() => {
+        const q = filter.trim().toLowerCase();
+        if (!q)
+            return items;
+        return items.filter((it) => {
+            const hay = `${it.label} ${it.hint ?? ''}`.toLowerCase();
+            return hay.includes(q);
+        });
+    }, [items, filter]);
+    // 合并可见列表：过滤后的 items ++ 全部 actions（单一光标贯穿）。
+    const combined = useMemo(() => [...filtered, ...actions], [filtered, actions]);
+    // 光标闪烁
+    const [blinkOn, setBlinkOn] = useState(true);
+    useEffect(() => {
+        const id = setInterval(() => setBlinkOn((b) => !b), 530);
+        return () => clearInterval(id);
+    }, []);
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.return) {
+            const it = combined[Math.min(index, combined.length - 1)];
+            if (it)
+                onDone(it.value);
+            return;
+        }
+        // Tab：在 items 区与 actions 区之间跳转（区域捷径，免得供应商多时连续 ↓）。
+        // 区域由当前光标位置派生（index < filtered.length ⇒ items 区），无需单独状态。
+        if (key.tab) {
+            const cur = Math.min(index, combined.length - 1);
+            const inItems = cur < filtered.length;
+            if (inItems) {
+                if (actions.length)
+                    setIndex(filtered.length);
+            }
+            else {
+                if (filtered.length)
+                    setIndex(0);
+            }
+            return;
+        }
+        if (key.upArrow) {
+            setIndex((i) => Math.max(0, i - 1));
+            return;
+        }
+        if (key.downArrow) {
+            setIndex((i) => Math.min(combined.length - 1, i + 1));
+            return;
+        }
+        // ink 把 \x7f（Linux/WSL 的 Backspace）映射成 key.delete；与 Delete 一并按退格处理。
+        // 打字/退格只影响 filter（仅过滤 items 区）；光标重置到首位（标准 fuzzy 行为）。
+        if (key.backspace || key.delete) {
+            setFilter((f) => f.slice(0, -1));
+            setIndex(0);
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            let s = '';
+            for (const ch of input) {
+                if (ch.charCodeAt(0) >= 32)
+                    s += ch;
+            }
+            if (s) {
+                setFilter((f) => f + s);
+                setIndex(0);
+            }
+        }
+    });
+    const safeIndex = combined.length ? Math.min(index, combined.length - 1) : 0;
+    // items 区滚动窗口：仅在 items 区滚动，actions 区始终全部显示。
+    const cursorInItems = safeIndex < filtered.length;
+    let startIdx = 0;
+    if (filtered.length > maxItems) {
+        if (cursorInItems) {
+            startIdx = Math.max(0, Math.min(safeIndex - Math.floor(maxItems / 2), filtered.length - maxItems));
+        }
+        else {
+            // 光标在 actions 区 → 显示 items 区最后一页，紧接 actions。
+            startIdx = Math.max(0, filtered.length - maxItems);
+        }
+    }
+    const visibleFiltered = filtered.slice(startIdx, startIdx + maxItems);
+    const renderRow = (it, abs, sel) => {
+        const style = sel ? { backgroundColor: 'cyan', color: 'black' } : {};
+        return h(Box, { key: abs, flexDirection: 'row' }, h(Text, style, `${sel ? '▸ ' : '  '}${it.label}`), it.hint
+            ? h(Text, sel ? { backgroundColor: 'cyan', color: 'black' } : { dimColor: true }, `  ${it.hint}`)
+            : null);
+    };
+    const hasItems = items.length > 0;
+    return h(Box, { flexDirection: 'column' }, statusMessage
+        ? h(Text, { color: 'green' }, `✓ ${statusMessage}`)
+        : null, h(Text, { color: 'cyan', bold: true }, message), h(Text, { dimColor: true }, '─'.repeat(Math.min(cols, 64))), 
+    // 过滤输入框：仅当存在可过滤的 items 时显示。
+    hasItems
+        ? h(Box, { flexDirection: 'row' }, h(Text, { color: 'cyan' }, '▸ '), filter
+            ? h(Text, { color: 'cyan' }, filter)
+            : h(Text, { dimColor: true }, t('picker.placeholder')), h(Text, { color: 'cyan' }, blinkOn ? '▏' : ' '))
+        : null, 
+    // items 区（可过滤、可滚动）
+    hasItems
+        ? h(Box, { flexDirection: 'column' }, h(Text, { dimColor: true }, t('picker.providers', { count: filtered.length })), visibleFiltered.length
+            ? visibleFiltered.map((it, i) => renderRow(it, startIdx + i, startIdx + i === safeIndex))
+            : h(Text, { dimColor: true }, '  ' + t('picker.noMatch')), filtered.length > maxItems
+            ? h(Text, { dimColor: true }, `  (${startIdx + 1}-${startIdx + visibleFiltered.length}/${filtered.length})`)
+            : null)
+        : null, 
+    // actions 区（固定、不过滤）
+    actions.length
+        ? h(Box, { flexDirection: 'column' }, h(Text, { dimColor: true }, t('picker.actions')), ...actions.map((it, i) => renderRow(it, filtered.length + i, filtered.length + i === safeIndex)))
+        : null, h(Text, { dimColor: true }, t('picker.help')));
+}
+/**
+ * 搜索选择器（ink）：items 区可过滤可滚动，actions 区固定不过滤。
+ * ↑↓ 选择、Enter 确认、Esc 取消（抛 Cancel）。
+ */
+export async function runPicker(opts) {
+    const { message, items, actions = [], initialValue, maxItems = 5, statusMessage } = opts;
+    const arr = [...items];
+    const act = [...actions];
+    const combined = [...arr, ...act];
+    let initialIndex = 0;
+    if (initialValue !== undefined) {
+        const i = combined.findIndex((it) => it.value === 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()); };
+        // 泛型函数组件在 createElement 处无法推断 T，显式具化后再渲染。
+        const App = PickerApp;
+        const props = { message, items: arr, actions: act, initialIndex, maxItems, onDone, onCancel };
+        if (statusMessage !== undefined)
+            props.statusMessage = statusMessage;
+        clearScreen();
+        inst = render(h(App, props));
+    });
+}

package/dist/presets.d.ts

@@ -0,0 +1,13 @@
+import type { Preset } from './types.js';
+export declare const CUSTOM_KEY = "__custom__";
+export declare function loadBuiltinPresets(): Record<string, Preset>;
+export declare function loadUserPresets(): Record<string, Preset>;
+/**
+ * 合并内置预设与用户预设（~/.ccs/presets.json），用户可覆盖同名预设或新增。
+ * 返回 { key: preset }，附带 CUSTOM 选项由调用方处理。
+ */
+export declare function getPresets(): Record<string, Preset>;
+export declare function getPreset(key: string): Preset | null;
+export declare function presetList(): Array<{
+    key: string;
+} & Preset>;

package/dist/presets.js

@@ -0,0 +1,29 @@
+import { readJSON } from './config.js';
+import builtinPresets from './presets.json' with { type: 'json' };
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const USER_PRESETS_FILE = join(homedir(), '.ccs', 'presets.json');
+export const CUSTOM_KEY = '__custom__';
+export function loadBuiltinPresets() {
+    return builtinPresets;
+}
+export function loadUserPresets() {
+    return readJSON(USER_PRESETS_FILE, {}) || {};
+}
+/**
+ * 合并内置预设与用户预设（~/.ccs/presets.json），用户可覆盖同名预设或新增。
+ * 返回 { key: preset }，附带 CUSTOM 选项由调用方处理。
+ */
+export function getPresets() {
+    const user = loadUserPresets();
+    return { ...builtinPresets, ...user };
+}
+export function getPreset(key) {
+    if (key === CUSTOM_KEY || !key)
+        return null;
+    return getPresets()[key] || null;
+}
+export function presetList() {
+    const all = getPresets();
+    return Object.entries(all).map(([key, p]) => ({ key, ...p }));
+}

package/dist/presets.json

@@ -0,0 +1,314 @@
+{
+    "ark-coding-plan": {
+        "label": "Ark 火山引擎 Coding Plan",
+        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding",
+        "model": {
+            "support": [
+                "ark-code-latest",
+                "doubao-seed-2.0-code",
+                "doubao-seed-2.0-pro",
+                "doubao-seed-2.0-lite",
+                "doubao-seed-code",
+                "minimax-m2.7",
+                "minimax-m3",
+                "glm-5.2",
+                "deepseek-v4-flash",
+                "deepseek-v4-pro",
+                "kimi-k2.6",
+                "kimi-k2.7"
+            ],
+            "default": "ark-code-latest",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "minimax-m3",
+                "sonnet": "deepseek-v4-pro[1m]",
+                "opus": "glm-5.2[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "ark-agent-plan": {
+        "label": "Ark 火山引擎 Agent Plan",
+        "baseUrl": "https://ark.cn-beijing.volces.com/api/plan",
+        "model": {
+            "support": [
+                "ark-code-latest",
+                "doubao-seed-2.0-code",
+                "doubao-seed-2.0-pro",
+                "doubao-seed-2.0-lite",
+                "doubao-seed-2.0-mini",
+                "doubao-seed-code",
+                "doubao-seed-2.0-pro",
+                "minimax-m2.7",
+                "minimax-m3",
+                "glm-5.2",
+                "deepseek-v4-flash",
+                "deepseek-v4-pro",
+                "kimi-k2.6",
+                "kimi-k2.7"
+            ],
+            "default": "ark-code-latest",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "minimax-m3",
+                "sonnet": "deepseek-v4-pro[1m]",
+                "opus": "glm-5.2[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "bigmodel-coding-plan": {
+        "label": "Bigmodel 智谱 Coding Plan",
+        "baseUrl": "https://open.bigmodel.cn/api/anthropic",
+        "model": {
+            "default": "glm-5.2[1m]",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "glm-4.7",
+                "sonnet": "glm-5.2[1m]",
+                "opus": "glm-5.2[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "bailian-coding-plan": {
+        "label": "Bailian 阿里百炼 Coding Plan",
+        "baseUrl": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
+        "model": {
+            "support": [
+                "qwen3.7-plus",
+                "qwen3.6-plus",
+                "kimi-k2.5",
+                "glm-5",
+                "MiniMax-M2.5",
+                "qwen3.5-plus",
+                "qwen3-max-2026-01-23",
+                "qwen3-coder-next",
+                "qwen3-coder-plus",
+                "glm-4.7"
+            ],
+            "default": "qwen3.6-plus",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "MiniMax-M2.5",
+                "sonnet": "qwen3.6-plus",
+                "opus": "qwen3.7-plus",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "bailian-token-plan": {
+        "label": "Bailian 阿里百炼 Token Plan",
+        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
+        "model": {
+            "support": [
+                "qwen3.7-max",
+                "qwen3.7-plus",
+                "qwen3.6-plus",
+                "qwen3.6-flash",
+                "deepseek-v4-pro",
+                "deepseek-v4-flash",
+                "deepseek-v3.2",
+                "kimi-k2.7-code",
+                "kimi-k2.6",
+                "kimi-k2.5",
+                "glm-5.2",
+                "glm-5.1",
+                "glm-5",
+                "MiniMax-M2.5"
+            ],
+            "default": "qwen3.7-max",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "qwen3.6-flash",
+                "sonnet": "qwen3.7-max",
+                "opus": "qwen3.7-max",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "deepseek-api": {
+        "label": "DeepSeek 深度求索 Api",
+        "baseUrl": "https://api.deepseek.com/anthropic",
+        "model": {
+            "default": "deepseek-v4-flash",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "deepseek-v4-flash",
+                "sonnet": "deepseek-v4-pro[1m]",
+                "opus": "deepseek-v4-pro[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "mimo-api": {
+        "label": "MiMo 小米 Api",
+        "baseUrl": "https://api.xiaomimimo.com/anthropic",
+        "model": {
+            "default": "mimo-v2.5-flash",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "mimo-v2.5-flash",
+                "sonnet": "mimo-v2.5-pro[1m]",
+                "opus": "mimo-v2.5-pro[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "mimo-token-plan": {
+        "label": "MiMo 小米 Token Plan",
+        "baseUrl": "https://token-plan-cn.xiaomimimo.com/anthropic",
+        "model": {
+            "default": "mimo-v2.5-flash",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "mimo-v2.5-flash",
+                "sonnet": "mimo-v2.5-pro[1m]",
+                "opus": "mimo-v2.5-pro[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "qianfan-coding-plan": {
+        "label": "Qianfan 百度千帆 Coding Plan",
+        "baseUrl": "https://qianfan.baidubce.com/anthropic/coding",
+        "model": {
+            "support": [
+                "deepseek-v3.2",
+                "deepseek-v4-flash",
+                "deepseek-v4-pro",
+                "ernie-4.5-turbo-20260402",
+                "glm-5",
+                "glm-5.1",
+                "kimi-k2.5"
+            ],
+            "default": "deepseek-v4-flash",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "deepseek-v4-flash",
+                "sonnet": "glm-5.1",
+                "opus": "deepseek-v4-pro[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "spark-coding-plan": {
+        "label": "Spark 讯飞星辰 Coding Plan",
+        "baseUrl": "https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic",
+        "model": {
+            "support": [
+                "astron-code-latest",
+                "xsparkx2",
+                "xsparkx2flash",
+                "xopglm51",
+                "xopglm5",
+                "xopdeepseekv4pro",
+                "xopdeepseekv4flash",
+                "xopdeepseekv32",
+                "xopkimik26",
+                "xopkimik25",
+                "xminimaxm25",
+                "xopqwen35397b",
+                "xopqwen36v35b",
+                "xopqwen35v35b",
+                "xop3qwencodernext",
+                "xopglmv47flash"
+            ],
+            "default": "astron-code-latest",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "astron-code-latest",
+                "sonnet": "xopglm51",
+                "opus": "xopdeepseekv4pro[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    },
+    "spark-token-plan": {
+        "label": "Spark 讯飞星辰 Token Plan",
+        "baseUrl": "https://maas-token-api.cn-huabei-1.xf-yun.com/anthropic",
+        "model": {
+            "support": [
+                "astron-code-latest",
+                "xsparkx2",
+                "xsparkx2flash",
+                "xopglm51",
+                "xopglm5",
+                "xopdeepseekv4pro",
+                "xopdeepseekv4flash",
+                "xopdeepseekv32",
+                "xopkimik26",
+                "xopkimik25",
+                "xminimaxm25",
+                "xopqwen35397b",
+                "xopqwen36v35b",
+                "xopqwen35v35b",
+                "xop3qwencodernext",
+                "xopglmv47flash"
+            ],
+            "default": "astron-code-latest",
+            "tier": "opus",
+            "tiers": {
+                "haiku": "astron-code-latest",
+                "sonnet": "xopglm51",
+                "opus": "xopdeepseekv4pro[1m]",
+                "fable": ""
+            }
+        },
+        "options": {
+            "attributionHeader": false,
+            "disableNonEssentialTraffic": true,
+            "autoCompactWindow": 1000000
+        }
+    }
+}

package/dist/screen.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 清屏 helper：擦除当前视口并将光标归位，**保留 scrollback**（历史可上滚）。
+ *
+ * 为什么需要：ink 默认（非 experimental）模式不在首次渲染时清屏，且卸载时
+ * 保留最后一帧（log.done()）。连续的 ink 屏幕（picker → 选预设 → 表单 …）
+ * 因此向下堆叠。每个顶层屏幕在 render() 前调用本函数，即可让视口一次只见一屏。
+ *
+ * 用 `\x1b[2J\x1b[H`（擦视口 + 归位）而非 `\x1b[3J`（清 scrollback）——
+ * 后者会抹掉终端历史，过度破坏；"页面独占"只需视口干净。
+ * 直接写 process.stdout，绕过 ink 的 patchConsole。
+ */
+export declare function clearScreen(): void;

package/dist/screen.js

@@ -0,0 +1,14 @@
+/**
+ * 清屏 helper：擦除当前视口并将光标归位，**保留 scrollback**（历史可上滚）。
+ *
+ * 为什么需要：ink 默认（非 experimental）模式不在首次渲染时清屏，且卸载时
+ * 保留最后一帧（log.done()）。连续的 ink 屏幕（picker → 选预设 → 表单 …）
+ * 因此向下堆叠。每个顶层屏幕在 render() 前调用本函数，即可让视口一次只见一屏。
+ *
+ * 用 `\x1b[2J\x1b[H`（擦视口 + 归位）而非 `\x1b[3J`（清 scrollback）——
+ * 后者会抹掉终端历史，过度破坏；"页面独占"只需视口干净。
+ * 直接写 process.stdout，绕过 ink 的 patchConsole。
+ */
+export function clearScreen() {
+    process.stdout.write('\x1b[2J\x1b[H');
+}

package/dist/tui.d.ts

@@ -0,0 +1,24 @@
+import { runPicker } from './picker.js';
+import { inkSelect, inkText, inkConfirm } from './inkPrompts.js';
+/** 用户取消时抛出，由顶层捕获统一退出。 */
+export declare class Cancel extends Error {
+    constructor();
+}
+export declare const ui: {
+    /** 取消提示（如顶层 Cancel 兜底）。纯 console 输出一行。 */
+    cancel: (t: string) => void;
+    log: {
+        message: (t: string) => void;
+        info: (t: string) => void;
+        step: (t: string) => void;
+        warning: (t: string) => void;
+        error: (t: string) => void;
+    };
+    /** 搜索选择器（ink）：输入过滤 + 可滚动下拉。 */
+    picker: typeof runPicker;
+    /** ink 版 select/text/confirm：交互提示一律用 ink。 */
+    inkSelect: typeof inkSelect;
+    inkText: typeof inkText;
+    inkConfirm: typeof inkConfirm;
+};
+export type { PickerItem, PickerOpts } from './picker.js';

package/dist/tui.js

@@ -0,0 +1,25 @@
+import { runPicker } from './picker.js';
+import { inkSelect, inkText, inkConfirm } from './inkPrompts.js';
+/** 用户取消时抛出，由顶层捕获统一退出。 */
+export class Cancel extends Error {
+    constructor() { super('cancel'); this.name = 'Cancel'; }
+}
+// 交互层完全由 ink 承担（runPicker / inkSelect / inkText / inkConfirm / 表单）。
+// 此处仅保留 ui 表面：cancel/log 走纯 console（不进 raw mode），其余交互一律 ink。
+export const ui = {
+    /** 取消提示（如顶层 Cancel 兜底）。纯 console 输出一行。 */
+    cancel: (t) => console.log(t),
+    log: {
+        message: (t) => console.log(t),
+        info: (t) => console.info(t),
+        step: (t) => console.log(t),
+        warning: (t) => console.warn(t),
+        error: (t) => console.error(t),
+    },
+    /** 搜索选择器（ink）：输入过滤 + 可滚动下拉。 */
+    picker: runPicker,
+    /** ink 版 select/text/confirm：交互提示一律用 ink。 */
+    inkSelect,
+    inkText,
+    inkConfirm,
+};

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 共享类型契约。
+ *
+ * ccs 的数据模型三层边界：
+ * - Preset / ProviderOptions：从 presets.json / 用户 presets 读入的预设结构
+ * - FormState：表单状态机，判别联合 mode: 'alias' | 'single'
+ * - ProviderSettings：写进 provider 配置、最终透传给 claude --settings 的片段
+ */
+/** Claude Code 模型档位（与 /model 选择器对应）。 */
+export type Tier = 'opus' | 'sonnet' | 'haiku' | 'fable';
+/** 推理强度档位（对应 CLAUDE_CODE_EFFORT_LEVEL）。 */
+export type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+/** 三项 CLAUDE_CODE_* 配置 + ccs 启动开关，存于 provider 配置。 */
+export interface ProviderOptions {
+    attributionHeader: boolean;
+    disableNonEssentialTraffic: boolean;
+    autoCompactWindow: number;
+    effort: EffortLevel;
+}
+/** 模型元信息：供应商支持列表、默认模型、档位配置。 */
+export interface ModelMeta {
+    /** 供应商支持的全部模型列表（用于 UI 展示）。 */
+    support?: string[];
+    /** 单模型模式的主模型。 */
+    default?: string;
+    /** 默认档位（如 'opus'）。 */
+    tier?: string;
+    /** 档位别名：haiku/sonnet/opus/fable → modelId。 */
+    tiers?: Partial<Record<Tier, string>>;
+}
+/** 内置/用户预设结构。model 字段统一为 ModelMeta。 */
+export interface Preset {
+    label: string;
+    baseUrl: string;
+    model?: ModelMeta;
+    options?: Partial<ProviderOptions>;
+}
+/**
+ * 写进 provider 配置、最终透传给 claude --settings 的片段。
+ * - env：环境变量（API key、base url、各档位别名、CLAUDE_CODE_* 等）
+ * - model：仅 alias 模式下记录初始档位（供 ccs 启动参数与菜单展示）
+ */
+export interface ProviderSettings {
+    env: Record<string, string>;
+    model?: Tier;
+}
+/** 表单模式：档位别名（多模型）或单一模型。 */
+export type FormMode = 'alias' | 'single';
+/** 认证方式。 */
+export type AuthMethod = 'auth_token' | 'api_key';
+/** 表单运行态。initState 构造、buildResult 消费、validateState 校验。 */
+export interface FormState {
+    baseUrl: string;
+    existingKey: string;
+    apiKey: string;
+    keepExistingKey: boolean;
+    mode: FormMode;
+    authMethod: AuthMethod;
+    tier: string;
+    /** ALIAS_TIERS → 模型 id（别名模式）。 */
+    aliases: Record<string, string>;
+    singleModel: string;
+    options: ProviderOptions;
+    /** 原始 JSON 字符串，提交时解析合并到 env。 */
+    customParams: string;
+}
+/** 表单提交结果，等价于 ProviderSettings 片段。 */
+export type FormResult = ProviderSettings;

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * 共享类型契约。
+ *
+ * ccs 的数据模型三层边界：
+ * - Preset / ProviderOptions：从 presets.json / 用户 presets 读入的预设结构
+ * - FormState：表单状态机，判别联合 mode: 'alias' | 'single'
+ * - ProviderSettings：写进 provider 配置、最终透传给 claude --settings 的片段
+ */
+export {};

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare function getVersion(): string;