oh-my-knowledge 1.0.0-beta.11 → 1.0.0-beta.13

package/dist/cli/commands/agents.js

@@ -0,0 +1,216 @@
+import { existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../oclif/base-command.js';
+import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
+import { shellQuoteArg } from '../../shared/shell-quote.js';
+import { UserSettingsStore } from '../../evidence/storage/user-settings.js';
+import { globalLayout } from '../../evidence/storage/layout.js';
+const description = (zh, en) => bilingual({ zh, en });
+function formatEntryLine(entry, lang) {
+    const roots = entry.logRoots.map((root) => {
+        const suffix = lang === 'zh'
+            ? `${root.traceSourceKind}：发现 ${root.discoveredCount} · 新增 ${root.collectedCount} · 跳过 ${root.skippedCount}`
+            : `${root.traceSourceKind}: ${root.discoveredCount} found · ${root.collectedCount} new · ${root.skippedCount} skipped`;
+        return root.failedCount > 0 ? `${suffix}${lang === 'zh' ? ` · 失败 ${root.failedCount}` : ` · ${root.failedCount} failed`}` : suffix;
+    }).join(' / ');
+    return lang === 'zh'
+        ? `  ${entry.displayName}：${entry.logRoots.length} 个日志根 · ${roots}`
+        : `  ${entry.displayName}: ${entry.logRoots.length} log roots · ${roots}`;
+}
+export default class AgentsCommand extends BaseCommand {
+    static description = description('识别本机已安装的 Agent，采集其日志并映射成统一格式，再提炼候选知识。', 'Detect installed agents, collect their logs into the unified trace format, and extract candidate knowledge.');
+    static args = {
+        operation: Args.string({
+            required: true,
+            options: ['list', 'collect', 'extract'],
+            description: description('操作：list 识别安装情况，collect 采集日志并映射成统一 Trace IR，extract 从已采集日志提炼候选知识。', 'list: inspect installs. collect: gather logs into normalized Trace IR. extract: draft candidate knowledge from collected logs.'),
+        }),
+    };
+    static flags = {
+        lang: LANG_FLAG,
+        dir: Flags.string({
+            description: description('清单与采集产物目录，默认全局 ~/.oh-my-knowledge/observe/agents。', 'Inventory and collection dir; defaults to the global ~/.oh-my-knowledge/observe/agents.'),
+        }),
+        limit: Flags.integer({
+            min: 1,
+            description: description('collect 单轮处理的会话文件上限。', 'Per-run session file cap for collect.'),
+        }),
+        session: Flags.string({
+            description: description('extract：采集报告里的 runId。', 'extract: a runId from the collection report.'),
+        }),
+        knowledge: Flags.string({
+            description: description('extract：知识工作区，默认全局知识目录。', 'extract: knowledge workspace; defaults to the global knowledge dir.'),
+        }),
+        executor: Flags.string({
+            description: description('extract：生成执行器，沿用 OMK 运行配置。', 'extract: generation executor, using OMK runtime configuration.'),
+        }),
+        model: Flags.string({
+            description: description('extract：生成模型，沿用已配置模型。', 'extract: generation model, using the configured model.'),
+        }),
+        json: Flags.boolean({
+            default: false,
+            description: description('输出完整 JSON；默认输出可读摘要。', 'Print complete JSON instead of a readable summary.'),
+        }),
+    };
+    static examples = [
+        '<%= config.bin %> agents list',
+        '<%= config.bin %> agents collect --limit 50',
+        '<%= config.bin %> agents extract --session <runId> --executor codex --model <model>',
+    ];
+    async run() {
+        const { args, flags } = await this.parse(AgentsCommand);
+        const lang = this.lang;
+        const { agentStorageLayout: layoutOf, AgentCollectionReportOutdatedError, collectAgentLogs, detectAgentInventory, loadAgentCollectionReport, LocalAgentCatalogError, resolveAgentCatalog, saveAgentCollectionReport, saveAgentInventoryReport, } = await import('../../observability/agents/index.js');
+        const layout = layoutOf(flags.dir ?? globalLayout().observeAgentsDir);
+        // 登记表是内置表与本机扩展文件的合并结果；扩展文件读不动时按业务失败处理，
+        // 因为拿半份表探测会让清单静默少一个宿主，比直接报错更难发现。
+        const readCatalog = () => {
+            try {
+                return resolveAgentCatalog();
+            }
+            catch (cause) {
+                if (cause instanceof LocalAgentCatalogError) {
+                    this.error(lang === 'zh'
+                        ? `本机 Agent 登记表扩展不可用：${cause.message}`
+                        : `Local agent catalog extension is unusable: ${cause.message}`, { exit: 1 });
+                }
+                throw cause;
+            }
+        };
+        await this.runWithCancellation(async (signal) => {
+            if (args.operation === 'list') {
+                const report = detectAgentInventory({ descriptors: readCatalog() });
+                const written = saveAgentInventoryReport(report, layout);
+                if (flags.json) {
+                    this.log(JSON.stringify(report, null, 2));
+                }
+                else {
+                    for (const agent of report.agents.filter((entry) => entry.installed)) {
+                        this.log(`${agent.displayName} (${agent.agentId}) · ${agent.traceSourceKind ?? 'unknown'} · ${agent.sessionFileCount}`);
+                        for (const root of agent.logRoots.filter((entry) => entry.exists)) {
+                            this.log(lang === 'zh'
+                                ? `  ${root.path}：${root.sessionFileCount} 份${root.truncated ? '（已截断）' : ''}${root.readable ? '' : '（不可读）'}${root.unreadableReason ? '（本机运行时解不了这格式）' : ''}`
+                                : `  ${root.path}: ${root.sessionFileCount}${root.truncated ? ' (truncated)' : ''}${root.readable ? '' : ' (unreadable)'}${root.unreadableReason ? ' (this runtime cannot read the format)' : ''}`);
+                        }
+                    }
+                    this.log(lang === 'zh'
+                        ? `已识别 ${report.summary.installedAgentCount}/${report.summary.knownAgentCount} 个 Agent · 会话日志 ${report.summary.sessionFileCount} 份`
+                        : `${report.summary.installedAgentCount}/${report.summary.knownAgentCount} agents detected · ${report.summary.sessionFileCount} session logs`);
+                }
+                for (const agent of report.agents.filter((entry) => entry.installed)) {
+                    // 「装了但本机读不了这格式」与「装了且没有日志」是两件事：前者要换运行时，
+                    // 后者要等用户真的产生会话，混成一句会让人白跑一边排查。
+                    if (agent.logRoots.some((root) => root.unreadableReason !== undefined)) {
+                        this.logToStderr(lang === 'zh'
+                            ? `${agent.displayName} 已安装并发现了会话文件，但本机 Node 运行时没有内建 zstd 解压，读不了 .jsonl.zstd 会话。`
+                            : `${agent.displayName} is installed and session files were found, but this Node runtime has no built-in zstd decompression, so .jsonl.zstd sessions cannot be read.`);
+                        continue;
+                    }
+                    if (agent.sessionFileCount > 0)
+                        continue;
+                    this.logToStderr(lang === 'zh'
+                        ? `${agent.displayName} 已安装，但没有找到可读的会话日志。`
+                        : `${agent.displayName} is installed but has no readable session logs.`);
+                }
+                this.logToStderr(lang === 'zh' ? `清单已写入：${written}` : `Inventory written to: ${written}`);
+                return;
+            }
+            if (args.operation === 'collect') {
+                const report = collectAgentLogs(undefined, {
+                    layout,
+                    detect: { descriptors: readCatalog() },
+                    ...(flags.limit === undefined ? {} : { limits: { maxFilesPerRun: flags.limit } }),
+                });
+                const written = saveAgentCollectionReport(report, layout);
+                if (flags.json) {
+                    this.log(JSON.stringify(report, null, 2));
+                }
+                else {
+                    for (const entry of report.agents) {
+                        this.log(formatEntryLine(entry, lang));
+                    }
+                    this.log(lang === 'zh'
+                        ? `采集：发现 ${report.summary.discoveredCount} · 新增 ${report.summary.collectedCount} · 跳过 ${report.summary.skippedCount} · 失败 ${report.summary.failedCount} · 事件 ${report.summary.eventCount}（未支持格式 ${report.summary.unknownEventCount} · 重复视图 ${report.summary.duplicateViewCount} · 待映射证据 ${report.summary.unmappedEvidenceCount}）`
+                        : `Collected: ${report.summary.discoveredCount} found · ${report.summary.collectedCount} new · ${report.summary.skippedCount} skipped · ${report.summary.failedCount} failed · ${report.summary.eventCount} events (${report.summary.unknownEventCount} unsupported format · ${report.summary.duplicateViewCount} duplicate views · ${report.summary.unmappedEvidenceCount} unmapped evidence)`);
+                }
+                for (const limitation of report.limitations) {
+                    this.logToStderr(lang === 'zh' ? `限制：${limitation}` : `Limitation: ${limitation}`);
+                }
+                this.logToStderr(lang === 'zh' ? `采集报告已写入：${written}` : `Collection report written to: ${written}`);
+                const sample = report.sessions[0]?.runId ?? '<runId>';
+                this.logToStderr(lang === 'zh'
+                    ? `下一步：omk agents extract --session ${shellQuoteArg(sample)}\n在 Studio 的 Agents 页查看：omk studio`
+                    : `Next: omk agents extract --session ${shellQuoteArg(sample)}\nTo review it in Studio: omk studio`);
+                return;
+            }
+            const runId = flags.session;
+            if (!runId?.trim()) {
+                this.error(`--session ${lang === 'zh' ? '不能为空' : 'is required'}`, { exit: 2 });
+            }
+            let collection;
+            try {
+                collection = loadAgentCollectionReport(layout.observeAgentsDir);
+            }
+            catch (cause) {
+                if (cause instanceof AgentCollectionReportOutdatedError) {
+                    this.error(lang === 'zh'
+                        ? `采集报告是 ${cause.foundVersion} 口径，未识别事件的分桶计数无法沿用。先运行 omk agents collect 重新采集。`
+                        : `The collection report uses the superseded ${cause.foundVersion} scheme, whose unrecognized-event buckets cannot be carried over. Run omk agents collect to recollect.`, { exit: 1 });
+                }
+                throw cause;
+            }
+            if (!collection) {
+                this.error(lang === 'zh'
+                    ? '还没有采集报告，先运行 omk agents collect。'
+                    : 'No collection report yet; run omk agents collect first.', { exit: 1 });
+            }
+            const session = collection.sessions.find((entry) => entry.runId === runId);
+            if (!session) {
+                this.error(lang === 'zh'
+                    ? `采集报告里没有会话 ${runId}。`
+                    : `Session ${runId} is not in the collection report.`, { exit: 1 });
+            }
+            if (!existsSync(session.sourcePath) || !statSync(session.sourcePath).isFile()) {
+                this.error(lang === 'zh'
+                    ? `原始日志已不可读：${session.sourcePath}`
+                    : `Source log is no longer readable: ${session.sourcePath}`, { exit: 1 });
+            }
+            const settings = new UserSettingsStore().resolve({
+                workspace: flags.knowledge ? resolve(flags.knowledge) : globalLayout().knowledgeDir,
+                executor: flags.executor,
+                model: flags.model,
+            });
+            const { createLocalKnowledgeApplication } = await import('../../observability/knowledge-extraction/local.js');
+            const { configuredExtractionModel } = await import('../../observability/knowledge-extraction/adapters/executor.js');
+            const app = createLocalKnowledgeApplication(settings.workspace);
+            this.logToStderr(lang === 'zh'
+                ? `${session.agentId} / ${session.sourceKind} · 仅发送选定来源片段；费用以执行器实际报告为准。`
+                : `${session.agentId} / ${session.sourceKind} · Only selected excerpts are sent; cost depends on executor reporting.`);
+            const captured = app.capture({
+                path: session.sourcePath,
+                ...(session.title ? { origin: { threadId: session.runId, title: session.title } } : {}),
+            }, signal);
+            if (!settings.model) {
+                this.error(lang === 'zh'
+                    ? '缺少生成模型，请用 --model 指定。'
+                    : 'No generation model; pass --model.', { exit: 2 });
+            }
+            const run = await app.generate(captured.snapshotId, configuredExtractionModel(settings.executor, settings.model), undefined, signal);
+            if (flags.json) {
+                this.log(JSON.stringify({ session, snapshot: captured, run }, null, 2));
+                return;
+            }
+            this.log(lang === 'zh'
+                ? `提炼完成：${run.committed.length} 条候选知识（来源格式 ${captured.sourceKind}，快照 ${captured.snapshotId}）`
+                : `Extracted ${run.committed.length} candidate(s) from ${captured.sourceKind} (snapshot ${captured.snapshotId}).`);
+            for (const committed of run.committed) {
+                const detail = app.detail(committed.knowledgeId, committed.revisionId);
+                this.log(`- ${detail.revision.title} · ${detail.revision.entities.length} 个实体 · ${committed.knowledgeId}`);
+            }
+            this.logToStderr(lang === 'zh'
+                ? `下一步：omk observe knowledge list --workspace ${shellQuoteArg(settings.workspace)}`
+                : `Next: omk observe knowledge list --workspace ${shellQuoteArg(settings.workspace)}`);
+        });
+    }
+}

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

@@ -9,7 +9,7 @@ export default class Doctor extends BaseCommand {
         target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         gate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         executor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/cli/commands/eval/gold/compare.d.ts

@@ -5,7 +5,7 @@ export default class EvalGoldCompare extends BaseCommand {
         runId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'gold-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         target: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         evaluator: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/cli/commands/eval/gold/index.d.ts

@@ -2,7 +2,7 @@ import { BaseCommand } from '../../../oclif/base-command.js';
 export default class EvalGold extends BaseCommand {
     static description: string;
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/cli/commands/eval/gold/init.d.ts

@@ -2,7 +2,7 @@ import { BaseCommand } from '../../../oclif/base-command.js';
 export default class EvalGoldInit extends BaseCommand {
     static description: string;
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         out: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         annotator: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/cli/commands/eval/gold/validate.d.ts

@@ -5,7 +5,7 @@ export default class EvalGoldValidate extends BaseCommand {
         dir: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -18,7 +18,7 @@ export default class Eval extends BaseCommand {
         command: string;
     }[];
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         control: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         treatment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'control-cwd': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/cli/commands/eval/task.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../oclif/base-command.js';
+export default class EvalTask extends BaseCommand {
+    static description: string;
+    static args: {
+        definition: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/cli/commands/eval/task.js

@@ -0,0 +1,42 @@
+import { Args, Flags } from '@oclif/core';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir, homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { BaseCommand } from '../../oclif/base-command.js';
+import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
+import { prepareLocalTask } from '../../../eval-workflows/hosts/local-task/application.js';
+export default class EvalTask extends BaseCommand {
+    static description = bilingual({ zh: '从固定快照执行可信本地任务 A/B，采集产物并独立验收。', en: 'Run trusted local task A/B from a fixed snapshot, collect artifacts and verify outcomes independently.' });
+    static args = { definition: Args.string({ required: true, description: bilingual({ zh: '本地任务 YAML／JSON 定义。', en: 'Local task YAML/JSON definition.' }) }) };
+    static flags = {
+        lang: LANG_FLAG,
+        'dry-run': Flags.boolean({ description: bilingual({ zh: '预览封存计划，不执行任务。', en: 'Preview the sealed plan without executing tasks.' }) }),
+        output: Flags.string({ default: '.omk/eval', description: bilingual({ zh: '报告输出目录。', en: 'Report output directory.' }) }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(EvalTask);
+        const temporaryRoot = await mkdtemp(join(tmpdir(), 'omk-local-task-'));
+        try {
+            await this.runWithCancellation(async (signal) => {
+                const application = await prepareLocalTask({ definitionPath: resolve(args.definition), temporaryRoot,
+                    outputDirectory: resolve(flags.output),
+                    authenticationFile: join(process.env.CODEX_HOME ?? join(homedir(), '.codex'), 'auth.json'),
+                });
+                if (flags['dry-run']) {
+                    this.log(JSON.stringify(application.preview, null, 2));
+                    return;
+                }
+                process.stderr.write(`${JSON.stringify(application.preview, null, 2)}\n`);
+                const { result, artifacts, reference, diagnosticsDirectory, diagnosticReferences } = await application.run(signal);
+                this.log(JSON.stringify({ runId: result.runId, outputDirectory: resolve(flags.output), reference, diagnosticsDirectory, diagnosticReferences, report: artifacts.report }, null, 2));
+                if (result.status !== 'completed' || artifacts.execution.records.some((record) => record.executionStatus !== 'completed')
+                    || artifacts.evaluation.records.some((record) => record.evaluationStatus !== 'completed'
+                        || record.observations.some((observation) => observation.observationStatus !== 'observed')))
+                    this.exit(1);
+            });
+        }
+        finally {
+            await rm(temporaryRoot, { recursive: true, force: true });
+        }
+    }
+}

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

@@ -13,7 +13,7 @@ export default class Evolve extends BaseCommand {
         skillPath: Interfaces.Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
+        lang: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         rounds: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
         target: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         samples: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;

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

@@ -9,7 +9,7 @@ export default class Init extends BaseCommand {
         targetDir: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         samples: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/cli/commands/init.js

@@ -8,20 +8,32 @@ import { shellQuoteArg } from '../../shared/shell-quote.js';
 import { writeProjectScaffold } from '../../knowledge-artifacts/authoring/scaffold.js';
 import { projectLayout } from '../../evidence/storage/layout.js';
 import { DEFAULT_INIT_SAMPLE_COUNT, FULL_INIT_SAMPLE_COUNT, serializeInitSamples, } from '../templates/init-samples.js';
-// 预置 .omk/.gitignore:测量 bulk + doctor --fix 备份(项目本地、不该入库)默认不入库;
-// managed/ 治理档案 + 配置不在此列,默认 track。
-const INIT_OMK_GITIGNORE = `# omk 测量 bulk 与 doctor --fix 备份（项目本地）——不入库；前导 / 锚定 .omk/ 顶层，不误伤嵌套同名目录。
+// 脚手架是用户拿到手的产物内容：语言必须跟着 --lang 走，否则英文用户 init 出来的
+// 项目从注释到 skill 正文都是中文。name／目录名等身份字段两版一致，只有文字随语言。
+const INIT_OMK_GITIGNORE = {
+    // 预置 .omk/.gitignore:测量 bulk + doctor --fix 备份(项目本地、不该入库)默认不入库;
+    // managed/ 治理档案 + 配置不在此列,默认 track。
+    zh: `# omk 测量 bulk 与 doctor --fix 备份（项目本地）——不入库；前导 / 锚定 .omk/ 顶层，不误伤嵌套同名目录。
 /eval/
 /doctor/
 /observe/
 /backups/
 /state/
-`;
+`,
+    en: `# omk measurement bulk and doctor --fix backups (project-local) - not committed; the leading / anchors at the .omk/ root so nested directories with the same name are unaffected.
+/eval/
+/doctor/
+/observe/
+/backups/
+/state/
+`,
+};
 // 模板带 Claude Code SKILL.md 兼容 frontmatter(name + description),让用户
 // 可以把 init 出来的 SKILL.md 直接 deploy 到 ~/.claude/skills/ 给 Claude Code 用,
 // 一份文件双向 dogfood(omk 评测 + Claude 部署)。omk 当前不 strip frontmatter,
 // 它会跟着 leak 进 system prompt — 在 model 行为层面是无害噪声,跨 executor 一致。
-const INIT_SKILL_V1 = `---
+const INIT_SKILL_V1 = {
+    zh: `---
 name: code-review-v1
 description: 简单代码审查 skill,识别明显问题
 ---
@@ -29,8 +41,19 @@ description: 简单代码审查 skill,识别明显问题
 # Code review v1
 
 你是一个代码审查助手。请审查用户提供的代码，指出潜在问题。
-`;
-const INIT_SKILL_V2 = `---
+`,
+    en: `---
+name: code-review-v1
+description: Simple code review skill that flags obvious problems
+---
+
+# Code review v1
+
+You are a code review assistant. Review the code the user provides and point out potential problems.
+`,
+};
+const INIT_SKILL_V2 = {
+    zh: `---
 name: code-review-v2
 description: 多维度代码审查,覆盖安全 / 健壮 / 可维护 / 性能,带严重程度标注
 ---
@@ -45,7 +68,24 @@ description: 多维度代码审查,覆盖安全 / 健壮 / 可维护 / 性能,
 4. 性能：是否存在明显的性能瓶颈
 
 对每个维度给出具体的改进建议，并标注严重程度（高/中/低）。
-`;
+`,
+    en: `---
+name: code-review-v2
+description: Multi-dimension code review covering security / robustness / maintainability / performance, with severity labels
+---
+
+# Code review v2
+
+You are a senior code review specialist. Review the code the user provides along these dimensions:
+
+1. Security: injection, XSS, secret leakage and similar risks
+2. Robustness: adequate error handling and boundary checks
+3. Maintainability: clear naming and sound structure
+4. Performance: obvious bottlenecks
+
+For each dimension give concrete improvements and label their severity (high / medium / low).
+`,
+};
 const INIT_EVAL_COMMAND = 'omk eval --control code-review-v1 --treatment code-review-v2';
 function isOutsideCwd(relPath) {
     return relPath === '..' || relPath.startsWith(`..${sep}`);
@@ -147,10 +187,10 @@ export default class Init extends BaseCommand {
                 throw new Error(tCli('cli.init.existing_files', lang, { paths: existingFiles.join(', ') }));
             }
             writeProjectScaffold(targetDir, [
-                { relativePath: 'eval-samples.json', content: serializeInitSamples(sampleCount) },
-                { relativePath: 'skills/code-review-v1/SKILL.md', content: INIT_SKILL_V1 },
-                { relativePath: 'skills/code-review-v2/SKILL.md', content: INIT_SKILL_V2 },
-                { relativePath: relative(targetDir, join(layout.root, '.gitignore')), content: INIT_OMK_GITIGNORE },
+                { relativePath: 'eval-samples.json', content: serializeInitSamples(sampleCount, lang) },
+                { relativePath: 'skills/code-review-v1/SKILL.md', content: INIT_SKILL_V1[lang] },
+                { relativePath: 'skills/code-review-v2/SKILL.md', content: INIT_SKILL_V2[lang] },
+                { relativePath: relative(targetDir, join(layout.root, '.gitignore')), content: INIT_OMK_GITIGNORE[lang] },
             ], flags.force);
             console.log(tCli('cli.init.scaffolded', lang, { dir: targetDir }));
             console.log(tCli('cli.init.sample_pack', lang, { count: sampleCount }));
@@ -163,6 +203,8 @@ export default class Init extends BaseCommand {
                 : 'cli.init.next_step_report_quick', lang));
             console.log(tCli('cli.init.next_step_customize', lang));
             console.log(tCli('cli.init.note_skill_injection', lang));
+            if (!this.langConfigured)
+                console.log(tCli('cli.init.language_hint', lang, { lang }));
         });
     }
 }

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

@@ -9,7 +9,7 @@ export default class Install extends BaseCommand {
         input: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         kind: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         dest: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -18,7 +18,7 @@ export default class List extends BaseCommand {
         command: string;
     }[];
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

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

@@ -5,7 +5,7 @@ export declare function runObserveInbox(_args: ObserveInboxArgs, flags: ObserveI
 export default class ObserveInbox extends BaseCommand {
     static description: string;
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'input-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         skill: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -13,11 +13,11 @@ function printText(value) {
 }
 // runObserveInbox export:test/cli/observe.test.ts in-process import 验证 by-skill 聚合行为。
 export async function runObserveInbox(_args, flags, lang, signal) {
-    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, DEFAULT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR } = await import('../../../observability/inbox/index.js');
-    // 显式 --input-dir 最高;否则 --global 直读全局、默认读项目(空则 loadObservationInboxReports 兜底全局)。
+    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, globalObservationsDir, projectObservationsDir } = await import('../../../observability/inbox/index.js');
+    // 显式 --input-dir 最高;否则 --global 直读全局、默认交给 inbox 读侧的「项目优先 → 全局兜底」。
     const dir = flags['input-dir']
         ? resolve(flags['input-dir'])
-        : (flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_OBSERVATIONS_DIR);
+        : (flags.global ? globalObservationsDir() : undefined);
     if (flags['llm-enhanced-review']) {
         const { buildObservationInboxViewModel } = await import('../../../observability/inbox/view-model.js');
         const { extractSkillSoftStandards } = await import('../../../observability/soft-standards/index.js');
@@ -62,7 +62,7 @@ export async function runObserveInbox(_args, flags, lang, signal) {
         items = items.filter((item) => item.skillName === flags.skill);
     }
     const recyclableCount = items.filter((item) => item.severity !== 'noise').length;
-    const sampleCommandBase = `omk sample --from-traces --observations-dir ${shellQuoteArg(dir)}`;
+    const sampleCommandBase = `omk sample --from-traces --observations-dir ${shellQuoteArg(dir ?? projectObservationsDir())}`;
     const sampleCommand = flags.skill
         ? `${sampleCommandBase} --skill ${shellQuoteArg(flags.skill)}`
         : sampleCommandBase;

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

@@ -9,7 +9,7 @@ export default class Observe extends BaseCommand {
         sessionsDir: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         kb: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         last: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -7,7 +7,7 @@ export default class ObserveIngest extends BaseCommand {
         traceDir: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;

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

@@ -84,14 +84,18 @@ export default class ObserveIngest extends BaseCommand {
                     : 'Error: --output-dir must not be an empty string.');
                 throw new CliExit(2);
             }
-            const { buildObservationInboxReport, compactObservationInboxReport, saveObservationInboxReport, DEFAULT_PROJECT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR, } = await import('../../../observability/inbox/index.js');
-            // 显式 --output-dir 最高;否则 --global 写全局、默认写项目(读侧 loadObservationInboxReports 会从项目兜底到全局)。
-            const defaultDir = flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_PROJECT_OBSERVATIONS_DIR;
-            const outDir = resolve(outDirRaw ?? defaultDir);
+            const { buildObservationInboxReport, compactObservationInboxReport, saveObservationInboxReport, projectObservationsDir, globalObservationsDir, } = await import('../../../observability/inbox/index.js');
+            // 显式 --output-dir 最高;否则 --global 写全局、默认写项目。
+            const outDir = resolve(outDirRaw ?? (flags.global ? globalObservationsDir() : projectObservationsDir()));
+            // 读侧兜底只在默认目标上生效：显式 --output-dir 与 --global 都照读给定目录，与 inbox 读侧同口径。
+            const reviewStateSource = outDirRaw || flags.global ? outDir : undefined;
             const { loadObservationReviewState } = await import('../../../observability/inbox/review-state.js');
             const { buildObserveDiagnosticsFromReport } = await import('../../../diagnosis/observe-producer.js');
-            const report = buildObservationInboxReport(tracePath, { reviewState: loadObservationReviewState(outDir) });
-            report.diagnostics = buildObserveDiagnosticsFromReport(report);
+            const report = buildObservationInboxReport(tracePath, { reviewState: loadObservationReviewState(reviewStateSource) });
+            // 链由 observability 侧单一生产者按报告内的 cwd 证据构建，歧义即跳过；诊断层只消费。
+            const { skillNamesFromReports, buildSkillChainsForEvidence } = await import('../../../observability/inbox/skill-chains.js');
+            const { chains } = buildSkillChainsForEvidence(skillNamesFromReports([report]), [report]);
+            report.diagnostics = buildObserveDiagnosticsFromReport(report, { skillChains: chains });
             const path = saveObservationInboxReport(report, outDir);
             console.log(flags.json
                 ? JSON.stringify(compactObservationInboxReport(report), null, 2)

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

@@ -5,7 +5,7 @@ export default class ObserveKnowledge extends BaseCommand {
         operation: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         source: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'start-record': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -15,7 +15,7 @@ export default class ObserveKnowledge extends BaseCommand {
     static flags = {
         lang: LANG_FLAG,
         workspace: Flags.string({ description: description('本地知识工作区，默认使用全局设置；CLI 与 Studio 共用。', 'Local knowledge workspace; defaults to global settings shared with Studio.') }),
-        source: Flags.string({ description: description('capture：一份 Codex JSONL 文件。', 'capture: one Codex JSONL file.') }),
+        source: Flags.string({ description: description('capture：一份已支持格式的 Agent 会话日志（Codex／Claude／Qoder 等）。', 'capture: one supported agent session log (Codex / Claude / Qoder / ...).') }),
         'start-record': Flags.integer({ min: 0, description: description('从零开始的非空记录序号，包含。', 'Zero-based nonempty record index, inclusive.') }),
         'end-record': Flags.integer({ min: 0, description: description('最后一条记录序号，包含。', 'Last record index, inclusive.') }),
         snapshot: Flags.string({ description: description('generate／source／delete-source：归档身份。', 'generate/source/delete-source: snapshot identity.') }),

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

@@ -5,7 +5,7 @@ export default class ObserveShow extends BaseCommand {
         inboxId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'input-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };