@ai-zen/cli 1.0.0-alpha.2 → 1.0.0-alpha.22

package/dist/tui/screens/use-input-editing.js

@@ -0,0 +1,192 @@
+// 输入编辑 —— 草稿文本与光标、历史、kill ring、撤销栈、暂存区的唯一实现
+//
+// 从 `chat.tsx` 抽出来的理由：这一整块（`input` / `cursor` / `history` / kill ring /
+// undo / stash + 20 个编辑动作）是**纯编辑器语义**，与「对话屏」毫无关系，却和会话、
+// 向导、渲染挤在同一个组件里 —— 于是既不能单测，也每次都被误认为「对话的一部分」。
+//
+// 两条贯穿全篇的约定：
+//
+//   1. **按字素簇编辑**：所有位置计算都走 `graphemes()`。`❤️` 是 2 个 code point、
+//      `👨‍👩‍👧` 是 5 个，但它们都是**一个**字符 —— 按 code point 删会切出半个字素簇。
+//   2. **纯函数算、hook 只套用**：具体「删哪个词、删到哪」在 `input.ts` /
+//      `input-editing.ts` 里（有独立测试），这里只负责「拿到结果 → 更新状态 + 记撤销」。
+import { useRef, useState } from "react";
+import { deleteToLineEnd, deleteToLineStart, deleteWordLeft, deleteWordRight, wordLeft, wordRight, } from "./input.js";
+import { deleteToPrevWhitespace, killedText, killAt, popUndo, pushKill, pushUndo, } from "../input-editing.js";
+import { graphemes } from "../text.js";
+import { t } from "../../i18n/index.js";
+export function useInputEditing({ initialText, notify }) {
+    const [input, setInput] = useState(initialText ?? "");
+    const [cursor, setCursor] = useState(graphemes(initialText ?? "").length);
+    const [history, setHistory] = useState([]);
+    /** 历史游标：-1 = 不在浏览历史（当前是草稿） */
+    const historyIndex = useRef(-1);
+    /** kill ring：Ctrl+W/U/K 删掉的文本，Ctrl+Y 取回、Alt+Y 循环 */
+    const killRingRef = useRef([]);
+    const yankIndexRef = useRef(-1);
+    /** 编辑撤销栈（Ctrl+_） */
+    const undoStackRef = useRef([]);
+    /** 暂存区（Ctrl+S） */
+    const stashRef = useRef(null);
+    const setInputText = (text) => {
+        setInput(text);
+        setCursor(graphemes(text).length);
+    };
+    /**
+     * 取「当前文本 + 钳制后的光标」，所有编辑动作的统一起点。
+     *
+     * 钳制防的**不是**「cursor 越界」——`cursor` 的每个写入点都已保证落在 `[0, len]`；
+     * 防的是**文本与光标不同步**：`input` 与 `cursor` 是两个 state，任何一处只改其一
+     * （或将来新增编辑动作忘了同步）都会让 `cp > chars.length` 成立，那时 `slice`
+     * 会静默切少、`cp - 1` 会变负。钳一下把后果限制在「本次编辑落点不对」。
+     */
+    const clampCursor = () => {
+        const chars = graphemes(input);
+        return { chars, cp: Math.max(0, Math.min(cursor, chars.length)) };
+    };
+    const insertAtCursor = (text) => {
+        const { chars, cp } = clampCursor();
+        setInput(chars.slice(0, cp).join("") + text + chars.slice(cp).join(""));
+        setCursor(cp + graphemes(text).length);
+    };
+    const deleteBeforeCursor = () => {
+        const { chars, cp } = clampCursor();
+        if (cp === 0)
+            return;
+        setInput(chars.slice(0, cp - 1).join("") + chars.slice(cp).join(""));
+        setCursor(cp - 1);
+    };
+    const deleteAfterCursor = () => {
+        const { chars, cp } = clampCursor();
+        if (cp >= chars.length)
+            return;
+        setInput(chars.slice(0, cp).join("") + chars.slice(cp + 1).join(""));
+    };
+    /** 套用纯函数算好的「文本 + 光标」结果（无变化则不触发重渲染，也不进撤销栈） */
+    const applyEdit = (r) => {
+        if (r.text === input && r.cursor === cursor)
+            return;
+        undoStackRef.current = pushUndo(undoStackRef.current, { text: input, cursor });
+        setInput(r.text);
+        setCursor(r.cursor);
+    };
+    /** 删除类编辑：额外把删掉的文本放进 kill ring（Ctrl+Y 可取回） */
+    const applyKill = (r) => {
+        if (r.text === input && r.cursor === cursor)
+            return;
+        killRingRef.current = pushKill(killRingRef.current, killedText(input, r.text));
+        yankIndexRef.current = -1;
+        applyEdit(r);
+    };
+    const yank = (advance) => {
+        const ring = killRingRef.current;
+        if (ring.length === 0)
+            return;
+        const next = advance ? yankIndexRef.current + 1 : 0;
+        // 只用 `killAt` 的 undefined 做越界守卫（环已到头），不再先判一遍 `next >= ring.length`
+        const text = killAt(ring, next);
+        if (text === undefined)
+            return;
+        yankIndexRef.current = next;
+        insertAtCursor(text);
+    };
+    const undoEdit = () => {
+        const popped = popUndo(undoStackRef.current);
+        if (!popped)
+            return;
+        undoStackRef.current = popped.rest;
+        setInput(popped.state.text);
+        setCursor(popped.state.cursor);
+    };
+    const toggleStash = () => {
+        if (input.length > 0) {
+            stashRef.current = { text: input, cursor };
+            setInputText("");
+            notify(t("notice.draftSaved"));
+            return;
+        }
+        const stashed = stashRef.current;
+        if (!stashed)
+            return;
+        stashRef.current = null;
+        setInput(stashed.text);
+        setCursor(stashed.cursor);
+        notify(t("notice.draftRestored"));
+    };
+    const moveCursor = (delta) => {
+        const len = graphemes(input).length;
+        setCursor((c) => Math.max(0, Math.min(len, c + delta)));
+    };
+    const moveCursorByWord = (dir) => {
+        setCursor(dir === -1 ? wordLeft(input, cursor) : wordRight(input, cursor));
+    };
+    const moveCursorToLineStart = () => {
+        const { chars, cp } = clampCursor();
+        let i = cp;
+        while (i > 0 && chars[i - 1] !== "\n")
+            i -= 1;
+        setCursor(i);
+    };
+    const moveCursorToLineEnd = () => {
+        const { chars, cp } = clampCursor();
+        let i = cp;
+        while (i < chars.length && chars[i] !== "\n")
+            i += 1;
+        setCursor(i);
+    };
+    // 历史浏览：「上一条」从最新开始往回走，「下一条」走到底就回到空草稿。
+    // 上下两处按键（Ctrl+P/N 与 ↑/↓）共用这一对，不再各写一遍。
+    const historyPrev = () => {
+        if (history.length === 0)
+            return;
+        const idx = historyIndex.current < 0 ? history.length - 1 : Math.max(0, historyIndex.current - 1);
+        historyIndex.current = idx;
+        setInputText(history[idx]);
+    };
+    const historyNext = () => {
+        if (historyIndex.current < 0)
+            return;
+        const idx = historyIndex.current + 1;
+        if (idx >= history.length) {
+            historyIndex.current = -1;
+            setInputText("");
+            return;
+        }
+        historyIndex.current = idx;
+        setInputText(history[idx]);
+    };
+    const clearDraft = () => {
+        setInput("");
+        setCursor(0);
+        historyIndex.current = -1;
+    };
+    const rememberSubmitted = (text) => {
+        setHistory((h) => [...h, text]);
+        historyIndex.current = -1;
+    };
+    return {
+        input,
+        cursor,
+        setInputText,
+        insertAtCursor,
+        deleteBeforeCursor,
+        deleteAfterCursor,
+        deleteWordBeforeCursor: () => applyKill(deleteWordLeft(input, cursor)),
+        deleteWordAfterCursor: () => applyKill(deleteWordRight(input, cursor)),
+        deleteToStartOfLine: () => applyKill(deleteToLineStart(input, cursor)),
+        deleteToEndOfLine: () => applyKill(deleteToLineEnd(input, cursor)),
+        deletePrevWhitespace: () => applyKill(deleteToPrevWhitespace(input, cursor)),
+        yank,
+        undoEdit,
+        toggleStash,
+        moveCursor,
+        moveCursorToLineStart,
+        moveCursorToLineEnd,
+        moveCursorByWord,
+        historyPrev,
+        historyNext,
+        clearDraft,
+        rememberSubmitted,
+    };
+}
+//# sourceMappingURL=use-input-editing.js.map

package/dist/tui/screens/use-input-editing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-input-editing.js","sourceRoot":"","sources":["../../../src/tui/screens/use-input-editing.ts"],"names":[],"mappings":"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"}

package/dist/tui/screens/use-overlays.d.ts

@@ -0,0 +1,25 @@
+import { type Dispatch, type SetStateAction } from "react";
+import type { SelectItem } from "../components.js";
+/** 确认框请求：`question` 上屏，用户作答后由 `resolve` 结算 */
+export interface ConfirmState {
+    question: string;
+    resolve: (value: boolean) => void;
+}
+/** 选择器请求：`items` 上屏，用户选中 / 取消后由 `resolve` 结算（取消为 `null`） */
+export interface PickerState {
+    title: string;
+    items: SelectItem<string>[];
+    resolve: (value: string | null) => void;
+}
+export interface ChatOverlays {
+    confirmState: ConfirmState | null;
+    pickerState: PickerState | null;
+    /** 命令层推送覆盖层用（`runCommand` / `chooseHandoffMode` 的入参类型） */
+    setConfirmState: Dispatch<SetStateAction<ConfirmState | null>>;
+    setPickerState: Dispatch<SetStateAction<PickerState | null>>;
+    /** 作答：结算 Promise 并关掉覆盖层（无覆盖层时为空操作） */
+    resolveConfirm: (value: boolean) => void;
+    resolvePicker: (value: string | null) => void;
+}
+export declare function useChatOverlays(): ChatOverlays;
+//# sourceMappingURL=use-overlays.d.ts.map

package/dist/tui/screens/use-overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlays.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/use-overlays.ts"],"names":[],"mappings":"AAWA,OAAO,EAAyB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,0DAA0D;IAC1D,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7D,sCAAsC;IACtC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/C;AAED,wBAAgB,eAAe,IAAI,YAAY,CAqB9C"}

package/dist/tui/screens/use-overlays.js

@@ -0,0 +1,32 @@
+// 覆盖层（确认框 / 选择器）—— 「弹一个、答一个、再关掉」的唯一实现
+//
+// 两种覆盖层共用同一套契约：调用方给一个 `resolve` 回调，拿到一个 Promise，
+// **用户在覆盖层上作答后 Promise 才结算**。这正是命令处理器能写成
+// `const ok = await confirm(...)` 的原因。
+//
+// 从 `chat.tsx` 抽出来的理由：这套 `resolve` 生命周期被埋在 God Component 里，
+// 既没法单测（要从键盘打到命令层才能碰到），也容易被下一个人的 `setState` 写出
+// 「先清状态、后调 resolve」的竞态。抽出来后：
+//   · 关状态与调 resolve 在**同一次**函数式更新里完成，不会读到过期状态；
+//   · 已经是 `null` 时重复 resolve 是安全空操作（Esc 连按不会炸）。
+import { useCallback, useState } from "react";
+export function useChatOverlays() {
+    const [confirmState, setConfirmState] = useState(null);
+    const [pickerState, setPickerState] = useState(null);
+    // 用函数式更新而不是闭包里的 `confirmState`：连按两下 Esc / 两个键同一帧到达时，
+    // 第二次更新仍能看到「已被第一次清掉」的真实状态，不会重复 resolve。
+    const resolveConfirm = useCallback((value) => {
+        setConfirmState((cs) => {
+            cs?.resolve(value);
+            return null;
+        });
+    }, []);
+    const resolvePicker = useCallback((value) => {
+        setPickerState((ps) => {
+            ps?.resolve(value);
+            return null;
+        });
+    }, []);
+    return { confirmState, pickerState, setConfirmState, setPickerState, resolveConfirm, resolvePicker };
+}
+//# sourceMappingURL=use-overlays.js.map

package/dist/tui/screens/use-overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlays.js","sourceRoot":"","sources":["../../../src/tui/screens/use-overlays.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,iDAAiD;AACjD,yCAAyC;AACzC,uCAAuC;AACvC,EAAE;AACF,4DAA4D;AAC5D,+CAA+C;AAC/C,6BAA6B;AAC7B,+CAA+C;AAC/C,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAsC,MAAM,OAAO,CAAC;AA2BlF,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAsB,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAEzE,qDAAqD;IACrD,wCAAwC;IACxC,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,KAAc,EAAE,EAAE;QACpD,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE;YACrB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,KAAoB,EAAE,EAAE;QACzD,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE;YACpB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AACvG,CAAC"}

package/dist/tui/screens/use-wizard-host.d.ts

@@ -0,0 +1,35 @@
+import type { AppConfig, ReasoningPresets } from "@ai-zen/agents-sdk";
+import { type AgentStore } from "../../agents-store.js";
+import type { McpSnapshot, WizardCloseResult, WizardStep } from "../config-wizard/index.js";
+import type { Notice } from "./notice.js";
+export interface WizardHostDeps {
+    /** 当前模型 id：`/key` 直达它所用端点的密钥；也是「当前端点是否被改动」的比较基准 */
+    modelId: string;
+    /** 通知出口（读写失败、变更摘要都从这里出去，不进食转录） */
+    notify: (text: string, tone?: Notice["tone"]) => void;
+    /** 会话是否已建好（未建好时改配置只能重启） */
+    hasSession: () => boolean;
+    /** 会话还没建好就改了配置 → 只能重启进程让新配置生效 */
+    restart: () => void;
+    /** 改了当前端点 / MCP / Agent 定义 → 重载会话（消息保留） */
+    reloadSession: () => void;
+}
+export interface WizardHost {
+    wizardStep: WizardStep | null;
+    wizardConfig: AppConfig | null;
+    wizardPresets: ReasoningPresets;
+    wizardAgents: {
+        id: string;
+        name: string;
+    }[];
+    wizardMcp: McpSnapshot | null;
+    wizardAgentStore: AgentStore | null;
+    /** 打开向导：先读齐快照再接管整屏（读失败则只报错、不进向导） */
+    openWizard: (step: WizardStep) => Promise<void>;
+    /** `/key`：直达当前模型所用端点的 API Key 编辑步骤 */
+    openKeyEditor: () => Promise<void>;
+    /** 向导关闭：渲染变更摘要，并让改动生效 */
+    closeWizard: (result: WizardCloseResult) => void;
+}
+export declare function useWizardHost({ modelId, notify, hasSession, restart, reloadSession, }: WizardHostDeps): WizardHost;
+//# sourceMappingURL=use-wizard-host.d.ts.map

package/dist/tui/screens/use-wizard-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-wizard-host.d.ts","sourceRoot":"","sources":["../../../src/tui/screens/use-wizard-host.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACtD,2BAA2B;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,gBAAgB,CAAC;IAChC,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,oCAAoC;IACpC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,sCAAsC;IACtC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,yBAAyB;IACzB,WAAW,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,MAAM,EACN,UAAU,EACV,OAAO,EACP,aAAa,GACd,EAAE,cAAc,GAAG,UAAU,CA0F7B"}

package/dist/tui/screens/use-wizard-host.js

@@ -0,0 +1,103 @@
+// 配置向导宿主 —— 「打开向导 / 读齐快照 / 关闭后让改动生效」的唯一实现
+//
+// 从 `chat.tsx` 抽出来的理由：向导本身（`config-wizard/`）是独立状态机，但**宿主**
+// 的活儿散落在对话屏里 —— 6 个 `useState`、3 个入口函数，还要顺手记「当前模型用的是
+// 哪个端点」以便关闭时判断要不要重建会话。这些既不属于「对话」，也没法单测（要一路
+// 从键盘打到向导关闭才能碰到）。
+//
+// 依赖方向是**注入**而非 import 会话：宿主要做的事（通知、重启、重载会话）都通过
+// `WizardHostDeps` 传进来，于是 hook 可以在测试里用假依赖跑完整生命周期。
+import { useRef, useState } from "react";
+import { readConfig, readMcpConfig, readReasoningPresets } from "../../config.js";
+import { readAgentStore } from "../../agents-store.js";
+import { resolveCredential } from "../../config-editor.js";
+import { t } from "../../i18n/index.js";
+export function useWizardHost({ modelId, notify, hasSession, restart, reloadSession, }) {
+    const [wizardStep, setWizardStep] = useState(null);
+    const [wizardConfig, setWizardConfig] = useState(null);
+    const [wizardPresets, setWizardPresets] = useState({});
+    const [wizardAgents, setWizardAgents] = useState([]);
+    const [wizardMcp, setWizardMcp] = useState(null);
+    const [wizardAgentStore, setWizardAgentStore] = useState(null);
+    /**
+     * 打开向导时当前模型所用的端点 id —— 关闭时据此判断「当前端点有没有被改」。
+     *
+     * 用 ref 而不是 state：它只在 `openWizard` / `closeWizard` 之间传递，不上屏，
+     * 放 state 会多一次无意义渲染。
+     */
+    const currentEndpointRef = useRef(null);
+    const openWizard = async (step) => {
+        try {
+            const config = await readConfig();
+            currentEndpointRef.current = resolveCredential(config, modelId)?.endpointId ?? null;
+            const agentStore = await readAgentStore();
+            setWizardConfig(config);
+            setWizardPresets(await readReasoningPresets());
+            setWizardAgents(agentStore.agents.map((agent) => ({ id: agent.id, name: agent.name || agent.id })));
+            setWizardAgentStore(agentStore);
+            setWizardMcp({ global: await readMcpConfig("global"), project: await readMcpConfig("project") });
+            setWizardStep(step);
+        }
+        catch (error) {
+            notify(t("chat.configReadFailed", { error: error?.message ?? error }), "error");
+        }
+    };
+    const openKeyEditor = async () => {
+        try {
+            const config = await readConfig();
+            const credential = resolveCredential(config, modelId);
+            if (!credential) {
+                notify(t("chat.modelNoEndpoint", { id: modelId }), "error");
+                return;
+            }
+            currentEndpointRef.current = credential.endpointId;
+            setWizardConfig(config);
+            setWizardStep({ kind: "edit", field: "apiKey", endpointId: credential.endpointId });
+        }
+        catch (error) {
+            notify(t("chat.configReadFailed", { error: error?.message ?? error }), "error");
+        }
+    };
+    /** 向导关闭：渲染变更摘要；若改到当前端点 / MCP / Agent 定义则重建会话（消息保留） */
+    const closeWizard = (result) => {
+        setWizardStep(null);
+        setWizardConfig(null);
+        setWizardMcp(null);
+        setWizardAgentStore(null);
+        // 同一批摘要合成**一条**（多行）：既能全部显示，又只占通知队列的一个槽位。
+        // 逐条 push 在单槽时代只剩最后一条，在队列时代则会挤掉更早的进度提示。
+        const { summary } = result;
+        if (summary.length === 1) {
+            notify(t("chat.configUpdated", { line: summary[0] }));
+        }
+        else if (summary.length > 1) {
+            // 子项缩进 = 一个汉字宽度（两个半角空格），不加 `·` 之类的项目符号：
+            // 通知正文本身就左对齐于行首，子项只需要一点层级差，符号是多余装饰。
+            notify(t("chat.configUpdatedMulti", { lines: summary.map((line) => `  ${line}`).join("\n") }));
+        }
+        if (!result.dirty)
+            return;
+        // 会话都没建好 → 只能重启让新配置生效。
+        if (!hasSession()) {
+            restart();
+            return;
+        }
+        // 只有「当前端点 / MCP / Agent 定义」变了才需要重建会话；改的是别的模型、
+        // 别的端点的参数，当前会话不受影响，不该白重连一次。
+        const endpointChanged = !!currentEndpointRef.current && result.changedEndpointIds.includes(currentEndpointRef.current);
+        if (endpointChanged || result.mcpChanged || result.agentsChanged)
+            reloadSession();
+    };
+    return {
+        wizardStep,
+        wizardConfig,
+        wizardPresets,
+        wizardAgents,
+        wizardMcp,
+        wizardAgentStore,
+        openWizard,
+        openKeyEditor,
+        closeWizard,
+    };
+}
+//# sourceMappingURL=use-wizard-host.js.map

package/dist/tui/screens/use-wizard-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-wizard-host.js","sourceRoot":"","sources":["../../../src/tui/screens/use-wizard-host.ts"],"names":[],"mappings":"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"}

package/dist/tui/status-segments.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 状态栏的折行 —— 输入是「按优先级排好的信息块」，输出是「确定的若干行」
+ *
+ * 为什么不用 Ink 自己的 wrap：状态栏高度必须是**确定值**，`computeChatLayout` 要靠它
+ * 算出对话区还能占几行（整帧高度恒等于终端行数，输入框才吸得住底）。让 Ink 在渲染时
+ * 折行，行数只有渲染完才知道，布局预算就会算错——轻则顶部留白多一行，重则把输入框
+ * 顶出屏幕。所以这里先在纯逻辑里折好，渲染层只负责按行铺颜色。
+ *
+ * 折行以「块」为单位（见 `packSegments`）：身份、用量、快捷键各是一块，窄屏时整块
+ * 顺延到下一行，而不是把一块劈成两半——也不再用 `justify-content: space-between` 把
+ * 两侧各切一半（左边「思考 高」被吃掉、右边提示只剩半截）。
+ */
+/** 一段带样式的文本（颜色由调用方给，这里只管切分） */
+export interface StatusSegment {
+    text: string;
+    color?: string;
+    bold?: boolean;
+}
+/**
+ * 把片段流按显示宽度折成若干行。
+ *
+ * 断行策略与 `wrapText` 一致：优先在**空格**处断（英文单词不被劈开），没有空格可断
+ * 时按字符硬断（CJK 本来就能任意断行）。折行后的行首空格会被吃掉，避免出现
+ * 「第二行无故缩进两格」。
+ */
+export declare function wrapSegments(segments: StatusSegment[], width: number): StatusSegment[][];
+/** 片段流的总显示宽度（宽字符算 2 列） */
+export declare function segmentsWidth(segments: StatusSegment[]): number;
+/**
+ * 以**块**为单位装行：能塞进当前行剩余宽度就并排（用 `separator` 连起来），
+ * 塞不下就整块挪到下一行；只有单块本身就比一整行还宽时，才退化成块内折行
+ * （`wrapSegments`），此时优先在空格 / CJK 边界断，尽量不劈开英文单词。
+ *
+ * 这样「换行时一块占一行」是默认行为：块是原子的排版单位，行的边界只会落在块边界上。
+ */
+export declare function packSegments(blocks: StatusSegment[][], width: number, separator?: StatusSegment[]): StatusSegment[][];
+//# sourceMappingURL=status-segments.d.ts.map

package/dist/tui/status-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-segments.d.ts","sourceRoot":"","sources":["../../src/tui/status-segments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwCD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,EAAE,CAyDxF;AAED,0BAA0B;AAC1B,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAM/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EAAE,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,aAAa,EAAsB,GAC7C,aAAa,EAAE,EAAE,CAwCnB"}

package/dist/tui/status-segments.js

