mocode-ai 0.1.1 → 0.1.3

package/dist/agent/index.js

@@ -31,7 +31,9 @@ function parseArgs(raw) {
  *  思考段用 layout.beginSegment / eraseSegmentBack 精确按物理行折叠(修预存按 \n 数行漏擦 bug),
  *  原文存入 collapsedThinkings 供 /think N 重打。
  */
-export async function runAgent(history, userInput, collapsedThinkings = [], signal) {
+export async function runAgent(history, userInput, collapsedThinkings = [], signal, 
+/** 每步 chat() 返回后回调:repl 据此重算并重画状态行 context 用量条(运行中实时刷新,不冻结在轮首)。 */
+onContextUpdate) {
     // 中断回滚快照:入口(本 turn push 任何消息前)整段浅拷贝。abort 时 length=0;push(...saved) 还原。
     // 用 slice() 而非 length:maybeCompact 会原地重建(length=0;push(...rebuilt)),savedLen 会失效。
     const savedHistory = history.slice();
@@ -138,6 +140,8 @@ export async function runAgent(history, userInput, collapsedThinkings = [], sign
             }
             contextState.lastUsage = result.usage; // 供 /context 与状态行显示实测 token
             spinner.stop();
+            // lastUsage 已更新:触发状态行 context 用量条重算+重画,运行中不再冻结在轮首。
+            onContextUpdate?.();
             if (result.toolCalls.length > 0) {
                 // 思考后直接进入 tool_call(无 text):先把可见的思考段折叠
                 flushThinkCollapsed();

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/repl/index.js

@@ -4,7 +4,7 @@ import { stdin, stdout } from 'node:process';
 import { config } from '../config/index.js';
 import { runAgent } from '../agent/index.js';
 import { ui } from '../ui/theme.js';
-import { bannerString, displayWidth, summarizeToolCall, summarizeToolResult } from '../ui/render.js';
+import { bannerString, displayWidth, padEndDisplay, summarizeToolCall, summarizeToolResult } from '../ui/render.js';
 import * as layout from '../ui/layout.js';
 import { promptWithSlashMenu, promptTurnPicker } from '../ui/prompt.js';
 import { tools } from '../tools/registry.js';
@@ -173,14 +173,30 @@ function stopRunningListener() {
     emitter.off('keypress', onRunningKey);
     currentAbort = null;
 }
+/**
+ * 把用户消息格式化为带满宽背景色的文本(上滑时易辨认用户消息)。
+ * 每行用 padEndDisplay 填充到终端宽度(含 ❯ / 缩进),背景色 SGR 包裹整行 + 行末 reset。
+ * 满宽 pad 使终端背景色覆盖整行(含行尾空单元格),上滑滚动时用户消息呈连续色块、与 assistant 正文区分。
+ */
+function formatUserMessage(lines) {
+    const cols = layout.getGeo().cols;
+    const promptW = displayWidth(PROMPT);
+    const indent = ' '.repeat(promptW);
+    const { userBg, reset } = ui;
+    return (lines
+        .map((l, i) => {
+        const prefix = i === 0 ? PROMPT : indent;
+        const full = prefix + l;
+        const padded = padEndDisplay(full, cols);
+        return `${userBg}${padded}${reset}`;
+    })
+        .join('\n') + '\n');
+}
 /** 把多行提交输入回显进内容区(❯ 首行,续行按 prompt 宽度缩进)。仅 TUI 态回显(非 TTY 由 readline 自带回显)。 */
 function echoInput(lines) {
     if (!layout.isActive())
         return;
-    const indent = ' '.repeat(displayWidth(PROMPT));
-    const echo = lines.map((l, i) => (i === 0 ? `${PROMPT}${l}` : `${indent}${l}`)).join('\n') +
-        '\n';
-    layout.contentWrite(echo);
+    layout.contentWrite(formatUserMessage(lines));
 }
 /** 把任意消息 content 拍平成字符串(OpenAI 可能 string / null / 多模态数组)。 */
 function textOf(c) {
@@ -202,16 +218,13 @@ function textOf(c) {
  * 内容长于屏时 viewport 显尾(最近轮次),PgUp 可看更早——与流式态一致。
  */
 export function renderHistory(history) {
-    const indent = ' '.repeat(displayWidth(PROMPT));
     const idToName = new Map();
     for (const m of history) {
         if (m.role === 'system')
             continue;
         if (m.role === 'user') {
             const lines = textOf(m.content).split('\n');
-            layout.contentWrite(lines
-                .map((l, i) => (i === 0 ? `${PROMPT}${l}` : `${indent}${l}`))
-                .join('\n') + '\n');
+            layout.contentWrite(formatUserMessage(lines));
             continue;
         }
         if (m.role === 'assistant') {
@@ -249,7 +262,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 +300,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)。
@@ -506,7 +523,12 @@ export async function startRepl(initialHistory, sessionId) {
         }
         try {
             const signal = startRunningListener(placeholder);
-            await runAgent(history, joined, collapsedThinkings, signal);
+            // 运行中每步 chat() 返回后刷新状态行 context 用量条(用 fresh lastUsage / 估算),
+            // 否则整轮冻结在轮首 refreshStatusBase 的值,「执行 grep」时 2k/1000k 不动。
+            await runAgent(history, joined, collapsedThinkings, signal, () => {
+                refreshStatusBase(history);
+                layout.drawStatusBar();
+            });
             // 成功轮次自动落盘(崩溃也保住上一轮);新会话首轮分配 id
             if (!currentSessionId)
                 currentSessionId = newSessionId();

package/dist/ui/prompt.js

@@ -3,6 +3,40 @@ import { stdin, stdout } from 'node:process';
 import { ui } from './theme.js';
 import { displayWidth, padEndDisplay, truncateDisplay } from './render.js';
 import * as layout from './layout.js';
+// ── 粘贴检测(块级 + 时间窗)──
+// 块级:多字节大块(len>8)或含 CR/LF 的小块 = 粘贴(键盘单键 1 字节,Enter=\r 单字节)。
+// 时间窗:每块重置 50ms 计时器,静默 50ms 即"粘贴结束"→ onPasteEnd。跨多块的大粘贴(块间 <50ms)累积进
+// 同一个 pasteParts、末尾一次性落 chip——避免"首块成 chip、后续块泄成文本"。粘贴中 onKey 把键累积进
+// pasteParts(不编辑 lines)。不启用 bracketed paste——emitKeypressEvents 会把 \x1B[200~ 标记当按键砸进输入框。
+let pasting = false;
+let pasteParts = [];
+let pasteTimer = null;
+let onPasteEnd = null; // 粘贴结束回调(prompt 注入:落 chip 或保留为文本)
+let pasteDetectorInstalled = false;
+function ensurePasteDetector() {
+    if (pasteDetectorInstalled)
+        return;
+    pasteDetectorInstalled = true;
+    stdin.on('data', (chunk) => {
+        const len = chunk.length;
+        const hasNL = typeof chunk === 'string'
+            ? chunk.indexOf('\r') >= 0 || chunk.indexOf('\n') >= 0
+            : chunk.indexOf(0x0d) >= 0 || chunk.indexOf(0x0a) >= 0;
+        // 大块(>8 字节)或含换行的多字节块 = 粘贴;键盘单键(1 字节,含 Enter=\r)不触发
+        if (!(len > 8 || (len > 1 && hasNL)))
+            return;
+        pasting = true;
+        if (pasteTimer)
+            clearTimeout(pasteTimer);
+        const t = setTimeout(() => {
+            pasteTimer = null;
+            pasting = false;
+            onPasteEnd?.();
+        }, 50);
+        t.unref();
+        pasteTimer = t;
+    });
+}
 /** 非 TTY / 未进 alt screen 时退化为普通 readline 行输入(无菜单、单行)。 */
 function questionFallback(prompt) {
     return new Promise((res, rej) => {
@@ -38,6 +72,8 @@ export async function promptWithSlashMenu(opts) {
         : [''];
     let cl = lines.length - 1; // 光标行(0-based)= 末行
     let cc = lines[cl].length; // 光标在该行的字符索引 = 末行末尾
+    let justSawCR = false; // \r\n 合一:粘贴的 \r 折行后,紧跟的 \n 吞掉(避免折两行)
+    let chip = null; // 原子粘贴块:整段封进 [预览…],不可编辑;提交时拼回全文
     let menuOpen = false;
     let selected = 0;
     let filtered = [];
@@ -62,6 +98,58 @@ export async function promptWithSlashMenu(opts) {
     function cursorCol() {
         return displayWidth(lines[cl].slice(0, cc));
     }
+    /** chip 预览前缀:整段扁平化(行界→空格,避免框内折行)取前 ~20 列,超长 truncateDisplay 自带 …;末尾空格与 suffix 分隔。 */
+    function chipPrefix() {
+        return chip ? `[${truncateDisplay(chip.split('\n').join(' '), 20)}] ` : '';
+    }
+    /** 供 layout 画的行:chip 存在时把前缀拼到第 0 行前(chip 原子显示,不可编辑;光标活在 suffix)。 */
+    function dispLines() {
+        if (!chip)
+            return lines;
+        const pre = chipPrefix();
+        return lines.length > 0 ? [pre + lines[0], ...lines.slice(1)] : [pre];
+    }
+    /** 供 layout 定位光标列:chip 在第 0 行时偏移 chipPrefix 宽度(suffix 光标始终在 chip 之后)。 */
+    function dispCursorCol() {
+        return chip && cl === 0 ? displayWidth(chipPrefix()) + cursorCol() : cursorCol();
+    }
+    /** 在光标处插入文本(含换行则拆行)。供短粘贴 finalize 落为可编辑文本。 */
+    function insertText(text) {
+        const parts = text.split('\n');
+        const before = lines[cl].slice(0, cc);
+        const after = lines[cl].slice(cc);
+        const newLines = [before + parts[0]];
+        for (let i = 1; i < parts.length; i++)
+            newLines.push(parts[i]);
+        newLines[newLines.length - 1] += after;
+        lines.splice(cl, 1, ...newLines);
+        cl = cl + parts.length - 1;
+        cc = parts[parts.length - 1].length;
+    }
+    /** 粘贴结束:长粘贴(>8 行或 >400 字符)落/并进 chip(原子,整段封预览),短粘贴落为可编辑文本。 */
+    function finalizePaste() {
+        if (resolved) {
+            pasteParts = [];
+            return;
+        }
+        const buf = pasteParts.join('');
+        pasteParts = [];
+        justSawCR = false;
+        if (!buf)
+            return;
+        const isLong = buf.split('\n').length > 8 || buf.length > 400;
+        if (isLong) {
+            chip = chip == null ? buf : chip + '\n' + buf; // 多块粘贴:并进同一 chip
+            lines = [''];
+            cl = 0;
+            cc = 0;
+        }
+        else {
+            insertText(buf);
+        }
+        computeFiltered();
+        redraw();
+    }
     function computeFiltered() {
         if (cl === 0 && lines[0].startsWith('/')) {
             filtered = opts.commands.filter((c) => c.name.startsWith(lines[0]));
@@ -77,9 +165,9 @@ export async function promptWithSlashMenu(opts) {
     function redraw() {
         layout.paintInput({
             prompt: opts.prompt,
-            lines,
+            lines: dispLines(),
             cursorLine: cl,
-            cursorCol: cursorCol(),
+            cursorCol: dispCursorCol(),
             menu: menuLines().length ? { lines: menuLines() } : null,
         });
     }
@@ -91,6 +179,13 @@ export async function promptWithSlashMenu(opts) {
             // 忽略
         }
         emitter.removeListener('keypress', onKey);
+        if (pasteTimer) {
+            clearTimeout(pasteTimer);
+            pasteTimer = null;
+        }
+        pasting = false;
+        pasteParts = [];
+        onPasteEnd = null;
         stdin.pause();
     }
     function finish(value) {
@@ -100,14 +195,16 @@ export async function promptWithSlashMenu(opts) {
         cleanup();
         resolve(value);
     }
-    /** 提交:菜单打开时先补全选中项到第 0 行。 */
+    /** 提交:菜单打开时先补全选中项到第 0 行。chip 与 suffix 拼回全文(chip 在前,换行接 suffix)。 */
     function submit() {
         if (menuOpen && filtered[selected]) {
             lines = [filtered[selected].name];
             cl = 0;
             cc = lines[0].length;
         }
-        finish(lines);
+        const suffix = lines.join('\n');
+        const content = chip ? (suffix.length > 0 ? chip + '\n' + suffix : chip) : suffix;
+        finish(content === '' ? [''] : content.split('\n'));
     }
     /** 插换行:在光标处断行。 */
     function insertNewline() {
@@ -122,6 +219,29 @@ export async function promptWithSlashMenu(opts) {
     function onKey(_str, key) {
         if (resolved || !key)
             return;
+        // 粘贴中:把键累积进 pasteParts(换行 \r\n 合一),不编辑 lines;末尾 finalizePaste 统一落 chip/文本
+        if (pasting) {
+            if (key.ctrl && key.name === 'c') {
+                cleanup();
+                reject(new Error('SIGINT'));
+                return;
+            }
+            const s = key.sequence ?? '';
+            const isReturn = key.name === 'return' || key.name === 'enter';
+            if (s === '\n' && justSawCR) {
+                justSawCR = false; // \r\n 的 \n:已随 \r 折行,吞掉
+                return;
+            }
+            if (isReturn || s === '\r' || s === '\n') {
+                justSawCR = s === '\r'; // \r 标记,待可能的尾随 \n
+                pasteParts.push('\n');
+                return;
+            }
+            justSawCR = false;
+            if (s && s >= ' ' && !key.ctrl && !key.meta)
+                pasteParts.push(s);
+            return;
+        }
         // 滚动回看键(优先;不触发回尾):PgUp/PgDn 翻页,Ctrl+↑↓ 与 plain ↑/↓ 单行。
         // plain ↑/↓ 仅在单行输入且菜单关闭时作滚动(多行编辑留给光标移动,菜单打开留给选项);
         // 兼鼠标滚轮——WT alt 屏(经 \x1B[?1007h)滚轮转发 ↑/↓。
@@ -171,17 +291,17 @@ export async function promptWithSlashMenu(opts) {
             return;
         }
         const isReturn = key.name === 'return' || key.name === 'enter';
-        // 换行:Ctrl+J / Alt+Enter(meta)/ Shift+Enter(终端区分时)/ 粘贴的 LF
+        // 换行:Ctrl+J / Alt+Enter(meta)/ Shift+Enter(终端区分时)/ lone LF
+        // (粘贴的 CR/LF 已在上方 pasting 分支累积进 pasteParts,不会到此)
         const wantNewline = (key.ctrl && key.name === 'j') ||
             (key.meta && isReturn) ||
             (key.shift && isReturn) ||
             (key.sequence === '\n' && !key.ctrl);
-        // 换行(Ctrl+J / Alt+Enter / Shift+Enter / 粘贴 LF)
         if (wantNewline) {
             insertNewline();
             return;
         }
-        // 提交(plain Enter)
+        // 提交(键盘 plain Enter)
         if (isReturn && !key.shift && !key.meta && !key.ctrl) {
             submit();
             return;
@@ -204,6 +324,12 @@ export async function promptWithSlashMenu(opts) {
                     computeFiltered();
                     redraw();
                 }
+                else if (chip) {
+                    // 光标在 suffix 开头(紧贴 ] 后):退格删整个 chip(原子)
+                    chip = null;
+                    computeFiltered();
+                    redraw();
+                }
                 return;
             case 'up':
                 if (menuOpen && filtered.length) {
@@ -284,6 +410,8 @@ export async function promptWithSlashMenu(opts) {
     return new Promise((res, rej) => {
         resolve = res;
         reject = rej;
+        ensurePasteDetector(); // 首次调用在 emitKeypressEvents 之前装 data 监听器(保序:mine 先于 解析器)
+        onPasteEnd = finalizePaste; // 粘贴结束回调:落 chip 或保留文本
         readline.emitKeypressEvents(stdin);
         let rawOk = true;
         try {
@@ -395,6 +523,7 @@ export async function promptTurnPicker(items) {
     return new Promise((res, rej) => {
         resolve = res;
         reject = rej;
+        ensurePasteDetector();
         readline.emitKeypressEvents(stdin);
         let rawOk = true;
         try {

package/dist/ui/render.js

@@ -160,7 +160,7 @@ const LOGO_GAP = 4; // logo 与信息区之间的间隔
 const LOGO_PAD = ' '.repeat(LOGO_W + LOGO_GAP); // 无 logo 行的缩进(对齐信息区)
 // 坐着的小人:[●ᴗ●] 头 / |　| 身 / ╲|　|╱ 双手外撑 / |　| 身 / ＯＯ 脚
 const LOGO_LINES = [
-    '  [●ᴗ●]  ',
+    '  [◕ᴗ◕]  ',
     ' ●|   |●  ',
     '  ＯＯ   ',
 ];

package/dist/ui/theme.js

@@ -19,4 +19,6 @@ export const ui = {
     magenta: wrap('\x1B[35m'),
     brightCyan: wrap('\x1B[96m'),
     brightMagenta: wrap('\x1B[95m'),
+    /** 用户消息满宽背景色(上滑时易辨认);bright black bg = 深灰,深色终端上微妙可辨。 */
+    userBg: wrap('\x1B[100m'),
 };

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.1",
+  "version": "0.1.3",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 9 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {