@ai-zen/cli 1.0.0-alpha.20 → 1.0.0-alpha.23

package/dist/tui/screens/chat.js

@@ -3,28 +3,35 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { Box, Text, useApp, useCursor, useInput, useWindowSize } from "ink";
 import { keyDebug } from "../key-debug.js";
-import { parseWheel, WHEEL_STEP } from "../mouse.js";
+import { phaseLabel } from "../phase.js";
 import { AgentNS } from "@ai-zen/agents-core";
 import { theme } from "../theme.js";
-import { Spinner, StatusBar, SlashMenu } from "../components.js";
-import { layoutInput, usableFrameRows, isTerminalReply } from "../text.js";
+import { Spinner, StatusBar, statusBarRows, SlashMenu } from "../components.js";
+import { graphemes, layoutInput, usableFrameRows } from "../text.js";
 import { ChatSession } from "../chat-session.js";
-import { matchCommandHints } from "../../conversation-commands/registry.js";
-import { readConfig, readMcpConfig, readReasoningPresets, saveConfig, writeMcpConfig } from "../../config.js";
+import { commandBlocksInput, matchCommandHints, parseCommandInput, } from "../../conversation-commands/registry.js";
+import { readConfig, readReasoningPresets, saveConfig, writeMcpConfig } from "../../config.js";
 import { readAgentStore } from "../../agents-store.js";
-import { resolveCredential } from "../../config-editor.js";
 import { ConfigWizard } from "../config-wizard/index.js";
-import { computeInputCursorPosition, deleteToLineEnd, deleteToLineStart, deleteWordLeft, deleteWordRight, wordLeft, wordRight } from "./input.js";
-import { deleteToPrevWhitespace, killedText, killAt, popUndo, pushKill, pushUndo, } from "../input-editing.js";
-import { clampViewTop, computeChatLayout } from "./layout.js";
+import { computeInputCursorPosition } from "./input.js";
+import { AGENT_TABS_LINES, computeChatLayout } from "./layout.js";
 import { FrameBuffer } from "./frame-buffer.js";
 import { LineView } from "./render.js";
 import { messageToLines, transcriptLines } from "./messages-view.js";
 import { PickerOverlay, Confirm } from "./overlays.js";
+import { CursorInputRow } from "./input-row.js";
 import { chooseHandoffMode } from "./handoff-choice.js";
 import { runCommand } from "./chat-commands.js";
-import { describeEffort } from "../../reasoning-effort.js";
+import { describeEffortView } from "../../reasoning-effort.js";
+import { t } from "../../i18n/index.js";
 import { NoticeChannel, noticeLines } from "./notice.js";
+import { NoticeBar } from "./notice-bar.js";
+import { AgentTabs } from "./agent-tabs.js";
+import { useChatViewport } from "./use-chat-viewport.js";
+import { useChatOverlays } from "./use-overlays.js";
+import { useWizardHost } from "./use-wizard-host.js";
+import { useInputEditing } from "./use-input-editing.js";
+import { handleCtrlDExit, handleScrollKey } from "./common-keys.js";
 /**
  * 计算回车时应提交的文本。
  *
@@ -44,34 +51,17 @@ export function Chat(props) {
     const { exit, suspendTerminal } = useApp();
     const { setCursorPosition } = useCursor();
     const { columns, rows } = useWindowSize();
-    const [input, setInput] = useState(props.initialInput ?? "");
-    /** 光标位置：以 code point 计的字符索引（0..len） */
-    const [cursor, setCursor] = useState(Array.from(props.initialInput ?? "").length);
-    const [menuIndex, setMenuIndex] = useState(0);
-    useEffect(() => {
-        setMenuIndex(0);
-    }, [input]);
-    const [confirmState, setConfirmState] = useState(null);
-    const [pickerState, setPickerState] = useState(null);
-    /** 配置向导：非 null 时整屏接管（凭据设置 / 配置中心） */
-    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);
-    const currentEndpointRef = useRef(null);
-    const [history, setHistory] = useState([]);
-    const historyIndex = useRef(-1);
+    /** 覆盖层（确认框 / 选择器）：弹窗与 resolve 生命周期见 use-overlays.ts */
+    const { confirmState, pickerState, setConfirmState, setPickerState, resolveConfirm, resolvePicker } = useChatOverlays();
     const sessionRef = useRef(null);
     const [bootError, setBootError] = useState(null);
     const [ready, setReady] = useState(false);
-    /** 视口顶部行索引；null = 贴底（自动跟随最新内容） */
-    const [viewTop, setViewTop] = useState(null);
-    /** 最近一次布局，供键盘回调读取总行数 / 视口高度（应用内翻页） */
-    const layoutRef = useRef(null);
+    /** 视口：滚动状态与翻页 / 按行 / 滚轮换算（唯一入口见 use-chat-viewport.ts） */
+    const { viewTop, layoutRef, scrollByPage, scrollByLine, scrollByWheel, scrollToBottom } = useChatViewport();
     /** 本轮是否在生成中（spinner / 输入禁用） */
     const [busy, setBusy] = useState(false);
+    /** 生成速率快照（token/s）：生成中为实时值，结束后保留本轮平均 */
+    const [rate, setRate] = useState(null);
     /**
      * 当前模型 id —— **从会话（即 Agent 定义）读**，不作为 prop 传入。
      *
@@ -85,19 +75,28 @@ export function Chat(props) {
      * 真相在配置里（模型的 `defaultParams`），这里只镜像一份供状态栏用：
      * `/think` 写入后由命令层回调刷新，切模型（会话重建）时靠 `modelId` 变化重读。
      */
-    const [effortText, setEffortText] = useState(null);
+    const [effortView, setEffortView] = useState(null);
+    /**
+     * 语言切换计数（`/lang`）：`t()` 是模块级函数，语言变了已渲染的文案不会自更新，
+     * 递增这个计数只为逼 React 重跑一遍渲染函数。
+     */
+    const [localeTick, bumpLocale] = useState(0);
+    /**
+     * IME 光标位置：由光标所在行**渲染后实测**而来（渲染器给的帧内坐标）。
+     * 带上 key —— 只有「产生它的那个输入状态」与当前一致时才能用，否则就是上一帧的陈旧值。
+     */
+    const [imePosition, setImePosition] = useState(null);
     /** 乐观回显：提交后、真实 user 消息落进 messages 之前，先显示用户提问 */
     const [pendingUser, setPendingUser] = useState(null);
     /** 转录显示起点（/clear 清屏用：隐藏此索引之前的消息，但不改上下文） */
     const [transcriptFrom, setTranscriptFrom] = useState(0);
-    // ---- Claude Code 同款编辑状态 ----
-    /** 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);
+    /**
+     * 当前查看的 Agent 视图：`"main"` 或某个子 Agent 的视图 id。
+     *
+     * 只影响**消息列表的数据源**（主 Agent 的 `messages` / 子 Agent 自己的 `messages`），
+     * 不改上下文、不影响发送目标：发出的消息永远属于主 Agent。
+     */
+    const [activeAgentId, setActiveAgentId] = useState("main");
     /** Ctrl+D 双击退出计时 */
     const ctrlDAtRef = useRef(0);
     /**
@@ -107,8 +106,28 @@ export function Chat(props) {
     if (noticeChannelRef.current == null)
         noticeChannelRef.current = new NoticeChannel();
     const noticeChannel = noticeChannelRef.current;
-    const [notice, setNotice] = useState(null);
-    useEffect(() => noticeChannel.subscribe(setNotice), [noticeChannel]);
+    /**
+     * 通知队列（最近的在最后）。通道内部保留最近 `MAX_NOTICE_HISTORY` 条，
+     * 这里只做镜像：单槽 state 会让「同一批摘要 / 分阶段进度」只剩最后一条。
+     */
+    const [notices, setNotices] = useState(noticeChannel.notices);
+    useEffect(() => noticeChannel.subscribe(setNotices), [noticeChannel]);
+    /**
+     * 配置向导宿主（凭据 / 配置中心）：整屏接管与「关闭后让改动生效」见
+     * use-wizard-host.ts。这里只提供出口：通知走通知通道、重启 / 重载走会话。
+     */
+    const { wizardStep, wizardConfig, wizardPresets, wizardAgents, wizardMcp, wizardAgentStore, openWizard, openKeyEditor, closeWizard, } = useWizardHost({
+        modelId,
+        notify: (text, tone) => noticeChannel.push(text, tone),
+        hasSession: () => sessionRef.current != null,
+        restart: () => exit({ restart: true, messages: props.messages }),
+        reloadSession: () => {
+            void sessionRef.current
+                ?.reload()
+                .then(() => noticeChannel.push(t("notice.reloaded")))
+                .catch((error) => noticeChannel.push(t("chat.sessionReloadFailed", { error: error?.message ?? error }), "error"));
+        },
+    });
     /**
      * 重挂载附带的系统提示（如 `/model` 的切换结果）。
      *
@@ -116,6 +135,8 @@ export function Chat(props) {
      * 会把「展示一条提示」误变成「重建会话」。
      */
     const initialNoticeRef = useRef(props.initialNotice);
