@windsland52/maafw-live 0.0.0-stage → 0.3.0

package/lib/commands/skill.js

@@ -0,0 +1,169 @@
+/**
+ * `maafw-live skill` —— 随包发布的 agent skill 与"装在 agent 里的那一份"如何对齐。
+ *
+ * 为什么不写版本号：skill 讲的是本工具的命令与判据，跟包走才不会各说各话；但写进文件的版本号
+ * 每次发版都要改，而且从仓库装的副本仍然对不上。所以对齐用**比字节**：逐文件 same / different /
+ * missing / extra（extra 是目标目录多出来的文件，例如 skills CLI 放进来的 agent 元数据，不算漂移）。
+ *
+ * 与本仓 docs/ 的分工：docs/ 是字段与协议的唯一出处，skill 只写动线与判据——两者都随包发布，
+ * 区别在消费者（人读 docs，agent 装 skill），因此这里只做"是不是同一份字节"，不解释内容。
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { EXIT, fail } from '../protocol.js';
+const SKILL_NAME = 'maafw-live';
+/** 包内 skill 目录：lib/commands/ → <包根>/skills/maafw-live（本地 checkout 同构） */
+export function skillPayloadDir() {
+    return join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'skills', SKILL_NAME);
+}
+const sha256 = (buf) => createHash('sha256').update(buf).digest('hex');
+/** 目录内全部文件的相对路径（'/' 分隔、排序稳定），供比对与安装共用。 */
+function listFiles(dir) {
+    const out = [];
+    const walk = (cur) => {
+        for (const e of readdirSync(cur, { withFileTypes: true })) {
+            const abs = join(cur, e.name);
+            if (e.isDirectory())
+                walk(abs);
+            else if (e.isFile())
+                out.push(relative(dir, abs).split(sep).join('/'));
+        }
+    };
+    walk(dir);
+    return out.sort();
+}
+/**
+ * 逐文件比对（纯函数，单测直接喂两个目录）。只比字节：任何不同都是 different，
+ * 但在**仅行尾不同**（CRLF ↔ LF）时补一条 note——那不是内容分叉，是工具改写。
+ */
+export function compareSkillTrees(payload, target) {
+    const files = listFiles(payload);
+    const rows = [];
+    for (const rel of files) {
+        const pb = readFileSync(join(payload, ...rel.split('/')));
+        const ta = join(target, ...rel.split('/'));
+        const base = { path: rel, bytes: pb.length, sha256: sha256(pb) };
+        if (!existsSync(ta)) {
+            rows.push({ ...base, status: 'missing' });
+            continue;
+        }
+        const tb = readFileSync(ta);
+        if (pb.equals(tb)) {
+            rows.push({ ...base, status: 'same' });
+            continue;
+        }
+        const eolOnly = pb.toString('utf8').replace(/\r\n/g, '\n') === tb.toString('utf8').replace(/\r\n/g, '\n');
+        rows.push({ ...base, status: 'different', ...(eolOnly ? { note: '仅行尾不同（CRLF/LF）' } : {}) });
+    }
+    for (const rel of listFiles(target)) {
+        if (!files.includes(rel))
+            rows.push({ path: rel, status: 'extra' });
+    }
+    return rows;
+}
+const driftOf = (rows) => rows.some((r) => r.status !== 'same' && r.status !== 'extra');
+function readPayload(dir) {
+    return listFiles(dir).map((rel) => {
+        const buf = readFileSync(join(dir, ...rel.split('/')));
+        return { path: rel, bytes: buf.length, sha256: sha256(buf), text: buf.toString('utf8') };
+    });
+}
+export const skillCommand = {
+    name: 'skill',
+    summary: '随包 skill：看包内副本与文件指纹、比对已装副本（same/different/missing/extra）、字节精确安装',
+    usage: 'maafw-live skill                                包内 skill 位置与文件指纹\n' +
+        '       maafw-live skill --check <dir>                 比对 <dir>/maafw-live 与包内副本（有漂移退出 3）\n' +
+        '       maafw-live skill --install <dir>               把包内副本逐字节写到 <dir>/maafw-live\n' +
+        '       maafw-live skill --print [--format json]       输出包内副本内容（harness 自取）',
+    options: {
+        check: { type: 'string' },
+        install: { type: 'string' },
+        print: { type: 'boolean' },
+        format: { type: 'string' },
+    },
+    async run(ctx) {
+        const payload = skillPayloadDir();
+        if (!existsSync(payload)) {
+            return fail('SKILL_NOT_FOUND', '包内未找到 skill 目录：' + payload, '本版本应随包发布 skills/maafw-live；从仓库运行时确认 skills/ 没有被删', EXIT.ENV);
+        }
+        const files = listFiles(payload);
+        const checkDir = typeof ctx.values.check === 'string' ? ctx.values.check : undefined;
+        if (checkDir !== undefined) {
+            const target = join(checkDir, SKILL_NAME);
+            if (!existsSync(target)) {
+                return fail('SKILL_DIR_NOT_FOUND', '目标目录下没有 ' + SKILL_NAME + ' skill：' + target, '给的是**安装根目录**（里面应当有 ' + SKILL_NAME + '/SKILL.md），例如 --global 装的 ~/.claude/skills', EXIT.ENV);
+            }
+            const rows = compareSkillTrees(payload, target);
+            const drifted = driftOf(rows);
+            const extra = rows.filter((r) => r.status === 'extra');
+            const mark = (s) => s === 'same' ? 'same     ' : (s === 'different' ? 'different' : (s === 'missing' ? 'missing  ' : 'extra    '));
+            const human = [
+                '包内副本 ' + payload,
+                '已装副本 ' + target,
+                ...rows.map((r) => '  ' + mark(r.status) + ' ' + r.path + (r.note ? '（' + r.note + '）' : '')),
+                drifted
+                    ? '结论：有漂移——用 --install <dir> 覆盖，或用 skills CLI 重新安装'
+                    : '结论：逐字节一致' + (extra.length ? '（' + extra.length + ' 个多余文件不计漂移）' : ''),
+            ];
+            return {
+                exitCode: drifted ? EXIT.FINDINGS : EXIT.OK,
+                human,
+                data: { payload, target, drift: drifted, files: rows },
+                ...(drifted ? { warnings: ['skill 与包内副本不一致：已装副本可能对应旧版本 CLI'] } : {}),
+            };
+        }
+        const installDir = typeof ctx.values.install === 'string' ? ctx.values.install : undefined;
+        if (installDir !== undefined) {
+            const target = join(installDir, SKILL_NAME);
+            const written = [];
+            for (const rel of files) {
+                const dst = join(target, ...rel.split('/'));
+                mkdirSync(dirname(dst), { recursive: true });
+                writeFileSync(dst, readFileSync(join(payload, ...rel.split('/'))));
+                written.push(dst);
+            }
+            return {
+                exitCode: EXIT.OK,
+                human: [
+                    '已写出 ' + files.length + ' 个文件 → ' + target,
+                    ...written.map((w) => '  ' + w),
+                    '注：本命令只做逐字节复制；要 agent 自动更新请用 skills CLI（npx skills add …）',
+                ],
+                data: { payload, target, files: written },
+                written,
+            };
+        }
+        if (ctx.values.print === true) {
+            const rows = readPayload(payload);
+            const asJson = ctx.values.format === 'json';
+            if (asJson) {
+                return {
+                    exitCode: EXIT.OK,
+                    data: { payload, files: rows },
+                };
+            }
+            const human = [];
+            for (const f of rows) {
+                human.push('===== ' + f.path + ' =====');
+                human.push(...f.text.replace(/\r\n/g, '\n').replace(/\n$/, '').split('\n'));
+                human.push('');
+            }
+            return { exitCode: EXIT.OK, human, data: { payload, files: rows.map(({ text, ...rest }) => rest) } };
+        }
+        const rows = readPayload(payload);
+        const total = rows.reduce((a, f) => a + f.bytes, 0);
+        return {
+            exitCode: EXIT.OK,
+            human: [
+                '包内 skill：' + payload,
+                '文件 ' + rows.length + ' 个，共 ' + total + ' 字节（skill 不写自己的版本号——对齐用比字节）',
+                ...rows.map((f) => '  ' + f.sha256.slice(0, 12) + '  ' + String(f.bytes).padStart(6) + '  ' + f.path),
+                '下一步：maafw-live skill --check <安装根目录> 比对已装副本；--install <目录> 逐字节写出',
+            ],
+            data: { payload, files: rows.map(({ text, ...rest }) => rest) },
+        };
+    },
+};
+//# sourceMappingURL=skill.js.map

package/lib/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"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"}

package/lib/commands/timing.js

@@ -0,0 +1,229 @@
+/**
+ * timing：从帧流与节点事件反推 pipeline 的 delay / timeout 建议值。
+ *
+ * 做法：自动开流 → 跑任务（--runs n 次采样）→ 对齐两类时间线——
+ *  - 节点时长（record.nodes）→ 节点级 timeout 建议（P95 × 1.5 余量）
+ *  - 节点完成后的画面稳定时间（完成事件到下一个 stable 事件的时距）→ post-delay /
+ *    wait_freezes 建议；下一节点先于 stable 开始则标"未稳定"（连续动画/识别窗口过紧）。
+ * 分布口径：建议值只取成功 run（失败 run 的时长是提前终止的，对 timeout 建议是误导）；
+ * 单次采样退化为 P50=P95=该值，与历史单次行为逐字段一致。
+ */
+import { EXIT, fail } from '../protocol.js';
+import { computePipelineOverride, mergeOverride } from '../interface/index.js';
+import * as act from '../runtime/actions.js';
+import { withDaemon } from '../runtime/actions.js';
+import { describeSession, ensureSession } from '../runtime/session.js';
+import { CONNECT_OPTIONS, daemonFail, sessionOptions } from './runtime.js';
+/** 最近邻秩百分位：sorted 升序；n=1 时任意 p 返回该值，n 小时偏保守端（P95 取最大） */
+export function percentile(values, p) {
+    if (!values.length)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const idx = Math.min(sorted.length - 1, Math.max(0, Math.ceil((p / 100) * sorted.length) - 1));
+    return sorted[idx];
+}
+/** 跨 run 聚合（纯函数，单测直断言）：节点统计与建议值都只算成功样本 */
+export function aggregateTiming(samples) {
+    const ok = samples.filter((s) => s.ok);
+    const failed = samples.length - ok.length;
+    const durations = ok.map((s) => s.durationMs);
+    const maxNodeP95 = ok.length ? percentile(ok.map((s) => Math.max(0, ...s.nodes.map((n) => n.ms))), 95) : 0;
+    const settleSamples = ok.map((s) => {
+        const ss = s.nodes.filter((n) => n.settle !== null).map((n) => n.settle);
+        return ss.length ? Math.max(...ss) : null;
+    });
+    const settles = settleSamples.filter((v) => v !== null);
+    const names = [...new Set(ok.flatMap((s) => s.nodes.map((n) => n.name)))];
+    const nodeStats = names.map((name) => {
+        /* 全部出现都算：同名节点 run 内重复执行时，慢的往往是第二次（首跑等动画） */
+        const per = ok.flatMap((s) => s.nodes.filter((n) => n.name === name));
+        const ms = per.map((n) => n.ms);
+        const st = per.filter((n) => n.settle !== null).map((n) => n.settle);
+        return {
+            name,
+            status: per.at(-1)?.status ?? 'unknown',
+            runs: ok.filter((s) => s.nodes.some((n) => n.name === name)).length,
+            occurrences: per.length,
+            msP50: percentile(ms, 50),
+            msP95: percentile(ms, 95),
+            settleP50: st.length ? percentile(st, 50) : null,
+            settleP95: st.length ? percentile(st, 95) : null,
+            settleSamples: st.length,
+            nextBeforeStable: per.some((n) => n.nextBeforeStable),
+        };
+    });
+    return {
+        successful: ok.length, failed,
+        durationP50: percentile(durations, 50),
+        durationP95: percentile(durations, 95),
+        maxNodeP95,
+        maxSettleP95: settles.length ? percentile(settles, 95) : null,
+        nodeStats,
+        suggest: {
+            nodeTimeoutMs: Math.ceil((maxNodeP95 * 1.5) / 100) * 100,
+            taskTimeoutMs: Math.ceil((percentile(durations, 95) * 2) / 1000) * 1000,
+            postDelayMs: settles.length ? Math.ceil((percentile(settles, 95) * 1.2) / 50) * 50 : null,
+        },
+    };
+}
+export const timingCommand = {
+    name: 'timing',
+    summary: '跑任务并反推 timing 建议：节点时长 → timeout，动作后稳定时间 → wait_freezes 兜底参考；--runs n 取 P50/P95 分布',
+    usage: 'maafw-live timing --entry <task> --project <dir> [--timeout <ms>] [--runs <n>] [--preset <name>] [--override <json>]\n' +
+        '       自动开流（帧流与节点事件对齐是分析前提）；单次采样是下界，--runs 3-5 取分布再定稿',
+    options: {
+        ...CONNECT_OPTIONS,
+        entry: { type: 'string' },
+        'resource-dir': { type: 'string' },
+        timeout: { type: 'string' },
+        runs: { type: 'string' },
+        override: { type: 'string' },
+        preset: { type: 'string' },
+    },
+    async run(ctx) {
+        const o = sessionOptions(ctx.values);
+        const entry = (typeof ctx.values.entry === 'string' ? ctx.values.entry : ctx.positionals[0]) ?? undefined;
+        const resourceDir = typeof ctx.values['resource-dir'] === 'string' ? ctx.values['resource-dir'] : undefined;
+        if (!entry)
+            return fail('BAD_ARGUMENTS', '缺少入口任务名：--entry <task>', undefined, EXIT.USAGE);
+        if (!o.project && !resourceDir) {
+            return fail('BAD_ARGUMENTS', '要么给 --project <dir>，要么给 --resource-dir <dir>', undefined, EXIT.USAGE);
+        }
+        const timeoutMs = typeof ctx.values.timeout === 'string' ? Number(ctx.values.timeout) : 120000;
+        if (!Number.isFinite(timeoutMs))
+            return fail('BAD_ARGUMENTS', '--timeout 必须是毫秒数', undefined, EXIT.USAGE);
+        const runs = typeof ctx.values.runs === 'string' ? Number(ctx.values.runs) : 1;
+        if (!Number.isInteger(runs) || runs < 1 || runs > 10) {
+            return fail('BAD_ARGUMENTS', '--runs 需为 1-10 的整数（真机动作采样，别当压测跑）', undefined, EXIT.USAGE);
+        }
+        let override = {};
+        if (typeof ctx.values.override === 'string') {
+            try {
+                override = JSON.parse(ctx.values.override);
+            }
+            catch (e) {
+                return fail('BAD_ARGUMENTS', '--override 不是合法 JSON', undefined, EXIT.USAGE);
+            }
+        }
+        try {
+            return await withDaemon(async (client) => {
+                const s = await ensureSession(client, o);
+                let args;
+                if (o.project) {
+                    const paths = s.plan?.resource?.paths ?? [];
+                    if (!paths.length) {
+                        return fail('RESOURCE_NOT_FOUND', '项目里没有解析出资源路径：检查 interface.json 的 resource[] 声明', undefined, EXIT.FINDINGS);
+                    }
+                    const task = s.plan?.loaded.tasks.find((t) => t.name === entry || t.entry === entry);
+                    const chain = computePipelineOverride({
+                        loaded: s.plan.loaded,
+                        controllerName: s.plan?.controllerName ?? null,
+                        resourceName: s.plan?.resource?.selected ?? null,
+                        taskName: task?.name ?? null,
+                        presetName: typeof ctx.values.preset === 'string' ? ctx.values.preset : null,
+                    });
+                    /* 用户 --override 最后覆盖合成结果：**与 run 共用同一份合并实现**。
+                     * 这里曾经自己展开 fields——字符串会被摊成 {0:'a',1:'b'}、null / 数字静默变空对象，
+                     * 于是同一个 --override 在 timing 与 run 下结果不同。 */
+                    mergeOverride(chain.override, override);
+                    args = {
+                        resourceDirs: paths, entry: task?.entry ?? entry,
+                        override: chain.override, timeoutMs,
+                        agents: s.plan.loaded.agents.map((a) => ({ exec: a.exec, args: a.args })),
+                        agentCwd: s.plan.loaded.dir ?? undefined,
+                    };
+                }
+                else {
+                    args = { resourceDir, entry, override, timeoutMs };
+                }
+                /* 帧流是分析前提：开流 → 跑 n 次 → 停流；每 run 切自己的事件区间对齐。
+                 * 末节点可能把下一 run 开头的 stable 算作自己的稳定点——语义上仍是
+                 * "该节点之后画面何时静默"，可接受。 */
+                await act.streamStart(client, { fps: 8 }).catch(() => null);
+                const samples = [];
+                try {
+                    for (let i = 1; i <= runs; i++) {
+                        const eventsBefore = client.events.events.length;
+                        const r = await act.run(client, args, timeoutMs);
+                        const evs = client.events.events.slice(eventsBefore);
+                        if (r.ok === false || !r.record) {
+                            return fail('TIMING_RUN', '任务没跑起来：' + String(r.error ?? '?'), undefined, EXIT.FINDINGS);
+                        }
+                        const rec = r.record;
+                        /* 时间线对齐：run 类事件带节点名与消息；stable 是画面静默点 */
+                        const runEvs = evs.filter((e) => e.type === 'run' && e.node);
+                        const stables = evs.filter((e) => e.type === 'stable').map((e) => Number(e.t));
+                        const nodes = rec.nodes.map((n) => {
+                            const done = runEvs.filter((e) => e.node === n.name && /Succeeded$/.test(e.msg)).at(-1)
+                                ?? runEvs.filter((e) => e.node === n.name && /Failed$/.test(e.msg)).at(-1);
+                            if (!done)
+                                return { name: n.name, ms: n.ms, status: n.status, settle: null, nextBeforeStable: false };
+                            const nextNode = runEvs.find((e) => e.t > done.t && e.node !== n.name);
+                            const stable = stables.find((t) => t > done.t);
+                            const settle = stable !== undefined ? stable - done.t : null;
+                            return {
+                                name: n.name, ms: n.ms, status: n.status,
+                                settle,
+                                nextBeforeStable: nextNode !== undefined && (stable === undefined || nextNode.t < stable),
+                            };
+                        });
+                        samples.push({ index: i, ok: rec.ok, durationMs: rec.durationMs, nodes, events: evs.length });
+                    }
+                }
+                finally {
+                    await act.streamStop(client).catch(() => null);
+                }
+                const agg = aggregateTiming(samples);
+                if (!agg.successful) {
+                    return fail('TIMING_RUN', runs + ' 次采样全部未成功——没有可用于建议的成功样本', undefined, EXIT.FINDINGS);
+                }
+                const unsettled = agg.nodeStats.filter((n) => n.nextBeforeStable);
+                const last = samples.at(-1);
+                const human = [
+                    ...describeSession(s),
+                    'timing 采样 x' + runs + '（' + agg.successful + ' 成功' + (agg.failed ? ' / ' + agg.failed + ' 失败' : '') + '）：',
+                    ...samples.map((smp) => '  #' + smp.index + ' ' + (smp.ok ? '成功' : '失败（不计入建议）') + '  ' + smp.durationMs + 'ms  ' + smp.nodes.length + ' 节点'),
+                    '节点时长分布（成功样本，P50 / P95）：',
+                    ...agg.nodeStats.map((n) => '  [' + n.status + '] ' + n.name + '  ' + n.msP50 + ' / ' + n.msP95 + 'ms' +
+                        (n.settleP50 !== null ? '  稳定 +' + n.settleP50 + ' / +' + n.settleP95 + 'ms' : '') +
+                        (n.occurrences > n.runs ? '  （重复执行 ' + n.occurrences + ' 次 / ' + n.runs + ' run——重试或 Next 环）' : '') +
+                        (n.runs < agg.successful ? '  （' + n.runs + '/' + agg.successful + ' run 出现——分支或跳过）' : '') +
+                        (n.nextBeforeStable ? '  （下一节点先于画面稳定开始——识别窗口紧或连续动画）' : '')),
+                    '建议（P95 × 余量，n=' + agg.successful + ' 成功采样；界面切换优先用 next 等待节点表达，delay 尽量保持缺省）：',
+                    '  节点 timeout ≥ ' + agg.suggest.nodeTimeoutMs + 'ms（各 run 最长节点 P95 ' + agg.maxNodeP95 + 'ms × 1.5）',
+                    '  任务 timeout ≥ ' + agg.suggest.taskTimeoutMs + 'ms（任务时长 P95 ' + agg.durationP95 + 'ms × 2）',
+                    agg.suggest.postDelayMs !== null
+                        ? '  动作后稳定参考 ' + agg.suggest.postDelayMs + 'ms（各 run 最长稳定 P95 ' + agg.maxSettleP95 + 'ms × 1.2）——优先由 next 等待节点的 timeout 覆盖该时长；确需兜底用 post_wait_freezes，post_delay 是最后手段'
+                        : '  动作后稳定时间：无 stable 事件可参考（画面持续变化或流太短）',
+                ];
+                if (agg.failed)
+                    human.push('  注意：' + agg.failed + ' 个失败 run 未计入建议；失败原因与时长见 data.runs');
+                if (unsettled.length) {
+                    human.push('  注意：' + unsettled.map((n) => n.name).join(' , ') + ' 未等画面稳定就进入下一节点');
+                }
+                return {
+                    exitCode: EXIT.OK,
+                    human,
+                    data: {
+                        runs: samples, distribution: agg, suggest: agg.suggest,
+                        /* 兼容字段：单次消费方读 record / nodes 的形状不变 */
+                        record: { ok: last.ok, durationMs: last.durationMs, nodes: last.nodes },
+                        nodes: last.nodes,
+                        sampledEvents: samples.reduce((a, smp) => a + smp.events, 0),
+                    },
+                    warnings: [
+                        ...(agg.failed ? [agg.failed + ' 个失败 run 未计入建议'] : []),
+                        ...samples.filter((smp) => !smp.ok).map((smp) => 'run #' + smp.index + ' 未成功——该样本已排除'),
+                        ...(unsettled.length ? [unsettled.length + ' 个节点未等画面稳定即进入下一节点：' + unsettled.map((n) => n.name).join(' , ')] : []),
+                        ...(runs === 1 ? ['单次采样=下界：加 --runs 3-5 取分布再定稿'] : []),
+                    ],
+                };
+            });
+        }
+        catch (e) {
+            return daemonFail(e);
+        }
+    },
+};
+export const TIMING_COMMANDS = [timingCommand];
+//# sourceMappingURL=timing.js.map

