mocode-ai 0.1.0 → 0.1.2

package/dist/agent/index.js

@@ -1,12 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
 import { chat, } from '../llm/index.js';
 import { executeTool } from '../tools/registry.js';
 import { ui } from '../ui/theme.js';
 import { Spinner } from '../ui/spinner.js';
 import { summarizeToolCall, summarizeToolResult, truncateDisplay, } from '../ui/render.js';
+import { renderFileChange } from '../ui/diff.js';
 import * as layout from '../ui/layout.js';
 import { beginTurn } from '../rollback/index.js';
 import { maybeCompact, capToolResultForHistory, contextState, } from '../session/index.js';
 const MAX_STEPS = 25; // 防止无限循环
+/** 解析工具 arguments JSON;非法或空返 null(调用方据此降级到普通 preview)。 */
+function parseArgs(raw) {
+    try {
+        return raw.trim() ? JSON.parse(raw) : {};
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * agent 核心循环:
  *  流式调 LLM(onText / onThinking 实时写内容区)→ 有 tool_calls 就执行并回灌
@@ -27,7 +39,17 @@ export async function runAgent(history, userInput, collapsedThinkings = [], sign
     // 开新轮次(回滚用):首行截断 40,供 /rollback 轮次菜单展示。
     beginTurn(truncateDisplay(userInput.split('\n')[0] ?? '', 40));
     layout.contentMode(); // 防御性:确保光标在内容续写位(enterRunningMode 已置,这里兜底)
-    const spinner = new Spinner((msg, frame) => layout.setStatus(msg, frame ?? undefined));
+    // spinner:状态行 + 续写位内联转圈(思考中 / 执行 工具时,内容区不再「干等」)。
+    // 内联帧不进缓冲、停时清掉,随后结果即写在该行——故 spinner 不入历史、PgUp 看不到。
+    const spinner = new Spinner((msg, frame) => {
+        layout.setStatus(msg, frame ?? undefined);
+        if (frame) {
+            layout.paintLiveAtCursor(`  ${ui.brightMagenta}${frame}${ui.reset} ${ui.dim}${msg}…${ui.reset}`);
+        }
+        else {
+            layout.clearLiveAtCursor();
+        }
+    });
     // 本轮流式状态:区分「思考」与「正文」,首个 token 到达即停 spinner。
     let mode = 'idle';
     let gotText = false;
@@ -69,14 +91,23 @@ export async function runAgent(history, userInput, collapsedThinkings = [], sign
     };
     const onText = (s) => {
         flushThinkCollapsed(); // 思考→正文过渡时折叠
-        if (mode === 'idle')
-            spinner.stop();
+        spinner.stop(); // 任何正文 token 都停 spinner(首 token 停「思考中」;onToolCall 重启后若又来文本则停「生成中」)。未旋转时 stop 为 no-op。
         mode = 'text';
         gotText = true;
         layout.contentWrite(s);
         if (s)
             lastChar = s[s.length - 1];
     };
+    const onToolCall = (name) => {
+        // 文本/思考已流完,模型转而生成 tool_call 参数(可能很长,如 write_file 整篇内容):
+        // 补换行(让随后的 ● 行与 diff 不黏在正文末尾)+ 启「生成中」内联 spinner,内容区不再干等。
+        if (lastChar && lastChar !== '\n') {
+            layout.contentWrite('\n');
+            lastChar = '\n';
+        }
+        if (name)
+            spinner.start(`生成 ${name}…`);
+    };
     try {
         for (let step = 0; step < MAX_STEPS; step++) {
             // 步前:接近窗口上限时自动压缩(三层)。此时 spinner 已停,通知行干净。
@@ -87,7 +118,7 @@ export async function runAgent(history, userInput, collapsedThinkings = [], sign
             lastChar = '';
             let result;
             try {
-                result = await chat(history, { onText, onThinking }, signal);
+                result = await chat(history, { onText, onThinking, onToolCall }, signal);
             }
             catch (e) {
                 // 中断(用户运行中 Ctrl+C):停 spinner、补换行、提示、history 还原到本 turn 前、return(不抛)。
@@ -110,6 +141,9 @@ export async function runAgent(history, userInput, collapsedThinkings = [], sign
             if (result.toolCalls.length > 0) {
                 // 思考后直接进入 tool_call(无 text):先把可见的思考段折叠
                 flushThinkCollapsed();
+                // 流式正文末尾补换行(若 onToolCall 已补则 lastChar='\n',此处 no-op);防 ● 行黏在正文行尾
+                if (mode !== 'idle' && lastChar !== '\n')
+                    layout.contentWrite('\n');
                 // 带工具调用的 assistant 消息原样回灌(OpenAI 格式要求)
                 history.push({
                     role: 'assistant',
@@ -123,12 +157,59 @@ export async function runAgent(history, userInput, collapsedThinkings = [], sign
                 for (const tc of result.toolCalls) {
                     const summary = summarizeToolCall(tc.name, tc.arguments);
                     layout.contentWrite(`  ${ui.brightMagenta}●${ui.reset} ${ui.cyan}${tc.name}${ui.reset}  ${ui.dim}${summary}${ui.reset}\n`);
+                    const isMutation = tc.name === 'edit_file' || tc.name === 'write_file';
+                    const parsed = isMutation ? parseArgs(tc.arguments) : null;
+                    // write_file 覆盖场景:执行前读旧内容供 diff(不存在→null=新建)。
+                    // edit_file:执行前读文件定位 old_string 起始行,供 diff 显示真实文件行号。
+                    // 两者皆失败不阻断(读不到则 diff 退化为相对行号 / 不渲染)。
+                    let preWriteOld = null;
+                    let editStartLine = 1;
+                    if (parsed) {
+                        const p = String(parsed.path ?? '');
+                        if (p) {
+                            if (tc.name === 'write_file') {
+                                try {
+                                    preWriteOld = readFileSync(resolve(p), 'utf8');
+                                }
+                                catch {
+                                    preWriteOld = null; // 文件不存在(新建)或不可读
+                                }
+                            }
+                            else if (tc.name === 'edit_file') {
+                                const oldStr = String(parsed.old_string ?? '');
+                                try {
+                                    const data = readFileSync(resolve(p), 'utf8');
+                                    const idx = oldStr ? data.indexOf(oldStr) : -1;
+                                    if (idx >= 0)
+                                        editStartLine = data.slice(0, idx).split('\n').length;
+                                }
+                                catch {
+                                    // 读不到:startLine 保持 1(diff 退化为相对行号)
+                                }
+                            }
+                        }
+                    }
                     spinner.start(`执行 ${tc.name}`);
                     const output = await executeTool(tc.name, tc.arguments);
                     spinner.stop();
-                    const preview = summarizeToolResult(tc.name, output);
-                    if (preview) {
-                        layout.contentWrite(`  ${ui.gray}↳ ${preview}${ui.reset}\n`);
+                    // edit_file / write_file 成功:渲染 diff 块(行号 + 语法高亮,仿 Claude Code);其余工具走一行 preview。
+                    if (isMutation && parsed && !output.startsWith('错误')) {
+                        layout.contentWrite(renderFileChange({
+                            path: String(parsed.path ?? ''),
+                            kind: tc.name === 'edit_file' ? 'edit' : 'write',
+                            oldStr: tc.name === 'edit_file'
+                                ? String(parsed.old_string ?? '')
+                                : preWriteOld,
+                            newStr: String((tc.name === 'edit_file' ? parsed.new_string : parsed.content) ??
+                                ''),
+                            startLine: tc.name === 'edit_file' ? editStartLine : 1,
+                        }));
+                    }
+                    else {
+                        const preview = summarizeToolResult(tc.name, output);
+                        if (preview) {
+                            layout.contentWrite(`  ${ui.gray}↳ ${preview}${ui.reset}\n`);
+                        }
                     }
                     history.push({
                         role: 'tool',

package/dist/index.js

@@ -1,4 +1,5 @@
 import { exitAltScreen } from './ui/layout.js';
+import { checkAndMaybeUpdate } from './updater/index.js';
 // 终端恢复兜底:任一退出 / 中断 / 未捕获异常路径都要恢复 alt screen,避免残留备用屏 + 滚动区域。
 // exitAltScreen 幂等(未激活时空操作),故全局注册安全——进 alt screen 前的路径(如 --resume 列表、缺环境变量、`mocode config`)调用它无副作用。
 // 仅 layout 是叶子(不依赖 config),故静态导入安全;repl / session 依赖 config(requireEnv 缺项即退出),改动态按需加载——`mocode config` 才能在零配置下跑。
@@ -63,12 +64,14 @@ async function main() {
             console.error(`[session] 找不到会话 ${id}(用 --resume 查看列表)`);
             process.exit(1);
         }
+        const updateNotice = checkAndMaybeUpdate();
         const { startRepl } = await import('./repl/index.js');
-        await startRepl(loaded.history, loaded.id);
+        await startRepl(loaded.history, loaded.id, updateNotice);
     }
     else {
+        const updateNotice = checkAndMaybeUpdate();
         const { startRepl } = await import('./repl/index.js');
-        await startRepl();
+        await startRepl(undefined, undefined, updateNotice);
     }
     process.exit(0);
 }

package/dist/llm/index.js

@@ -67,8 +67,12 @@ export async function chat(messages, handlers = {}, signal) {
                 }
                 if (tc.id)
                     entry.id = tc.id;
-                if (tc.function?.name)
-                    entry.name += tc.function.name;
+                const fname = tc.function?.name;
+                if (fname) {
+                    if (!entry.name)
+                        handlers.onToolCall?.(fname); // 首次得知工具名:通知调用方启生成中 spinner
+                    entry.name += fname;
+                }
                 if (tc.function?.arguments)
                     entry.arguments += tc.function.arguments;
             }

package/dist/repl/index.js

@@ -249,7 +249,7 @@ export function renderHistory(history) {
  * contentWrite 落入内容区(滚动区域内自动滚动,底栏不动)。history 由本模块持有,在轮次间持久;
  * agent 只读取并追加(+ 经 session/ 压缩)。每轮成功结束后自动落盘,退出后可用 --resume / /resume 续接。
  */
-export async function startRepl(initialHistory, sessionId) {
+export async function startRepl(initialHistory, sessionId, updateNotice = null) {
     // 有预加载(--resume)则用它,并把 history[0] 刷成当前 system prompt(config 可能已变);
     // 否则新会话只塞 system 提示。
     const systemPrompt = effectiveSystemPrompt(config.systemPrompt);
@@ -287,6 +287,10 @@ export async function startRepl(initialHistory, sessionId) {
     else {
         layout.contentWrite(bannerString(banner()));
     }
+    if (updateNotice) {
+        // 自更新提示:开场静态段(进 INPUT 态前),dim 一行,不与流式 / 输入争用。
+        layout.contentWrite(`  ${ui.gray}↳ ${updateNotice}${ui.reset}\n`);
+    }
     /**
      * 回滚子流程(由 /rollback 触发):菜单(↑/↓)选轮次 → 选中第 X 轮 = 删第 X 轮及之后 + 预填第 X 轮 user 输入
      * (仿 Claude Code rewind,Enter 重新跑该轮);被删轮次的文件改动仍逐个「保留/撤销」询问(cooked readline)。

package/dist/ui/diff.js

@@ -0,0 +1,295 @@
+import { highlight, plain } from 'cli-highlight';
+import { ui } from './theme.js';
+import { charWidth, displayWidth } from './render.js';
+const MAX_FULL_DIFF_LINES = 800; // 任一边超此行数则跳过全量 LCS(避免大文件 O(n·m) 高开销)
+const MAX_BODY_LINES = 24; // 正文最多展示行数(超出尾注「还有 N 行未显示」)
+const MAX_LINE_DISPLAY = 120; // 单行截断显示宽度(CJK / 全角按 2 计)
+const HEAD_INDENT = '  ';
+const BODY_INDENT = '    ';
+/** 扩展名 / 文件名 → cli-highlight(hljs)语言 id;未命中则不高亮(纯文本)。 */
+const LANG_BY_EXT = {
+    '.ts': 'typescript', '.tsx': 'typescript', '.mts': 'typescript', '.cts': 'typescript',
+    '.js': 'javascript', '.jsx': 'javascript', '.mjs': 'javascript', '.cjs': 'javascript',
+    '.py': 'python', '.pyw': 'python', '.pyi': 'python',
+    '.json': 'json', '.json5': 'json',
+    '.md': 'markdown', '.markdown': 'markdown',
+    '.sh': 'bash', '.bash': 'bash', '.zsh': 'bash', '.fish': 'bash',
+    '.yml': 'yaml', '.yaml': 'yaml',
+    '.css': 'css', '.scss': 'scss', '.less': 'less',
+    '.html': 'xml', '.htm': 'xml', '.xml': 'xml', '.svg': 'xml',
+    '.go': 'go', '.rs': 'rust', '.java': 'java', '.kt': 'kotlin', '.kts': 'kotlin',
+    '.c': 'cpp', '.h': 'cpp', '.cpp': 'cpp', '.cc': 'cpp', '.hpp': 'cpp', '.cxx': 'cpp',
+    '.cs': 'csharp', '.rb': 'ruby', '.php': 'php', '.swift': 'swift',
+    '.sql': 'sql', '.lua': 'lua', '.r': 'r', '.dart': 'dart', '.scala': 'scala', '.groovy': 'groovy',
+    '.toml': 'ini', '.ini': 'ini', '.cfg': 'ini', '.conf': 'ini', '.properties': 'ini',
+    '.dockerfile': 'dockerfile', 'dockerfile': 'dockerfile', 'makefile': 'makefile', '.mk': 'makefile',
+};
+function langForPath(p) {
+    const lower = p.toLowerCase();
+    const slash = Math.max(lower.lastIndexOf('/'), lower.lastIndexOf('\\'));
+    const base = slash >= 0 ? lower.slice(slash + 1) : lower;
+    const dot = base.lastIndexOf('.');
+    if (dot > 0) {
+        const ext = base.slice(dot);
+        if (LANG_BY_EXT[ext])
+            return LANG_BY_EXT[ext];
+    }
+    return LANG_BY_EXT[base];
+}
+/** 包一层:token 文本 + 颜色 + reset,自成闭区间(防 SGR 跨行泄漏)。 */
+const paint = (color) => (s) => `${color}${s}${ui.reset}`;
+/** 自定义主题:default=plain(未匹配文本不着色,避免默认主题把普通代码染黄),常见 token 用 mocode ui 色板。 */
+const THEME = {
+    default: plain,
+    keyword: paint(ui.magenta),
+    'built_in': paint(ui.cyan),
+    type: paint(ui.cyan),
+    literal: paint(ui.cyan),
+    number: paint(ui.green),
+    string: paint(ui.green),
+    subst: paint(ui.green),
+    comment: paint(ui.gray),
+    doctag: paint(ui.gray),
+    function: paint(ui.blue),
+    title: paint(ui.blue),
+    class: paint(ui.brightCyan),
+    meta: paint(ui.gray),
+    'meta-keyword': paint(ui.magenta),
+    regexp: paint(ui.red),
+    attr: paint(ui.cyan),
+    attribute: paint(ui.cyan),
+    variable: paint(ui.red),
+    tag: paint(ui.red),
+    name: paint(ui.cyan),
+    symbol: paint(ui.cyan),
+    section: paint(ui.brightMagenta),
+    addition: paint(ui.green),
+    deletion: paint(ui.red),
+};
+function highlightLine(text, lang) {
+    if (!lang || text === '')
+        return text;
+    try {
+        return highlight(text, { language: lang, theme: THEME });
+    }
+    catch {
+        return text; // 语言未注册 / 解析失败:退化为纯文本
+    }
+}
+/** 按行切分;去掉末尾单个空行(由末尾 \n 产生)与行尾 \r(CRLF 兼容)。 */
+function splitLines(s) {
+    const a = s.split('\n');
+    if (a.length > 1 && a[a.length - 1] === '')
+        a.pop();
+    for (let i = 0; i < a.length; i++) {
+        if (a[i].endsWith('\r'))
+            a[i] = a[i].slice(0, -1);
+    }
+    return a;
+}
+/** 按显示宽度截断(不含省略号);CJK / 全角按 2 计,零宽符附上不推进。 */
+function truncatePlain(s, width) {
+    let w = 0;
+    let out = '';
+    for (const ch of s) {
+        const cw = charWidth(ch.codePointAt(0) ?? 0);
+        if (cw <= 0) {
+            out += ch;
+            continue;
+        }
+        if (w + cw > width)
+            break;
+        out += ch;
+        w += cw;
+    }
+    return out;
+}
+/** 截断(plain)→ 高亮 → 末尾补 reset(+ 截断尾注)。 */
+function codeText(text, lang) {
+    let plain = text;
+    let cut = false;
+    if (displayWidth(plain) > MAX_LINE_DISPLAY) {
+        plain = truncatePlain(plain, MAX_LINE_DISPLAY - 1);
+        cut = true;
+    }
+    return highlightLine(plain, lang) + ui.reset + (cut ? `${ui.dim}…${ui.reset}` : '');
+}
+/**
+ * 行级 LCS diff。返回 op 序列(ctx/add/del)。
+ * 任一边超 MAX_FULL_DIFF_LINES 返回 null(降级,由调用方走「省略 diff」分支)。
+ */
+export function lineDiff(oldS, newS) {
+    const a = splitLines(oldS);
+    const b = splitLines(newS);
+    if (a.length > MAX_FULL_DIFF_LINES || b.length > MAX_FULL_DIFF_LINES)
+        return null;
+    const n = a.length;
+    const m = b.length;
+    const dp = new Array(n + 1);
+    for (let i = 0; i <= n; i++)
+        dp[i] = new Uint16Array(m + 1);
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            dp[i][j] =
+                a[i] === b[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+        }
+    }
+    const out = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            out.push({ op: 'ctx', text: a[i] });
+            i++;
+            j++;
+        }
+        else if (dp[i + 1][j] >= dp[i][j + 1]) {
+            out.push({ op: 'del', text: a[i] });
+            i++;
+        }
+        else {
+            out.push({ op: 'add', text: b[j] });
+            j++;
+        }
+    }
+    while (i < n) {
+        out.push({ op: 'del', text: a[i] });
+        i++;
+    }
+    while (j < m) {
+        out.push({ op: 'add', text: b[j] });
+        j++;
+    }
+    return out;
+}
+/** 连续 ctx 折叠:run ≤3 全显;>3 显首 + …(n) + 尾(保留紧邻改动的上下文)。 */
+function compactCtx(ops) {
+    const items = [];
+    let i = 0;
+    while (i < ops.length) {
+        if (ops[i].op !== 'ctx') {
+            items.push({ kind: ops[i].op, text: ops[i].text });
+            i++;
+            continue;
+        }
+        let j = i;
+        while (j < ops.length && ops[j].op === 'ctx')
+            j++;
+        const run = ops.slice(i, j);
+        if (run.length <= 3) {
+            for (const r of run)
+                items.push({ kind: 'ctx', text: r.text });
+        }
+        else {
+            items.push({ kind: 'ctx', text: run[0].text });
+            items.push({ kind: 'ellipsis', count: run.length - 2 });
+            items.push({ kind: 'ctx', text: run[run.length - 1].text });
+        }
+        i = j;
+    }
+    return items;
+}
+function gutterOf(op) {
+    if (op === 'del')
+        return `${ui.red}-${ui.reset}`;
+    if (op === 'add')
+        return `${ui.green}+${ui.reset}`;
+    return `${ui.dim} ${ui.reset}`;
+}
+function lineWord(n) {
+    return n === 1 ? 'line' : 'lines';
+}
+/**
+ * 渲染文件改动块(供 layout.contentWrite 写入)。
+ *  - kind:'edit' 头行用 Update;kind:'write' 用 Update(覆盖)/ Create(oldStr===null 新建)。
+ *  - oldStr===null 表示新建:正文只显 + 行,行号从 1。
+ *  - startLine:diff 首行对应的文件行号(edit_file 由调用方定位 old_string 起始行;write_file 传 1)。
+ *  - diff 过大(超 MAX_FULL_DIFF_LINES)时仅显头行 + 「file too large, diff omitted」。
+ */
+export function renderFileChange(opts) {
+    const { path, kind, oldStr, newStr } = opts;
+    const startLine = opts.startLine ?? 1;
+    const lang = langForPath(path);
+    const pathDisp = path; // 路径原样展示(不做截断,长路径由 contentWrite 折行)
+    const verb = oldStr === null ? 'Create' : 'Update';
+    // 头行:Update(path) / Create(path)
+    const head = `${HEAD_INDENT}${ui.brightMagenta}${verb}${ui.reset}${ui.gray}(${ui.reset}${ui.cyan}${pathDisp}${ui.reset}${ui.gray})${ui.reset}`;
+    // 新建:整文件作 + 行,行号从 1
+    if (oldStr === null) {
+        const lines = splitLines(newStr);
+        const counts = `${HEAD_INDENT}  ${ui.dim}Added ${ui.reset}${ui.green}${lines.length}${ui.reset}${ui.dim} ${lineWord(lines.length)}${ui.reset}`;
+        const padW = Math.max(3, String(startLine + lines.length - 1).length);
+        return renderBody(head, counts, lines.map((l) => ({ kind: 'add', text: l })), padW, startLine, lang);
+    }
+    const ops = lineDiff(oldStr, newStr);
+    if (ops === null) {
+        return `${head}\n${HEAD_INDENT}  ${ui.dim}(file too large, diff omitted)${ui.reset}\n`;
+    }
+    let add = 0;
+    let del = 0;
+    for (const o of ops) {
+        if (o.op === 'add')
+            add++;
+        else if (o.op === 'del')
+            del++;
+    }
+    // 计数行:Added N lines, removed M lines(按需省略 0 项)
+    const parts = [];
+    if (add > 0)
+        parts.push(`${ui.dim}Added ${ui.reset}${ui.green}${add}${ui.reset}${ui.dim} ${lineWord(add)}`);
+    if (del > 0)
+        parts.push(`${ui.dim}removed ${ui.reset}${ui.red}${del}${ui.reset}${ui.dim} ${lineWord(del)}`);
+    const counts = parts.length > 0
+        ? `${HEAD_INDENT}  ${parts.join(`${ui.dim}, ${ui.reset}`)}${ui.reset}`
+        : `${HEAD_INDENT}  ${ui.dim}No changes${ui.reset}`;
+    if (add === 0 && del === 0)
+        return `${head}\n${counts}\n`;
+    const oldLen = splitLines(oldStr).length;
+    const newLen = splitLines(newStr).length;
+    const padW = Math.max(3, String(startLine + Math.max(oldLen, newLen) - 1).length);
+    return renderBody(head, counts, compactCtx(ops), padW, startLine, lang);
+}
+/** 头行 + 计数行 + 正文(折叠 + 截断 + 行号),每行尾 \n。 */
+function renderBody(head, counts, items, padW, startLine, lang) {
+    const lines = [head, counts];
+    const metaPrefix = `${BODY_INDENT}${' '.repeat(padW)}   `; // 对齐到代码列(num + 空格 + gutter + 空格)
+    let oldLine = startLine;
+    let newLine = startLine;
+    let shown = 0;
+    let overflow = 0;
+    const pushBody = (num, op, text) => {
+        const numStr = String(num).padStart(padW);
+        lines.push(`${BODY_INDENT}${ui.gray}${numStr}${ui.reset} ${gutterOf(op)} ${codeText(text, lang)}`);
+    };
+    for (const it of items) {
+        if (shown >= MAX_BODY_LINES) {
+            overflow++;
+            continue;
+        }
+        if (it.kind === 'ellipsis') {
+            oldLine += it.count;
+            newLine += it.count;
+            lines.push(`${metaPrefix}${ui.dim}…(${it.count} 行不变)${ui.reset}`);
+            shown++;
+            continue;
+        }
+        if (it.kind === 'del') {
+            pushBody(oldLine, 'del', it.text);
+            oldLine++;
+        }
+        else if (it.kind === 'add') {
+            pushBody(newLine, 'add', it.text);
+            newLine++;
+        }
+        else {
+            pushBody(newLine, 'ctx', it.text);
+            oldLine++;
+            newLine++;
+        }
+        shown++;
+    }
+    if (overflow > 0) {
+        lines.push(`${metaPrefix}${ui.dim}…(还有 ${overflow} 行未显示)${ui.reset}`);
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/ui/layout.js

@@ -316,6 +316,22 @@ export function setStatus(status, frame) {
     spinnerFrame = frame;
     drawStatusBar();
 }
+/**
+ * 在续写位画一行瞬时活动文本(spinner 帧):不进缓冲、不推进续写位,逐行 clearLine 重画。
+ * 仅 TTY + offset=0(实时尾)时物理写屏;滚动态跳过(由状态行 spinner 兜底,且避免覆盖 viewport 历史行)。
+ * 配合 clearLiveAtCursor 在 spinner 停时清掉,随后 contentWrite 的结果即写在该行(spinner 不入历史缓冲)。
+ */
+export function paintLiveAtCursor(text) {
+    if (!active || !ui.isTTY || scrollOffset !== 0)
+        return;
+    stdout.write(cup(contentRow, contentCol) + esc.clearLine + text);
+}
+/** 清掉续写位那行瞬时活动文本(配合 paintLiveAtCursor)。 */
+export function clearLiveAtCursor() {
+    if (!active || !ui.isTTY || scrollOffset !== 0)
+        return;
+    stdout.write(cup(contentRow, contentCol) + esc.clearLine);
+}
 /** 更新状态行基线(模型 / context / cwd)。repl 在轮次边界调。 */
 export function setStatusBase(b) {
     base = b;

package/dist/ui/render.js

@@ -1,5 +1,7 @@
 import { stdout } from 'node:process';
+import { createRequire } from 'node:module';
 import { ui } from './theme.js';
+const VERSION = createRequire(import.meta.url)('../../package.json').version;
 /**
  * 清空整屏 + 滚动缓冲(向上滚动可见的历史输出),光标归位。
  * 进入会话时调用,让终端只剩当前 agent 对话。非 TTY 时空操作。
@@ -71,6 +73,40 @@ export function padEndDisplay(str, width) {
     const w = displayWidth(str);
     return w >= width ? str : str + ' '.repeat(width - w);
 }
+/** 带色串按可见宽度右补空格(先剥离 ANSI 算真实宽度,空格补在串末,不破坏颜色码)。 */
+export function padEndAnsi(str, width) {
+    const w = ansiDisplayWidth(str);
+    return w >= width ? str : str + ' '.repeat(width - w);
+}
+/** 带色串按可见宽度截断(保留中间 ANSI 码,超出末尾加 …,补 reset 防 … 继承颜色)。 */
+export function truncateAnsi(str, width) {
+    if (ansiDisplayWidth(str) <= width)
+        return str;
+    let w = 0;
+    let out = '';
+    let hasStyle = false;
+    // 按 ANSI 转义切分:偶数索引=文本,奇数索引=SGR 码
+    const parts = str.split(/(\x1b\[[0-9;]*m)/);
+    for (let i = 0; i < parts.length; i++) {
+        if (i % 2 === 1) {
+            out += parts[i];
+            hasStyle = parts[i] !== '\x1b[0m';
+            continue;
+        }
+        for (const ch of parts[i]) {
+            const cw = charWidth(ch.codePointAt(0) ?? 0);
+            if (cw > 0 && w + cw + 1 > width) {
+                if (hasStyle)
+                    out += '\x1b[0m';
+                return out + '…';
+            }
+            if (cw > 0)
+                w += cw;
+            out += ch;
+        }
+    }
+    return out;
+}
 /** 按显示宽度截断,超出加 …。 */
 export function truncateDisplay(str, width) {
     if (displayWidth(str) <= width)
@@ -116,40 +152,41 @@ export function wrapByDisplayWidth(text, width) {
     out.push(cur);
     return out;
 }
-const BOX_W = 76; // 内容区显示宽度(容下完整工具列表 + 命令提示)
+const BOX_W = 60; // 内容区显示宽度(logo 区 + 信息区)
 const MARGIN = '  '; // 盒外左缩进
-function boxBorder(left, mid, right) {
-    return `${ui.gray}${left}${mid.repeat(BOX_W + 2)}${right}${ui.reset}`;
-}
-function boxLine(content) {
-    const inner = padEndDisplay(truncateDisplay(content, BOX_W), BOX_W);
-    return `${ui.gray}│${ui.reset} ${inner} ${ui.gray}│${ui.reset}`;
-}
-function boxEmpty() {
-    return `${ui.gray}│${ui.reset} ${' '.repeat(BOX_W)} ${ui.gray}│${ui.reset}`;
-}
-function labelRow(label, value) {
-    return boxLine(`${ui.dim}${padEndDisplay(label, 6)}${ui.reset}${value}`);
-}
-/** 横幅纯文本(带 ANSI 颜色,不写出)——供 TUI 经 contentWrite 写入内容区以跟踪续写位。 */
+// ── 坐姿 logo(乌龟风,加双手)──
+const LOGO_W = 11; // logo 区显示宽度
+const LOGO_GAP = 4; // logo 与信息区之间的间隔
+const LOGO_PAD = ' '.repeat(LOGO_W + LOGO_GAP); // 无 logo 行的缩进(对齐信息区)
+// 坐着的小人:[●ᴗ●] 头 / |　| 身 / ╲|　|╱ 双手外撑 / |　| 身 / ＯＯ 脚
+const LOGO_LINES = [
+    '  [◕ᴗ◕]  ',
+    ' ●|   |●  ',
+    '  ＯＯ   ',
+];
+/** 取第 idx 行 logo(着色 + 补宽);越界返空格(logo 下方行仍缩进对齐)。 */
+function logoLine(idx) {
+    if (idx >= LOGO_LINES.length)
+        return LOGO_PAD;
+    return `${ui.brightCyan}${padEndDisplay(LOGO_LINES[idx], LOGO_W)}${ui.reset}${' '.repeat(LOGO_GAP)}`;
+}
+function labelContent(label, value) {
+    return `${ui.dim}${padEndDisplay(label, 6)}${ui.reset}${value}`;
+}
+/** 横幅纯文本(带 ANSI 颜色,不写出)——供 TUI 经 contentWrite 写入内容区以跟踪续写位。
+ *  无边框:左侧实心小熊 + 右侧标题/信息(模型/目录),末尾一行提示。 */
 export function bannerString(info) {
+    const title = `${ui.bold}${ui.brightCyan}◆  mocode${ui.reset}  ${ui.dim}v${VERSION}${ui.reset}`;
     const rows = [
-        boxBorder('╭', '─', '╮'),
-        boxLine(`${ui.bold}${ui.brightCyan}◆  mocode${ui.reset}  ${ui.dim}终端编码 agent${ui.reset}`),
-        boxEmpty(),
-        labelRow('模型', info.model),
-        labelRow('后端', info.baseURL),
-        labelRow('目录', info.cwd),
-        labelRow('工具', info.tools),
-        boxEmpty(),
-        boxLine(`${ui.dim}/exit 退出 · /clear 清空 · /compact 压缩 · /context 用量 · /resume 续接${ui.reset}`),
-        boxBorder('╰', '─', '╯'),
+        logoLine(0) + title,
+        logoLine(1) + labelContent('模型', info.model),
+        logoLine(2) + labelContent('目录', truncateDisplay(info.cwd, 48)),
     ];
     return (rows.map((r) => MARGIN + r).join('\n') +
         '\n\n' +
         `${MARGIN}${ui.dim}直接描述任务,agent 会自动读写文件与执行命令。${ui.reset}\n`);
 }
-/** 启动横幅:带边框的信息盒 + 一行提示。纯渲染,不依赖 config / 业务。 */
+/** 启动横幅:小熊 logo + 标题/信息 + 一行提示。纯渲染,不依赖 config / 业务。 */
 export function printBanner(info) {
     stdout.write(bannerString(info));
 }

package/dist/ui/theme.js

@@ -13,6 +13,7 @@ export const ui = {
     red: wrap('\x1B[31m'),
     green: wrap('\x1B[32m'),
     yellow: wrap('\x1B[33m'),
+    blue: wrap('\x1B[34m'),
     cyan: wrap('\x1B[36m'),
     gray: wrap('\x1B[90m'),
     magenta: wrap('\x1B[35m'),

package/dist/updater/index.js

@@ -0,0 +1,161 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+/**
+ * 启动时自动检测并后台自更新(仿 update-notifier,但**真更新**而非仅提示)。
+ *
+ * 设计要点:
+ *  - **零启动延迟**:`checkAndMaybeUpdate()` 同步返回提示串或 null;联网刷新与 `npm i -g` 都是
+ *    fire-and-forget 后台操作(不 await),不卡 REPL 启动。
+ *  - **下次启动生效**:当前进程已把 dist/*.js 读入内存,运行中不持有文件句柄;后台 `npm i -g`
+ *    覆写磁盘包(含 mocode.cmd shim),当前进程不受影响,**下次** `mocode` 即新版本。
+ *  - **节流**:检查 24h、spawn 6h(防每跑必联网 / 重复 spawn)。更新成功后下次重读 package.json
+ *    得 current=latest → 不再 spawn、不再提示。
+ *  - **不依赖 config**:只用 stdlib + 全局 fetch,缺 LLM 配置也能跑(在 config 校验前调)。
+ *  - **dev 跳过**:tsx 运行 `.ts`(`npm start`)不自更新;编译态 `.js`(`mocode` 全局命令)才更新。
+ *  - **失败静默**:断网 / 无 npm / 权限不足都不阻断启动。
+ */
+const PKG_NAME = 'mocode-ai';
+/** 包根 package.json:从 dist/updater/ 或 src/updater/ 均 `../../package.json`(npm 必带 package.json)。 */
+const PKG_PATH = fileURLToPath(new URL('../../package.json', import.meta.url));
+const CACHE_PATH = path.join(os.homedir(), '.mocode', 'update-check.json');
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24h:多久重新拉一次 registry
+const SPAWN_INTERVAL_MS = 6 * 60 * 60 * 1000; // 6h:同一待更新版本多久内不重复 spawn
+const FETCH_TIMEOUT_MS = 2500;
+/** 缓存路径:MOCODE_UPDATE_CACHE 可重定向(测试用临时文件,避免污染真实 ~/.mocode 缓存)。 */
+function cachePath() {
+    return process.env.MOCODE_UPDATE_CACHE || CACHE_PATH;
+}
+/** tsx 开发态(import.meta.url 以 .ts 结尾)跳过自更新;编译态 .js 才更新。 */
+function isDevRun() {
+    try {
+        return fileURLToPath(import.meta.url).endsWith('.ts');
+    }
+    catch {
+        return false;
+    }
+}
+/** 读当前安装版本(package.json 的 version)。读不到返 ''。 */
+function readCurrentVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(PKG_PATH, 'utf8'));
+        return pkg.version ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+function readCache() {
+    try {
+        return JSON.parse(fs.readFileSync(cachePath(), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** 读-合并-写(各写者独立 merge,降低后台 fetch 与同步 spawn 写的竞态丢字段风险)。 */
+function writeCache(patch) {
+    try {
+        const merged = { ...readCache(), ...patch };
+        fs.mkdirSync(path.dirname(cachePath()), { recursive: true });
+        fs.writeFileSync(cachePath(), JSON.stringify(merged), 'utf8');
+    }
+    catch {
+        // 写缓存失败不阻断
+    }
+}
+/** registry 取自 ~/.npmrc(国内镜像用户与 `npm i -g` 装的源一致);无则用官方端点。保证尾 `/`。 */
+function readRegistry() {
+    let reg = 'https://registry.npmjs.org/';
+    try {
+        const npmrc = fs.readFileSync(path.join(os.homedir(), '.npmrc'), 'utf8');
+        const m = /^registry\s*=\s*["']?([^"'\s]+)["']?\s*$/m.exec(npmrc);
+        if (m && m[1])
+            reg = m[1];
+    }
+    catch {
+        // 无 ~/.npmrc:用默认
+    }
+    return reg.endsWith('/') ? reg : reg + '/';
+}
+/** 后台拉 registry 最新版(不 await):成功写 latest+lastCheck,失败只写 lastCheck(防离线每跑必联网)。 */
+async function fetchLatestInBackground() {
+    try {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
+        const res = await fetch(`${readRegistry()}${PKG_NAME}/latest`, { signal: ctrl.signal });
+        clearTimeout(t);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const data = (await res.json());
+        writeCache(data.version ? { latest: data.version, lastCheck: Date.now() } : { lastCheck: Date.now() });
+    }
+    catch {
+        writeCache({ lastCheck: Date.now() });
+    }
+}
+/** 后台 spawn `npm i -g <pkg>@latest`(Win:shell 解析 npm.cmd + windowsHide 防控制台闪;detached+unref 跨进程存活)。 */
+function spawnUpdate() {
+    if (process.env.MOCODE_NO_SPAWN)
+        return; // 测试门控:禁真跑 npm
+    try {
+        const child = spawn('npm', ['install', '-g', `${PKG_NAME}@latest`], {
+            shell: true,
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.unref();
+        child.on('error', () => { });
+    }
+    catch {
+        // 忽略
+    }
+}
+/** 简易 semver 比较(只管 X.Y.Z 数字,无 pre-release):a>b 返正,a<b 返负,等返 0。 */
+export function compareSemver(a, b) {
+    const pa = a.split('.').map((x) => Number(x) || 0);
+    const pb = b.split('.').map((x) => Number(x) || 0);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const da = pa[i] ?? 0;
+        const db = pb[i] ?? 0;
+        if (da !== db)
+            return da - db;
+    }
+    return 0;
+}
+/** 纯决策:据当前版本 / 缓存 / 时间,算是否提示 / spawn / 后台刷新。无副作用,可离线测。 */
+export function evaluateUpdate(current, cache, now) {
+    const refresh = !cache.latest || now - (cache.lastCheck ?? 0) > CHECK_INTERVAL_MS;
+    let notice = null;
+    let spawn = false;
+    if (cache.latest && compareSemver(cache.latest, current) > 0) {
+        notice = `检测到新版本 ${cache.latest},后台更新中,下次启动生效。`;
+        spawn = now - (cache.lastSpawn ?? 0) > SPAWN_INTERVAL_MS;
+    }
+    return { notice, spawn, refresh };
+}
+/**
+ * 启动时调(同步,零延迟):返一行纯文本更新提示或 null。
+ * 流程:dev 跳过 → 读当前版本 → 读缓存 → evaluateUpdate 决策 → 按需后台刷新 / spawn → 返提示。
+ * 提示由 repl 上色写入内容区开场段(进 INPUT 态前)。
+ */
+export function checkAndMaybeUpdate() {
+    if (isDevRun())
+        return null;
+    const current = readCurrentVersion();
+    if (!current)
+        return null;
+    const cache = readCache();
+    const now = Date.now();
+    const d = evaluateUpdate(current, cache, now);
+    if (d.refresh)
+        void fetchLatestInBackground(); // fire-and-forget:刷新缓存供下次启动用
+    if (d.spawn) {
+        spawnUpdate();
+        writeCache({ lastSpawn: now });
+    }
+    return d.notice;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 9 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
     "prepare": "npm run build"
   },
   "dependencies": {
+    "cli-highlight": "^2.1.11",
     "dotenv": "^16.0.0",
     "fast-glob": "^3.0.0",
     "openai": "^4.0.0"