@bolloon/bolloon-agent 0.4.28 → 0.4.30

package/dist/utils/update-cli.js

@@ -0,0 +1,82 @@
+/**
+ * update-cli.ts — 更新系统的**脚本侧入口** (2026-09-19)
+ *
+ * 为什么单独有它: `scripts/version_check.py` / `scripts/upgrade.sh` / 安装脚本 / pre-commit
+ * 都不想拉起整个 CLI (那会先跑 setup 门禁、banner、TUI 冻结那一套)。它们只需要
+ * **同一份版本解析与同一份检查逻辑**, 所以这里只暴露薄薄一层:
+ *
+ *   node dist/utils/update-cli.js check   [json] [force] [offline]
+ *   node dist/utils/update-cli.js status  [json]
+ *   node dist/utils/update-cli.js plan    [json]
+ *   node dist/utils/update-cli.js history [json] [N]
+ *   node dist/utils/update-cli.js version [json] [verbose]
+ *   node dist/utils/update-cli.js doctor  [json] [offline]
+ *
+ * 退出码与 `bolloon update` 完全一致: 0 正常 / 1 执行失败 / 2 检查不可用。
+ */
+import { resolveBolloonHome } from '../setup/setup-store.js';
+import { checkForUpdate, readUpdateStatus } from './update-manager.js';
+import { renderCheckResult, runDoctorCommand, runUpdateCommand, runVersionCommand } from '../cli/update-commands.js';
+import { runDoctor, renderDoctor } from './update-health.js';
+function out(s) { process.stdout.write(s + '\n'); }
+async function main() {
+    const argv = process.argv.slice(2);
+    const cmd = argv[0] || 'check';
+    const args = argv.slice(1);
+    const json = args.includes('json') || args.includes('--json');
+    const home = resolveBolloonHome();
+    switch (cmd) {
+        case 'check': {
+            const force = args.includes('force') || args.includes('--force') || args.includes('--fresh');
+            const offline = args.includes('offline') || args.includes('--offline');
+            const r = await checkForUpdate({ home, force, offline });
+            if (json)
+                out(JSON.stringify(r, null, 2));
+            else if (r.status === 'up_to_date' || r.status === 'check_skipped') {
+                // 脚本默认静默: 只有在"有话说"时才输出 (与 AGENTS.md §1 步 0 的约定一致)
+                if (process.env.BOLLOON_UPDATE_VERBOSE === '1')
+                    out(renderCheckResult(r));
+            }
+            else {
+                out(renderCheckResult(r));
+            }
+            return (r.status === 'offline' || r.status === 'registry_unavailable' || r.status === 'local_version_unknown') ? 2 : 0;
+        }
+        case 'status': {
+            const s = await readUpdateStatus({ home });
+            if (json)
+                out(JSON.stringify(s, null, 2));
+            else {
+                const L = [
+                    `当前版本: ${s.currentVersion}`,
+                    `最新版本: ${s.latestVersion || '未知'}`,
+                    `检查结论: ${s.lastCheckStatus || '尚未检查'}${s.lastCheckReason ? ` (${s.lastCheckReason})` : ''}`,
+                    `最近检查: ${s.lastCheckAt || '从未'}`,
+                    `安装方式: ${s.installMethod}`,
+                    `安装目录: ${s.installDir}`,
+                    `最近更新: ${s.lastUpdate ? `${s.lastUpdate.at} ${s.lastUpdate.from} → ${s.lastUpdate.to} [${s.lastUpdate.status}]` : '无记录'}`,
+                    `需要重启: ${s.needsRestart ? '是' : '否'}`,
+                ];
+                out(L.join('\n'));
+            }
+            return 0;
+        }
+        case 'plan': return runUpdateCommand(['plan', ...(json ? ['json'] : [])]);
+        case 'history': return runUpdateCommand(['history', ...args.filter((a) => /^\d+$/.test(a)), ...(json ? ['json'] : [])]);
+        case 'version': return runVersionCommand(args);
+        case 'doctor': {
+            if (json)
+                return runDoctorCommand(['json', ...args.filter((a) => a === 'offline' || a === '--offline')]);
+            const rep = await runDoctor({ bolloonHome: home, skipNetwork: args.includes('offline') || args.includes('--offline') });
+            out(renderDoctor(rep));
+            return rep.grade === 'failed' ? 1 : 0;
+        }
+        default:
+            process.stderr.write(`未知子命令: ${cmd}\n用法: update-cli check|status|plan|history|version|doctor [json]\n`);
+            return 64;
+    }
+}
+main().then((code) => process.exit(code)).catch((e) => {
+    process.stderr.write(`更新命令执行失败: ${e?.message || e}\n`);
+    process.exit(1);
+});

package/dist/utils/update-health.js

@@ -0,0 +1,401 @@
+/**
+ * update-health.ts — 更新后的健康检查 + `bolloon doctor` (Phase 6/7, 2026-09-19)
+ *
+ * 核心判断: **安装成功 ≠ 更新成功**。所以更新完成后必须真读一遍用户数据:
+ *   版本读取 → CLI 启动 → 配置读取 → SetupStore → RunStore → TransactionStore →
+ *   SkillsManager.health → Supervisor 状态。
+ *
+ * 分级:
+ *   healthy   全过
+ *   degraded  能用, 但有漂移/缺件 (例如技能 hash 与 registry 不一致、Web 构建缺失)
+ *   failed    用不了 (例如配置损坏 / 旧交易记录读不出来)
+ *
+ * 硬约束: 健康检查**只读**。配置损坏时报 failed 并保留原文件, 绝不覆盖。
+ */
+import * as os from 'os';
+import * as fs from 'fs';
+import * as fsp from 'fs/promises';
+import * as path from 'path';
+import { spawnSync } from 'child_process';
+import { detectInstallation, readPackageAt, PKG_NAME } from './version-info.js';
+import { readUpdateState, readUpdateLock, lockIsStale, reclaimStaleLockIfAny, IN_FLIGHT_RUN_STATUSES, } from './update-state.js';
+import { queryRegistryDoc, parseJsonFromStdout } from './update-manager.js';
+import { detectRuntimeReport, verifyRuntimesDeep, evaluateCapabilities, RUNTIME_MIN, readIncompleteMarker, } from './runtime-bootstrap.js';
+function worst(items) {
+    if (items.some((i) => i.grade === 'failed'))
+        return 'failed';
+    if (items.some((i) => i.grade === 'degraded'))
+        return 'degraded';
+    return 'healthy';
+}
+export function gradeOfItems(items) { return worst(items); }
+/**
+ * 更新后 (以及 doctor) 执行的分层健康检查。
+ * 每一项都真读一次磁盘/真起一次进程, 不做"应该没问题"的推断。
+ *
+ * 路径约定 (本仓两套约定并存, 这里显式分开, 不再混):
+ *   bolloonHome = `~/.bolloon`     → readSetupState / update-state 用这个
+ *   userHome    = `~`              → RunStore / TransactionStore / SkillsManager 的 home 参数
+ *     (它们内部再拼 `.bolloon/<x>`, 传错会读到一个不存在的嵌套目录)
+ */
+export async function runHealthCheck(opts) {
+    const home = opts.bolloonHome;
+    const userHome = opts.userHome || os.homedir();
+    const install = opts.installation || detectInstallation({ home });
+    const entry = opts.entry || install.entryPath;
+    const items = [];
+    // 1. 版本读取
+    const pkg = readPackageAt(install.packageRoot);
+    const version = pkg?.version || 'unknown';
+    items.push(pkg?.version
+        ? { id: 'version_read', label: '版本读取', grade: 'ok', detail: `${PKG_NAME}@${version} (${install.packageRoot})` }
+        : { id: 'version_read', label: '版本读取', grade: 'failed', detail: `${install.packageRoot}/package.json 读不到版本` });
+    // 2. CLI 启动 (真起一次进程)
+    const cli = spawnSync(process.execPath, [entry, '--version', '--json'], { encoding: 'utf-8', timeout: 120_000, maxBuffer: 8 * 1024 * 1024 });
+    if (cli.status === 0) {
+        const parsed = parseJsonFromStdout(String(cli.stdout || ''));
+        const parsedVersion = parsed?.packageVersion ?? null;
+        if (parsedVersion && parsedVersion === version) {
+            items.push({ id: 'cli_startup', label: 'CLI 启动', grade: 'ok', detail: `node dist/cli-entry.js --version --json → ${parsedVersion}` });
+        }
+        else {
+            items.push({
+                id: 'cli_startup', label: 'CLI 启动', grade: 'degraded',
+                detail: `CLI 能启动但版本不一致 (磁盘 ${version} / 入口报 ${parsedVersion || '解析失败'}) — dist 可能过期, 跑 npm run build:main`,
+            });
+        }
+    }
+    else {
+        items.push({
+            id: 'cli_startup', label: 'CLI 启动', grade: 'failed',
+            detail: `新入口无法启动 (exit ${cli.status}): ${String(cli.stderr || '').trim().slice(0, 200) || '无输出'}`,
+        });
+    }
+    // 3. 配置读取 (损坏只报, 绝不覆盖)
+    const cfgFiles = ['config.json', 'bolloon-config.json', 'llm-config.json'];
+    const cfgProblems = [];
+    const cfgPresent = [];
+    for (const f of cfgFiles) {
+        const p = path.join(home, f);
+        if (!fs.existsSync(p))
+            continue;
+        try {
+            JSON.parse(await fsp.readFile(p, 'utf8'));
+            cfgPresent.push(f);
+        }
+        catch (e) {
+            cfgProblems.push(`${f}: ${e?.message || '解析失败'}`);
+        }
+    }
+    items.push(cfgProblems.length === 0
+        ? { id: 'config_read', label: '配置读取', grade: cfgPresent.length ? 'ok' : 'degraded', detail: cfgPresent.length ? `可读: ${cfgPresent.join(', ')}` : '没有配置文件 (首次运行?)' }
+        : { id: 'config_read', label: '配置读取', grade: 'failed', detail: `配置损坏, 已保留原文件不覆盖: ${cfgProblems.join('; ')}`, fixable: true });
+    // 4. SetupStore
+    try {
+        const { readSetupState } = await import('../setup/setup-store.js');
+        const st = await readSetupState(home);
+        items.push(st
+            ? { id: 'setup_store', label: 'SetupStore 读取', grade: 'ok', detail: `stage=${st.stage} gate=${st.allow?.agent ? 'agent-ready' : 'agent-blocked'}` }
+            : { id: 'setup_store', label: 'SetupStore 读取', grade: 'degraded', detail: '没有 setup-state.json (未初始化或未走过向导)' });
+    }
+    catch (e) {
+        items.push({ id: 'setup_store', label: 'SetupStore 读取', grade: 'failed', detail: `读取异常: ${e?.message || e}` });
+    }
+    // 5. RunStore
+    try {
+        const { listRuns } = await import('../agents/run-store.js');
+        const runs = await listRuns({ limit: 5 });
+        items.push({ id: 'run_store', label: 'RunStore 读取', grade: 'ok', detail: `可读, 最近 ${runs.length} 条 Run` });
+    }
+    catch (e) {
+        items.push({ id: 'run_store', label: 'RunStore 读取', grade: 'failed', detail: `旧 Run 记录读不出来: ${e?.message || e}` });
+    }
+    // 6. TransactionStore (home 参数 = 用户 home, 内部再拼 .bolloon/transactions)
+    try {
+        const { listTransactions } = await import('../agents/x402/transaction-store.js');
+        const txs = await listTransactions(userHome);
+        items.push({ id: 'transaction_store', label: 'TransactionStore 读取', grade: 'ok', detail: `可读, ${txs.length} 笔交易` });
+    }
+    catch (e) {
+        items.push({ id: 'transaction_store', label: 'TransactionStore 读取', grade: 'failed', detail: `旧交易记录读不出来: ${e?.message || e}` });
+    }
+    // 7. SkillsManager health (home 参数 = 用户 home)
+    try {
+        const { getSkillsManager } = await import('../agents/skills-manager.js');
+        const h = await getSkillsManager({ home: userHome }).health({ home: userHome });
+        const issues = [];
+        if (h.drifted.length)
+            issues.push(`漂移 ${h.drifted.length}`);
+        if (h.invalid.length)
+            issues.push(`不合格 ${h.invalid.length}`);
+        if (h.missing.length)
+            issues.push(`registry 缺盘 ${h.missing.length}`);
+        if (h.duplicates.length)
+            issues.push(`重复 ${h.duplicates.length}`);
+        items.push(issues.length === 0
+            ? { id: 'skills_health', label: 'SkillsManager 健康', grade: 'ok', detail: `${h.total} 个技能, 无漂移` }
+            : { id: 'skills_health', label: 'SkillsManager 健康', grade: 'degraded', detail: `${h.total} 个技能: ${issues.join(', ')}` });
+    }
+    catch (e) {
+        items.push({ id: 'skills_health', label: 'SkillsManager 健康', grade: 'degraded', detail: `无法检查: ${e?.message || e}` });
+    }
+    // 8. 运行时 (Node/npm/Git/Python) —— Phase 8: 更新后不能只验证 CLI 版本,
+    //    还要**真执行**: git 建临时仓库读状态 / python 真跑脚本 / node 真加载 CLI。
+    let runtimeReport = null;
+    try {
+        const detected = await detectRuntimeReport({ home, useConfig: true, entryPath: entry });
+        const deep = await verifyRuntimesDeep(detected.facts, entry);
+        runtimeReport = { ...detected, facts: deep, capabilities: evaluateCapabilities(deep) };
+        runtimeReport.ok = deep.every((f) => f.status === 'found' && f.meetsMinimum);
+        runtimeReport.missing = deep.filter((f) => f.status === 'missing').map((f) => f.runtime);
+        const bad = deep.filter((f) => f.status !== 'found');
+        if (bad.length === 0) {
+            items.push({
+                id: 'runtime', label: '运行时 (Node/npm/Git/Python)', grade: 'ok',
+                detail: deep.map((f) => `${f.runtime} ${f.version}`).join(' · ') + ` (最低: ${Object.entries(RUNTIME_MIN).map(([k, v]) => `${k}≥${v.min}`).join(', ')})`,
+            });
+        }
+        else {
+            items.push({
+                id: 'runtime', label: '运行时 (Node/npm/Git/Python)', grade: 'failed',
+                detail: `${bad.map((f) => `${f.runtime}: ${f.error || '不可用'}`).join('; ')} → bolloon runtime install yes`,
+                fixable: true,
+            });
+        }
+    }
+    catch (e) {
+        items.push({ id: 'runtime', label: '运行时 (Node/npm/Git/Python)', grade: 'degraded', detail: `检查失败: ${e?.message || e}` });
+    }
+    // 9. Supervisor 状态
+    try {
+        const { supervisorStatePath } = await import('../agents/supervisor-host.js');
+        let sup = null;
+        try {
+            sup = JSON.parse(await fsp.readFile(supervisorStatePath(), 'utf8'));
+        }
+        catch {
+            sup = null;
+        }
+        if (!sup) {
+            items.push({ id: 'supervisor_state', label: 'Supervisor 状态', grade: 'ok', detail: '无 supervisor.json (未启用长期执行)' });
+        }
+        else {
+            let alive = false;
+            try {
+                process.kill(sup.pid, 0);
+                alive = true;
+            }
+            catch (e) {
+                alive = e?.code === 'EPERM';
+            }
+            const ghost = alive === false && !sup.stoppedAt;
+            items.push(ghost
+                ? { id: 'supervisor_state', label: 'Supervisor 状态', grade: 'degraded', detail: `幽灵状态: pid ${sup.pid} 已不在, 但没有 stoppedAt (上次没好好停)` }
+                : { id: 'supervisor_state', label: 'Supervisor 状态', grade: 'ok', detail: alive ? `运行中 (pid ${sup.pid})` : `已停止 (${sup.stoppedAt})` });
+        }
+    }
+    catch (e) {
+        items.push({ id: 'supervisor_state', label: 'Supervisor 状态', grade: 'degraded', detail: `无法读取: ${e?.message || e}` });
+    }
+    return {
+        grade: worst(items),
+        version,
+        checkedAt: new Date().toISOString(),
+        items,
+        failures: items.filter((i) => i.grade === 'failed').map((i) => `${i.label}: ${i.detail}`),
+        degradations: items.filter((i) => i.grade === 'degraded').map((i) => `${i.label}: ${i.detail}`),
+        runtime: runtimeReport,
+    };
+}
+export function renderHealth(r) {
+    const L = [`更新健康检查: ${r.grade} (v${r.version} @ ${r.checkedAt})`];
+    for (const i of r.items)
+        L.push(`  ${i.grade === 'ok' ? '✓' : i.grade === 'degraded' ? '!' : '✗'} ${i.label}: ${i.detail}`);
+    return L.join('\n');
+}
+/** npm 各可能位置上的 @bolloon/bolloon-agent 副本 (用来发现"装了多份/装错份")。 */
+export async function findInstalledCopies(home) {
+    const { npmGlobalRoot, npmGlobalPrefix } = await import('./version-info.js');
+    const globalRoot = npmGlobalRoot();
+    const prefix = npmGlobalPrefix();
+    const candidates = [];
+    if (globalRoot)
+        candidates.push(path.join(globalRoot, '@bolloon', 'bolloon-agent'));
+    if (prefix)
+        candidates.push(path.join(prefix, 'lib', 'node_modules', '@bolloon', 'bolloon-agent'));
+    candidates.push(path.join(home, '.npm-global', 'lib', 'node_modules', '@bolloon', 'bolloon-agent'), '/usr/local/lib/node_modules/@bolloon/bolloon-agent', '/opt/homebrew/lib/node_modules/@bolloon/bolloon-agent');
+    try {
+        const nvmBase = path.join(home, '.nvm', 'versions', 'node');
+        for (const ver of await fsp.readdir(nvmBase))
+            candidates.push(path.join(nvmBase, ver, 'lib', 'node_modules', '@bolloon', 'bolloon-agent'));
+    }
+    catch { /* 没有 nvm */ }
+    const install = detectInstallation({ home });
+    const seen = new Set();
+    const out = [];
+    for (const c of candidates) {
+        let real = c;
+        try {
+            real = fs.realpathSync(c);
+        }
+        catch {
+            continue;
+        }
+        if (seen.has(real))
+            continue;
+        seen.add(real);
+        const pkg = readPackageAt(c) || readPackageAt(real);
+        if (!pkg?.version)
+            continue;
+        out.push({ dir: c, version: pkg.version, isCurrent: path.resolve(real) === path.resolve(install.packageRoot) });
+    }
+    return out;
+}
+/**
+ * `bolloon doctor` —— 回答"我这台机器上的 Bolloon 是不是健康的"。
+ * 重点不在"能不能跑", 而在"安装入口 / 版本事实 / 更新状态 三者是否自洽"。
+ */
+export async function runDoctor(opts) {
+    const home = opts.bolloonHome;
+    const userHome = opts.userHome || os.homedir();
+    const install = opts.installation || detectInstallation({ home });
+    const checks = [];
+    const pkg = readPackageAt(install.packageRoot);
+    const version = pkg?.version || 'unknown';
+    // 1. 安装入口指向正确版本
+    if (!install.binPath) {
+        checks.push({ id: 'entry_point', label: '安装入口', grade: 'degraded', detail: 'PATH 里找不到 bolloon 入口 (可能只是没加 PATH)', action: 'export PATH="$(npm prefix -g)/bin:$PATH"' });
+    }
+    else {
+        let target = '';
+        try {
+            target = fs.realpathSync(install.binPath);
+        }
+        catch {
+            target = '';
+        }
+        const expect = path.join(install.packageRoot, 'dist', 'cli-entry.js');
+        const ok = target === '' || path.resolve(target) === path.resolve(expect) || target.startsWith(path.resolve(install.packageRoot));
+        checks.push(ok
+            ? { id: 'entry_point', label: '安装入口', grade: 'ok', detail: `${install.binPath} → ${target || '未知'}` }
+            : { id: 'entry_point', label: '安装入口', grade: 'failed', detail: `${install.binPath} 指向 ${target}, 但当前安装目录是 ${install.packageRoot}`, action: '重新安装: npm install -g @bolloon/bolloon-agent' });
+    }
+    // 2. package.json 版本 vs 运行时版本
+    const cli = spawnSync(process.execPath, [install.entryPath, '--version', '--json'], { encoding: 'utf-8', timeout: 120_000, maxBuffer: 8 * 1024 * 1024 });
+    const runtimeVersion = parseJsonFromStdout(String(cli.stdout || ''))?.packageVersion ?? null;
+    checks.push(runtimeVersion === version
+        ? { id: 'version_consistency', label: '版本一致性', grade: 'ok', detail: `package.json 与运行时一致 (${version})` }
+        : { id: 'version_consistency', label: '版本一致性', grade: 'failed', detail: `package.json ${version} ≠ 运行时 ${runtimeVersion || '读取失败'} (dist 过期或入口错位)`, action: 'npm run build:main' });
+    // 3. npm 全局路径冲突 (装了几份)
+    const copies = await findInstalledCopies(userHome);
+    const others = copies.filter((c) => !c.isCurrent);
+    checks.push(others.length === 0
+        ? { id: 'npm_conflicts', label: 'npm 全局路径', grade: 'ok', detail: `只有一份 (${copies[0]?.dir || install.packageRoot} = ${copies[0]?.version || version})` }
+        : { id: 'npm_conflicts', label: 'npm 全局路径', grade: 'degraded', detail: `发现 ${others.length} 份其它安装: ${others.map((o) => `${o.dir} (${o.version})`).join(', ')}`, action: '删掉多余那份, 否则 which bolloon 可能指向旧版本' });
+    // 4. ~/.bolloon 可写
+    //    注意: 目录**还不存在** (首次运行) 不等于不可写 —— 真跑抓到过这个假阴性:
+    //    全新 HOME 里 doctor 报"不可写"并据此退出 1, 而实际上父目录可写、首次运行会自己创建。
+    let homeState = 'blocked';
+    if (fs.existsSync(home)) {
+        try {
+            fs.accessSync(home, fs.constants.W_OK);
+            homeState = 'writable';
+        }
+        catch {
+            homeState = 'blocked';
+        }
+    }
+    else {
+        try {
+            fs.accessSync(path.dirname(home), fs.constants.W_OK);
+            homeState = 'creatable';
+        }
+        catch {
+            homeState = 'blocked';
+        }
+    }
+    checks.push(homeState === 'blocked'
+        ? { id: 'home_writable', label: '~/.bolloon 可写', grade: 'failed', detail: `${home} 不可写 — 会话/技能/Run 都落不下去`, action: `chmod u+w ${path.dirname(home)}` }
+        : homeState === 'creatable'
+            ? { id: 'home_writable', label: '~/.bolloon 可写', grade: 'degraded', detail: `${home} 还不存在 (首次运行会创建; 父目录 ${path.dirname(home)} 可写)` }
+            : { id: 'home_writable', label: '~/.bolloon 可写', grade: 'ok', detail: home });
+    // 5. 更新锁残留
+    const lock = readUpdateLock(home);
+    if (!lock) {
+        checks.push({ id: 'update_lock', label: '更新锁', grade: 'ok', detail: '无残留锁' });
+    }
+    else if (lockIsStale(lock)) {
+        const rec = await reclaimStaleLockIfAny(home);
+        checks.push({ id: 'update_lock', label: '更新锁', grade: 'degraded', detail: `陈旧锁 (pid ${lock.pid}, ${lock.at})${rec.reclaimed ? ' — 已回收' : ' — 回收失败, 请手动删除 update.lock'}` });
+    }
+    else {
+        checks.push({ id: 'update_lock', label: '更新锁', grade: 'degraded', detail: `另一个更新进程正在持有锁 (pid ${lock.pid}, ${lock.at}) — 等它结束或确认该进程已死` });
+    }
+    // 6. 上次更新是否异常中断
+    const st = await readUpdateState(home);
+    const inFlight = st.lastUpdate && IN_FLIGHT_RUN_STATUSES.includes(st.lastUpdate.status);
+    checks.push(inFlight
+        ? { id: 'last_update', label: '上次更新', grade: 'degraded', detail: `上次更新停在 ${st.lastUpdate.status} (${st.lastUpdate.at}) — 异常中断, 建议 bolloon update --plan 后再更新一次`, action: 'bolloon update --plan' }
+        : st.lastFailure
+            ? { id: 'last_update', label: '上次更新', grade: 'degraded', detail: `上次更新失败 (${st.lastFailure.at}, ${st.lastFailure.stage}): ${st.lastFailure.reason}` }
+            : { id: 'last_update', label: '上次更新', grade: 'ok', detail: st.lastUpdate ? `最近一次 ${st.lastUpdate.at} ${st.lastUpdate.from} → ${st.lastUpdate.to} [${st.lastUpdate.status}]` : '无更新记录' });
+    if (st.needsRestart) {
+        checks.push({ id: 'needs_restart', label: '待重启', grade: 'degraded', detail: '新版本已就位但还没重启, 当前进程仍在跑旧代码', action: '重启 bolloon' });
+    }
+    // 7. 版本检查源是否可达 (可跳过)
+    if (opts.skipNetwork) {
+        checks.push({ id: 'version_source', label: '版本源可达', grade: 'ok', detail: '已跳过 (离线)' });
+    }
+    else {
+        const reg = await queryRegistryDoc();
+        checks.push(reg.ok
+            ? { id: 'version_source', label: '版本源可达', grade: 'ok', detail: `npm registry 可达, latest=${reg.doc.latest}` }
+            : { id: 'version_source', label: '版本源可达', grade: 'degraded', detail: `${reg.kind}: ${reg.detail}` });
+    }
+    // 7.5 安装完整性标记 (postinstall 发现缺 Git/Python 时留下的)
+    const marker = await readIncompleteMarker(home).catch(() => null);
+    if (marker) {
+        checks.push({
+            id: 'install_complete', label: '安装完整性', grade: 'degraded',
+            detail: `postinstall 记下过一次"安装未完成" (${marker.at}): 缺 ${marker.missing.join(', ')} —— 运行时补齐成功会自动清掉这个标记`,
+            action: 'bolloon runtime install yes',
+        });
+    }
+    // 8. 分层健康检查 (版本/CLI/配置/三个 Store/运行时/技能/Supervisor)
+    const health = await runHealthCheck({ bolloonHome: home, userHome, installation: install });
+    if (health.runtime) {
+        const rt = health.runtime;
+        const detail = rt.facts.map((f) => `${f.runtime} ${f.version || '-'} ${f.path || ''}[${f.installedByBolloon ? 'Bolloon 安装' : f.source}]`).join(' · ');
+        checks.push({
+            id: 'runtime', label: '运行时配置', grade: rt.ok ? 'ok' : 'failed', detail,
+            action: rt.ok ? undefined : 'bolloon runtime install yes (补装缺失运行时; 不会偷偷 sudo)',
+        });
+        checks.push({
+            id: 'runtime_capabilities', label: '能力矩阵',
+            grade: rt.capabilities.core ? (rt.capabilities.sourceUpdate && rt.capabilities.pythonSkill ? 'ok' : 'degraded') : 'failed',
+            detail: `核心运行=${rt.capabilities.core ? '可用' : '不可用'} · 源码更新=${rt.capabilities.sourceUpdate ? '可用' : '不可用'} · Git 协作=${rt.capabilities.gitCollaboration ? '可用' : '不可用'} · Python Skill=${rt.capabilities.pythonSkill ? '可用' : '不可用'} · Wiki 工具=${rt.capabilities.wikiTools ? '可用' : '不可用'}`,
+        });
+    }
+    checks.push({
+        id: 'health', label: '分层健康检查', grade: health.grade === 'healthy' ? 'ok' : health.grade === 'degraded' ? 'degraded' : 'failed',
+        detail: `${health.grade}: ${[...health.failures, ...health.degradations].join(' | ') || '全部通过'}`,
+    });
+    return { grade: worst(checks.map((c) => ({ ...c, id: c.id, label: c.label, detail: c.detail, grade: c.grade }))), version, checkedAt: new Date().toISOString(), checks, health };
+}
+export function renderDoctor(r) {
+    const L = [`Bolloon doctor — ${r.grade} (v${r.version})`, ''];
+    for (const c of r.checks) {
+        L.push(`${c.grade === 'ok' ? '✅' : c.grade === 'degraded' ? '⚠️ ' : '❌'} ${c.label}: ${c.detail}`);
+        if (c.action)
+            L.push(`      → ${c.action}`);
+    }
+    if (r.grade !== 'healthy') {
+        L.push('');
+        L.push(r.grade === 'failed' ? '结论: 有阻塞性问题, 先按上面 → 的提示修。' : '结论: 能跑, 但有需要看一眼的地方 (不影响基本使用)。');
+    }
+    else {
+        L.push('');
+        L.push('结论: 安装入口 / 版本事实 / 更新状态三者自洽。');
+    }
+    return L.join('\n');
+}