mocode-ai 0.1.2 → 0.1.4

package/dist/tools/builtins/use-skill.js

@@ -4,7 +4,7 @@ import { getSkillBody } from '../../skills/index.js';
 // 系统提示里已列出可用 skill 的 name + description(何时用),模型据此决定调用。
 export const useSkillTool = {
     name: 'use_skill',
-    description: '加载并返回某个 skill 的完整 SKILL.md 指令。系统提示里列出了可用 skill(name + 何时用的 description)。只在任务相关时调用本工具传 skill 的 name,拿到完整指令后据此行动;不要无脑批量加载。',
+    description: '加载并返回某个 skill 的完整 SKILL.md 指令(传 name)。何时用见系统提示的 skill 列表。',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/web-fetch.js

@@ -4,7 +4,7 @@ const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,
 // ---------- web_fetch ----------
 export const webFetchTool = {
     name: 'web_fetch',
-    description: '抓取指定 URL 的网页内容并清洗成纯文本(去 HTML 标签/脚本/样式,保留正文)。用于读取搜索结果里的某个链接、或用户给出的具体 URL。注意:只能抓静态 HTML,JS 渲染的页面(正文靠脚本填充)可能拿不到内容——那种情况改用 web_search(其结果自带清洗后的 content)。',
+    description: '抓取指定 URL 的网页内容并清洗成纯文本(去 HTML 标签/脚本/样式,保留正文)。用于读取搜索结果里的某个链接、或用户给出的具体 URL。',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/builtins/web-search.js

@@ -6,7 +6,7 @@ const MAX_CONTENT_CHARS = 800;
 // ---------- web_search ----------
 export const webSearchTool = {
     name: 'web_search',
-    description: '联网搜索(AnySearch)。返回每条结果的标题/URL/摘要/正文,用于查模型训练数据之外的最新信息(新版本发布、新闻、实时数据、最新 API 文档等)。可选 tag 切换子域:general.general(默认通用网页)/ code.doc(开发文档,须配 params.library)/ code.snippet(代码片段)。',
+    description: '联网搜索(AnySearch)。返回每条结果的标题/URL/摘要/正文。可选 tag 切换子域(见 tag 参数)。',
     parameters: {
         type: 'object',
         properties: {

package/dist/tools/constants.js

@@ -8,4 +8,17 @@ export const MAX_HISTORY_RESULT = 8000;
 export const MAX_SKILL_RESULT = 64000;
 /** 微压缩时旧工具结果截到的存根长度(字符)。 */
 export const MAX_OLD_TOOL_STUB = 600;
+// ── 记忆(Tier-2 JSONL 工具库)──────────────────────────────────────────────
+/** 单条记忆 body 上限(字符)。进 history 前 memory_search 结果另有 MAX_MEMORY_RESULT 兜底。 */
+export const MAX_MEMORY_ENTRY = 4000;
+/** 启动注入 systemPrompt 的索引条目上限(遗忘封顶后 active 条目 ≤ MAX_ACTIVE,索引再封一层)。 */
+export const MAX_INDEX_ENTRIES = 50;
+/** active 记忆封顶:超则按 recallCount 低 × lastRecalledAt 老 淘汰到 archived。 */
+export const MAX_ACTIVE = 100;
+/** 衰减:active + !pinned + (lastRecalledAt|createdAt) 早于 DECAY_DAYS → archived。 */
+export const DECAY_DAYS = 30;
+/** GC:archived 超 GC_DAYS → 硬删。 */
+export const GC_DAYS = 90;
+/** memory_search 结果(召回的记忆正文)的放宽上限:指令性内容,中截破坏语义,对齐 use_skill。 */
+export const MAX_MEMORY_RESULT = 64000;
 export const IGNORE = ['**/node_modules/**', '**/.git/**'];

package/dist/ui/intervention.js

@@ -0,0 +1,297 @@
+import readline from 'node:readline';
+import { stdin, stderr } from 'node:process';
+import { ui } from './theme.js';
+import { displayWidth, truncateDisplay } from './render.js';
+import * as layout from './layout.js';
+import { Spinner } from './spinner.js';
+const emitter = stdin;
+/** choice 末尾的"自定义输入"项标签(纯 ASCII,宽度安全)。选中后切到 input 子态。 */
+const CUSTOM_LABEL = '其他(自定义输入)';
+/** 弹出介入面板,阻塞直到用户完成选择。 */
+export async function promptIntervention(req) {
+    // 非 TTY 降级:不阻塞,自动选默认。日志走 stderr(不污染 stdout 内容流)。
+    if (!layout.isActive()) {
+        const kind = req.type === 'choice' ? '自动选默认项' : '自动返回空输入';
+        stderr.write(`[介入] ${req.title}(非交互环境,${kind})\n`);
+        if (req.type === 'choice') {
+            return { action: 'selected', value: req.options?.[0] ?? '' };
+        }
+        return { action: 'submitted', value: req.seed ?? '' };
+    }
+    const options = req.type === 'choice' && Array.isArray(req.options)
+        ? req.options.map((o) => String(o)).filter((s) => s.length > 0)
+        : [];
+    // choice 但选项被滤空 → 降级 input(对齐设计文档 §8:ask_human 选项为空数组→input)。
+    const startMode = req.type === 'choice' && options.length > 0 ? 'choice' : 'input';
+    let mode = startMode;
+    // choice:选中下标(0..options.length-1 为各选项,options.length 为"自定义"项)。
+    let selected = 0;
+    // input:可编辑文本 + 光标(UTF-16 码元索引;显示位置由 displayWidth 算,见 paintInput)。
+    let text = req.seed ?? '';
+    let cursor = text.length;
+    // input 是否由 choice 的"自定义"项切入(决定 Esc 是返回 choice 还是取消)。
+    let cameFromChoice = false;
+    let resolved = false;
+    let resolve;
+    // 挂自己监听前快照的现有 keypress 监听(运行态即 onRunningKey),退出时按原序恢复。
+    let savedListeners = [];
+    /** choice 菜单行:标题(bold)+ detail(dim,行数上限保选项可见)+ 空行 + 选项(▸ 选中/dim)。 */
+    function menuLinesChoice() {
+        const g = layout.getGeo();
+        const cols = g.cols;
+        const items = [...options, CUSTOM_LABEL];
+        const optionCount = items.length;
+        // detail 上限:title(1)+detail(D)+空行(1)+options(O) ≤ contentBottom → D ≤ contentBottom-2-O
+        const detailCap = Math.max(0, g.contentBottom - 2 - optionCount);
+        const lines = [];
+        lines.push(`${ui.bold}${truncateDisplay(req.title, cols)}${ui.reset}`);
+        if (req.detail) {
+            const dl = req.detail.split('\n');
+            const shown = dl.slice(0, detailCap);
+            for (const d of shown) {
+                lines.push(`${ui.dim}${truncateDisplay(d, cols)}${ui.reset}`);
+            }
+            if (dl.length > detailCap)
+                lines.push(`${ui.dim}…${ui.reset}`);
+        }
+        lines.push(''); // 分隔空行
+        // 选项开窗:超屏高时以 selected 为中心取窗,保选中项可见。
+        const maxOptRows = Math.max(1, g.contentBottom - lines.length);
+        let start = 0;
+        if (optionCount > maxOptRows) {
+            start = Math.max(0, Math.min(selected - Math.floor(maxOptRows / 2), optionCount - maxOptRows));
+        }
+        const count = Math.min(maxOptRows, optionCount);
+        for (let i = 0; i < count; i++) {
+            const idx = start + i;
+            // 选中项:▸ 与正文均 cyan+bold(去 dim),未选中项保持 dim——选中行整体高亮。
+            const isSel = idx === selected;
+            const color = isSel ? `${ui.cyan}${ui.bold}` : ui.dim;
+            const marker = isSel ? `${ui.cyan}${ui.bold}▸${ui.reset}` : ' ';
+            const body = truncateDisplay(items[idx], cols - 2);
+            lines.push(`${marker} ${color}${body}${ui.reset}`);
+        }
+        return lines;
+    }
+    /** input 菜单行:标题(bold)+ detail(dim)+ 提示行(dim)。可编辑文本在底栏输入框。 */
+    function menuLinesInput() {
+        const g = layout.getGeo();
+        const cols = g.cols;
+        const detailCap = Math.max(0, g.contentBottom - 2); // title(1)+提示(1)
+        const lines = [];
+        lines.push(`${ui.bold}${truncateDisplay(req.title, cols)}${ui.reset}`);
+        if (req.detail) {
+            const dl = req.detail.split('\n');
+            const shown = dl.slice(0, detailCap);
+            for (const d of shown) {
+                lines.push(`${ui.dim}${truncateDisplay(d, cols)}${ui.reset}`);
+            }
+            if (dl.length > detailCap)
+                lines.push(`${ui.dim}…${ui.reset}`);
+        }
+        lines.push(`${ui.dim}Enter 提交 · Esc ${cameFromChoice ? '返回选项' : '取消'} · Ctrl+C 取消${ui.reset}`);
+        return lines;
+    }
+    function redraw() {
+        if (mode === 'choice') {
+            const hint = '↑↓ 选择 · Enter 确认 · 数字键直选 · Esc 取消';
+            layout.paintInput({
+                prompt: '❯ ',
+                lines: [hint],
+                cursorLine: 0,
+                cursorCol: displayWidth(hint),
+                menu: { lines: menuLinesChoice() },
+                caret: false, // 纯导航(非文本输入):不画输入框块状光标,聚焦由选项 ▸ 标记
+            });
+        }
+        else {
+            layout.paintInput({
+                prompt: '❯ ',
+                lines: [text],
+                cursorLine: 0,
+                cursorCol: displayWidth(text.slice(0, cursor)),
+                menu: { lines: menuLinesInput() },
+            });
+        }
+    }
+    function finish(result) {
+        if (resolved)
+            return;
+        resolved = true;
+        cleanup();
+        resolve(result);
+    }
+    /** 退出:摘自己的监听 + 恢复快照监听 + 擦菜单恢复内容区。不 setRawMode(false)/pause stdin(运行态由 repl 接管)。 */
+    function cleanup() {
+        emitter.removeListener('keypress', onKey);
+        for (const l of savedListeners)
+            emitter.on('keypress', l);
+        savedListeners = [];
+        // 先 paintInput(dim,menu:null):擦菜单(用 lastMenuRows)+ 画 dim 占位底栏 + 复位 lastMenuRows=0;
+        // 再 repaintViewport:从 content 缓冲重画内容区(恢复被菜单覆盖的 ● ask_human 行)。
+        // 顺序不可反——repaintViewport 后再 paintInput(menu:null) 会用 stale lastMenuRows 擦掉已恢复的内容。
+        layout.paintInput({
+            prompt: '❯ ',
+            lines: [''],
+            cursorLine: 0,
+            cursorCol: 0,
+            menu: null,
+            dim: true,
+        });
+        layout.repaintViewport();
+    }
+    function onKey(_str, key) {
+        if (resolved || !key)
+            return;
+        // Ctrl+C → 取消(不 reject SIGINT——否则经 executeTool 的 try/catch 变成 tool 错误串)
+        if (key.ctrl && key.name === 'c') {
+            finish({ action: 'cancelled' });
+            return;
+        }
+        if (key.name === 'escape') {
+            if (mode === 'input' && cameFromChoice) {
+                // 由 choice"自定义"项切入的 input:Esc 返回选项(不取消整次提问)
+                mode = 'choice';
+                redraw();
+                return;
+            }
+            finish({ action: 'cancelled' });
+            return;
+        }
+        if (mode === 'choice') {
+            onKeyChoice(key);
+        }
+        else {
+            onKeyInput(key);
+        }
+    }
+    function onKeyChoice(key) {
+        const itemCount = options.length + 1; // +自定义项
+        switch (key.name) {
+            case 'up':
+                selected = (selected - 1 + itemCount) % itemCount;
+                redraw();
+                return;
+            case 'down':
+                selected = (selected + 1) % itemCount;
+                redraw();
+                return;
+            case 'return':
+            case 'enter':
+                if (selected === options.length) {
+                    // 自定义项 → 切 input 子态(空文本起)
+                    mode = 'input';
+                    cameFromChoice = true;
+                    text = '';
+                    cursor = 0;
+                    redraw();
+                }
+                else {
+                    finish({ action: 'selected', value: options[selected] });
+                }
+                return;
+        }
+        // 数字键 1-9 直选对应选项(自定义项不绑定数字)
+        const s = key.sequence ?? '';
+        if (s >= '1' && s <= '9') {
+            const n = Number(s) - 1;
+            if (n < options.length) {
+                finish({ action: 'selected', value: options[n] });
+            }
+        }
+    }
+    function onKeyInput(key) {
+        if (key.name === 'return' || key.name === 'enter') {
+            finish({ action: 'submitted', value: text });
+            return;
+        }
+        if (key.ctrl && key.name === 'a') {
+            cursor = 0;
+            redraw();
+            return;
+        }
+        if (key.ctrl && key.name === 'e') {
+            cursor = text.length;
+            redraw();
+            return;
+        }
+        switch (key.name) {
+            case 'backspace':
+                if (cursor > 0) {
+                    text = text.slice(0, cursor - 1) + text.slice(cursor);
+                    cursor--;
+                    redraw();
+                }
+                return;
+            case 'left':
+                if (cursor > 0) {
+                    cursor--;
+                    redraw();
+                }
+                return;
+            case 'right':
+                if (cursor < text.length) {
+                    cursor++;
+                    redraw();
+                }
+                return;
+            case 'home':
+                cursor = 0;
+                redraw();
+                return;
+            case 'end':
+                cursor = text.length;
+                redraw();
+                return;
+        }
+        // 可打印字符(>= 空格,非 ctrl/meta)→ 插入光标处(\n < ' ' 自动排除,保单行)
+        const s = key.sequence ?? '';
+        if (s && s >= ' ' && !key.ctrl && !key.meta) {
+            text = text.slice(0, cursor) + s + text.slice(cursor);
+            cursor += s.length;
+            redraw();
+        }
+    }
+    return new Promise((res, rej) => {
+        resolve = res;
+        try {
+            // 进入面板:停 spinner(避免 onFrame 覆盖)+ 回尾(若用户正滚动回看)
+            Spinner.pauseCurrent();
+            layout.resetScroll();
+            // 快照现有 keypress 监听(运行态的 onRunningKey)并摘掉,挂自己的 onKey
+            savedListeners = emitter.listeners('keypress').slice();
+            for (const l of savedListeners)
+                emitter.removeListener('keypress', l);
+            readline.emitKeypressEvents(stdin); // 幂等(运行态已挂解析器,防御性再调)
+            // raw 模式:runAgent 期间 repl 已设 true;防御性确保(失败则按键不来,但不崩)
+            try {
+                stdin.setRawMode(true);
+            }
+            catch {
+                // 非 TTY / 不支持:忽略(实际非 TTY 已在上方 isActive 守卫返回)
+            }
+            stdin.resume();
+            emitter.on('keypress', onKey);
+            redraw();
+        }
+        catch (e) {
+            // 进入失败:必须恢复运行态监听,否则 onRunningKey 残留摘除 → 本 turns 的 Ctrl+C/滚动/typeahead 全废
+            try {
+                emitter.removeListener('keypress', onKey);
+            }
+            catch {
+                // 忽略
+            }
+            for (const l of savedListeners) {
+                try {
+                    emitter.on('keypress', l);
+                }
+                catch {
+                    // 忽略
+                }
+            }
+            savedListeners = [];
+            rej(e instanceof Error ? e : new Error(String(e)));
+        }
+    });
+}

package/dist/ui/layout.js

@@ -1,11 +1,11 @@
 import { stdin, stdout } from 'node:process';
-import { charWidth, displayWidth, truncateDisplay, ansiDisplayWidth, wrapByDisplayWidth, } from './render.js';
+import { charWidth, displayWidth, truncateDisplay, ansiDisplayWidth, wrapByDisplayWidth, fmtElapsed, } from './render.js';
 import { ui } from './theme.js';
 import * as content from './content.js';
 // ── 内部状态 ──
 let active = false;
 let mode = 'input';
-let footerH = 2; // 1 状态行 + 输入行数
+let footerH = 4; // 1 状态行 + 1 上线 + 输入行数 + 1 下线(上下线框住输入区)
 let contentRow = 1; // 续写位行(1-based,屏坐标,[1,contentBottom])
 let contentCol = 1; // 续写位列(1-based)
 let segmentStartRow = 1; // 当前思考段起始屏行(供 eraseSegmentBack 定位擦除起点;段内行数由 content 段标记跟踪)
@@ -13,6 +13,8 @@ let scrollOffset = 0; // 滚动回看距尾行数(0=尾,跟随新内容);>0 时
 let base = null;
 let statusText = '';
 let spinnerFrame;
+let turnStart = null; // RUNNING 态起点(Date.now());INPUT 态为 null。composeStatus 据此拼走时。
+let turnTimer = null; // 走时刷新计时器(独立于 spinner):流式期间 spinner 停转,由它续刷状态行。
 let lastView = null;
 let lastMenuStartRow = 0; // 上次菜单起始屏行(供擦除)
 let lastMenuRows = 0;
@@ -282,9 +284,17 @@ function composeStatus(status, cols) {
     const ctxW = ansiDisplayWidth(ctx);
     // 滚动回看时状态段改显历史指示(无 spinner——滚动只在 INPUT 态)
     const scrolled = scrollOffset > 0;
-    const st = scrolled
-        ? `历史 ↑${scrollOffset} (PgDn 回底)`
-        : (status.spinnerFrame ? status.spinnerFrame + ' ' : '') + status.status;
+    let st;
+    if (scrolled) {
+        st = `历史 ↑${scrollOffset} (PgDn 回底)`; // 滚动回看显历史指示,不显走时
+    }
+    else {
+        st = (status.spinnerFrame ? status.spinnerFrame + ' ' : '') + status.status;
+        // RUNNING 态追加走时:整轮从 enterRunningMode 起计时,200ms 计时器续刷使其连续递增。
+        if (mode === 'running' && turnStart != null) {
+            st += ` · ${fmtElapsed(Date.now() - turnStart)}`;
+        }
+    }
     const stW = displayWidth(st);
     const fixed = displayWidth(lead) + displayWidth(model) + sepW * 3 + ctxW + stW;
     const cwdBudget = cols - fixed - 1;
@@ -316,6 +326,26 @@ export function setStatus(status, frame) {
     spinnerFrame = frame;
     drawStatusBar();
 }
+/**
+ * 启走时刷新计时器:RUNNING 态每 200ms 重画状态行,使 composeStatus 重算 elapsed。
+ * 必要性:spinner 在首 token 到达即 stop,思考/正文流式期间状态行不再经 spinner 刷新;
+ * 若走时只挂 spinner onFrame,流式那几十秒会冻住。此计时器独立续刷,与 spinner 80ms 重叠幂等无妨。
+ * 非 TTY 不启(active=false 时 drawStatusBar 为 no-op)。
+ */
+function startTurnTimer() {
+    if (!active)
+        return;
+    stopTurnTimer();
+    turnTimer = setInterval(() => drawStatusBar(), 200);
+    turnTimer.unref();
+}
+/** 停走时计时器。enterInputMode / exitAltScreen 调。 */
+function stopTurnTimer() {
+    if (turnTimer) {
+        clearInterval(turnTimer);
+        turnTimer = null;
+    }
+}
 /**
  * 在续写位画一行瞬时活动文本(spinner 帧):不进缓冲、不推进续写位,逐行 clearLine 重画。
  * 仅 TTY + offset=0(实时尾)时物理写屏;滚动态跳过(由状态行 spinner 兜底,且避免覆盖 viewport 历史行)。
@@ -389,6 +419,31 @@ function windowInputVis(lines, cursorLine, cursorCol, cols, promptW, rows) {
         startVis,
     };
 }
+/**
+ * 把一行纯可见文本(无 ANSI / 零宽)在光标显示列处切成 before/cur/after:
+ * cur = 光标右侧那个字符(块状光标"压"在它上面);光标在行末(列 == 行宽)则 cur=''。
+ * 供 paintInput 画块状光标——反白 cur(行末反白一个空格),让用户看清"现在在哪输入"。
+ *
+ * 光标列恒落在字符边界:cursorCol = 显示宽度(slice 整字累加),不进字符内部,故按 acc===col 取字符即可。
+ * 宽字符(CJK=2)在行尾放不下时整字折下行,光标列仍在边界,acc 逐字累加 displayWidth 与终端光标一致。
+ */
+function splitAtVisCol(line, col) {
+    let acc = 0;
+    let i = 0;
+    for (const ch of line) {
+        const cw = charWidth(ch.codePointAt(0) ?? 0);
+        if (cw <= 0) {
+            i += ch.length;
+            continue; // 零宽(组合符等):不计列,跳过(输入文本一般无,稳妥)
+        }
+        if (acc === col) {
+            return { before: line.slice(0, i), cur: ch, after: line.slice(i + ch.length) };
+        }
+        acc += cw;
+        i += ch.length;
+    }
+    return { before: line, cur: '', after: '' }; // 光标在行末:无字符可反白
+}
 /**
  * 画输入区:擦旧菜单 → (必要时)setRegion → 画状态行 + 输入行 + 向上菜单,光标留输入框(dim 时回续写位)。
  * prompt.ts 每次按键调;enterInputMode / enterRunningMode 也调(空 / dim)。
@@ -398,13 +453,14 @@ export function paintInput(view) {
         return;
     lastView = view;
     const preGeo = getGeo();
+    // 累积本帧所有 cup/clearLine/文本,末尾一次写出——避免「擦旧菜单」与「重画」分多次 write 时,
+    // 终端把中间空白渲染出来 → 菜单/面板切换时闪烁(↑↓ 导航每次 redraw 都全帧擦后重画)。
+    let buf = '';
     // 1. 擦旧菜单(用上次记录的起始行 + 行数,与本次几何无关——setRegion 不动屏幕内容)
     if (lastMenuRows > 0) {
-        let p = '';
         for (let i = 0; i < lastMenuRows; i++) {
-            p += cup(lastMenuStartRow + i, 1) + esc.clearLine;
+            buf += cup(lastMenuStartRow + i, 1) + esc.clearLine;
         }
-        stdout.write(p);
         lastMenuRows = 0;
     }
     // 2. 算输入可视行(软折行)+ 必要时 setRegion。dim=运行态占位:单行不折行。
@@ -418,55 +474,77 @@ export function paintInput(view) {
             startVis: 0,
         }
         : windowInputVis(view.lines, view.cursorLine, view.cursorCol, preGeo.cols, promptW, preGeo.rows);
-    const needFooterH = 1 + vis.inputRows;
+    const needFooterH = 3 + vis.inputRows; // 1 状态 + 1 上线 + 输入行 + 1 下线
     let g = preGeo;
-    if (needFooterH !== footerH)
+    if (needFooterH !== footerH) {
+        // setRegion 自己 write(DECSTBM + 清行 + 归位):先把已累积的擦除 flush 出去保序(擦除用的是旧几何的
+        // lastMenuStartRow,须在 setRegion 改区域前落地),再 setRegion,之后 2b..6 重新累积。
+        // footerH 不变时(常见:单行输入 / 菜单切换 / ↑↓ 导航)整帧一次 write,终端原子应用,无中间空白→不闪烁。
+        if (buf) {
+            stdout.write(buf);
+            buf = '';
+        }
         g = setRegion(needFooterH);
+    }
     // 2b. 重画内容末行(底栏上一行)从缓冲:防 WT 边距漏影(状态行重复到该行),并保证该行显正确内容
     {
         const slice = content.sliceFromEnd(scrollOffset, g.contentBottom);
         const line = slice[g.contentBottom - 1] ?? '';
-        stdout.write(cup(g.contentBottom, 1) + esc.clearLine + line);
+        buf += cup(g.contentBottom, 1) + esc.clearLine + line;
     }
     // 3. 状态行(footerH 变或始终重画——便宜且避免旧状态行残留)
     const statusRow = g.contentBottom + 1;
     const status = { ...base, status: statusText, spinnerFrame };
-    stdout.write(cup(statusRow, 1) + esc.clearLine + composeStatus(status, g.cols));
-    // 4. 输入行(g.contentBottom+2 .. rows)——按可视行画,首行带 prompt、其余缩进 promptW
-    const firstInputRow = g.contentBottom + 2;
-    const inputRowsAvail = g.footerH - 1;
+    buf += cup(statusRow, 1) + esc.clearLine + composeStatus(status, g.cols);
+    // 3b. 上线(输入框顶):满屏宽细线 ─(cyan),框住输入区上边界
+    buf += cup(g.contentBottom + 2, 1) + esc.clearLine + ui.cyan + '─'.repeat(g.cols) + ui.reset;
+    // 4. 输入行(g.contentBottom+3 .. rows-1)——按可视行画,首行带 prompt、其余缩进 promptW
+    const firstInputRow = g.contentBottom + 3;
+    const inputRowsAvail = g.footerH - 3; // 去掉状态/上线/下线,留输入行
     const indent = ' '.repeat(promptW);
+    const showCaret = view.caret !== false; // 默认 true;picker 等非文本输入传 false 关闭块状光标
     for (let i = 0; i < inputRowsAvail; i++) {
         const line = vis.visRows[i] ?? '';
         const r = firstInputRow + i;
         const prefix = vis.startVis === 0 && i === 0 ? view.prompt : indent;
-        const text = view.dim
-            ? `${ui.dim}${prefix}${line}${ui.reset}`
-            : `${prefix}${line}`;
-        stdout.write(cup(r, 1) + esc.clearLine + text);
+        let text;
+        if (view.dim) {
+            text = `${ui.dim}${prefix}${line}${ui.reset}`;
+        }
+        else if (showCaret && i === vis.visLine) {
+            // 块状光标:反白光标右侧字符(cur),行末(无字符)反白一个空格——示"现在在哪输入"
+            const { before, cur, after } = splitAtVisCol(line, vis.cursorVisCol);
+            text = `${prefix}${before}${ui.reverse}${cur || ' '}${ui.reset}${after}`;
+        }
+        else {
+            text = `${prefix}${line}`;
+        }
+        buf += cup(r, 1) + esc.clearLine + text;
     }
+    // 4b. 下线(输入框底):满屏宽细线 ─(cyan),固定屏底 rows
+    buf += cup(g.rows, 1) + esc.clearLine + ui.cyan + '─'.repeat(g.cols) + ui.reset;
     // 5. 向上菜单(画在内容区底,底栏正上方)
     if (view.menu && view.menu.lines.length > 0) {
         const menuRows = Math.min(view.menu.lines.length, g.contentBottom);
         const menuStart = g.contentBottom - menuRows + 1;
-        let p = '';
         for (let i = 0; i < menuRows; i++) {
-            p += cup(menuStart + i, 1) + esc.clearLine + view.menu.lines[i];
+            buf += cup(menuStart + i, 1) + esc.clearLine + view.menu.lines[i];
         }
-        stdout.write(p);
         lastMenuStartRow = menuStart;
         lastMenuRows = menuRows;
     }
     // 6. 光标
     if (view.dim) {
         // 滚动回看时归内容区底(dim=运行态占位,光标不入输入框,viewport 锁历史)
-        stdout.write(cup(scrollOffset === 0 ? contentRow : g.contentBottom, scrollOffset === 0 ? contentCol : 1));
+        buf += cup(scrollOffset === 0 ? contentRow : g.contentBottom, scrollOffset === 0 ? contentCol : 1);
     }
     else {
         const r = firstInputRow + vis.visLine;
         const col = promptW + vis.cursorVisCol + 1;
-        stdout.write(cup(r, col));
+        buf += cup(r, col);
     }
+    if (buf)
+        stdout.write(buf); // 整帧一次写出(footerH 不变时):终端原子应用,无中间空白→不闪烁
 }
 /**
  * 运行态 typeahead 回显:定向写输入行(底栏输入框),把 dim 占位换成已打字文本(无打字时仍显 placeholder)。
@@ -478,9 +556,10 @@ export function paintRunningInputEcho(text, placeholder) {
     if (!active || !base)
         return;
     const g = getGeo();
-    const inputRow = g.contentBottom + 2; // 运行态 footerH 恒 2:状态行(contentBottom+1)+ 输入行(contentBottom+2)
+    const inputRow = g.contentBottom + 3; // 运行态 footerH 恒 4:状态(+1)+上线(+2)+输入行(+3);下线在 rows
     const shown = text.length > 0 ? text : placeholder;
-    stdout.write(cup(inputRow, 1) + esc.clearLine + `${ui.dim}❯ ${shown}${ui.reset}`);
+    const trimmed = truncateDisplay(shown, g.cols - 2); // 截断防超长软折行写穿下线
+    stdout.write(cup(inputRow, 1) + esc.clearLine + `${ui.dim}❯ ${trimmed}${ui.reset}`);
     // 同步 lastView:dim 视图(lines=回显文本),使滚动/resize 的 repaint 不擦掉已打字
     lastView = {
         prompt: '❯ ',
@@ -507,8 +586,10 @@ export function enterInputMode(status = '空闲') {
     mode = 'input';
     statusText = status;
     spinnerFrame = undefined;
+    turnStart = null; // 停走时
+    stopTurnTimer();
     if (active && base) {
-        setRegion(2);
+        setRegion(4); // 1 状态 + 1 上线 + 1 输入 + 1 下线
         paintInput({
             prompt: '❯ ',
             lines: [''],
@@ -518,14 +599,15 @@ export function enterInputMode(status = '空闲') {
         });
     }
 }
-/** 进入运行态:底栏输入行改 dim 占位,光标回续写位。footerH 恒 2。新轮回尾(确保新内容可见)。 */
+/** 进入运行态:底栏输入行改 dim 占位,光标回续写位。footerH 恒 4(状态+上线+输入+下线)。新轮回尾(确保新内容可见)。 */
 export function enterRunningMode(status, placeholder) {
     mode = 'running';
     statusText = status;
     spinnerFrame = undefined;
+    turnStart = Date.now(); // 起走时(整轮从发起到 enterInputMode 止)
     resetScroll(); // 若上轮 INPUT 滚动过(未打字回底),新轮回尾
     if (active && base) {
-        setRegion(2);
+        setRegion(4); // 1 状态 + 1 上线 + 1 输入 + 1 下线
         paintInput({
             prompt: '❯ ',
             lines: [placeholder],
@@ -534,6 +616,7 @@ export function enterRunningMode(status, placeholder) {
             menu: null,
             dim: true,
         });
+        startTurnTimer(); // 续刷状态行走时(流式期间 spinner 停转,由它兜底)
         contentMode();
     }
 }
@@ -544,7 +627,7 @@ export function enterAltScreen() {
     active = true;
     stdout.write(esc.altOn);
     stdout.write(esc.altScrollOn); // alt 屏滚轮转发 ↑/↓(滚轮滚动靠此 + onKey/onRunningKey 的 ↑/↓ 滚动)
-    setRegion(2);
+    setRegion(4); // 1 状态 + 1 上线 + 1 输入 + 1 下线(底栏始终含上下线)
     contentRow = 1;
     contentCol = 1;
     segmentStartRow = 1;
@@ -581,6 +664,8 @@ export function exitAltScreen() {
     if (!active)
         return;
     active = false;
+    stopTurnTimer(); // 兜底清走时计时器(防异常退出泄漏)
+    turnStart = null;
     // raw 还原独立 try:非 TTY / 不支持时 setRawMode 抛错,不应阻断 stdout 恢复(alt 退屏必须执行)。
     try {
         stdin.setRawMode(false); // 还原 raw(RUNNING 态常驻 raw,退出时必须还原,否则终端残留 raw 模式)