@@ -0,0 +1,166 @@
+/**
+ * 状态栏的折行 —— 输入是「按优先级排好的信息块」，输出是「确定的若干行」
+ *
+ * 为什么不用 Ink 自己的 wrap：状态栏高度必须是**确定值**，`computeChatLayout` 要靠它
+ * 算出对话区还能占几行（整帧高度恒等于终端行数，输入框才吸得住底）。让 Ink 在渲染时
+ * 折行，行数只有渲染完才知道，布局预算就会算错——轻则顶部留白多一行，重则把输入框
+ * 顶出屏幕。所以这里先在纯逻辑里折好，渲染层只负责按行铺颜色。
+ *
+ * 折行以「块」为单位（见 `packSegments`）：身份、用量、快捷键各是一块，窄屏时整块
+ * 顺延到下一行，而不是把一块劈成两半——也不再用 `justify-content: space-between` 把
+ * 两侧各切一半（左边「思考 高」被吃掉、右边提示只剩半截）。
+ */
+import { clusterWidth, graphemes } from "./text.js";
+function toChars(segments) {
+    const chars = [];
+    for (const segment of segments) {
+        // 按**字素簇**切，不按 code point：`✌️`（VS16）是两个 code point 但占 2 列，
+        // 逐 code point 累加会算成 1 列 → 状态栏行超宽 → Ink 二次折行 → 帧高多一行。
+        for (const ch of graphemes(segment.text)) {
+            chars.push({ ch, color: segment.color, bold: segment.bold, width: clusterWidth(ch) });
+        }
+    }
+    return chars;
+}
+/** 连续同色同粗细的字符合并回一个片段 */
+function toSegments(chars) {
+    const segments = [];
+    for (const char of chars) {
+        const last = segments[segments.length - 1];
+        if (last && last.color === char.color && last.bold === char.bold) {
+            last.text += char.ch;
+        }
+        else {
+            segments.push({ text: char.ch, color: char.color, bold: char.bold });
+        }
+    }
+    return segments;
+}
+/** 行尾空格没有意义（会视觉上「多出一截」），折行前后都裁掉 */
+function trimTail(line) {
+    while (line.length > 0 && line[line.length - 1].ch === " ")
+        line.pop();
+}
+/**
+ * 把片段流按显示宽度折成若干行。
+ *
+ * 断行策略与 `wrapText` 一致：优先在**空格**处断（英文单词不被劈开），没有空格可断
+ * 时按字符硬断（CJK 本来就能任意断行）。折行后的行首空格会被吃掉，避免出现
+ * 「第二行无故缩进两格」。
+ */
+export function wrapSegments(segments, width) {
+    const limit = Math.max(1, width);
+    const chars = toChars(segments);
+    const lines = [];
+    let line = [];
+    let lineWidth = 0;
+    for (let index = 0; index < chars.length; index += 1) {
+        const char = chars[index];
+        // 行已满且下一个正好是空格：直接断行并把这个空格丢掉，而不是往回找上一处空格
+        // （否则会把已经排好的「aaaa bbbb」硬拆成「aaaa」+「bbbb」，白白浪费半行）
+        if (char.ch === " " && lineWidth + char.width > limit && line.length > 0) {
+            trimTail(line);
+            lines.push(line);
+            line = [];
+            lineWidth = 0;
+            continue;
+        }
+        if (lineWidth + char.width > limit && line.length > 0) {
+            // 当前行最后一个空格的位置：能在此断就在此断，把尾巴挪到下一行
+            let spaceAt = -1;
+            for (let i = line.length - 1; i > 0; i -= 1) {
+                if (line[i].ch === " ") {
+                    spaceAt = i;
+                    break;
+                }
+            }
+            if (spaceAt > 0) {
+                const carry = line.slice(spaceAt + 1);
+                line = line.slice(0, spaceAt);
+                trimTail(line);
+                lines.push(line);
+                line = carry;
+                lineWidth = carry.reduce((sum, item) => sum + item.width, 0);
+            }
+            else {
+                trimTail(line);
+                lines.push(line);
+                line = [];
+                lineWidth = 0;
+            }
+        }
+        if (line.length === 0) {
+            if (char.ch === " ")
+                continue; // 行首不吃空格
+            // 行首的孤儿分隔符（`·`）是折行切出来的，留在开头只会变成「· ⚡ 47 tok/s」，
+            // 难看且无意义（换行本身已表达分隔），连同其后的空格一并丢掉。
+            if (char.ch === "·" && index > 0) {
+                while (index + 1 < chars.length && chars[index + 1].ch === " ")
+                    index += 1;
+                continue;
+            }
+        }
+        line.push(char);
+        lineWidth += char.width;
+    }
+    trimTail(line);
+    lines.push(line);
+    return lines.map(toSegments);
+}
+/** 片段流的总显示宽度（宽字符算 2 列） */
+export function segmentsWidth(segments) {
+    let width = 0;
+    for (const segment of segments) {
+        for (const ch of graphemes(segment.text))
+            width += clusterWidth(ch);
+    }
+    return width;
+}
+/**
+ * 以**块**为单位装行：能塞进当前行剩余宽度就并排（用 `separator` 连起来），
+ * 塞不下就整块挪到下一行；只有单块本身就比一整行还宽时，才退化成块内折行
+ * （`wrapSegments`），此时优先在空格 / CJK 边界断，尽量不劈开英文单词。
+ *
+ * 这样「换行时一块占一行」是默认行为：块是原子的排版单位，行的边界只会落在块边界上。
+ */
+export function packSegments(blocks, width, separator = [{ text: " · " }]) {
+    const limit = Math.max(1, width);
+    const separatorWidth = segmentsWidth(separator);
+    const lines = [];
+    let line = [];
+    let lineWidth = 0;
+    const flush = () => {
+        if (line.length === 0)
+            return;
+        lines.push(line);
+        line = [];
+        lineWidth = 0;
+    };
+    for (const block of blocks) {
+        const blockWidth = segmentsWidth(block);
+        if (blockWidth === 0)
+            continue; // 空块（如本轮没有速率）不占位，也不留分隔符
+        if (line.length > 0) {
+            if (lineWidth + separatorWidth + blockWidth <= limit) {
+                line = [...line, ...separator, ...block];
+                lineWidth += separatorWidth + blockWidth;
+                continue;
+            }
+            flush();
+        }
+        if (blockWidth <= limit) {
+            line = [...block];
+            lineWidth = blockWidth;
+            continue;
+        }
+        // 单块超一整行：块内折行兜底，尾巴留在 `line` 上等着接下一块
+        const chunks = wrapSegments(block, limit);
+        const tail = chunks.pop();
+        lines.push(...chunks);
+        line = tail;
+        lineWidth = segmentsWidth(tail);
+    }
+    flush();
+    return lines.length > 0 ? lines : [[]];
+}
+//# sourceMappingURL=status-segments.js.map

package/dist/tui/status-segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-segments.js","sourceRoot":"","sources":["../../src/tui/status-segments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAgBpD,SAAS,OAAO,CAAC,QAAyB;IACxC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,2DAA2D;QAC3D,sDAAsD;QACtD,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wBAAwB;AACxB,SAAS,UAAU,CAAC,KAAmB;IACrC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACjE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,mCAAmC;AACnC,SAAS,QAAQ,CAAC,IAAkB;IAClC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE,KAAK,GAAG;QAAE,IAAI,CAAC,GAAG,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAyB,EAAE,KAAa;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,IAAI,IAAI,GAAiB,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;QAC3B,wCAAwC;QACxC,gDAAgD;QAChD,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,EAAE,CAAC;YACV,SAAS,GAAG,CAAC,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,iCAAiC;YACjC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;YACjB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;oBACxB,OAAO,GAAG,CAAC,CAAC;oBACZ,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACtC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,GAAG,KAAK,CAAC;gBACb,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,GAAG,EAAE,CAAC;gBACV,SAAS,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG;gBAAE,SAAS,CAAC,SAAS;YACxC,+CAA+C;YAC/C,iCAAiC;YACjC,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,EAAE,KAAK,GAAG;oBAAE,KAAK,IAAI,CAAC,CAAC;gBAC5E,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC/B,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAyB,EACzB,KAAa,EACb,YAA6B,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,MAAM,cAAc,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,IAAI,GAAoB,EAAE,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,GAAG,EAAE,CAAC;QACV,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,CAAC;YAAE,SAAS,CAAC,wBAAwB;QACxD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,SAAS,GAAG,cAAc,GAAG,UAAU,IAAI,KAAK,EAAE,CAAC;gBACrD,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;gBACzC,SAAS,IAAI,cAAc,GAAG,UAAU,CAAC;gBACzC,SAAS;YACX,CAAC;YACD,KAAK,EAAE,CAAC;QACV,CAAC;QACD,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;YAClB,SAAS,GAAG,UAAU,CAAC;YACvB,SAAS;QACX,CAAC;QACD,oCAAoC;QACpC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAG,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACtB,IAAI,GAAG,IAAI,CAAC;QACZ,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC"}