mocode-ai 1.0.4 → 1.0.6

package/bin/mocode.js

@@ -1,4 +1,21 @@
 #!/usr/bin/env node
 // mocode 全局入口:shebang + 拉起编译产物。子命令(--resume / config)路由在 dist/index.js 的 main() 内,
 // 用动态 import 按需加载,避免 `mocode config`(零配置时)触发 config/index.ts 的 requireEnv 退出。
+
+// 抑制 openai v4 -> node-fetch v2 -> whatwg-url v5 链触发的 Node 内置 punycode 弃用警告,
+// 防止 [DEP0040] 输出污染终端 UI 的输入框区域。
+const originalEmit = process.emit;
+process.emit = function (event, warning, ...args) {
+  if (
+    event === 'warning' &&
+    warning &&
+    warning.code === 'DEP0040' &&
+    typeof warning.message === 'string' &&
+    warning.message.includes('punycode')
+  ) {
+    return true;
+  }
+  return originalEmit.apply(this, [event, warning, ...args]);
+};
+
 await import('../dist/index.js');

package/dist/commands/upgrade.js

@@ -0,0 +1,104 @@
+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';
+/**
+ * /upgrade 命令实现:按需检查/升级 mocode,不阻塞启动。
+ *
+ * 设计要点:
+ *  - 启动时不检查、不联网、不 spawn:把旧自动升级完全删除后,REPL 首屏即进输入态。
+ *  - 用户主动输入 /upgrade 时才拉 registry / 执行 npm i -g。
+ *  - 当前进程正在运行 dist/*.js,后台 npm install 只改磁盘,**下次启动**才用上新版本。
+ *  - dev 运行(tsx src/index.ts)时禁真 spawn,防止误改全局包;编译产物运行(mocode 全局命令)才执行。
+ *  - 失败时返回可读错误,不抛异常,避免 REPL 崩掉。
+ */
+const PKG_NAME = 'mocode-ai';
+const PKG_PATH = fileURLToPath(new URL('../../package.json', import.meta.url));
+const FETCH_TIMEOUT_MS = 5000;
+/** 是否 tsx 开发运行(import.meta.url 以 .ts 结尾)。 */
+export function isDevRun() {
+    try {
+        return fileURLToPath(import.meta.url).endsWith('.ts');
+    }
+    catch {
+        return false;
+    }
+}
+/** 读当前安装版本(package.json 的 version)。读不到返 '0.0.0'。 */
+export function getCurrentVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(PKG_PATH, 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/** registry 取自 ~/.npmrc(与 `npm i -g` 同源);无则用官方端点。保证尾 `/`。 */
+export 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 + '/';
+}
+/** 简易 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;
+}
+/** 拉 registry 最新版。超时/失败返 null,不抛异常。 */
+export async function fetchLatestVersion(timeoutMs = FETCH_TIMEOUT_MS) {
+    try {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), timeoutMs);
+        const res = await fetch(`${readRegistry()}${PKG_NAME}/latest`, { signal: ctrl.signal });
+        clearTimeout(t);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 检查当前版本与 registry 最新版本。 */
+export async function checkVersion() {
+    const current = getCurrentVersion();
+    const latest = await fetchLatestVersion();
+    const hasUpdate = latest ? compareSemver(latest, current) > 0 : false;
+    return { current, latest, hasUpdate };
+}
+/** 后台 spawn `npm i -g mocode-ai@latest`。 */
+export function spawnUpgrade() {
+    if (isDevRun() || process.env.MOCODE_NO_SPAWN)
+        return;
+    try {
+        const child = spawn('npm', ['install', '-g', `${PKG_NAME}@latest`], {
+            shell: true,
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.unref();
+        child.on('error', () => { });
+    }
+    catch {
+        // 忽略
+    }
+}

package/dist/i18n/index.js

@@ -57,6 +57,10 @@ const zhCN = {
     'commands.language': '切换界面与回复语言',
     'commands.languageZh': '切换到中文',
     'commands.languageEn': 'Switch to English',
+    'commands.upgrade': '升级 mocode 到最新版本',
+    'commands.upgradeNow': '立即升级',
+    'commands.upgradeCheck': '检查当前版本与最新版本差异',
+    'commands.upgradeStatus': '显示当前本地版本',
     'help.title': '可用斜杠命令',
     'help.hint': '（› 表示可进入子菜单；→ 后为实际执行命令）',
     'language.current': '当前语言：{language}',
@@ -92,6 +96,8 @@ const zhCN = {
     'running.skill': '项目 Skill',
     'running.language': '切语言',
     'running.chooseLanguage': '选择语言…',
+    'running.upgrade': '升级',
+    'running.upgrading': '升级中…',
     'prompt.lines': '{count} 行',
     'prompt.chars': '{count} 字符',
     'prompt.chooseRollback': '↑↓ 选择 · Enter 回滚到该轮 · Esc 取消',
@@ -230,6 +236,17 @@ const zhCN = {
     'plan.running': '执行',
     'plan.executing': '按计划执行…',
     'plan.executePrompt': '请按上述计划执行。',
+    'upgrade.currentVersion': '当前版本：{version}',
+    'upgrade.latestVersion': '最新版本：{version}',
+    'upgrade.noUpdate': '已是最新版本 v{version}',
+    'upgrade.hasUpdate': '发现新版本：当前 v{current} → 最新 v{latest}',
+    'upgrade.upgradeStarted': '已启动后台升级 → {version}',
+    'upgrade.upgradeHint': 'npm install -g mocode-ai@latest 正在后台运行，完成后下次启动 mocode 即生效。',
+    'upgrade.devSkip': '当前为开发运行(tsx)，已跳过真实 npm install，避免误改全局包。',
+    'upgrade.fetchFailed': '无法获取最新版本（请检查网络或 npm registry）。',
+    'upgrade.pkgName': '包名：mocode-ai',
+    'upgrade.failed': '[upgrade] 失败：{message}',
+    'upgrade.usage': '/upgrade 用法：\n  /upgrade              升级到最新版本\n  /upgrade now          同 /upgrade\n  /upgrade check        检查当前版本与最新版本差异\n  /upgrade status       显示当前本地版本',
     'assistant.languageInstruction': 'Reply to the user in Chinese.',
 };
 const en = {
@@ -291,6 +308,10 @@ const en = {
     'commands.language': 'Switch interface and reply language',
     'commands.languageZh': '切换到中文',
     'commands.languageEn': 'Switch to English',
+    'commands.upgrade': 'Upgrade mocode to the latest version',
+    'commands.upgradeNow': 'Upgrade now',
+    'commands.upgradeCheck': 'Check current vs latest version',
+    'commands.upgradeStatus': 'Show current local version',
     'help.title': 'Available slash commands',
     'help.hint': '(› opens a submenu; → shows the command that will run)',
     'language.current': 'Current language: {language}',
@@ -326,6 +347,8 @@ const en = {
     'running.skill': 'Project Skill',
     'running.language': 'Language',
     'running.chooseLanguage': 'Choose a language…',
+    'running.upgrade': 'Upgrade',
+    'running.upgrading': 'Upgrading…',
     'prompt.lines': '{count} lines',
     'prompt.chars': '{count} characters',
     'prompt.chooseRollback': '↑↓ Select · Enter Roll back to turn · Esc Cancel',
@@ -464,6 +487,17 @@ const en = {
     'plan.running': 'Execute',
     'plan.executing': 'Executing the plan…',
     'plan.executePrompt': 'Execute the plan above.',
+    'upgrade.currentVersion': 'Current version: {version}',
+    'upgrade.latestVersion': 'Latest version: {version}',
+    'upgrade.noUpdate': 'Already up to date: v{version}',
+    'upgrade.hasUpdate': 'New version available: v{current} → v{latest}',
+    'upgrade.upgradeStarted': 'Background upgrade started → {version}',
+    'upgrade.upgradeHint': 'npm install -g mocode-ai@latest is running in the background; restart mocode to use it.',
+    'upgrade.devSkip': 'Running in dev mode (tsx); skipped real npm install to avoid touching the global package.',
+    'upgrade.fetchFailed': 'Unable to fetch the latest version (check network or npm registry).',
+    'upgrade.pkgName': 'Package: mocode-ai',
+    'upgrade.failed': '[upgrade] failed: {message}',
+    'upgrade.usage': 'Usage: /upgrade\n  /upgrade              Upgrade to latest\n  /upgrade now          Same as /upgrade\n  /upgrade check        Check current vs latest\n  /upgrade status       Show current local version',
     'assistant.languageInstruction': 'Reply to the user in English.',
 };
 const resources = {

package/dist/index.js

@@ -1,5 +1,4 @@
 import { exitAltScreen } from './ui/layout.js';
-import { checkAndMaybeUpdate } from './updater/index.js';
 import { readConfigFile } from './config/file.js';
 import { detectLanguage, setLanguage, t } from './i18n/index.js';
 // 终端恢复兜底:任一退出 / 中断 / 未捕获异常路径都要恢复 alt screen,避免残留备用屏 + 滚动区域。
@@ -79,14 +78,12 @@ async function main() {
             console.error(t('cli.sessionMissing', { id }));
             process.exit(1);
         }
-        const updateNotice = checkAndMaybeUpdate();
         const { startRepl } = await import('./repl/index.js');
-        await startRepl(loaded.history, loaded.id, updateNotice, sandboxRootOverride, loaded.queryHistory);
+        await startRepl(loaded.history, loaded.id, sandboxRootOverride, loaded.queryHistory);
     }
     else {
-        const updateNotice = checkAndMaybeUpdate();
         const { startRepl } = await import('./repl/index.js');
-        await startRepl(undefined, undefined, updateNotice, sandboxRootOverride);
+        await startRepl(undefined, undefined, sandboxRootOverride);
     }
     process.exit(0);
 }

package/dist/repl/index.js

@@ -32,6 +32,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { getSandboxRoot } from '../sandbox/root.js';
 import { setCurrentSessionId, getCurrentSessionId } from '../session/state.js';
+import { checkVersion, fetchLatestVersion, getCurrentVersion, isDevRun, spawnUpgrade, } from '../commands/upgrade.js';
 /**
  * readline 的 prompt 必须是纯文本(无 ANSI):readline 按字符数算光标位置,
  * 颜色码会让光标错位、编辑时漂移。颜色只用在直接 stdout.write 的横幅 / 工具行 / 回复。
@@ -126,6 +127,13 @@ function buildSlashCommands() {
                 { name: 'en', value: '/language en', desc: d('commands.languageEn') },
             ],
         },
+        {
+            name: '/upgrade', desc: d('commands.upgrade'), children: [
+                { name: 'now', value: '/upgrade', desc: d('commands.upgradeNow') },
+                { name: 'check', value: '/upgrade check', desc: d('commands.upgradeCheck') },
+                { name: 'status', value: '/upgrade status', desc: d('commands.upgradeStatus') },
+            ],
+        },
     ];
 }
 /** 从菜单树递归生成 /help 内容；叶子 value 与菜单路径不同则同时展示真实命令。 */
@@ -342,6 +350,8 @@ function runningStateFor(cmd) {
             return { status: t('running.snapshot'), placeholder: t('running.switching') };
         case '/language':
             return { status: t('running.language'), placeholder: t('running.chooseLanguage') };
+        case '/upgrade':
+            return { status: t('running.upgrade'), placeholder: t('running.upgrading') };
         default:
             return { status: '', placeholder: '' };
     }
@@ -704,7 +714,7 @@ export function renderHistory(history) {
  * contentWrite 落入内容区(滚动区域内自动滚动,底栏不动)。history 由本模块持有,在轮次间持久;
  * agent 只读取并追加(+ 经 session/ 压缩)。每轮成功结束后自动落盘,退出后可用 --resume / /resume 续接。
  */
-export async function startRepl(initialHistory, sessionId, updateNotice = null, sandboxRootOverride, initialQueryHistory) {
+export async function startRepl(initialHistory, sessionId, sandboxRootOverride, initialQueryHistory) {
     // 模式重置:agentMode 不落盘,每个 REPL 会话从 auto 开始(/resume / --resume 亦重置)。
     setAgentMode('auto');
     // 沙箱根:文件操作边界。优先级 --sandbox-root > SANDBOX_ROOT env > process.cwd()。
@@ -809,11 +819,6 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
         }
     }
-    if (updateNotice) {
-        // 自更新提示:放 /plan · /auto 行下方,黄色(警示色)突出"你正在用的版本较旧",与 dim 提示区分。
-        // 开场静态段(进 INPUT 态前),一行,纯文本不与流式 / 输入争用。
-        layout.contentWrite(`  ${ui.yellow}⚠ ${updateNotice}${ui.reset}\n`);
-    }
     /**
      * 切换 agent 模式(Shift+Tab 触发,经 prompt.ts 的 onCycleMode 回调)。
      * cycleMode 翻 agentMode + applyMode 重写 history[0] + refreshStatusBase 设状态行 modeTag;
@@ -1154,6 +1159,72 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             // /init:把 init 指令当 user 输入发给 agent(扫描项目 + 生成 MOCODE.md),fall through 走 runAgent
             joined = INIT_PROMPT;
         }
+        if (line === '/upgrade' || line.startsWith('/upgrade ')) {
+            const arg = line === '/upgrade' ? '' : line.slice('/upgrade '.length).trim().toLowerCase();
+            // /upgrade check — 联网检查当前版本与最新版本差异
+            if (arg === 'check') {
+                const signal = startRunningListener(t('running.upgrading'));
+                try {
+                    const info = await checkVersion();
+                    if (!info.latest) {
+                        layout.contentWrite(`${ui.yellow}⚠ ${t('upgrade.fetchFailed')}${ui.reset}\n`);
+                    }
+                    else if (info.hasUpdate) {
+                        layout.contentWrite(`${ui.cyan}● ${t('upgrade.hasUpdate', { current: info.current, latest: info.latest })}${ui.reset}\n`);
+                        layout.contentWrite(`${ui.dim}${t('upgrade.upgradeStarted', { version: `v${info.latest}` })}${ui.reset}\n`);
+                    }
+                    else {
+                        layout.contentWrite(`${ui.green}✓ ${t('upgrade.noUpdate', { version: info.current })}${ui.reset}\n`);
+                    }
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    layout.contentWrite(`${ui.red}${t('upgrade.failed', { message: msg })}${ui.reset}\n`);
+                }
+                finally {
+                    stopRunningListener();
+                }
+                continue;
+            }
+            // /upgrade status — 只显示本地当前版本(不联网)
+            if (arg === 'status') {
+                const current = getCurrentVersion();
+                layout.contentWrite(`${ui.dim}${t('upgrade.currentVersion', { version: `v${current}` })}${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('upgrade.pkgName')}${ui.reset}\n`);
+                continue;
+            }
+            // /upgrade 或 /upgrade now — 直接执行升级
+            if (arg === '' || arg === 'now') {
+                const signal = startRunningListener(t('running.upgrading'));
+                try {
+                    // 先快速拉一次最新版本,给出一个明确的升级目标提示
+                    const latest = await fetchLatestVersion();
+                    const current = getCurrentVersion();
+                    if (latest && latest === current) {
+                        layout.contentWrite(`${ui.green}✓ ${t('upgrade.noUpdate', { version: current })}${ui.reset}\n`);
+                        continue;
+                    }
+                    spawnUpgrade();
+                    const target = latest ? `v${latest}` : t('upgrade.latestVersion', { version: '?' });
+                    layout.contentWrite(`${ui.cyan}● ${t('upgrade.upgradeStarted', { version: target })}${ui.reset}\n`);
+                    layout.contentWrite(`${ui.dim}${t('upgrade.upgradeHint')}${ui.reset}\n`);
+                    if (isDevRun()) {
+                        layout.contentWrite(`${ui.yellow}⚠ ${t('upgrade.devSkip')}${ui.reset}\n`);
+                    }
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    layout.contentWrite(`${ui.red}${t('upgrade.failed', { message: msg })}${ui.reset}\n`);
+                }
+                finally {
+                    stopRunningListener();
+                }
+                continue;
+            }
+            // 未知子命令
+            layout.contentWrite(`${ui.yellow}${t('upgrade.usage')}${ui.reset}\n`);
+            continue;
+        }
         if (line === '/plan') {
             // /plan:切到 plan 模式(只读探查 + 产出计划)。
             if (getAgentMode() === 'plan') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {

package/dist/updater/index.d.ts

@@ -1,22 +0,0 @@
-export interface UpdateCache {
-    lastCheck?: number;
-    latest?: string;
-    lastSpawn?: number;
-}
-/** 简易 semver 比较(只管 X.Y.Z 数字,无 pre-release):a>b 返正,a<b 返负,等返 0。 */
-export declare function compareSemver(a: string, b: string): number;
-export interface UpdateDecision {
-    notice: string | null;
-    spawn: boolean;
-    refresh: boolean;
-}
-/** 纯决策:据当前版本 / 缓存 / 时间,算是否提示 / spawn / 后台刷新。无副作用,可离线测。
- *  notice 同时携带当前版本(`current`)与最新版本(`latest`),让 REPL 提示能向用户
- *  清晰展示"你正在用的 mocode 是 X,最新是 Y",不只是单调的"有新版本"。 */
-export declare function evaluateUpdate(current: string, cache: UpdateCache, now: number): UpdateDecision;
-/**
- * 启动时调(同步,零延迟):返一行纯文本更新提示或 null。
- * 流程:dev 跳过 → 读当前版本 → 读缓存 → evaluateUpdate 决策 → 按需后台刷新 / spawn → 返提示。
- * 提示由 repl 上色写入内容区开场段(进 INPUT 态前)。
- */
-export declare function checkAndMaybeUpdate(): string | null;

package/dist/updater/index.js

@@ -1,163 +0,0 @@
-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 / 后台刷新。无副作用,可离线测。
- *  notice 同时携带当前版本(`current`)与最新版本(`latest`),让 REPL 提示能向用户
- *  清晰展示"你正在用的 mocode 是 X,最新是 Y",不只是单调的"有新版本"。 */
-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 = `当前 mocode v${current} 已是较旧版本,最新为 v${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;
-}