oh-my-knowledge 0.37.0 → 0.38.0

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

@@ -20,8 +20,11 @@ function pickSkillToolCounts(value, skillName) {
 }
 // runObserveInbox export:test/cli/observe.test.ts in-process import 验证 by-skill 聚合行为。
 export async function runObserveInbox(_args, flags, lang) {
-    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
-    const dir = resolve(flags['input-dir'] || DEFAULT_OBSERVATIONS_DIR);
+    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, DEFAULT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+    // 显式 --input-dir 最高;否则 --global 直读全局、默认读项目(空则 loadObservationInboxReports 兜底全局)。
+    const dir = flags['input-dir']
+        ? resolve(flags['input-dir'])
+        : (flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_OBSERVATIONS_DIR);
     if (flags['llm-enhanced-review']) {
         const { buildObservationInboxViewModel } = await import('../../../observability/inbox-view-model.js');
         const { extractSkillSoftStandards, DEFAULT_LLM_ENHANCED_REVIEW_MODEL } = await import('../../../observability/soft-standards/index.js');
@@ -186,10 +189,17 @@ export default class ObserveInbox extends BaseCommand {
         lang: LANG_FLAG,
         'input-dir': Flags.string({
             description: bilingual({
-                zh: 'inbox 数据目录，默认 .omk/observations（项目级，相对于 cwd）；目录不存在时兜底读 ~/.oh-my-knowledge/observations。',
-                en: 'Inbox data dir, default .omk/observations (project-local); falls back to ~/.oh-my-knowledge/observations when missing.',
+                zh: 'inbox 数据目录，默认 .omk/observe-inbox（项目级，相对于 cwd）；目录不存在时兜底读 ~/.oh-my-knowledge/observe-inbox。',
+                en: 'Inbox data dir, default .omk/observe-inbox (project-local); falls back to ~/.oh-my-knowledge/observe-inbox when missing.',
             }),
         }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '直接读取全局 ~/.oh-my-knowledge/observe-inbox（跳过项目级与兜底）。',
+                en: 'Read directly from global ~/.oh-my-knowledge/observe-inbox (skip project-local and fallback).',
+            }),
+            default: false,
+        }),
         skill: Flags.string({
             description: bilingual({ zh: '只看指定 skill', en: 'Filter to specific skill' }),
         }),

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

@@ -1,4 +1,14 @@
 import { BaseCommand } from '../../oclif/base-command.js';
+import type { SkillHealthReport } from '../../../observability/skill-health-analyzer.js';
+/**
+ * observe-health 报告落盘:id / 文件名加 4 位随机段,根治「同秒两次 omk observe 直接覆盖、数据丢失」的 bug。
+ * 保留 `-observe-health.json` 后缀 —— resolveObserveHealthDir 靠它判项目优先、listAnalyses 靠它取 id stem、
+ * loadAnalysis 靠 `${id}.json` 读真身。落盘后 best-effort 追加全局轻卡片,让 studio 跨项目聚合。
+ */
+export declare function persistObserveHealthReport(report: SkillHealthReport, outDir: string): {
+    id: string;
+    jsonPath: string;
+};
 export default class Observe extends BaseCommand {
     static description: string;
     static examples: {
@@ -16,6 +26,7 @@ export default class Observe extends BaseCommand {
         to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         skills: 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>;
     };
     run(): Promise<void>;
 }

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

@@ -1,3 +1,4 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
 import { resolve, join } from 'node:path';
 import { Args, Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
@@ -5,12 +6,29 @@ import { BaseCommand } from '../../oclif/base-command.js';
 import { CliExit } from '../../lib/cli-exit.js';
 import { tCli } from '../../lib/i18n.js';
 import { parseLastWindow } from '../../lib/shared.js';
-// oclif 版 observe 默认命令 — `omk observe <sessions-dir>` 走 health 分析。
-// 三个子命令(ingest / inbox / show)由 src/cli/commands/observe/ 文件目录托管。
+import { projectObserveHealthDir, globalObserveHealthDir } from '../../../eval-core/measurement-dirs.js';
+import { indexObserveWrite } from '../../../eval-core/artifact-index.js';
+/**
+ * observe-health 报告落盘:id / 文件名加 4 位随机段,根治「同秒两次 omk observe 直接覆盖、数据丢失」的 bug。
+ * 保留 `-observe-health.json` 后缀 —— resolveObserveHealthDir 靠它判项目优先、listAnalyses 靠它取 id stem、
+ * loadAnalysis 靠 `${id}.json` 读真身。落盘后 best-effort 追加全局轻卡片,让 studio 跨项目聚合。
+ */
+export function persistObserveHealthReport(report, outDir) {
+    mkdirSync(outDir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const rand = Math.random().toString(36).slice(2, 6);
+    const id = `${timestamp}-${rand}-observe-health`;
+    const jsonPath = join(outDir, `${id}.json`);
+    writeFileSync(jsonPath, JSON.stringify(report, null, 2));
+    indexObserveWrite(report, jsonPath, outDir, id);
+    return { id, jsonPath };
+}
+// `omk observe <sessions-dir>` 是默认命令 —— 分析 sessions 目录的 skill 调用健康度，产出 observe-health 报告(JSON)，
+// 由 Studio 健康报告页按需渲染。observe 这条线的另一条产物是观测收件箱(observe-inbox)，走子命令 ingest / inbox / show。
 export default class Observe extends BaseCommand {
     static description = bilingual({
         zh: '分析 sessions 目录的 skill 调用健康度（默认行为）。子命令:ingest / inbox / show。',
-        en: 'Analyze skill invocation health from sessions dir (default). Subcommands: ingest / inbox / show.',
+        en: 'Analyze skill invocation health from a sessions dir (default). Subcommands: ingest / inbox / show.',
     });
     static examples = [
         {
@@ -52,8 +70,14 @@ export default class Observe extends BaseCommand {
         }),
         'output-dir': Flags.string({
             description: bilingual({
-                zh: '分析结果输出目录',
-                en: 'Analysis output directory',
+                zh: '健康报告输出目录，默认项目级 .omk/observe-health（--global 写全局）',
+                en: 'Health report output dir, default project-level .omk/observe-health (--global for global)',
+            }),
+        }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '写全局 ~/.oh-my-knowledge/observe-health，而非项目 .omk/observe-health',
+                en: 'Write to global ~/.oh-my-knowledge/observe-health instead of project .omk/observe-health',
             }),
         }),
     };
@@ -67,7 +91,7 @@ export default class Observe extends BaseCommand {
                 throw new CliExit(1);
             }
             const tracePath = resolve(dir);
-            const { existsSync, mkdirSync, writeFileSync } = await import('node:fs');
+            const { existsSync } = await import('node:fs');
             if (!existsSync(tracePath)) {
                 console.error(`Trace path does not exist: ${tracePath}`);
                 throw new CliExit(1);
@@ -92,12 +116,11 @@ export default class Observe extends BaseCommand {
                 to,
                 skills,
             });
-            // JSON 是主产物；HTML 由 report server 的 /analyses/:id 按需渲染。
-            const outDir = resolve(flags['output-dir'] || join(process.env.HOME || '.', '.oh-my-knowledge', 'analyses'));
-            mkdirSync(outDir, { recursive: true });
-            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-            const jsonPath = join(outDir, `${timestamp}-skill-health.json`);
-            writeFileSync(jsonPath, JSON.stringify(report, null, 2));
+            // JSON 是主产物；HTML 由 report server 的健康报告详情页按需渲染。
+            const outDir = flags['output-dir']
+                ? resolve(flags['output-dir'])
+                : (flags.global ? globalObserveHealthDir() : projectObserveHealthDir());
+            const { jsonPath } = persistObserveHealthReport(report, outDir);
             const { sessionCount, segmentCount, toolCallCount, toolFailureRate } = report.meta;
             console.log('');
             console.log(`sessions: ${sessionCount} · segments: ${segmentCount} · tool calls: ${toolCallCount} · fail rate: ${(toolFailureRate * 100).toFixed(1)}%`);

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

@@ -7,6 +7,7 @@ export default class ObserveIngest extends BaseCommand {
     static flags: {
         lang: import("@oclif/core/interfaces").OptionFlag<string, 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>;
     };
     run(): Promise<void>;
 }

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

@@ -21,10 +21,17 @@ export default class ObserveIngest extends BaseCommand {
         lang: LANG_FLAG,
         'output-dir': Flags.string({
             description: bilingual({
-                zh: '输出目录，默认 .omk/observations（项目级，相对于 cwd）。',
-                en: 'Output dir, default .omk/observations (project-local, relative to cwd).',
+                zh: '输出目录，默认 .omk/observe-inbox（项目级，相对于 cwd；--global 写全局）。',
+                en: 'Output dir, default .omk/observe-inbox (project-local, relative to cwd; --global writes global).',
             }),
         }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '写入全局 ~/.oh-my-knowledge/observe-inbox，而非项目 .omk/observe-inbox。',
+                en: 'Write to global ~/.oh-my-knowledge/observe-inbox instead of project .omk/observe-inbox.',
+            }),
+            default: false,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(ObserveIngest);
@@ -54,8 +61,10 @@ export default class ObserveIngest extends BaseCommand {
                     : 'Error: --output-dir must not be an empty string.');
                 throw new CliExit(2);
             }