package/lib/commands/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/commands/timing.ts"],"names":[],"mappings":"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"}

package/lib/commands/version.js

@@ -0,0 +1,66 @@
+/** `maafw-live version` —— CLI 与运行环境版本。技能用它做版本对齐；`--check` 对 registry 查有没有新版。 */
+import { EXIT, fail } from '../protocol.js';
+import { cliPackage } from '../pkg.js';
+import { compareVersions, fetchLatest, readState, shouldCheck, updateCheckDisabled, writeState, } from '../update-check.js';
+export const versionCommand = {
+    name: 'version',
+    summary: '打印 maafw-live CLI 及依赖的版本；--check 顺带对 registry 查有没有新版',
+    usage: 'maafw-live version [--check]',
+    options: { check: { type: 'boolean' } },
+    async run(ctx) {
+        const pkg = cliPackage();
+        const human = [
+            `${pkg.name} ${pkg.version}`,
+            // 装的是带 scope 的包名，敲的是裸名——同一个词的两种形态，这里显式给出敲的那个
+            `  command    maafw-live`,
+            `  node       ${process.version}`,
+            `  platform   ${process.platform} ${process.arch}`,
+        ];
+        const data = {
+            name: pkg.name,
+            version: pkg.version,
+            node: process.version,
+            platform: process.platform,
+            arch: process.arch,
+        };
+        const explicit = ctx.values.check === true;
+        /* 显式请求：不受 TTY/限频约束，查不到要如实说。自动路径：只在交互终端、限频、失败静默。 */
+        const auto = !explicit && !updateCheckDisabled() && process.stdout.isTTY === true;
+        if (explicit || auto) {
+            let latest = auto ? readState()?.latest ?? null : null;
+            let fresh = false;
+            const cached = readState();
+            if (explicit || shouldCheck(cached, Date.now())) {
+                const fetched = await fetchLatest(pkg.name);
+                if (fetched) {
+                    latest = fetched;
+                    writeState({ checkedAt: Date.now(), latest: fetched });
+                    fresh = true;
+                }
+                else if (explicit) {
+                    return fail('UPDATE_CHECK_FAILED', '查询 registry 失败（离线 / 代理 / registry 抖动）', '加 --check 才需要联网；不带它 version 完全离线可用', EXIT.ENV);
+                }
+            }
+            else if (cached) {
+                latest = cached.latest;
+            }
+            if (latest) {
+                const cmp = compareVersions(latest, pkg.version);
+                data.latest = latest;
+                data.updateAvailable = cmp > 0;
+                data.source = fresh ? 'registry' : 'cache';
+                if (cmp > 0) {
+                    human.push(`  新版       ${latest}（当前 ${pkg.version}）`, `  升级       npm install --global ${pkg.name}@latest`);
+                    /* 自动提示不改退出码：版本旧不是"这次调用发现的问题" */
+                    return { exitCode: explicit ? EXIT.FINDINGS : EXIT.OK, human, data };
+                }
+                human.push(`  最新       ${latest}（已是最新）`);
+            }
+            else if (explicit) {
+                human.push('  最新       查询不到（registry 不可达）');
+            }
+        }
+        return { exitCode: EXIT.OK, human, data };
+    },
+};
+//# sourceMappingURL=version.js.map

package/lib/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"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"}