oh-my-knowledge 0.33.0 → 0.35.0

package/dist/cli/commands/install.js

@@ -0,0 +1,436 @@
+import { copyFileSync, cpSync, existsSync, mkdirSync, realpathSync, rmSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, dirname, resolve, join, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Args, Flags } from '@oclif/core';
+import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
+import { BaseCommand } from '../oclif/base-command.js';
+import { tCli } from '../lib/i18n.js';
+import { resolveInstallSource, resolveRemoteGitSource, SourceResolveError } from '../../inputs/source-resolver.js';
+import { buildManagedArtifactRecord, hashArtifactSource, distributableCopyFilter, managedDir, recordManagedArtifact } from '../../managed/index.js';
+const BUILTIN_OMK_AGENT_SKILL_ID = 'omk-agent-skill';
+const INSTALLABLE_KINDS = ['skill', 'prompt', 'agent', 'workflow'];
+const TARGET_ORDER = ['codex', 'claude'];
+const TARGET_SPECS = {
+    codex: {
+        label: 'Codex/AGENTS',
+        skillsDir: (home) => join(home, '.agents', 'skills'),
+        detectDirs: (home) => [join(home, '.agents'), join(home, '.codex')],
+    },
+    claude: {
+        label: 'Claude Code',
+        skillsDir: (home) => join(home, '.claude', 'skills'),
+        detectDirs: (home) => [join(home, '.claude')],
+    },
+};
+function packagedOmkAgentSkillDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, '..', '..', 'assets', 'agent-skills', 'omk');
+}
+function knownTarget(target) {
+    const home = homedir();
+    const spec = TARGET_SPECS[target];
+    return { label: spec.label, skillsDir: spec.skillsDir(home) };
+}
+function directoryExists(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function parseTargets(raw, lang) {
+    const parts = [...new Set(raw.split(',').map((part) => part.trim()).filter(Boolean))];
+    if (parts.length === 0)
+        return autoTargets();
+    if (parts.includes('auto')) {
+        if (parts.length > 1)
+            throw new Error(tCli('cli.install.invalid_target_combo', lang, { target: raw }));
+        return autoTargets();
+    }
+    if (parts.includes('all')) {
+        if (parts.length > 1)
+            throw new Error(tCli('cli.install.invalid_target_combo', lang, { target: raw }));
+        return TARGET_ORDER;
+    }
+    const out = [];
+    for (const part of parts) {
+        if (part !== 'codex' && part !== 'claude') {
+            throw new Error(tCli('cli.install.unknown_target', lang, { target: part }));
+        }
+        out.push(part);
+    }
+    return out;
+}
+function autoTargets() {
+    const home = homedir();
+    return TARGET_ORDER.filter((target) => TARGET_SPECS[target].detectDirs(home).some(directoryExists));
+}
+function resolveInstallTargets(params) {
+    if (params.dest) {
+        return [{ label: 'custom', skillsDir: resolve(params.dest) }];
+    }
+    const targets = parseTargets(params.to, params.lang);
+    if (targets.length === 0) {
+        throw new Error(tCli('cli.install.no_detected_targets', params.lang));
+    }
+    const seen = new Set();
+    return targets
+        .map(knownTarget)
+        .filter((target) => {
+        const key = resolve(target.skillsDir);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/** 目标落点:目录-skill → {skillsDir}/{name};文件-skill → {skillsDir}/{name}.md。 */
+function targetArtifactPath(target, name, isDirectorySkill) {
+    return isDirectorySkill ? join(target.skillsDir, name) : join(target.skillsDir, `${name}.md`);
+}
+/** 内置 omk Agent Skill 固定落到 {skillsDir}/omk(目录-skill)。 */
+function targetSkillDir(target) {
+    return targetArtifactPath(target, 'omk', true);
+}
+/** 全部目标预检通过才拷任何一个(无部分安装)。源就是目标(就地接管)的目标跳过存在性检查。 */
+function validateInstallTargets(params) {
+    if (params.dryRun || params.force)
+        return;
+    for (const targetPath of params.targetPaths) {
+        if (params.source && classifyPaths(params.source, targetPath) === 'same')
+            continue;
+        if (existsSync(targetPath)) {
+            throw new Error(tCli('cli.install.target_exists', params.lang, { path: targetPath }));
+        }
+    }
+}
+/** 解析路径的物理形态:对存在的最长前缀做 realpath、余下保持字面,使尚不存在的目标也能比较。 */
+function realPathBestEffort(p) {
+    let cur = resolve(p);
+    const tail = [];
+    while (!existsSync(cur)) {
+        tail.unshift(basename(cur));
+        const parent = dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    const base = existsSync(cur) ? realpathSync(cur) : cur;
+    return tail.length ? join(base, ...tail) : base;
+}
+/**
+ * 源与目标的物理关系(解析软链):
+ *   - same:同一节点 → 就地接管(绝不删/拷);
+ *   - overlap:一个是另一个的祖先 → rmSync(target) 会删掉源、或 cpSync 把目录拷进自身子目录,数据损坏,必须拒;
+ *   - disjoint:正常拷贝。
+ */
+function classifyPaths(source, targetPath) {
+    const rs = realPathBestEffort(source);
+    const rt = realPathBestEffort(targetPath);
+    if (rs === rt)
+        return 'same';
+    if (rs.startsWith(rt + sep) || rt.startsWith(rs + sep))
+        return 'overlap';
+    return 'disjoint';
+}
+/**
+ * 通用拷贝:目录递归 cp(过滤 .omk / .git / evolve 等非分发产物 + 软链)、单文件 copyFile。
+ * 不打印——由调用方决定文案。dry-run 不写。源即目标 → 就地接管(inPlace);源与目标互为祖先 → 拒绝(防自毁)。
+ */
+function copyArtifactToTarget(params) {
+    if (!existsSync(params.source)) {
+        throw new Error(tCli('cli.install.asset_missing', params.lang, { path: params.source }));
+    }
+    if (params.dryRun) {
+        return { targetPath: params.targetPath, planned: true, inPlace: false };
+    }
+    const relation = classifyPaths(params.source, params.targetPath);
+    // 就地接管:源就是目标(接管已安装的 skill),绝不 rmSync 源。
+    if (relation === 'same') {
+        return { targetPath: params.targetPath, planned: false, inPlace: true };
+    }
+    // 互为祖先:删除目标会删掉源、或自拷进子目录 —— 数据损坏,直接拒,哪怕带 --force。
+    if (relation === 'overlap') {
+        throw new Error(tCli('cli.install.target_overlaps_source', params.lang, { source: params.source, target: params.targetPath }));
+    }
+    if (existsSync(params.targetPath) && !params.force) {
+        throw new Error(tCli('cli.install.target_exists', params.lang, { path: params.targetPath }));
+    }
+    mkdirSync(params.skillsDir, { recursive: true });
+    rmSync(params.targetPath, { recursive: true, force: true });
+    if (params.isDirectorySkill) {
+        cpSync(params.source, params.targetPath, {
+            recursive: true,
+            // 与 hashArtifactSource / eval 隔离副本共用同一处过滤(distributableCopyFilter),保证
+            // "分发出去的 == 算进 hash 的 == 测量的副本":源根永远拷;软链跳过;evolve 仅源根第一层排除、
+            // .omk/.git/node_modules 任意层级排除。
+            filter: distributableCopyFilter(params.source),
+        });
+    }
+    else {
+        copyFileSync(params.source, params.targetPath);
+    }
+    return { targetPath: params.targetPath, planned: false, inPlace: false };
+}
+function installOmkAgentSkill(params) {
+    const targetDir = targetSkillDir(params.target);
+    const { planned } = copyArtifactToTarget({
+        source: params.sourceDir,
+        isDirectorySkill: true,
+        targetPath: targetDir,
+        skillsDir: params.target.skillsDir,
+        force: params.force,
+        dryRun: params.dryRun,
+        lang: params.lang,
+    });
+    console.log(tCli(planned ? 'cli.install.plan' : 'cli.install.installed', params.lang, { path: targetDir }));
+    return targetDir;
+}
+/**
+ * 是否当作用户 artifact 路径(否则按 typo 的内置 id 处理,报 unknown_input)。
+ *   - 显式路径意图(含 `/`)或 `.md` 结尾 → 是(后续 installManagedSkill 经 resolver 给出精确的存在性 / SKILL.md 报错);
+ *   - 裸短名 → 仅当它确实解析到一个含 SKILL.md 的目录才算;裸的同名普通文件(如 cwd 里恰好有个
+ *     `omk-agnt-skill` 文件)不该被当成 skill 安装,落回 unknown_input。
+ */
+function looksLikeArtifactPath(input) {
+    if (input.includes('/') || /\.md$/i.test(input))
+        return true;
+    try {
+        const abs = resolve(input);
+        return statSync(abs).isDirectory() && existsSync(join(abs, 'SKILL.md'));
+    }
+    catch {
+        return false;
+    }
+}
+export default class Install extends BaseCommand {
+    static description = bilingual({
+        zh: '安装 omk 官方 Agent Skill，或登记并分发用户自己的 skill（内置 id omk-agent-skill，本地路径，或 git:<ref>:<name> 取当前仓库某个 ref 的 skill）。默认写入本机已检测 agent 目标；安装用户 skill 时同时登记一条受管记录。',
+        en: 'Install the official omk Agent Skill, or register and distribute your own skill (built-in id omk-agent-skill, a local path, or git:<ref>:<name> for a skill at a ref of the current repo). Defaults to detected local agent targets; installing a user skill also records a managed entry.',
+    });
+    static examples = [
+        {
+            description: bilingual({
+                zh: '安装 omk 官方 Agent Skill 到默认本机目标',
+                en: 'Install the official omk Agent Skill into default local targets',
+            }),
+            command: '<%= config.bin %> install omk-agent-skill',
+        },
+        {
+            description: bilingual({
+                zh: '强制安装到当前 omk 已知的所有目标',
+                en: 'Install into every target currently known to omk',
+            }),
+            command: '<%= config.bin %> install omk-agent-skill --to all',
+        },
+        {
+            description: bilingual({
+                zh: '安装到自定义 skill 根目录',
+                en: 'Install into a custom skill root',
+            }),
+            command: '<%= config.bin %> install omk-agent-skill --dest ~/.my-agent/skills',
+        },
+        {
+            description: bilingual({
+                zh: '登记并分发用户自己的 skill（--kind 可省，命中 SKILL.md 自动推导）',
+                en: 'Register and distribute your own skill (--kind optional; inferred from SKILL.md)',
+            }),
+            command: '<%= config.bin %> install ./skills/review',
+        },
+        {
+            description: bilingual({
+                zh: '从当前仓库某个 ref 安装 skill（可复现；SHA 不可变、分支会随 ref 漂移）',
+                en: 'Install a skill from a ref of the current repo (reproducible; a SHA is immutable, a branch drifts with the ref)',
+            }),
+            command: '<%= config.bin %> install git:main:skills/review',
+        },
+        {
+            description: bilingual({
+                zh: '从远端 git 仓库安装 skill（位置参数是仓库内路径；认证用本机 git 凭证；记录钉实际 SHA）',
+                en: 'Install a skill from a remote git repo (positional arg is the in-repo path; auth via local git credentials; record pins the actual SHA)',
+            }),
+            command: '<%= config.bin %> install --git-url https://github.com/org/repo.git --git-ref v1.0.0 skills/review',
+        },
+    ];
+    static args = {
+        input: Args.string({
+            description: bilingual({
+                zh: '要安装的知识输入：内置 id omk-agent-skill，本地 skill 路径（目录或 .md），或 git:<ref>:<name>（当前仓库某 ref 的 skill）。',
+                en: 'Knowledge input to install: built-in id omk-agent-skill, a local skill path (directory or .md), or git:<ref>:<name> (a skill at a ref of the current repo).',
+            }),
+            required: true,
+        }),
+    };
+    static flags = {
+        lang: LANG_FLAG,
+        kind: Flags.string({
+            description: bilingual({
+                zh: '用户 artifact 的 kind（对齐 Artifact.kind）。可省：命中 SKILL.md 自动推导，当前仅支持 skill。',
+                en: 'Kind of the user artifact (aligns with Artifact.kind). Optional: inferred from SKILL.md; only skill is supported today.',
+            }),
+            options: INSTALLABLE_KINDS,
+        }),
+        to: Flags.string({
+            description: bilingual({
+                zh: '安装目标：auto（默认，本机已检测目标） / codex / claude / all。',
+                en: 'Install target: auto (default, detected local targets) / codex / claude / all.',
+            }),
+            default: 'auto',
+        }),
+        dest: Flags.string({
+            description: bilingual({
+                zh: '自定义 skill 根目录；skill 安装到 <dir>/<name>（内置 omk-agent-skill 为 <dir>/omk）。',
+                en: 'Custom skill root; a skill installs into <dir>/<name> (the built-in omk-agent-skill into <dir>/omk).',
+            }),
+        }),
+        force: Flags.boolean({
+            description: bilingual({
+                zh: '覆盖目标位置已存在的 skill。',
+                en: 'Overwrite an existing skill at the target location.',
+            }),
+            default: false,
+        }),
+        'dry-run': Flags.boolean({
+            description: bilingual({
+                zh: '只打印安装目标，不写文件。',
+                en: 'Print install targets without writing files.',
+            }),
+            default: false,
+        }),
+        'git-url': Flags.string({
+            description: bilingual({
+                zh: '远端 git 仓库 URL（https / ssh / git@host:path）。给了它时，位置参数当作仓库内 skill 路径（spec）。',
+                en: 'Remote git repository URL (https / ssh / git@host:path). When set, the positional arg is the in-repo skill path (spec).',
+            }),
+        }),
+        'git-ref': Flags.string({
+            description: bilingual({
+                zh: '远端 git 的 ref（分支 / tag / SHA），默认 HEAD。仅配合 --git-url 使用。',
+                en: 'Remote git ref (branch / tag / SHA), default HEAD. Only with --git-url.',
+            }),
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Install);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            // --git-ref 必须配 --git-url(否则静默丢弃、误把 spec 当本地路径解析,报错令人困惑)。
+            if (flags['git-ref'] && !flags['git-url']) {
+                throw new Error(tCli('cli.install.git_ref_needs_url', lang));
+            }
+            // 远端 git:--git-url 在场时,位置参数是仓库内 spec(repo 相对路径),先于其它分支判定。
+            if (flags['git-url']) {
+                this.installManagedSkill(args.input, flags.kind, flags, lang, {
+                    url: flags['git-url'],
+                    ref: flags['git-ref'] || 'HEAD',
+                });
+                return;
+            }
+            if (args.input === BUILTIN_OMK_AGENT_SKILL_ID) {
+                this.installBuiltinAgentSkill(flags, lang);
+                return;
+            }
+            if (args.input.startsWith('git:') || looksLikeArtifactPath(args.input)) {
+                this.installManagedSkill(args.input, flags.kind, flags, lang);
+                return;
+            }
+            throw new Error(tCli('cli.install.unknown_input', lang, { input: args.input }));
+        });
+    }
+    installBuiltinAgentSkill(flags, lang) {
+        const sourceDir = packagedOmkAgentSkillDir();
+        const targets = resolveInstallTargets({ to: flags.to, dest: flags.dest, lang });
+        validateInstallTargets({
+            targetPaths: targets.map(targetSkillDir),
+            force: flags.force,
+            dryRun: flags['dry-run'],
+            lang,
+        });
+        for (const target of targets) {
+            installOmkAgentSkill({ sourceDir, target, force: flags.force, dryRun: flags['dry-run'], lang });
+        }
+        if (!flags['dry-run'])
+            console.log(tCli('cli.install.next_hint', lang));
+    }
+    installManagedSkill(input, kindFlag, flags, lang, remote) {
+        // kind 推导:--kind 显式优先;否则缺省 skill(Phase 1 仅 skill)。
+        const kind = kindFlag ?? 'skill';
+        if (kind !== 'skill') {
+            throw new Error(tCli('cli.install.kind_unsupported', lang, { kind }));
+        }
+        // 源解析委托给 source-resolver(file / 本地 git / 远端 git),install 主干源无关。
+        // 远端走结构化 resolveRemoteGitSource(url/ref/spec 分字段,URL 不经任何字符串切分);
+        // resolver 不依赖 CLI,错误以 SourceResolveError(messageKey) 抛出,这里映射成本地化文案。
+        let src;
+        try {
+            src = remote ? resolveRemoteGitSource(remote.url, remote.ref, input) : resolveInstallSource(input);
+        }
+        catch (err) {
+            if (err instanceof SourceResolveError) {
+                throw new Error(tCli(err.messageKey, lang, err.params));
+            }
+            throw err;
+        }
+        try {
+            const { localRoot, name, isDirectorySkill, sourceKind, locator, ref, url } = src;
+            // 目录-skill 哈整棵可分发树(排除 .omk/.git/evolve);git 源哈的是物化后的临时树。
+            const contentHash = hashArtifactSource(localRoot, isDirectorySkill);
+            const targets = resolveInstallTargets({ to: flags.to, dest: flags.dest, lang });
+            validateInstallTargets({
+                targetPaths: targets.map((t) => targetArtifactPath(t, name, isDirectorySkill)),
+                force: flags.force,
+                dryRun: flags['dry-run'],
+                lang,
+                source: localRoot,
+            });
+            const now = new Date().toISOString();
+            const distribution = [];
+            const dir = managedDir();
+            // 即便多目标中途失败,也把已成功分发的落点登记进记录,保持"磁盘 == 记录"一致;
+            // 重跑 --force 时 upsert 会按 path 去重并补齐其余目标。
+            const writeRecordIfAny = () => {
+                if (flags['dry-run'] || distribution.length === 0)
+                    return;
+                const record = buildManagedArtifactRecord({
+                    name,
+                    kind,
+                    source: { sourceKind, locator, ...(ref ? { ref } : {}), ...(url ? { url } : {}), isDirectorySkill },
+                    contentHash,
+                    installedAt: now,
+                    distribution,
+                });
+                recordManagedArtifact(record, { dir });
+                console.log(tCli('cli.install.registered', lang, { id: record.id, store: dir }));
+            };
+            try {
+                for (const target of targets) {
+                    const targetPath = targetArtifactPath(target, name, isDirectorySkill);
+                    const { planned, inPlace } = copyArtifactToTarget({
+                        source: localRoot,
+                        isDirectorySkill,
+                        targetPath,
+                        skillsDir: target.skillsDir,
+                        force: flags.force,
+                        dryRun: flags['dry-run'],
+                        lang,
+                    });
+                    if (planned) {
+                        console.log(tCli('cli.install.plan_skill', lang, { name, path: targetPath }));
+                    }
+                    else {
+                        console.log(tCli(inPlace ? 'cli.install.adopted' : 'cli.install.copied', lang, { name, path: targetPath }));
+                        distribution.push({ label: target.label, path: targetPath, contentHash, copiedAt: now });
+                    }
+                }
+            }
+            finally {
+                writeRecordIfAny();
+            }
+        }
+        finally {
+            src.cleanup(); // git 删临时物化目录;file noop
+        }
+    }
+}

package/dist/cli/commands/observe/inbox.d.ts

@@ -20,4 +20,3 @@ export default class ObserveInbox extends BaseCommand {
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=inbox.d.ts.map

package/dist/cli/commands/observe/inbox.js

@@ -257,4 +257,3 @@ export default class ObserveInbox extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=inbox.js.map

package/dist/cli/commands/observe/index.d.ts

@@ -19,4 +19,3 @@ export default class Observe extends BaseCommand {
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/observe/index.js

@@ -119,4 +119,3 @@ export default class Observe extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=index.js.map

package/dist/cli/commands/observe/ingest.d.ts

@@ -10,4 +10,3 @@ export default class ObserveIngest extends BaseCommand {
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=ingest.d.ts.map

package/dist/cli/commands/observe/ingest.js

@@ -68,4 +68,3 @@ export default class ObserveIngest extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=ingest.js.map

package/dist/cli/commands/observe/show.d.ts

@@ -10,4 +10,3 @@ export default class ObserveShow extends BaseCommand {
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=show.d.ts.map

package/dist/cli/commands/observe/show.js

@@ -46,4 +46,3 @@ export default class ObserveShow extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=show.js.map

package/dist/cli/commands/sample.d.ts

@@ -6,7 +6,7 @@ export declare function collectSampleDesignFailureIds(report: Pick<Report, 'resu
 export declare function assertFixReportMatchesCurrentInputs(params: {
     report: Pick<Report, 'meta'>;
     treatmentName: string;
-    skillContent: string;
+    currentContentHash: string;
     samples: SampleType[];
     sampleIds: Set<string>;
     lang?: CliLang;
@@ -37,4 +37,3 @@ export default class Sample extends BaseCommand {
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=sample.d.ts.map

package/dist/cli/commands/sample.js

@@ -9,7 +9,8 @@ import { CliExit } from '../lib/cli-exit.js';
 import { tCli } from '../lib/i18n.js';
 import { DEFAULT_REPORTS_DIR } from '../lib/parse-run-config.js';
 import { loadSamples, parseYaml } from '../../inputs/load-samples.js';
-import { hashSample, hashString } from '../../eval-core/evaluation-reporting.js';
+import { hashSample } from '../../eval-core/evaluation-reporting.js';
+import { hashArtifactSource } from '../../inputs/content-hash.js';
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -48,20 +49,29 @@ export function collectSampleDesignFailureIds(report, treatmentName) {
     return ids;
 }
 export function assertFixReportMatchesCurrentInputs(params) {
-    const { report, treatmentName, skillContent, samples, sampleIds } = params;
+    const { report, treatmentName, currentContentHash, samples, sampleIds } = params;
     const lang = params.lang ?? 'zh';
     const issues = [];
-    const expectedSkillHash = report.meta.artifactHashes?.[treatmentName];
-    const currentSkillHash = hashString(skillContent);
-    if (!expectedSkillHash) {
+    // schemaVersion < 2 的报告:artifactHashes 是旧「仅 SKILL.md 正文文本」哈,与当前「整棵可分发树」哈
+    // 不同空间,直接比对会必然误报不一致。识别后给可见提示(归入 issues → 触发「请先重跑 eval」),
+    // 不拿旧文本哈与当前树哈错配比对。sample 指纹口径未变,下面照常校。
+    if ((report.meta.schemaVersion ?? 0) < 2) {
         issues.push(lang === 'zh'
-            ? `报告缺少 ${treatmentName} 的 skill 指纹，无法确认诊断对应当前 SKILL.md。`
-            : `Report is missing the skill hash for ${treatmentName}; cannot verify it matches the current SKILL.md.`);
+            ? `报告早于树哈纪元（skill 指纹口径已从「仅 SKILL.md 文本」改为「整棵可分发树」），无法与当前指纹比对。`
+            : `Report predates the tree-hash era (skill fingerprint changed from SKILL.md-body-text to whole-tree); cannot compare against the current fingerprint.`);
     }
-    else if (expectedSkillHash !== currentSkillHash) {
-        issues.push(lang === 'zh'
-            ? `skill 指纹不一致：报告 ${expectedSkillHash}，当前 ${currentSkillHash}。`
-            : `Skill hash mismatch: report ${expectedSkillHash}, current ${currentSkillHash}.`);
+    else {
+        const expectedSkillHash = report.meta.artifactHashes?.[treatmentName];
+        if (!expectedSkillHash) {
+            issues.push(lang === 'zh'
+                ? `报告缺少 ${treatmentName} 的 skill 指纹，无法确认诊断对应当前 SKILL.md。`
+                : `Report is missing the skill hash for ${treatmentName}; cannot verify it matches the current SKILL.md.`);
+        }
+        else if (expectedSkillHash !== currentContentHash) {
+            issues.push(lang === 'zh'
+                ? `skill 指纹不一致：报告 ${expectedSkillHash}，当前 ${currentContentHash}。`
+                : `Skill hash mismatch: report ${expectedSkillHash}, current ${currentContentHash}.`);
+        }
     }
     const reportSampleHashes = report.meta.sampleHashes;
     if (!reportSampleHashes) {
@@ -196,11 +206,14 @@ async function runSampleFix(args, flags, lang) {
         process.stderr.write(lang === 'zh' ? '✅ 没有 sample_design 类型的失败，无需修复\n' : '✅ No sample_design failures found, nothing to fix\n');
         return;
     }
+    // 当前内容指纹走整树哈,与 eval 报告口径一致:dir-skill(用户传 .../SKILL.md)哈整棵 skill 目录、
+    // 单文件 .md 哈单文件字节。
+    const currentContentHash = hashArtifactSource(isDir ? skillDir : resolvedSkillPath, isDir);
     try {
         assertFixReportMatchesCurrentInputs({
             report,
             treatmentName,
-            skillContent,
+            currentContentHash,
             samples,
             sampleIds: sampleDesignIds,
             lang,
@@ -456,7 +469,7 @@ export default class Sample extends BaseCommand {
     static examples = [
         {
             description: bilingual({
-                zh: '为单个 skill 生成默认数量的样本',
+                zh: '为单个 skill 生成默认数量的用例',
                 en: 'Generate default-count samples for a single skill',
             }),
             command: '<%= config.bin %> sample skills/my-skill/SKILL.md',
@@ -503,7 +516,7 @@ export default class Sample extends BaseCommand {
         }),
         count: Flags.string({
             description: bilingual({
-                zh: '生成样本条数。不传由 LLM 按 skill 类型自动决定。',
+                zh: '生成用例条数。不传由 LLM 按 skill 类型自动决定。',
                 en: 'Number of samples to generate. Defaults to LLM auto-selection by skill type.',
             }),
             parse: integerStringParser('--count', { min: 1 }),
@@ -576,4 +589,3 @@ export default class Sample extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=sample.js.map

package/dist/cli/commands/studio.d.ts

@@ -20,4 +20,3 @@ export default class Studio extends BaseCommand {
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=studio.d.ts.map

package/dist/cli/commands/studio.js

@@ -155,4 +155,3 @@ export default class Studio extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=studio.js.map

package/dist/cli/index.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { getCliLang, parseLangFromArgv } from './lib/i18n.js';
-import { checkUpdate } from './lib/update-check.js';
 import { CliExit } from './lib/cli-exit.js';
 // CLI 入口:lang / 版本提醒等共享前置逻辑跑完,把控制权交给 oclif dispatcher。
 // 所有命令统一走 src/cli/commands/* 下的 oclif Command。
@@ -14,6 +13,7 @@ function isShortPath(argv) {
 async function main() {
     const lang = getCliLang(parseLangFromArgv(process.argv));
     if (!isShortPath(process.argv)) {
+        const { checkUpdate } = await import('./lib/update-check.js');
         checkUpdate(lang);
     }
     const { runOclifPath } = await import('./oclif/run.js');
@@ -26,4 +26,3 @@ main().catch((err) => {
     console.error(err);
     process.exit(1);
 });
-//# sourceMappingURL=index.js.map

package/dist/cli/lib/cli-exit.d.ts

@@ -13,4 +13,3 @@ export declare class CliExit extends Error {
     readonly code: number;
     constructor(code: number);
 }
-//# sourceMappingURL=cli-exit.d.ts.map

package/dist/cli/lib/cli-exit.js

@@ -17,4 +17,3 @@ export class CliExit extends Error {
         this.name = 'CliExit';
     }
 }
-//# sourceMappingURL=cli-exit.js.map

package/dist/cli/lib/cmd-flags.d.ts

@@ -108,6 +108,7 @@ export interface EvalFlags {
     'trivial-diff'?: string;
     'report-only'?: boolean;
     'no-gate'?: boolean;
+    'no-evidence'?: boolean;
 }
 export interface EvolveArgs {
     skillPath: string;
@@ -133,6 +134,12 @@ export interface EvolveFlags {
     'reuse-latest-eval': boolean;
     'improve-mode': string;
     'holdout-ratio': string;
+    'no-significance-gate': boolean;
+    'significance-alpha': string;
+    'test-ratio': string;
+    'edit-budget': string;
+    'no-edit-budget': boolean;
+    'no-reject-memory': boolean;
 }
 export interface SampleArgs {
     skillPath?: string;
@@ -226,4 +233,3 @@ export interface StudioFlags {
     'no-open': boolean;
     dev: boolean;
 }
-//# sourceMappingURL=cmd-flags.d.ts.map