-            const { buildObservationInboxReport, saveObservationInboxReport, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
-            const outDir = resolve(outDirRaw ?? DEFAULT_OBSERVATIONS_DIR);
+            const { buildObservationInboxReport, saveObservationInboxReport, DEFAULT_PROJECT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+            // 显式 --output-dir 最高;否则 --global 写全局、默认写项目(读侧 loadObservationInboxReports 会从项目兜底到全局)。
+            const defaultDir = flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_PROJECT_OBSERVATIONS_DIR;
+            const outDir = resolve(outDirRaw ?? defaultDir);
             const { loadObservationReviewState } = await import('../../../observability/review-state.js');
             const { buildObserveDiagnosticsFromReport } = await import('../../../diagnosis/observe-producer.js');
             const report = buildObservationInboxReport(tracePath, { reviewState: loadObservationReviewState(outDir) });

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

@@ -7,6 +7,7 @@ export default class ObserveShow extends BaseCommand {
     static flags: {
         lang: import("@oclif/core/interfaces").OptionFlag<string, 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>;
     };
     run(): Promise<void>;
 }

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

@@ -25,6 +25,13 @@ export default class ObserveShow extends BaseCommand {
                 en: 'Inbox data dir',
             }),
         }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '直接读取全局 ~/.oh-my-knowledge/observe-inbox（跳过项目级与兜底）。',
+                en: 'Read directly from global ~/.oh-my-knowledge/observe-inbox (skip project-local and fallback).',
+            }),
+            default: false,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(ObserveShow);
@@ -35,8 +42,11 @@ export default class ObserveShow extends BaseCommand {
                 console.error(lang === 'zh' ? '用法：omk observe show <inbox_id> [--input-dir <path>]' : 'Usage: omk observe show <inbox_id> [--input-dir <path>]');
                 throw new CliExit(1);
             }
-            const { findObservationInboxItem, formatObservationShow, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
-            const dir = resolve(flags['input-dir'] || DEFAULT_OBSERVATIONS_DIR);
+            const { findObservationInboxItem, formatObservationShow, DEFAULT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+            // 显式 --input-dir 最高;否则 --global 直读全局、默认读项目(空则 findObservationInboxItem 兜底全局)。与 observe inbox 同口径。
+            const dir = flags['input-dir']
+                ? resolve(flags['input-dir'])
+                : (flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_OBSERVATIONS_DIR);
             const item = findObservationInboxItem(id, dir);
             if (!item) {
                 console.error(lang === 'zh' ? `未找到 observation：${id}` : `Observation not found: ${id}`);

package/dist/cli/commands/promote.js

@@ -4,10 +4,9 @@ import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
 import { tCli } from '../lib/i18n.js';
 import { CliExit } from '../lib/cli-exit.js';
-import { probeSourceState } from '../lib/source-probe.js';
 import { sanitizeCell } from '../lib/cell-format.js';
 import { getJudgePromptHash } from '../../grading/judge.js';
-import { appendManagedDecision, evaluatePromoteGate, globalManagedDir, isCurrentlyPromoted, loadManagedRecord, managedDir, managedRecordId, resolveManagedDir, } from '../../managed/index.js';
+import { appendManagedDecision, evaluatePromoteGate, globalManagedDir, isCurrentlyPromoted, loadManagedRecord, probeSourceState, managedDir, managedRecordId, resolveManagedDir, } from '../../managed/index.js';
 const SUPPORTED_KINDS = ['skill'];
 /** 决定的 actor:--actor > git config user.name > $USER / $LOGNAME > unknown。git 参数无用户输入,安全。 */
 function resolveActor(flagActor) {

package/dist/cli/commands/sample.js

@@ -7,7 +7,7 @@ import { BaseCommand } from '../oclif/base-command.js';
 import { integerStringParser } from '../oclif/parsers.js';
 import { CliExit } from '../lib/cli-exit.js';
 import { tCli } from '../lib/i18n.js';
-import { DEFAULT_REPORTS_DIR } from '../lib/parse-run-config.js';
+import { projectReportsDir, globalReportsDir } from '../../eval-core/measurement-dirs.js';
 import { loadSamples, parseYaml } from '../../inputs/load-samples.js';
 import { hashSample } from '../../eval-core/evaluation-reporting.js';
 import { hashArtifactSource } from '../../inputs/content-hash.js';
@@ -154,9 +154,8 @@ export function writeFixedSamplesToSources(loaded, samples, changedIds) {
 }
 async function runSampleFix(args, flags, lang) {
     const { fixSamples } = await import('../../authoring/sample-fixer.js');
-    const { createFileStore } = await import('../../server/report-store.js');
+    const { createFileStore, createOverlayReportStore } = await import('../../server/report-store.js');
     const model = flags.model;
-    const reportsDir = resolve(flags['reports-dir'] ?? DEFAULT_REPORTS_DIR);
     const skillPath = args.skillPath;
     if (!skillPath) {
         console.error(lang === 'zh' ? '请指定 skill 路径，如: omk sample skills/my-skill/SKILL.md --fix' : 'Specify skill path: omk sample skills/my-skill/SKILL.md --fix');
@@ -181,10 +180,17 @@ async function runSampleFix(args, flags, lang) {
         : basename(resolvedSkillPath, extname(resolvedSkillPath));
     const treatmentName = flags.treatment ?? defaultTreatmentName;
     process.stderr.write(lang === 'zh' ? `🔍 正在查找 ${treatmentName} 的最新评测报告...\n` : `🔍 Scanning latest report for ${treatmentName}...\n`);
-    const store = createFileStore(reportsDir);
+    // 显式 --reports-dir 固定该目录;默认 overlay(项目 .omk/reports 盖全局),findByVariant 记录优先看项目、
+    // 空则全局兜底,不因 eval 写默认翻项目而查不到报告。
+    const store = flags['reports-dir']
+        ? createFileStore(resolve(flags['reports-dir']))
+        : createOverlayReportStore(projectReportsDir(), globalReportsDir());
     const reports = await store.findByVariant(treatmentName);
     if (reports.length === 0) {
-        console.error(lang === 'zh' ? `未找到 ${treatmentName} 的评测报告（报告目录: ${reportsDir}）` : `No eval report found for ${treatmentName} in ${reportsDir}`);
+        const where = flags['reports-dir']
+            ? resolve(flags['reports-dir'])
+            : (lang === 'zh' ? '项目 .omk/reports 或全局 ~/.oh-my-knowledge/reports' : 'project .omk/reports or global ~/.oh-my-knowledge/reports');
+        console.error(lang === 'zh' ? `未找到 ${treatmentName} 的评测报告（报告目录: ${where}）` : `No eval report found for ${treatmentName} in ${where}`);
         throw new CliExit(1);
     }
     const report = reports[0];
@@ -273,8 +279,8 @@ async function runSampleFromTraces(flags, lang) {
     const obsDir = resolve(flags['observations-dir'] ?? DEFAULT_OBSERVATIONS_DIR);
     if (!existsSync(obsDir)) {
         console.error(lang === 'zh'
-            ? `observations 目录不存在: ${obsDir}（先运行 omk observe 生成 inbox）`
-            : `Observations dir not found: ${obsDir} (run omk observe first)`);
+            ? `observe-inbox 目录不存在: ${obsDir}（先运行 omk observe ingest 生成）`
+            : `Observe-inbox dir not found: ${obsDir} (run omk observe ingest first)`);
         throw new CliExit(1);
     }
     // Drop noise-tier signals up front: they're exactly what the generator is told to
@@ -582,8 +588,8 @@ export default class Sample extends BaseCommand {
         }),
         'observations-dir': Flags.string({
             description: bilingual({
-                zh: 'observe inbox 目录（from-traces 模式用），默认项目 .omk/observations。',
-                en: 'Observe inbox dir (from-traces mode), default project .omk/observations.',
+                zh: 'observe inbox 目录（from-traces 模式用），默认项目 .omk/observe-inbox。',
+                en: 'Observe inbox dir (from-traces mode), default project .omk/observe-inbox.',
             }),
         }),
     };

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

@@ -14,7 +14,9 @@ export default class Studio extends BaseCommand {
         host: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'reports-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'analyses-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'doctors-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'observations-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'no-open': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         dev: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/cli/commands/studio.js

@@ -4,7 +4,9 @@ import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
 import { integerStringParser } from '../oclif/parsers.js';
 import { tCli } from '../lib/i18n.js';
-import { DEFAULT_REPORTS_DIR } from '../lib/parse-run-config.js';
+import { resolveManagedDir, managedDir } from '../../managed/index.js';
+import { resolveObserveHealthDir, projectObserveHealthDir, globalObserveHealthDir, resolveDoctorsDir, projectDoctorsDir, globalDoctorsDir, globalReportsDir, } from '../../eval-core/measurement-dirs.js';
+import { DEFAULT_GLOBAL_OBSERVATIONS_DIR } from '../../observability/inbox.js';
 async function openWorkbench(url, lang) {
     const { execFile } = await import('node:child_process');
     const { platform } = await import('node:os');
@@ -29,7 +31,13 @@ async function openWorkbench(url, lang) {
 // import 直接调用。把业务作为 module-level helper export 从 Command file 暴露,
 // 既保留 test 兼容又让产品命令树语义干净(无 legacy commands directory)。
 export async function runStudio(_args, flags, lang) {
-    const reportsDir = flags['reports-dir'] ?? DEFAULT_REPORTS_DIR;
+    // reports 读取目录:显式 --reports-dir 固定该目录;--global 钉全局;默认 = undefined,交给
+    // createReportServer 建 indexed(机器级聚合:当前项目 + 全局 live ∪ 别项目索引卡片)。
+    const reportsDirOpt = flags['reports-dir']
+        ? resolve(flags['reports-dir'])
+        : flags.global
+            ? globalReportsDir()
+            : undefined;
     if (flags.dev && !process.env.__OMK_DEV_CHILD) {
         const { spawn } = await import('node:child_process');
         const { fileURLToPath } = await import('node:url');
@@ -44,14 +52,22 @@ export async function runStudio(_args, flags, lang) {
             'studio',
             '--port', flags.port,
             ...(flags.host ? ['--host', flags.host] : []),
-            '--reports-dir', reportsDir,
         ];
+        if (flags['reports-dir']) {
+            childArgs.push('--reports-dir', flags['reports-dir']);
+        }
         if (flags['analyses-dir']) {
             childArgs.push('--analyses-dir', flags['analyses-dir']);
         }
+        if (flags['doctors-dir']) {
+            childArgs.push('--doctors-dir', flags['doctors-dir']);
+        }
         if (flags['observations-dir']) {
             childArgs.push('--observations-dir', flags['observations-dir']);
         }
+        if (flags.global) {
+            childArgs.push('--global');
+        }
         if (flags['no-open']) {
             childArgs.push('--no-open');
         }
@@ -69,9 +85,31 @@ export async function runStudio(_args, flags, lang) {
     const server = createReportServer({
         port: Number(flags.port),
         ...(flags.host ? { host: flags.host } : {}),
-        reportsDir: resolve(reportsDir),
-        ...(flags['analyses-dir'] ? { analysesDir: resolve(flags['analyses-dir']) } : {}),
-        ...(flags['observations-dir'] ? { observationsDir: resolve(flags['observations-dir']) } : {}),
+        // reportsDir 缺省 undefined → server 建 indexed(机器级:当前项目 + 全局 + 别项目索引卡片);
+        // 显式 --reports-dir / --global 固定单目录(逃生舱,不走聚合)。
+        ...(reportsDirOpt !== undefined ? { reportsDir: reportsDirOpt } : {}),
+        // 测量产物(observe-health / doctors)默认按请求项目优先→全局兜底(同 managed);
+        // 显式 --analyses-dir/--doctors-dir 固定该目录;--global 钉全局目录。
+        analysesDir: flags['analyses-dir']
+            ? resolve(flags['analyses-dir'])
+            : (flags.global ? globalObserveHealthDir : () => resolveObserveHealthDir(projectObserveHealthDir())),
+        doctorsDir: flags['doctors-dir']
+            ? resolve(flags['doctors-dir'])
+            : (flags.global ? globalDoctorsDir : () => resolveDoctorsDir(projectDoctorsDir())),
+        // 只有默认机器级模式才合别项目的索引卡片;--global / 显式 --analyses-dir / --doctors-dir 是逃生舱,
+        // 只看固定目录(与 reports 的 --reports-dir 关闭 indexed store 对称)。observe / doctor 各自独立判定。
+        includeObserveCards: !flags.global && !flags['analyses-dir'],
+        includeDoctorCards: !flags.global && !flags['doctors-dir'],
+        // observe-inbox 缺省按请求项目优先→全局兜底(report-server 默认即此);显式 --observations-dir 固定该目录;
+        // --global 钉全局(与 observe-health / doctors 的 --global 一致)。
+        ...(flags['observations-dir']
+            ? { observationsDir: resolve(flags['observations-dir']) }
+            : flags.global
+                ? { observationsDir: DEFAULT_GLOBAL_OBSERVATIONS_DIR }
+                : {}),
+        // 传解析器而非解析结果:Studio 是长会话,受管根目录要按请求解析(项目首次 install 后从 global 切回
+        // project),与 omk list 同口径;若在此处一次性解析、冻结进 server,长会话里会与 CLI 分叉。
+        managedDir: () => resolveManagedDir(managedDir()),
     });
     const url = await server.start();
     console.log(tCli('cli.studio.started', lang, { url }));
@@ -116,20 +154,32 @@ export default class Studio extends BaseCommand {
         }),
         'reports-dir': Flags.string({
             description: bilingual({
-                zh: '报告目录，默认 ~/.oh-my-knowledge/reports',
-                en: 'Reports dir, default ~/.oh-my-knowledge/reports',
+                zh: '只看指定报告目录（可选；默认机器级聚合：当前项目 + 全局 + 别项目索引）',
+                en: 'View only this reports dir (optional; default aggregates machine-wide: current project + global + other projects via index)',
             }),
         }),
         'analyses-dir': Flags.string({
             description: bilingual({
-                zh: '分析数据目录（可选）',
-                en: 'Analyses dir (optional)',
+                zh: '观测健康报告目录（可选，默认项目级 .omk/observe-health，空则全局兜底）',
+                en: 'Observe-health reports dir (optional, default project .omk/observe-health, falls back to global)',
+            }),
+        }),
+        'doctors-dir': Flags.string({
+            description: bilingual({
+                zh: '体检报告目录（可选，默认项目级 .omk/doctors，空则全局兜底）',
+                en: 'Doctor reports dir (optional, default project .omk/doctors, falls back to global)',
             }),
         }),
         'observations-dir': Flags.string({
             description: bilingual({
-                zh: '观测数据目录（可选）',
-                en: 'Observations dir (optional)',
+                zh: '观测收件箱数据目录（可选，默认 .omk/observe-inbox）',
+                en: 'Observe-inbox data dir (optional, default .omk/observe-inbox)',
+            }),
+        }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '只看全局 reports / observe-health / doctors / observe-inbox 目录（~/.oh-my-knowledge/*），而非机器级聚合 / 项目优先；managed 不受影响',
+                en: 'View only global reports / observe-health / doctors / observe-inbox dirs (~/.oh-my-knowledge/*) instead of machine-wide / project-first; does not affect managed',
             }),
         }),
         'no-open': Flags.boolean({

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

@@ -76,6 +76,8 @@ export interface EvalFlags {
     executor?: string;
     'judge-models'?: string;
     'output-dir'?: string;
+    /** 报告写全局而非项目 .omk/reports(写入侧 escape;读取侧 studio / 复用走 overlay 兜底)。 */
+    global?: boolean;
     'no-judge'?: boolean;
     'no-cache'?: boolean;
     'dry-run'?: boolean;
@@ -140,6 +142,7 @@ export interface EvolveFlags {
     'edit-budget': string;
     'no-edit-budget': boolean;
     'no-reject-memory': boolean;
+    'snapshot-only': boolean;
 }
 export interface SampleArgs {
     skillPath?: string;
@@ -200,11 +203,13 @@ export interface ObserveIngestArgs {
 export interface ObserveIngestFlags {
     lang: Lang;
     'output-dir'?: string;
+    global: boolean;
 }
 export type ObserveInboxArgs = Record<string, never>;
 export interface ObserveInboxFlags {
     lang: Lang;
     'input-dir'?: string;
+    global: boolean;
     skill?: string;
     limit?: string;
     explore?: string;
@@ -222,6 +227,7 @@ export interface ObserveShowArgs {
 export interface ObserveShowFlags {
     lang: Lang;
     'input-dir'?: string;
+    global: boolean;
 }
 export type StudioArgs = Record<string, never>;
 export interface StudioFlags {
@@ -230,7 +236,9 @@ export interface StudioFlags {
     host?: string;
     'reports-dir'?: string;
     'analyses-dir'?: string;
+    'doctors-dir'?: string;
     'observations-dir'?: string;
+    global?: boolean;
     'no-open': boolean;
     dev: boolean;
 }

package/dist/cli/lib/i18n-dict/common.js

@@ -56,7 +56,7 @@ export const commonDict = {
         en: 'Silence: set {env} to disable',
     },
     'cli.observe.view_hint': {
-        zh: '分析 JSON 已写入 output-dir；后续可用 omk observe 持续生成日报。',
+        zh: '分析 JSON 已写入 output-dir；后续可用 omk observe 持续生成健康报告。',
         en: 'Analysis JSON written to output-dir; use omk observe to keep producing health reports.',
     },
     'cli.studio.started': {

package/dist/cli/lib/i18n-dict/evolve.d.ts

@@ -1,3 +1,3 @@
 import type { CliMessage } from './types.js';
-export type EvolveMessageKey = 'cli.evolve.specify_skill_path' | 'cli.evolve.section_header' | 'cli.evolve.round_baseline' | 'cli.evolve.round_baseline_reused' | 'cli.evolve.round_error' | 'cli.evolve.round_done' | 'cli.evolve.summary' | 'cli.evolve.best_path' | 'cli.evolve.versions_saved' | 'cli.evolve.report_link' | 'cli.evolve.holdout_active' | 'cli.evolve.holdout_disabled' | 'cli.evolve.gate_underpowered' | 'cli.evolve.generalization' | 'cli.evolve.test_disabled' | 'cli.evolve.reject_not_significant';
+export type EvolveMessageKey = 'cli.evolve.specify_skill_path' | 'cli.evolve.section_header' | 'cli.evolve.round_baseline' | 'cli.evolve.round_baseline_reused' | 'cli.evolve.round_error' | 'cli.evolve.round_done' | 'cli.evolve.summary' | 'cli.evolve.best_path' | 'cli.evolve.versions_saved' | 'cli.evolve.report_link' | 'cli.evolve.holdout_active' | 'cli.evolve.holdout_disabled' | 'cli.evolve.gate_underpowered' | 'cli.evolve.generalization' | 'cli.evolve.test_disabled' | 'cli.evolve.reject_not_significant' | 'cli.evolve.evidence_recorded_managed' | 'cli.evolve.snapshot_only_hint';
 export declare const evolveDict: Record<EvolveMessageKey, CliMessage>;

package/dist/cli/lib/i18n-dict/evolve.js

@@ -39,6 +39,14 @@ export const evolveDict = {
         zh: '📊 查看报告：omk studio（报告 ID：{id}）\n',
         en: '📊 View report: omk studio (report id: {id})\n',
     },
+    'cli.evolve.evidence_recorded_managed': {
+        zh: '📌 已记入受管记录：{name}（verdict={verdict}）→ measurable。运行 omk promote {name} 接受为 promoted。\n',
+        en: '📌 Recorded to managed record: {name} (verdict={verdict}) → measurable. Run omk promote {name} to accept as promoted.\n',
+    },
+    'cli.evolve.snapshot_only_hint': {
+        zh: '📎 --snapshot-only：未写回 source，候选留在 {dir}/。挑选后手动应用，再 omk eval / omk promote。\n',
+        en: '📎 --snapshot-only: source not modified; candidates kept in {dir}/. Apply your pick manually, then omk eval / omk promote.\n',
+    },
     'cli.evolve.holdout_active': {
         zh: '🔀 holdout 切分：训练 {train} / 验收 {holdout}，accept 看 holdout 分（防 train-on-test）\n',
         en: '🔀 Holdout split: {train} train / {holdout} holdout; accepted on holdout score (guards train-on-test)\n',