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

package/dist/tui/index.js

@@ -11,12 +11,17 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 import { render, useApp } from "ink";
 import { AgentRepository } from "@ai-zen/agents-sdk";
-import { AGENTS_DIR, readConfig, saveConfig } from "../config.js";
+import { AGENTS_DIR, ensureConfigDir, readConfig, saveConfig } from "../config.js";
 import { resolveCredential } from "../config-editor.js";
 import { ConfigWizard } from "./config-wizard/index.js";
 import { conversationRepository } from "../conversation-repository.js";
 import { readLastSession } from "../session-pointer.js";
 import { Splash, Chat } from "./screens/index.js";
+import { keyDebugStart } from "./key-debug.js";
+import { disableMouseTracking, enableMouseTracking } from "./mouse.js";
+import { installSdkLogger } from "../sdk-log.js";
+import { initLocale } from "../i18n/preferences.js";
+import { t } from "../i18n/index.js";
 /** ANSI：清屏 + 光标归位 + 显示光标（屏幕间切换时从头绘制，避免行偏移） */
 const CLEAR_SCREEN = "\x1b[2J\x1b[H\x1b[?25h";
 /**
@@ -27,6 +32,13 @@ const CLEAR_SCREEN = "\x1b[2J\x1b[H\x1b[?25h";
  * 保证退出即干净交还 shell（Windows 下 TTY 写为异步，用回调 + 兜底定时器双保险）。
  */
 function farewell() {
+    // 先关鼠标上报：不关的话，回到 shell 后每次滚轮都会在提示符前吐一串 `^[[<64;…M`
+    try {
+        disableMouseTracking();
+    }
+    catch {
+        /* ignore */
+    }
     try {
         process.stdin.setRawMode?.(false);
     }
@@ -40,7 +52,7 @@ function farewell() {
         /* ignore */
     }
     const finish = () => process.exit(0);
-    process.stdout.write("\x1b[?25h\n再见 👋\n", finish);
+    process.stdout.write(`\x1b[?25h${t("app.goodbye")}`, finish);
     setTimeout(finish, 250);
 }
 /** 当前活动的 Ink 实例（用于信号处理时兜底卸载） */