+    /** 钩子带来的首条消息：只在会话建好后发一次，重挂载不再重发 */
+    const initialPromptRef = useRef(props.initialPrompt);
     /**
      * 渲染信号 + 合帧：SDK 内容变更 → FrameBuffer 合帧 → setTick 触发重渲染。
      * 转录内容始终从 `agent.messages` 现取，tick 只负责「告诉 React 该重画了」。
@@ -138,16 +159,17 @@ export function Chat(props) {
             const agentId = props.agentId ?? "default";
             const definition = store.agents.find((item) => item.id === agentId) ?? null;
             if (alive)
-                setEffortText(describeEffort(model, presets, definition));
+                setEffortView(describeEffortView(model, presets, definition));
         })
             .catch(() => {
             if (alive)
-                setEffortText(null);
+                setEffortView(null);
         });
         return () => {
             alive = false;
         };
-    }, [modelId, props.agentId]);
+        // localeTick：切语言后档位文案要重算（它缓存的是已本地化的字符串，不是档位名）
+    }, [modelId, props.agentId, localeTick]);
     // 创建会话
     useEffect(() => {
         let disposed = false;
@@ -168,7 +190,7 @@ export function Chat(props) {
             conversationId: props.conversationId,
             conversationName: props.conversationName,
             // 自动迁移：与手动 /migrate、/handoff 共用同一套「交接方式三选一」选择器
-            requestMode: (info) => chooseHandoffMode(setPickerState, `上下文即将超限（${info.promptTokens}/${info.handoffTokens} tokens）· 选择交接方式`),
+            requestMode: (info) => chooseHandoffMode(setPickerState, t("handoff.pickTitle", { used: info.promptTokens, limit: info.handoffTokens })),
         }, notifier)
             .then((session) => {
             if (disposed) {
@@ -183,6 +205,14 @@ export function Chat(props) {
                 noticeChannel.push(initialNoticeRef.current);
                 initialNoticeRef.current = undefined;
             }
+            // shell 钩子：会话就绪后立即把原命令当**用户消息**发出去（不经命令解析）
+            if (initialPromptRef.current) {
+                const prompt = initialPromptRef.current;
+                initialPromptRef.current = undefined;
+                setTick((t) => t + 1);
+                void runSubmit(prompt, { asMessage: true });
+                return;
+            }
             setTick((t) => t + 1);
         })
             .catch((error) => setBootError(error?.message ?? String(error)));
@@ -197,231 +227,51 @@ export function Chat(props) {
         props.conversationId,
         props.conversationName,
     ]);
-    const resolveConfirm = (value) => {
-        setConfirmState((cs) => {
-            cs?.resolve(value);
-            return null;
-        });
-    };
-    const resolvePicker = (value) => {
-        setPickerState((ps) => {
-            ps?.resolve(value);
-            return 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) {
-            noticeChannel.push(`读取配置失败：${error?.message ?? error}`, "error");
-        }
-    };
-    /** `/key`：直达「当前模型所用端点」的 API Key 编辑步骤 */
-    const openKeyEditor = async () => {
-        try {
-            const config = await readConfig();
-            const credential = resolveCredential(config, modelId);
-            if (!credential) {
-                noticeChannel.push(`模型 ${modelId} 未绑定可用端点，请用 /config 检查配置`, "error");
-                return;
-            }
-            currentEndpointRef.current = credential.endpointId;
-            setWizardConfig(config);
-            setWizardStep({ kind: "edit", field: "apiKey", endpointId: credential.endpointId });
-        }
-        catch (error) {
-            noticeChannel.push(`读取配置失败：${error?.message ?? error}`, "error");
-        }
-    };
-    /** 向导关闭：渲染变更摘要；若改到当前端点则重建会话（消息保留） */
-    const closeWizard = (result) => {
-        setWizardStep(null);
-        setWizardConfig(null);
-        setWizardMcp(null);
-        setWizardAgentStore(null);
-        for (const line of result.summary)
-            noticeChannel.push(`配置已更新：${line}`);
-        if (!result.dirty)
-            return;
-        if (!sessionRef.current) {
-            exit({ restart: true, messages: props.messages });
-            return;
-        }
-        const endpointChanged = !!currentEndpointRef.current && result.changedEndpointIds.includes(currentEndpointRef.current);
-        if (endpointChanged || result.mcpChanged || result.agentsChanged) {
-            sessionRef.current
-                .reload()
-                .then(() => noticeChannel.push("已按新配置重建会话（消息与上下文保留）"))
-                .catch((error) => noticeChannel.push(`重建会话失败：${error?.message ?? error}`, "error"));
-        }
-    };
-    // ---- 滚动视口控制（应用内翻页，回看历史）----
-    const scrollTo = (nextTop) => {
-        const L = layoutRef.current;
-        if (!L)
-            return;
-        setViewTop(clampViewTop(L.totalLines, L.budget, nextTop));
-    };
-    const scrollByPage = (dir) => {
-        const L = layoutRef.current;
-        if (!L)
-            return;
-        scrollTo(L.viewTop + dir * Math.max(1, L.budget - 1));
-    };
-    const scrollByLine = (dir) => {
-        const L = layoutRef.current;
-        if (!L)
-            return;
-        scrollTo(L.viewTop + dir);
-    };
-    /** 鼠标滚轮：一格滚 `WHEEL_STEP` 行（与按行滚动共用一个钳制入口） */
-    const scrollByWheel = (dir) => {
-        const L = layoutRef.current;
-        if (!L)
+    // 速率采样：Spinner 的重渲染只影响它自己，不会带着状态栏一起刷，所以生成中要自己定时读快照。
+    // 生成结束（busy → false）时再读一次，拿本轮平均速率并留在状态栏上。
+    useEffect(() => {
+        const read = () => setRate(sessionRef.current?.rateSample ?? null);
+        read();
+        if (!busy)
             return;
-        scrollTo(L.viewTop + dir * WHEEL_STEP);
-    };
-    const scrollToBottom = () => setViewTop(null);
+        const timer = setInterval(read, 250);
+        return () => clearInterval(timer);
+    }, [busy]);
     /** 清屏但保留上下文：把显示起点推到当前消息末尾 */
     const clearTranscript = () => {
         setTranscriptFrom(sessionRef.current?.messages.length ?? 0);
-        setNotice(null);
-    };
-    // ---- 输入编辑（光标感知）----
-    const setInputText = (text) => {
-        setInput(text);
-        setCursor(Array.from(text).length);
-    };
-    const insertAtCursor = (text) => {
-        const chars = Array.from(input);
-        const cp = Math.max(0, Math.min(cursor, chars.length));
-        setInput(chars.slice(0, cp).join("") + text + chars.slice(cp).join(""));
-        setCursor(cp + Array.from(text).length);
-    };
-    const deleteBeforeCursor = () => {
-        const chars = Array.from(input);
-        const cp = Math.max(0, Math.min(cursor, chars.length));
-        if (cp === 0)
-            return;
-        setInput(chars.slice(0, cp - 1).join("") + chars.slice(cp).join(""));
-        setCursor(cp - 1);
-    };
-    const deleteAfterCursor = () => {
-        const chars = Array.from(input);
-        const cp = Math.max(0, Math.min(cursor, chars.length));
-        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 deleteWordBeforeCursor = () => applyKill(deleteWordLeft(input, cursor));
-    const deleteWordAfterCursor = () => applyKill(deleteWordRight(input, cursor));
-    const deleteToEndOfLine = () => applyKill(deleteToLineEnd(input, cursor));
-    const deleteToStartOfLine = () => applyKill(deleteToLineStart(input, cursor));
-    /** Ctrl+W：删到前一空白（标点不切分，整条路径一次删掉） */
-    const deletePrevWhitespace = () => applyKill(deleteToPrevWhitespace(input, cursor));
-    /** Ctrl+Y / Alt+Y：插入 kill ring 中的一段（index 循环） */
-    const yank = (advance) => {
-        const ring = killRingRef.current;
-        if (ring.length === 0)
-            return;
-        const next = advance ? yankIndexRef.current + 1 : 0;
-        if (next >= ring.length)
-            return;
-        yankIndexRef.current = next;
-        const text = killAt(ring, next) ?? "";
-        insertAtCursor(text);
-    };
-    /** Ctrl+_：撤销上一次编辑 */
-    const undoEdit = () => {
-        const popped = popUndo(undoStackRef.current);
-        if (!popped)
-            return;
-        undoStackRef.current = popped.rest;
-        setInput(popped.state.text);
-        setCursor(popped.state.cursor);
-    };
-    /** Ctrl+S：暂存 / 恢复输入 */
-    const toggleStash = () => {
-        if (input.length > 0) {
-            stashRef.current = { text: input, cursor };
-            setInputText("");
-            noticeChannel.push("已暂存输入（Ctrl+S 恢复）");
-            return;
-        }
-        const stashed = stashRef.current;
-        if (!stashed)
-            return;
-        stashRef.current = null;
-        setInput(stashed.text);
-        setCursor(stashed.cursor);
-        noticeChannel.push("已恢复暂存的输入");
-    };
-    /** Ctrl+V：粘粘图片 —— 暂未支持（需先做「文件 → 内容块」能力探测，见 SKILL/后续迭代） */
-    const pasteImageUnsupported = () => {
-        noticeChannel.push("暂不支持粘贴图片（Ctrl+V 预留给图片粘贴，当前未实现）", "error");
-    };
-    const moveCursor = (delta) => {
-        const len = Array.from(input).length;
-        setCursor((c) => Math.max(0, Math.min(len, c + delta)));
-    };
-    const moveCursorToLineStart = () => {
-        const chars = Array.from(input);
-        const cp = Math.max(0, Math.min(cursor, chars.length));
-        let i = cp;
-        while (i > 0 && chars[i - 1] !== "\n")
-            i -= 1;
-        setCursor(i);
-    };
-    const moveCursorToLineEnd = () => {
-        const chars = Array.from(input);
-        const cp = Math.max(0, Math.min(cursor, chars.length));
-        let i = cp;
-        while (i < chars.length && chars[i] !== "\n")
-            i += 1;
-        setCursor(i);
+        noticeChannel.clear();
     };
+    /**
+     * 输入编辑（文本 / 光标 / 历史 / kill ring / undo / stash）：
+     * 全部语义在 use-input-editing.ts，这里只把通知出口接上。
+     */
+    const { input, cursor, setInputText, insertAtCursor, deleteBeforeCursor, deleteAfterCursor, deleteWordBeforeCursor, deleteWordAfterCursor, deleteToStartOfLine, deleteToEndOfLine, deletePrevWhitespace, yank, undoEdit, toggleStash, moveCursor, moveCursorToLineStart, moveCursorToLineEnd, moveCursorByWord, historyPrev, historyNext, clearDraft, rememberSubmitted, } = useInputEditing({
+        initialText: props.initialInput,
+        notify: (text, tone) => noticeChannel.push(text, tone),
+    });
+    /** 斜杠候选菜单的高亮索引；输入一变就回到第一个候选 */
+    const [menuIndex, setMenuIndex] = useState(0);
+    useEffect(() => {
+        setMenuIndex(0);
+    }, [input]);
     // 命令候选人
     const slash = input.startsWith("/") && !input.includes("\n") && !input.includes(" ");
     const hints = slash ? matchCommandHints(input.slice(1)) : [];
-    const runSubmit = async (text) => {
+    const runSubmit = async (text, options = {}) => {
         const trimmed = text.trim();
         if (!trimmed || !sessionRef.current || busy)
             return;
-        setInputText("");
-        historyIndex.current = -1;
+        clearDraft();
         scrollToBottom();
-        setNotice(null);
-        if (trimmed.startsWith("/")) {
-            // 命令名取首个 token：支持 `/migrate summary`、`/handoff self` 这类带参数的写法
-            const name = trimmed.slice(1).split(/\s+/)[0].toLowerCase();
-            // 交接/迁移会调用模型写文档（较慢）：期间应像自动迁移一样拦住输入框。
-            const blocksInput = name === "migrate" || name === "migration" || name === "handoff";
+        // 发出去的消息永远属于主 Agent：停在子 Agent 视图上会让用户看不到自己的提问
+        setActiveAgentId("main");
+        noticeChannel.clear();
+        // 斜杠命令：命令名怎么解析、哪些命令会调用模型（要拦输入框），都来自命令元数据
+        const command = options.asMessage ? null : parseCommandInput(trimmed);
+        if (command) {
+            const name = command.name;
+            const blocksInput = commandBlocksInput(name);
             if (blocksInput)
                 setBusy(true);
             try {
@@ -438,7 +288,8 @@ export function Chat(props) {
                     setPickerState,
                     setConfirmState,
                     setInputText,
-                    setEffortText,
+                    setEffortView,
+                    refreshLocale: () => bumpLocale((n) => n + 1),
                 });
             }
             finally {
@@ -447,7 +298,7 @@ export function Chat(props) {
             }
             return;
         }
-        setHistory((h) => [...h, trimmed]);
+        rememberSubmitted(trimmed);
         const base = sessionRef.current.messages.filter((m) => m.role === AgentNS.Role.User).length;
         setPendingUser({ text: trimmed, base });
         setBusy(true);
@@ -462,6 +313,32 @@ export function Chat(props) {
     const doExit = () => {
         exit("done");
     };
+    /** 本次会话已出现的子 Agent（渲染期现取；`sessionRef` 在首次渲染时为 null） */
+    const subAgentViews = sessionRef.current?.subAgents ?? [];
+    /**
+     * Agent 栏目切换（← / →）：在「主 Agent + 各子 Agent」之间循环。
+     *
+     * 键位分流见下方两个 `useInput`：输入框**为空**或**生成中**（输入框已被 Spinner 顶替）
+     * 时，左右键本来就无事可做，正好用来切换；输入框**有内容**时左右键仍然是移光标——
+     * 不能为了切栏目把文本编辑的左右移动废掉。
+     */
+    const switchAgentView = (dir) => {
+        const ids = ["main", ...subAgentViews.map((item) => item.id)];
+        // 旧 id 已失效（会话重建）时 indexOf 为 -1，归一后从主 Agent 起步
+        const current = Math.max(0, ids.indexOf(activeAgentId));
+        setActiveAgentId(ids[(current + dir + ids.length) % ids.length]);
+        scrollToBottom();
+    };
+    /**
+     * 两个 `useInput`（空闲 / 忙碌）共用的键位上下文 —— 判定逻辑在 common-keys.ts。
+     * 放这里而不是各自内联，是为了让「什么时候能滚、Ctrl+D 怎么退」只有一份定义。
+     */
+    const scrollKeys = { scrollByWheel, scrollByPage, scrollByLine };
+    const ctrlDExit = {
+        lastAt: ctrlDAtRef,
+        notify: () => noticeChannel.push(t("notice.pressCtrlDAgain")),
+        exit: doExit,
+    };
     // 输入处理
     useInput((char, key) => {
         // 按键诊断（AIZ_DEBUG_KEYS=1）：必须在任何 return 之前记录，否则被吞掉的键不会留痕
@@ -475,41 +352,9 @@ export function Chat(props) {
                 exit("done");
             return;
         }
-        // 鼠标滚轮：滚视口。**必须**排在下面 `isTerminalReply` 之前——那里会把整条鼠标序列
-        // 当「终端上报」吃掉，放后面就永远收不到滚轮。其余鼠标事件（点击 / 拖拽 / 横向滚轮）
-        // 交给 `isTerminalReply` 丢弃，绝不落下到输入框。
-        const wheel = parseWheel(char);
-        if (wheel) {
-            scrollByWheel(wheel.direction);
-            return;
-        }
-        if (isTerminalReply(char))
+        // 回看历史类按键（滚轮 / PgUp/PgDn / ⌘[ ⌘] / ⌘; ⌘' / Alt+V）与忙碌态共用
+        if (handleScrollKey(char, key, scrollKeys))
             return;
-        if (key.pageUp) {
-            scrollByPage(-1);
-            return;
-        }
-        if (key.pageDown) {
-            scrollByPage(1);
-            return;
-        }
-        // 翻页的「兜底键」：部分终端把 PgUp/PgDn 留给自己滚 scrollback（应用收不到）。
-        // 注意 `Ctrl+V` 预留给图片粘贴（当前未实现），不再兼任 page-down。
-        if (char === "v" && key.meta) {
-            scrollByPage(-1);
-            return;
-        }
-        // macOS 习惯键：⌘[ / ⌘] 翻页、⌘; / ⌘' 按行滚动。
-        // Cmd 只在 kitty 键盘协议下才会带 super 位（或终端把 ⌘ 组合映射成带 8 号
-        // 修饰位的转义序列，那种会落到上面的 meta 分支里，同样生效）。
-        if (key.super && (char === "[" || char === "]")) {
-            scrollByPage(char === "[" ? -1 : 1);
-            return;
-        }
-        if (key.super && (char === ";" || char === "'")) {
-            scrollByLine(char === ";" ? -1 : 1);
-            return;
-        }
         if (key.return && (key.ctrl || key.meta || key.shift)) {
             insertAtCursor("\n");
             return;
@@ -520,27 +365,19 @@ export function Chat(props) {
                 sessionRef.current?.abort();
             else if (input.length > 0) {
                 setInputText("");
-                noticeChannel.push("已清空输入 · 再按一次 Ctrl+C 退出");
+                noticeChannel.push(t("notice.inputCleared"));
             }
             else
                 void doExit();
             return;
         }
-        if (char === "d" && key.ctrl) {
-            // Claude Code：有草稿时删光标后一个字符；空输入需双击确认退出
-            if (input.length > 0) {
-                deleteAfterCursor();
-                return;
-            }
-            const now = Date.now();
-            if (now - ctrlDAtRef.current < 800) {
-                void doExit();
-                return;
-            }
-            ctrlDAtRef.current = now;
-            noticeChannel.push("再按一次 Ctrl+D 退出");
+        if (char === "d" && key.ctrl && input.length > 0) {
+            // Claude Code：有草稿时删光标后一个字符（空闲态独有）
+            deleteAfterCursor();
             return;
         }
+        if (handleCtrlDExit(char, key, ctrlDExit))
+            return;
         if (char === "l" && key.ctrl) {
             clearTranscript();
             return;
@@ -578,7 +415,8 @@ export function Chat(props) {
             return;
         }
         if ((char === "v" && key.ctrl) || (key.super && (char === "v" || char === "V"))) {
-            pasteImageUnsupported();
+            // 图片粘贴暂未支持：需要先做「文件 → 内容块」的能力探测（见后续迭代）
+            noticeChannel.push(t("notice.pasteImageUnsupported"), "error");
             return;
         }
         // readline 的行首 / 行尾（macOS 上部分终端把 ⌘← / ⌘→ 发成 ^A / ^E）
@@ -601,22 +439,10 @@ export function Chat(props) {
                 setMenuIndex((i) => (up ? (i - 1 + hints.length) % hints.length : (i + 1) % hints.length));
                 return;
             }
-            if (up && history.length > 0) {
-                const idx = historyIndex.current < 0 ? history.length - 1 : Math.max(0, historyIndex.current - 1);
-                historyIndex.current = idx;
-                setInputText(history[idx]);
-            }
-            else if (!up && historyIndex.current >= 0) {
-                const idx = historyIndex.current + 1;
-                if (idx >= history.length) {
-                    historyIndex.current = -1;
-                    setInputText("");
-                }
-                else {
-                    historyIndex.current = idx;
-                    setInputText(history[idx]);
-                }
-            }
+            if (up)
+                historyPrev();
+            else
+                historyNext();
             return;
         }
         // 按词删除：Alt+Backspace / Ctrl+Backspace 删前一个词；Alt+D / Ctrl+Delete 删后一个词。
@@ -650,34 +476,27 @@ export function Chat(props) {
                 setMenuIndex((i) => key.upArrow ? (i - 1 + hints.length) % hints.length : (i + 1) % hints.length);
                 return;
             }
-            if (key.upArrow && history.length > 0) {
-                const idx = historyIndex.current < 0 ? history.length - 1 : Math.max(0, historyIndex.current - 1);
-                historyIndex.current = idx;
-                setInputText(history[idx]);
-            }
-            else if (key.downArrow && historyIndex.current >= 0) {
-                const idx = historyIndex.current + 1;
-                if (idx >= history.length) {
-                    historyIndex.current = -1;
-                    setInputText("");
-                }
-                else {
-                    historyIndex.current = idx;
-                    setInputText(history[idx]);
-                }
-            }
+            if (key.upArrow)
+                historyPrev();
+            else
+                historyNext();
+            return;
+        }
+        // Agent 栏目：输入框为空时光标停在 0，←/→ 本无作用 → 拿来切换主 / 子 Agent
+        if ((key.leftArrow || key.rightArrow) && input.length === 0 && subAgentViews.length > 0) {
+            switchAgentView(key.leftArrow ? -1 : 1);
             return;
         }
         if (key.leftArrow) {
             if (key.ctrl || key.meta || key.super)
-                setCursor(wordLeft(input, cursor));
+                moveCursorByWord(-1);
             else
                 moveCursor(-1);
             return;
         }
         if (key.rightArrow) {
             if (key.ctrl || key.meta || key.super)
-                setCursor(wordRight(input, cursor));
+                moveCursorByWord(1);
             else
                 moveCursor(1);
             return;
@@ -686,11 +505,11 @@ export function Chat(props) {
         // （readline 的 backward-word / forward-word），并不带 leftArrow 标记；
         // 而 Ctrl+←/→ 常被系统「Mission Control → 左右切换空间」截走，应用根本收不到。
         if (char === "b" && key.meta) {
-            setCursor(wordLeft(input, cursor));
+            moveCursorByWord(-1);
             return;
         }
         if (char === "f" && key.meta) {
-            setCursor(wordRight(input, cursor));
+            moveCursorByWord(1);
             return;
         }
         if (key.home) {
@@ -731,12 +550,7 @@ export function Chat(props) {
     useInput((char, key) => {
         keyDebug(char, key);
         // 忙碌期只剩「中止 / 退出 / 回看」，滚轮同样生效（生成时正是最想往回看的时机）
-        const wheel = parseWheel(char);
-        if (wheel) {
-            scrollByWheel(wheel.direction);
-            return;
-        }
-        if (isTerminalReply(char))
+        if (handleScrollKey(char, key, scrollKeys))
             return;
         if (char === "c" && key.ctrl) {
             sessionRef.current?.abort();
@@ -747,38 +561,19 @@ export function Chat(props) {
             sessionRef.current?.abort();
             return;
         }
-        if (char === "d" && key.ctrl) {
-            const now = Date.now();
-            if (now - ctrlDAtRef.current < 800) {
-                void doExit();
-                return;
-            }
-            ctrlDAtRef.current = now;
-            noticeChannel.push("再按一次 Ctrl+D 退出");
-            return;
-        }
-        if (key.pageUp) {
-            scrollByPage(-1);
+        if (handleCtrlDExit(char, key, ctrlDExit))
             return;
-        }
-        if (key.pageDown) {
-            scrollByPage(1);
-            return;
-        }
         if ((key.upArrow || key.downArrow) && (key.shift || key.meta || key.super)) {
             scrollByLine(key.upArrow ? -1 : 1);
             return;
         }
-        if (char === "v" && (key.meta || key.super)) {
-            scrollByPage(-1);
+        // Agent 栏目：生成中输入框已失活，←/→ 空闲 → 直接切换（此时最想看子 Agent 在干什么）
+        if ((key.leftArrow || key.rightArrow) && subAgentViews.length > 0) {
+            switchAgentView(key.leftArrow ? -1 : 1);
             return;
         }
-        if (key.super && (char === "[" || char === "]")) {
-            scrollByPage(char === "[" ? -1 : 1);
-            return;
-        }
-        if (key.super && (char === ";" || char === "'")) {
-            scrollByLine(char === ";" ? -1 : 1);
+        if (char === "v" && key.super) {
+            scrollByPage(-1);
             return;
         }
     }, { isActive: busy && !confirmState && !pickerState && !wizardStep });
@@ -790,20 +585,58 @@ export function Chat(props) {
     }
     if (bootError) {
         setCursorPosition(undefined);
-        return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Text, { color: theme.error, wrap: "truncate", children: ["\u2716 \u65E0\u6CD5\u542F\u52A8\u5BF9\u8BDD\uFF1A", bootError] }), _jsx(Text, { color: theme.dim, wrap: "truncate", children: "\u6309 k \u6253\u5F00\u914D\u7F6E\u4E2D\u5FC3\uFF08\u53EF\u8BBE\u7F6E API Key / \u7AEF\u70B9\u5730\u5740\uFF09\u00B7 Enter \u8FD4\u56DE" })] }));
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Text, { color: theme.error, wrap: "truncate", children: t("chat.bootFailed", { error: bootError }) }), _jsx(Text, { color: theme.dim, wrap: "truncate", children: t("chat.bootHint") })] }));
     }
     const session = sessionRef.current;
     const lastTokens = session?.lastUsage?.total_tokens;
     const totalTokens = session?.totalUsage.total_tokens;
     const cols = columns ?? 80;
     const messages = session?.messages ?? [];
+    const subAgents = session?.subAgents ?? [];
+    /** 当前查看的子 Agent；不在列表里（会话重建后 id 失效）时回落到主 Agent */
+    const activeSub = subAgents.find((item) => item.id === activeAgentId) ?? null;
     const userCount = messages.filter((m) => m.role === AgentNS.Role.User).length;
-    const showPending = pendingUser != null && userCount <= pendingUser.base;
-    const transcript = transcriptLines(messages.slice(transcriptFrom), cols);
+    // 乐观回显只属于主 Agent 的视图（子 Agent 不会收到用户直接发的消息）
+    const showPending = !activeSub && pendingUser != null && userCount <= pendingUser.base;
+    // 子 Agent 视图读它**自己**的 messages（从第 0 条起，不受主会话 /clear 的显示起点影响）
+    const transcript = transcriptLines(activeSub ? activeSub.agent.messages : messages.slice(transcriptFrom), cols);
     if (showPending) {
         transcript.push(...messageToLines({ id: "__pending_user", role: AgentNS.Role.User, content: pendingUser.text }, cols));
     }
-    const noticeTextLines = notice ? noticeLines(notice, cols) : [];
+    const noticeTextLines = noticeLines(notices, cols);
+    /** Agent 栏目条目：无子 Agent 时整条栏目不存在（不占高度、也不接管左右键） */
+    const agentTabs = subAgents.length > 0
+        ? [
+            { id: "main", label: t("agentTabs.main") },
+            ...subAgents.map((item) => ({
+                id: item.id,
+                label: t("agentTabs.sub", { n: item.index }),
+                status: item.status,
+            })),
+        ]
+        : [];
+    const activeTabId = activeSub ? activeSub.id : "main";
+    const agentTabLines = agentTabs.length > 0 ? AGENT_TABS_LINES : 0;
+    // 状态栏：先按当前状态算出「折行后实际几行」，交给布局预留高度（否则窄屏下一旦提示折行，
+    // 整帧就会高出一行，把输入框顶出屏幕）。这里用 `viewTop` 状态判断滚动，而不是
+    // `layout.scrolled` —— 后者要等布局算完才有，会与行数测量形成循环。
+    const statusProps = {
+        model: modelId,
+        agent: props.agentId ?? "default",
+        effort: effortView?.text ?? null,
+        effortDimmed: effortView?.dimmed ?? false,
+        lastTokens,
+        totalTokens,
+        busy,
+        hint: !ready
+            ? t("input.hint.initializing")
+            : viewTop != null
+                ? t("input.hint.scrolling")
+                : t("input.hint.ready"),
+        rate,
+        columns: cols,
+    };
+    const statusRows = statusBarRows(statusProps, cols);
     const layout = computeChatLayout({
         columns: cols,
         rows: usableFrameRows(rows ?? 24),
@@ -812,45 +645,69 @@ export function Chat(props) {
         busy,
         hintCount: hints.length,
         noticeCount: noticeTextLines.length,
+        agentTabLines,
         overlay: confirmState ? "confirm" : pickerState ? "picker" : "none",
         pickerItems: pickerState?.items.length ?? 0,
         viewTop,
+        statusBarLines: statusRows.length,
     });
     layoutRef.current = layout;
     const isPlaceholder = input.length === 0;
-    const inputLayout = layoutInput(isPlaceholder ? "输入消息，/ 查看命令…" : input, isPlaceholder ? 0 : cursor, Math.max(4, cols - 4));
+    const inputLayout = layoutInput(isPlaceholder ? t("input.placeholder") : input, isPlaceholder ? 0 : cursor, Math.max(4, cols - 4));
     const bodyLines = inputLayout.lines;
-    // 把终端硬件光标移到编辑光标处，让 IME（输入法）候选框正确定位
+    // 光标所在行的三段拆分（与 `CursorInputRow` 的渲染一一对应）
+    const cursorRowIndex = inputLayout.cursorRow;
+    const cursorRowChars = graphemes(bodyLines[cursorRowIndex] ?? "");
+    const cursorColInRow = Math.min(inputLayout.cursorCol, cursorRowChars.length);
+    const cursorBefore = cursorRowChars.slice(0, cursorColInRow).join("");
+    const cursorAt = cursorRowChars[cursorColInRow] ?? " ";
+    const cursorAfter = cursorRowChars.slice(cursorColInRow + 1).join("");
+    /** 实测结果的身份标记：输入段落一改，上一帧的实测值就作废 */
+    const cursorKey = `${cursorRowIndex}\u0000${cursorBefore}\u0000${cursorAt}\u0000${cursorAfter}`;
+    /** 渲染后实测（值不变则不会重渲染）；闭包捕获当帧的 key，保证标的是「这一帧」的结果 */
+    const onCursorMeasure = (position) => {
+        setImePosition((prev) => prev && prev.position.x === position.x && prev.position.y === position.y
+            ? prev
+            : { key: cursorKey, position });
+    };
+    // 把终端硬件光标移到编辑光标处，让 IME（输入法）候选框正确定位：
+    // 首选「渲染器实测」（宽字符 / emoji 的宽度由 Ink 自己算，不会偏）；
+    // 首次渲染还没量到时，退回手算值顶一帧（下一帧即被实测值纠正）。
     if (!busy && !confirmState && !pickerState) {
-        setCursorPosition(computeInputCursorPosition({
-            transcriptLines: layout.lines.length,
-            hintCount: hints.length,
-            cursorRow: inputLayout.cursorRow,
-            cursorCol: inputLayout.cursorCol,
-            lineText: bodyLines[inputLayout.cursorRow] ?? "",
-            placeholder: isPlaceholder,
-        }));
+        const measured = imePosition && imePosition.key === cursorKey ? imePosition.position : null;
+        setCursorPosition(measured ??
+            computeInputCursorPosition({
+                transcriptLines: layout.lines.length,
+                // Agent 栏目与通知栏都夹在对话区与输入行之间：漏算会让硬件光标整体偏上
+                agentTabCount: agentTabLines,
+                noticeCount: noticeTextLines.length,
+                hintCount: hints.length,
+                cursorRow: inputLayout.cursorRow,
+                cursorCol: inputLayout.cursorCol,
+                lineText: bodyLines[inputLayout.cursorRow] ?? "",
+                placeholder: isPlaceholder,
+            }));
     }
     else {
         setCursorPosition(undefined);
     }
-    return (_jsxs(Box, { flexDirection: "column", width: cols, children: [layout.lines.map((line) => (_jsx(LineView, { line: line }, line.key))), confirmState ? (_jsx(Confirm, { question: confirmState.question, onAnswer: resolveConfirm })) : pickerState ? (_jsx(PickerOverlay, { title: pickerState.title, items: pickerState.items, columns: cols, onPick: resolvePicker })) : (_jsxs(Box, { flexDirection: "column", children: [noticeTextLines.length > 0 ? (_jsx(Box, { flexDirection: "column", paddingX: 1, children: noticeTextLines.map((line, i) => (_jsx(Text, { color: notice?.tone === "error" ? theme.error : theme.dim, wrap: "truncate", children: line }, i))) })) : null, hints.length > 0 ? _jsx(SlashMenu, { hints: hints, selected: menuIndex }) : null, _jsx(Box, { paddingX: 1, children: _jsx(Text, { color: theme.border, wrap: "truncate", children: "─".repeat(Math.max(1, cols - 2)) }) }), _jsx(Box, { flexDirection: "column", paddingX: 1, children: busy ? (_jsx(Spinner, { label: "\u601D\u8003\u4E2D\u2026" })) : (bodyLines.map((line, i) => {
+    return (_jsxs(Box, { flexDirection: "column", width: cols, children: [layout.lines.map((line) => (_jsx(LineView, { line: line }, line.key))), confirmState ? (_jsx(Confirm, { question: confirmState.question, onAnswer: resolveConfirm })) : pickerState ? (_jsx(PickerOverlay, { title: pickerState.title, items: pickerState.items, columns: cols, onPick: resolvePicker })) : (_jsxs(Box, { flexDirection: "column", children: [agentTabs.length > 0 ? _jsx(AgentTabs, { tabs: agentTabs, activeId: activeTabId }) : null, _jsx(NoticeBar, { lines: noticeTextLines }), hints.length > 0 ? _jsx(SlashMenu, { hints: hints, selected: menuIndex }) : null, _jsx(Box, { paddingX: 1, children: _jsx(Text, { color: theme.border, wrap: "truncate", children: "─".repeat(Math.max(1, cols - 2)) }) }), _jsx(Box, { flexDirection: "column", paddingX: 1, children: busy ? (
+                        // 阶段随 SDK 事件推进：连接中 → 排队中 → 思考 / 输出 / 调用工具 → 等工具返回。
+                        // 渲染期现取（不另存 state）：chunk 与轮次边界都会触发重渲染，
+                        // 而 `busy` 置 true 本身也会重渲一次，捕得到首轮的「连接中」。
+                        _jsx(Spinner, { label: phaseLabel(sessionRef.current?.phase ?? null) })) : (bodyLines.map((line, i) => {
                             const prompt = i === 0 ? (_jsx(Text, { color: theme.brand[0], bold: true, children: "❯ " })) : (_jsx(Text, { children: "  " }));
                             if (isPlaceholder) {
-                                return (_jsxs(Text, { wrap: "truncate", children: [prompt, _jsx(Text, { color: theme.faint, children: line }), i === bodyLines.length - 1 ? (_jsx(Text, { color: theme.brand[1], children: "\u258F" })) : null] }, i));
+                                // 占位态不画「假光标」（那个行尾的 ▏）：硬件光标这时就停在提示语开头
+                                // （x = 前缀宽），终端自己会把它显示出来；再画一个方块等于屏幕上两个光标，
+                                // 而且位置还在提示语末尾，反而误导。
+                                return (_jsxs(Text, { wrap: "truncate", children: [prompt, _jsx(Text, { color: theme.faint, children: line })] }, i));
                             }
-                            if (i === inputLayout.cursorRow) {
-                                const rowChars = Array.from(line);
-                                const before = rowChars.slice(0, inputLayout.cursorCol).join("");
-                                const at = rowChars[inputLayout.cursorCol];
-                                const after = rowChars.slice(inputLayout.cursorCol + 1).join("");
-                                return (_jsxs(Text, { wrap: "truncate", children: [prompt, _jsx(Text, { children: before }), _jsx(Text, { inverse: true, color: theme.brand[0], children: at ?? " " }), _jsx(Text, { children: after })] }, i));
+                            // 光标行：把光标字符包成独立节点，渲染后由渲染器给出真实坐标（IME 定位）
+                            if (i === cursorRowIndex) {
+                                return (_jsx(CursorInputRow, { firstLine: i === 0, before: cursorBefore, at: cursorAt, after: cursorAfter, onMeasure: onCursorMeasure }, i));
                             }
                             return (_jsxs(Text, { wrap: "truncate", children: [prompt, _jsx(Text, { children: line })] }, i));
-                        })) })] })), _jsx(StatusBar, { model: modelId, agent: props.agentId ?? "default", effort: effortText, lastTokens: lastTokens, totalTokens: totalTokens, busy: busy, hint: !ready
-                    ? "初始化中…"
-                    : layout.scrolled
-                        ? "↕ 滚动中 · PgUp/PgDn 翻页 · 发送回到底部"
-                        : "Enter 发送 · Ctrl+J 换行 · / 命令 · PgUp 看历史" })] }));
+                        })) })] })), _jsx(StatusBar, { ...statusProps })] }));
 }
 //# sourceMappingURL=chat.js.map