@@ -62,13 +74,20 @@ let activeInstance = null;
 export const RENDER_OPTIONS = {
     exitOnCtrlC: false,
     alternateScreen: false,
+    // 只重绘「变化的行」，而不是每帧擦除 + 重写整屏（Ink 默认 false，走 createStandard）。
+    // 流式高频下把每帧输出量从 O(屏幕大小) 降到 O(变化量)，显著减轻 SSH 带宽 / 背压压力。
+    incrementalRendering: true,
     kittyKeyboard: { mode: "disabled" },
 };
 function mount(node) {
     process.stdout.write(CLEAR_SCREEN);
+    // 鼠标上报随实例生命周期开关：本 TUI 会反复挂载（启动屏 → 对话 → 配置向导），
+    // 每个实例结束时都关掉，避免「已卸载却仍在收鼠标事件」。
+    enableMouseTracking();
     const instance = render(node, RENDER_OPTIONS);
     activeInstance = instance;
     return instance.waitUntilExit().finally(() => {
+        disableMouseTracking();
         if (activeInstance === instance)
             activeInstance = null;
     });
@@ -97,37 +116,48 @@ async function ensureCredential(modelId) {
     const result = (await mount(_jsx(CredentialGate, { config: config, endpointId: credential.endpointId })));
     return Boolean(result?.dirty);
 }
-async function resolveTarget() {
+/**
+ * 解析某个 Agent 绑定模型（**唯一真相源**）。
+ *
+ * 配置层已无 `defaultModel`、会话存档也不再记模型，所以这里缺失就直接报错，
+ * 绝不做任何隐式回退——回退正是「状态栏显示 A、实发请求 B」的根源。
+ */
+async function modelOf(agentId) {
+    const id = agentId || "default";
+    // 先跑一次配置初始化：bootstrap 会为缺 modelId 的历史 Agent 补上并落盘。
+    // 不做这一步就会读到“未绑定模型”的旧定义，把一次正常的升级变成启动错误。
     const config = await readConfig();
-    const repository = new AgentRepository(AGENTS_DIR);
-    const agents = await repository.list();
-    const agentId = config.defaultAgent ?? agents[0]?.id;
-    let modelId;
-    if (agentId) {
-        const agent = await repository.read(agentId);
-        modelId = agent?.modelId;
-    }
-    modelId = modelId ?? config.defaultModel ?? config.models[0]?.id;
+    const agent = await new AgentRepository(AGENTS_DIR).read(id);
+    const modelId = agent?.modelId;
     if (!modelId) {
-        throw new Error("没有可用的模型，请先在配置中添加端点与模型（配置文件 config.json）");
+        throw new Error(t("app.agentNoModel", { id }));
+    }
+    if (!config.models.some((model) => model.id === modelId)) {
+        throw new Error(t("app.agentModelGone", { id, model: modelId }));
     }
-    return { modelId, agentId };
+    return modelId;
 }
-/** 目标模型是否仍在配置中（续接的会话可能引用了已删除的模型） */
-async function modelExists(modelId) {
+async function resolveTarget() {
     const config = await readConfig();
-    return config.models.some((model) => model.id === modelId);
+    const repository = new AgentRepository(AGENTS_DIR);
+    const agents = await repository.list();
+    const agentId = config.defaultAgent ?? agents[0]?.id;
+    if (!agentId)
+        throw new Error(t("app.noAgents"));
+    // 校验模型可用（缺失时抛出可读错误，交给启动屏展示）
+    await modelOf(agentId);
+    return { agentId };
 }
 /** 读取「上一轮会话 id」指针，续接该会话（指针缺失或会话不存在时返回 null） */
 async function resumeLastSession() {
-    const pointer = await readLastSession();
+    const pointer = await readLastSession(process.cwd());
     if (!pointer)
         return null;
     const conversation = await conversationRepository.read(pointer.id);
     if (!conversation)
         return null;
+    // 模型由 Agent 定义决定（旧存档里的 modelId 一律忽略）
     return targetFromMessages({
-        modelId: conversation.modelId,
         agentId: conversation.agentId,
         messages: conversation.messages,
         conversationId: conversation.id,
@@ -137,7 +167,6 @@ async function resumeLastSession() {
 /** 从已保存对话构造对话目标 */
 function targetFromMessages(input) {
     return {
-        modelId: input.modelId,
         agentId: input.agentId,
         messages: input.messages,
         conversationId: input.conversationId,
@@ -149,65 +178,77 @@ function targetFromMessages(input) {
  * 运行对话屏；`/clear`、`/back`、`/load` 通过重挂载（新 Ink 实例 + 原生清屏）实现，
  * 其余退出（退出）直接结束。
  */
-async function runChat(target) {
+async function runChat(target, options = {}) {
     let current = target;
     let messages = target.messages;
     let initialInput;
-    let clearTranscript = false;
+    /** 重挂载后要展示一次的系统提示（如 `/model` 的写入结果，旧实例已卸载，只能传给新屏） */
+    let initialNotice;
+    /**
+     * shell 钩子（`ai --tui --new "$@"`）带来的首条消息。
+     * **只发一次**：挂载后置空，否则重挂载（切模型 / `/lang` 等）会反复重发。
+     */
+    let initialPrompt = options.initialPrompt;
     while (true) {
-        const result = await mount(_jsx(Chat, { modelId: current.modelId, agentId: current.agentId, messages: messages, conversationId: current.conversationId, conversationName: current.conversationName, initialInput: initialInput, clearTranscript: clearTranscript }));
+        const result = await mount(_jsx(Chat, { agentId: current.agentId, messages: messages, conversationId: current.conversationId, conversationName: current.conversationName, initialInput: initialInput, initialNotice: initialNotice, initialPrompt: initialPrompt }));
+        initialPrompt = undefined;
         if (result && typeof result === "object") {
             const value = result;
             if (value.load) {
-                // /load：整体切换到另一段已保存对话（含模型 / Agent），重挂载对话屏
+                // /load：整体切换到另一段已保存对话（含 Agent），重挂载对话屏
                 current = {
-                    modelId: value.load.modelId,
                     agentId: value.load.agentId,
                     conversationId: value.load.conversationId,
                     conversationName: value.load.conversationName,
                 };
                 messages = value.load.messages;
                 initialInput = undefined;
-                clearTranscript = false;
+                initialNotice = undefined;
                 continue;
             }
             if (value.restart) {
                 messages = value.messages ?? messages;
                 initialInput = value.initialInput;
-                clearTranscript = Boolean(value.clearTranscript);
+                initialNotice = value.notice;
+                // `/model` 换模型：Agent 定义里的 modelId 已变，需重建会话（阈值、工具集跟着变）
+                if (value.agentId) {
+                    current = { ...current, agentId: value.agentId };
+                }
                 continue;
             }
         }
         return;
     }
 }
-// ==================== 入口 ====================
-export async function runTui() {
+export async function runTui(options = {}) {
     const uninstallSignals = installSignalSafety();
+    // 接管 SDK 全局日志：关掉库自带的 console 兜底。必须在任何 Ink 渲染之前——
+    // SDK 的 logger 默认是 console.log，直写 stdout 会把界面撕坏
+    // （`load_mcp` 甚至会把整份 manifest 打出来）。AIZ_DEBUG_SDK=1 可改为落盘。
+    installSdkLogger();
+    // 界面语言必须在任何渲染之前定下来：首次启动按系统语言识别并落盘，
+    // 之后以 preferences.json 为准（`/lang` 可随时改）。
+    await initLocale();
+    // 按键诊断：AIZ_DEBUG_KEYS=1 时把终端环境 + 每次按键写进日志（默认关闭，零开销）
+    keyDebugStart();
     try {
+        // 配置初始化必须早于任何 Agent 读取：
+        //   - 目录 / config.json / 默认 Agent / 出厂策略表都在这里释放；
+        //   - 历史 Agent 缺 `modelId` 的补齐也在这里（`ensureDefaultAgent`）。
+        // 而「续接上一轮会话」这条路径不会经过 `resolveTarget()`，少了这一步，
+        // 升级后第一次启动会直接报「Agent 未绑定模型」。
+        await ensureConfigDir();
         // 启动界面（一次性）
         await mount(_jsx(Splash, {}));
-        // 直达对话：优先续接「上一轮会话」，否则新建对话
-        let target = await resumeLastSession();
-        if (target && !(await modelExists(target.modelId))) {
-            // 续接目标引用了已从配置中删除的模型：退回默认模型但保留历史，
-            // 避免卡在「模型不存在」的报错屏而无处可走
-            const fallback = await resolveTarget().catch(() => null);
-            target = fallback
-                ? {
-                    ...fallback,
-                    messages: target.messages,
-                    conversationId: target.conversationId,
-                    conversationName: target.conversationName,
-                }
-                : null;
-        }
-        else if (!target) {
+        // 直达对话：优先续接「上一轮会话」，否则新建对话。
+        // `--new` 跳过续接（不读 last-session.json 指针），直接走新建路径
+        let target = options.newSession ? null : await resumeLastSession();
+        if (!target) {
             try {
                 target = await resolveTarget();
             }
             catch (error) {
-                process.stderr.write(`\n✖ 无法启动对话：${error?.message ?? error}\n`);
+                process.stderr.write(`\n${t("app.bootFailed", { error: error?.message ?? error })}\n`);
             }
         }
         if (!target) {
@@ -215,11 +256,21 @@ export async function runTui() {
             return;
         }
         // 端点凭据预检：未配置 API Key 时先弹出输入屏，而不是「报错即退出」
-        if (!(await ensureCredential(target.modelId))) {
+        // 模型从 Agent 定义读 —— 与 SDK 实发请求用的是同一个值
+        let modelId = null;
+        try {
+            modelId = await modelOf(target.agentId);
+        }
+        catch (error) {
+            process.stderr.write(`\n${t("app.bootFailed", { error: error?.message ?? error })}\n`);
             farewell();
             return;
         }
-        await runChat(target);
+        if (!(await ensureCredential(modelId))) {
+            farewell();
+            return;
+        }
+        await runChat(target, options);
         farewell();
     }
     finally {
@@ -236,6 +287,13 @@ function installSignalSafety() {
         catch {
             /* 忽略 */
         }
+        // 任何异常退出路径都要把终端鼠标上报关掉，否则终端会持续把滚轮写成转义序列
+        try {
+            disableMouseTracking();
+        }
+        catch {
+            /* 忽略 */
+        }
         activeInstance = null;
     };
     const onSigint = () => {
@@ -248,7 +306,7 @@ function installSignalSafety() {
     };
     const onFatal = (error) => {
         restore();
-        process.stderr.write(`\n✖ 意外错误: ${error?.message ?? error}\n`);
+        process.stderr.write(`\n${t("app.unexpected", { error: error?.message ?? error })}\n`);
         process.exit(1);
     };
     process.on("SIGINT", onSigint);

package/dist/tui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":"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"}

package/dist/tui/input-editing.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 输入框编辑的纯逻辑层 —— 与 Claude Code / readline 的键位语义对齐。
+ *
+ * 全部函数都是「(文本, 光标) → (文本, 光标)」的纯变换，便于单测；
+ * chat.tsx 只负责把按键映射过来、套用结果、维护 kill ring 与撤销栈。
+ *
+ * 光标单位是**字素簇**（`graphemes`），不是 code point：`✌️` 是 2 个 code point
+ * 但只是 1 个簇，按 code point 删会只删掉半个 emoji、留下孤立的变体选择符。
+ *
+ * 键位语义依据 Claude Code 官方文档（interactive-mode.md）：
+ * - `Ctrl+W` 删到**前一空白**（标点不切分：`src/utils/foo.ts` 一次删掉整条路径）
+ * - `Alt+B/F/D` 按「词」处理（标点算分隔符：停在 `ts` / `foo` / `utils` / `src`）
+ */
+/** 一段可撤销的编辑状态（文本 + 字素簇光标） */
+export interface EditState {
+    text: string;
+    cursor: number;
+}
+/**
+ * 删到前一空白（Ctrl+W）：先吃掉光标前的空白，再吃掉一整段非空白。
+ *
+ * 与 `deleteWordLeft` 的区别在于标点：本函数只认空白为边界，
+ * 因此 `src/utils/foo.ts` 会被整段删除，而不是只删 `foo.ts`。
+ */
+export declare function deleteToPrevWhitespace(text: string, cursor: number): EditState;
+/**
+ * 求「被删掉的文本」：比较编辑前后，取中间不重合的那一段。
+ *
+ * 用于把 `Ctrl+W/U/K` 删掉的内容放进 kill ring 供 `Ctrl+Y` 取回，
+ * 免去每个删除函数各自返回「删了什么」。
+ */
+export declare function killedText(before: string, after: string): string;
+export declare const KILL_RING_SIZE = 5;
+/**
+ * 记录一段被删除的文本。
+ *
+ * 空串不入环；与栈顶相同的连续删除（如连按 `Ctrl+W` 删同一个词）不重复入栈，
+ * 否则 `Alt+Y` 会在同一段文本上空转。
+ */
+export declare function pushKill(ring: string[], killed: string, limit?: number): string[];
+/** 取环中第 index 段（越界返回 undefined）；index 0 为最近一次删除 */
+export declare function killAt(ring: string[], index: number): string | undefined;
+/** 撤销栈上限：编辑很密，但每条只是一个短字符串，100 条足够 */
+export declare const UNDO_LIMIT = 100;
+/** 入栈一条编辑前快照；与栈顶相同的状态不重复入栈 */
+export declare function pushUndo(stack: EditState[], state: EditState, limit?: number): EditState[];
+/** 出栈一条快照（无历史时返回 null） */
+export declare function popUndo(stack: EditState[]): {
+    state: EditState;
+    rest: EditState[];
+} | null;
+//# sourceMappingURL=input-editing.d.ts.map

package/dist/tui/input-editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-editing.d.ts","sourceRoot":"","sources":["../../src/tui/input-editing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,6BAA6B;AAC7B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhE;AAGD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,MAAM,EAAE,CAIzF;AAED,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAID,qCAAqC;AACrC,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,SAAa,GAAG,SAAS,EAAE,CAI9F;AAED,0BAA0B;AAC1B,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAG1F"}

package/dist/tui/input-editing.js

@@ -0,0 +1,91 @@
+/**
+ * 输入框编辑的纯逻辑层 —— 与 Claude Code / readline 的键位语义对齐。
+ *
+ * 全部函数都是「(文本, 光标) → (文本, 光标)」的纯变换，便于单测；
+ * chat.tsx 只负责把按键映射过来、套用结果、维护 kill ring 与撤销栈。
+ *
+ * 光标单位是**字素簇**（`graphemes`），不是 code point：`✌️` 是 2 个 code point
+ * 但只是 1 个簇，按 code point 删会只删掉半个 emoji、留下孤立的变体选择符。
+ *
+ * 键位语义依据 Claude Code 官方文档（interactive-mode.md）：
+ * - `Ctrl+W` 删到**前一空白**（标点不切分：`src/utils/foo.ts` 一次删掉整条路径）
+ * - `Alt+B/F/D` 按「词」处理（标点算分隔符：停在 `ts` / `foo` / `utils` / `src`）
+ */
+import { graphemes } from "./text.js";
+function clampCursor(chars, cursor) {
+    return Math.max(0, Math.min(cursor, chars.length));
+}
+/**
+ * 删到前一空白（Ctrl+W）：先吃掉光标前的空白，再吃掉一整段非空白。
+ *
+ * 与 `deleteWordLeft` 的区别在于标点：本函数只认空白为边界，
+ * 因此 `src/utils/foo.ts` 会被整段删除，而不是只删 `foo.ts`。
+ */
+export function deleteToPrevWhitespace(text, cursor) {
+    const chars = graphemes(text);
+    const cp = clampCursor(chars, cursor);
+    let from = cp;
+    while (from > 0 && /\s/.test(chars[from - 1]))
+        from -= 1;
+    while (from > 0 && !/\s/.test(chars[from - 1]))
+        from -= 1;
+    return {
+        text: chars.slice(0, from).join("") + chars.slice(cp).join(""),
+        cursor: from,
+    };
+}
+/**
+ * 求「被删掉的文本」：比较编辑前后，取中间不重合的那一段。
+ *
+ * 用于把 `Ctrl+W/U/K` 删掉的内容放进 kill ring 供 `Ctrl+Y` 取回，
+ * 免去每个删除函数各自返回「删了什么」。
+ */
+export function killedText(before, after) {
+    const a = graphemes(before);
+    const b = graphemes(after);
+    let prefix = 0;
+    while (prefix < b.length && a[prefix] === b[prefix])
+        prefix += 1;
+    let suffix = 0;
+    while (suffix < b.length - prefix && a[a.length - 1 - suffix] === b[b.length - 1 - suffix])
+        suffix += 1;
+    return a.slice(prefix, a.length - suffix).join("");
+}
+// ==================== kill ring（Ctrl+Y / Alt+Y）====================/** kill ring 最大长度（够 Alt+Y 循环几次即可，不做无限历史） */
+export const KILL_RING_SIZE = 5;
+/**
+ * 记录一段被删除的文本。
+ *
+ * 空串不入环；与栈顶相同的连续删除（如连按 `Ctrl+W` 删同一个词）不重复入栈，
+ * 否则 `Alt+Y` 会在同一段文本上空转。
+ */
+export function pushKill(ring, killed, limit = KILL_RING_SIZE) {
+    if (!killed)
+        return ring;
+    if (ring[0] === killed)
+        return ring;
+    return [killed, ...ring].slice(0, limit);
+}
+/** 取环中第 index 段（越界返回 undefined）；index 0 为最近一次删除 */
+export function killAt(ring, index) {
+    if (index < 0 || index >= ring.length)
+        return undefined;
+    return ring[index];
+}
+// ==================== 撤销栈（Ctrl+_）====================
+/** 撤销栈上限：编辑很密，但每条只是一个短字符串，100 条足够 */
+export const UNDO_LIMIT = 100;
+/** 入栈一条编辑前快照；与栈顶相同的状态不重复入栈 */
+export function pushUndo(stack, state, limit = UNDO_LIMIT) {
+    const top = stack[stack.length - 1];
+    if (top && top.text === state.text && top.cursor === state.cursor)
+        return stack;
+    return [...stack, state].slice(-limit);
+}
+/** 出栈一条快照（无历史时返回 null） */
+export function popUndo(stack) {
+    if (stack.length === 0)
+        return null;
+    return { state: stack[stack.length - 1], rest: stack.slice(0, -1) };
+}
+//# sourceMappingURL=input-editing.js.map

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

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

package/dist/tui/key-debug.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 按键诊断 —— 不同终端的按键编码差异极大（macOS 的 Option、PageUp/PageDown 尤其），
+ * 「某个键在我机器上没反应」这类问题靠猜毫无意义：要么键被 OS/终端吞掉，
+ * 要么终端发来的序列和我们认的不一样。两种情况的判定方法是同一个 —— 看日志里有几行。
+ *
+ * 用法：
+ *   AIZ_DEBUG_KEYS=1 aiz                       → 追加写到 <tmp>/aiz-key-debug.log
+ *   AIZ_DEBUG_KEYS=1 AIZ_KEYS_FILE=/path aiz   → 写到指定文件
+ *
+ * 判读：
+ *   - 按了键但日志里没有新增行 → 键根本没到应用（被 OS 快捷键或终端键位映射截走）
+ *   - 有行但 `input`/`flags` 与预期不符 → 序列认识，是匹配逻辑的问题
+ *   - 有行且 `raw=false` → 终端没处于 raw mode，键被终端自己解释了（如滚动 scrollback）
+ *
+ * 刻意在 `useInput` 回调里记录而不是直接监听 `stdin` 的 data 事件：
+ * 后者会把流切成 flowing 模式，与 Ink 内部的 readable 读取抢数据。
+ */
+export declare const KEY_DEBUG_ENABLED: boolean;
+/** 日志落盘路径（测试与用户都可能改写，故导出常量） */
+export declare const KEY_DEBUG_FILE: string;
+/** Ink `useInput` 的 key 对象里我们关心的字段（结构化，避免依赖 ink 的类型导出） */
+export interface KeyFlags {
+    upArrow?: boolean;
+    downArrow?: boolean;
+    leftArrow?: boolean;
+    rightArrow?: boolean;
+    pageUp?: boolean;
+    pageDown?: boolean;
+    return?: boolean;
+    escape?: boolean;
+    tab?: boolean;
+    backspace?: boolean;
+    delete?: boolean;
+    home?: boolean;
+    end?: boolean;
+    ctrl?: boolean;
+    shift?: boolean;
+    meta?: boolean;
+}
+/** 终端环境摘要：排查「只在某终端失灵」时先看这一行 */
+export declare function terminalSummary(env?: NodeJS.ProcessEnv): string;
+/**
+ * 把一次按键格式化成单行记录。
+ *
+ * `input` 用 JSON.stringify 转义（控制字符会变成 `\u001b` 这类可读形式），
+ * `raw` 表示按下时 stdin 是否仍在 raw mode —— 为 false 时键会被终端自己吃掉。
+ */
+export declare function formatKeyEvent(input: string, key: KeyFlags, raw: boolean): string;
+/** 当前 stdin 是否处于 raw mode（非 TTY 或平台不支持时视为 false） */
+export declare function stdinIsRaw(): boolean;
+/**
+ * 记录一行到诊断日志；仅在 `AIZ_DEBUG_KEYS=1` 时生效。
+ *
+ * 同步写：调试期每次按键都写一行，量小；异步写反而可能在崩溃时丢最后几行
+ * —— 而那几行往往正是要看的那几行。
+ */
+export declare function keyDebugLog(line: string): void;
+/** 会话开始时写一行环境摘要（同一次运行只写一次） */
+export declare function keyDebugStart(): void;
+/** 记录一次按键 */
+export declare function keyDebug(input: string, key: KeyFlags): void;
+//# sourceMappingURL=key-debug.d.ts.map

package/dist/tui/key-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-debug.d.ts","sourceRoot":"","sources":["../../src/tui/key-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,iBAAiB,SAAqC,CAAC;AAEpE,+BAA+B;AAC/B,eAAO,MAAM,cAAc,QAAwD,CAAC;AAEpF,0DAA0D;AAC1D,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAK5E;AAqBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAGjF;AAED,oDAAoD;AACpD,wBAAgB,UAAU,IAAI,OAAO,CAGpC;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO9C;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED,aAAa;AACb,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAG3D"}

package/dist/tui/key-debug.js

@@ -0,0 +1,92 @@
+/**
+ * 按键诊断 —— 不同终端的按键编码差异极大（macOS 的 Option、PageUp/PageDown 尤其），
+ * 「某个键在我机器上没反应」这类问题靠猜毫无意义：要么键被 OS/终端吞掉，
+ * 要么终端发来的序列和我们认的不一样。两种情况的判定方法是同一个 —— 看日志里有几行。
+ *
+ * 用法：
+ *   AIZ_DEBUG_KEYS=1 aiz                       → 追加写到 <tmp>/aiz-key-debug.log
+ *   AIZ_DEBUG_KEYS=1 AIZ_KEYS_FILE=/path aiz   → 写到指定文件
+ *
+ * 判读：
+ *   - 按了键但日志里没有新增行 → 键根本没到应用（被 OS 快捷键或终端键位映射截走）
+ *   - 有行但 `input`/`flags` 与预期不符 → 序列认识，是匹配逻辑的问题
+ *   - 有行且 `raw=false` → 终端没处于 raw mode，键被终端自己解释了（如滚动 scrollback）
+ *
+ * 刻意在 `useInput` 回调里记录而不是直接监听 `stdin` 的 data 事件：
+ * 后者会把流切成 flowing 模式，与 Ink 内部的 readable 读取抢数据。
+ */
+import { appendFileSync } from "node:fs";
+export const KEY_DEBUG_ENABLED = process.env.AIZ_DEBUG_KEYS === "1";
+/** 日志落盘路径（测试与用户都可能改写，故导出常量） */
+export const KEY_DEBUG_FILE = process.env.AIZ_KEYS_FILE || "/tmp/aiz-key-debug.log";
+/** 终端环境摘要：排查「只在某终端失灵」时先看这一行 */
+export function terminalSummary(env = process.env) {
+    const keys = ["TERM", "TERM_PROGRAM", "TERM_PROGRAM_VERSION", "COLORTERM", "LANG", "COLUMNS", "LINES"];
+    const parts = keys.map((k) => `${k}=${env[k] ?? "-"}`);
+    parts.push(`platform=${process.platform}`, `node=${process.version}`);
+    return parts.join(" ");
+}
+const FLAG_NAMES = [
+    "ctrl",
+    "meta",
+    "shift",
+    "upArrow",
+    "downArrow",
+    "leftArrow",
+    "rightArrow",
+    "pageUp",
+    "pageDown",
+    "home",
+    "end",
+    "return",
+    "escape",
+    "tab",
+    "backspace",
+    "delete",
+];
+/**
+ * 把一次按键格式化成单行记录。
+ *
+ * `input` 用 JSON.stringify 转义（控制字符会变成 `\u001b` 这类可读形式），
+ * `raw` 表示按下时 stdin 是否仍在 raw mode —— 为 false 时键会被终端自己吃掉。
+ */
+export function formatKeyEvent(input, key, raw) {
+    const flags = FLAG_NAMES.filter((name) => key[name]).join(",");
+    return `key input=${JSON.stringify(input ?? "")} flags=[${flags}] raw=${raw}`;
+}
+/** 当前 stdin 是否处于 raw mode（非 TTY 或平台不支持时视为 false） */
+export function stdinIsRaw() {
+    const stdin = process.stdin;
+    return Boolean(stdin.isRaw);
+}
+let started = false;
+/**
+ * 记录一行到诊断日志；仅在 `AIZ_DEBUG_KEYS=1` 时生效。
+ *
+ * 同步写：调试期每次按键都写一行，量小；异步写反而可能在崩溃时丢最后几行
+ * —— 而那几行往往正是要看的那几行。
+ */
+export function keyDebugLog(line) {
+    if (!KEY_DEBUG_ENABLED)
+        return;
+    try {
+        appendFileSync(KEY_DEBUG_FILE, `${new Date().toISOString()} ${line}\n`);
+    }
+    catch {
+        /* 诊断失败绝不能影响主流程 */
+    }
+}
+/** 会话开始时写一行环境摘要（同一次运行只写一次） */
+export function keyDebugStart() {
+    if (!KEY_DEBUG_ENABLED || started)
+        return;
+    started = true;
+    keyDebugLog(`=== start ${terminalSummary()} file=${KEY_DEBUG_FILE} ===`);
+}
+/** 记录一次按键 */
+export function keyDebug(input, key) {
+    if (!KEY_DEBUG_ENABLED)
+        return;
+    keyDebugLog(formatKeyEvent(input, key, stdinIsRaw()));
+}
+//# sourceMappingURL=key-debug.js.map

package/dist/tui/key-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-debug.js","sourceRoot":"","sources":["../../src/tui/key-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG,CAAC;AAEpE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,wBAAwB,CAAC;AAsBpF,+BAA+B;AAC/B,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,GAAuB;IACrC,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,WAAW;IACX,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,MAAM;IACN,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,WAAW;IACX,QAAQ;CACT,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,GAAa,EAAE,GAAY;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,OAAO,aAAa,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS,GAAG,EAAE,CAAC;AAChF,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,KAA4B,CAAC;IACnD,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,iBAAiB;QAAE,OAAO;IAC/B,IAAI,CAAC;QACH,cAAc,CAAC,cAAc,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,iBAAiB,IAAI,OAAO;QAAE,OAAO;IAC1C,OAAO,GAAG,IAAI,CAAC;IACf,WAAW,CAAC,aAAa,eAAe,EAAE,SAAS,cAAc,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,aAAa;AACb,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,GAAa;IACnD,IAAI,CAAC,iBAAiB;QAAE,OAAO;IAC/B,WAAW,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC"}