oh-my-knowledge 0.36.0 → 0.38.0

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/cell-format.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 终端展示前的不可信字符洗白——`omk list` 与 `omk promote` 共用。受管 JSON 可随仓库分发、用户可手改
+ * (store.ts validator 只收窄到「是字符串」,不卡内容),把它的字段(name / verdict / judgePromptHash /
+ * reportId / sourceLabel 等)塞进终端输出前必须先洗,否则 ANSI / OSC 转义、BiDi 重排、零宽分割会破坏排版
+ * 甚至伪造输出(清屏、改窗口标题、覆盖历史行误导审计)。一律映射到可见 U+FFFD;`--json` 路径保留原值
+ * (JSON.stringify 自带控制符转义,脚本消费要的是原始值)。
+ *
+ * 用 Unicode **属性类**而非手列码点 —— 手列清单天然有缺口(BiDi、U+2028 / 2029、Tags 块都曾漏一轮补一轮),
+ * 属性类一次覆盖整类、新码点自动纳入:
+ *   - `\p{Cc}` 控制符(C0 / C1 / DEL,含 ESC / 换行 / 回车 / TAB)→ 杀 ANSI / OSC 转义与终端控制;
+ *   - `\p{Cf}` 格式符(BiDi 重排 / 隔离、零宽、joiners、BOM、Tags、interlinear)→ 防 Trojan-Source 视觉伪造与零宽隐藏 / 分割;
+ *   - `\p{Zl}` / `\p{Zp}` 行 / 段分隔(U+2028 / 2029)→ LF 的 Unicode 孪生,防换行伪造;
+ *   - `\p{Mn}` / `\p{Me}` 非间距 / 封闭组合附加符 → 变可见,避免零前进宽度令列宽与终端错位
+ *     (间距组合符 `\p{Mc}` 合法占 1 列,保留);
+ *   - Hangul filler(U+115F / U+1160 / U+3164,属 Lo 不在上述任何类)→ 零宽显示诡计,补列。
+ */
+export declare function sanitizeCell(s: string): string;

package/dist/cli/lib/cell-format.js

@@ -0,0 +1,19 @@
+/**
+ * 终端展示前的不可信字符洗白——`omk list` 与 `omk promote` 共用。受管 JSON 可随仓库分发、用户可手改
+ * (store.ts validator 只收窄到「是字符串」,不卡内容),把它的字段(name / verdict / judgePromptHash /
+ * reportId / sourceLabel 等)塞进终端输出前必须先洗,否则 ANSI / OSC 转义、BiDi 重排、零宽分割会破坏排版
+ * 甚至伪造输出(清屏、改窗口标题、覆盖历史行误导审计)。一律映射到可见 U+FFFD;`--json` 路径保留原值
+ * (JSON.stringify 自带控制符转义,脚本消费要的是原始值)。
+ *
+ * 用 Unicode **属性类**而非手列码点 —— 手列清单天然有缺口(BiDi、U+2028 / 2029、Tags 块都曾漏一轮补一轮),
+ * 属性类一次覆盖整类、新码点自动纳入:
+ *   - `\p{Cc}` 控制符(C0 / C1 / DEL,含 ESC / 换行 / 回车 / TAB)→ 杀 ANSI / OSC 转义与终端控制;
+ *   - `\p{Cf}` 格式符(BiDi 重排 / 隔离、零宽、joiners、BOM、Tags、interlinear)→ 防 Trojan-Source 视觉伪造与零宽隐藏 / 分割;
+ *   - `\p{Zl}` / `\p{Zp}` 行 / 段分隔(U+2028 / 2029)→ LF 的 Unicode 孪生,防换行伪造;
+ *   - `\p{Mn}` / `\p{Me}` 非间距 / 封闭组合附加符 → 变可见,避免零前进宽度令列宽与终端错位
+ *     (间距组合符 `\p{Mc}` 合法占 1 列,保留);
+ *   - Hangul filler(U+115F / U+1160 / U+3164,属 Lo 不在上述任何类)→ 零宽显示诡计,补列。
+ */
+export function sanitizeCell(s) {
+    return s.replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}\p{Mn}\p{Me}ᅟᅠㅤ]/gu, '�');
+}

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;
@@ -149,6 +152,7 @@ export interface SampleFlags {
     batch: boolean;
     count?: string;
     model: string;
+    executor?: string;
     'skill-dir': string;
     focus?: string;
     'no-mock': boolean;
@@ -199,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;
@@ -221,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 {
@@ -229,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.d.ts

@@ -1,3 +1,3 @@
 import type { CliMessage } from './types.js';
-export type CommonMessageKey = 'cli.common.unknown_domain' | 'cli.common.error_prefix' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.skill_dir_no_skill_md' | 'cli.common.report_not_found' | 'cli.common.no_judge_model' | 'cli.common.judge_models_single_only' | 'cli.common.warn_load_samples_failed' | 'cli.update.new_version_available' | 'cli.update.box_title' | 'cli.update.box_version_line' | 'cli.update.box_upgrade_line' | 'cli.update.box_silence_line' | 'cli.observe.view_hint' | 'cli.studio.started' | 'cli.studio.stop_hint' | 'cli.studio.open_failed' | 'cli.doctor.no_skill_found' | 'cli.doctor.samples_detected';
+export type CommonMessageKey = 'cli.common.unknown_domain' | 'cli.common.error_prefix' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.skill_dir_no_skill_md' | 'cli.common.report_not_found' | 'cli.common.no_judge_model' | 'cli.common.judge_models_single_only' | 'cli.common.warn_load_samples_failed' | 'cli.update.new_version_available' | 'cli.update.box_title' | 'cli.update.box_version_line' | 'cli.update.box_upgrade_line' | 'cli.update.box_silence_line' | 'cli.observe.view_hint' | 'cli.studio.started' | 'cli.studio.stop_hint' | 'cli.studio.open_failed' | 'cli.doctor.no_skill_found' | 'cli.doctor.samples_detected' | 'cli.doctor.progress_skill_start' | 'cli.doctor.progress_skill_done';
 export declare const commonDict: Record<CommonMessageKey, CliMessage>;

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': {
@@ -79,4 +79,12 @@ export const commonDict = {
         zh: '✓ 使用评测用例文件：{path}',
         en: '✓ Using eval samples file: {path}',
     },
+    'cli.doctor.progress_skill_start': {
+        zh: '{prefix}{skill} ⏳ 体检中...\n',
+        en: '{prefix}{skill} ⏳ checking...\n',
+    },
+    'cli.doctor.progress_skill_done': {
+        zh: '{prefix}{skill} {result}（{ms}ms）\n',
+        en: '{prefix}{skill} {result} ({ms}ms)\n',
+    },
 };

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',

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

@@ -1,13 +1,10 @@
 export const helpDict = {
     'cli.help.observe': {
         zh: `
-omk observe——分析真实 session trace，生成 skill 健康度日报
+omk observe——分析真实 session trace，生成 skill 健康度报告
 
 用法：
   omk observe <sessions-dir> [options]
-  omk observe ingest <sessions-dir> [options]
-  omk observe inbox [options]
-  omk observe show <inbox_id> [options]
 
 选项：
   --kb <path>                         知识库根路径（默认：从 trace cwd 推断）
@@ -15,27 +12,16 @@ omk observe——分析真实 session trace，生成 skill 健康度日报
   --from <iso>                        窗口起点，优先级高于 --last
   --to <iso>                          窗口终点，优先级高于 --last
   --skills <n1,n2,...>                只分析指定 skill
-  --output-dir <path>                 输出目录（默认：~/.oh-my-knowledge/analyses）
-
-Inbox:
-  ingest --output-dir <path>           写入 observe inbox 数据（默认：.omk/observations；读取时兜底到 ~/.oh-my-knowledge/observations）
-  inbox --input-dir <path>             读取 observe inbox 数据
-  inbox --limit <n>                    展示 top N（默认：20）
-  inbox --skill <name>                 只看指定 skill
-  inbox --explore <n>                  从最近 50 条 medium/low 问题里抽样查看长尾
-  inbox --include-noise                --explore 时显式包含 noise 桶
-  inbox --by-skill                     按 skill 输出资产看板
-  inbox --json                         输出 JSON
-  show <inbox_id> --input-dir <path>    查看单条 observation 的前后上下文
+  --output-dir <path>                 输出目录（默认：项目级 .omk/observe-health）
+  --global                            写全局 ~/.oh-my-knowledge/observe-health，而非项目 .omk/
+
+观测收件箱（observe inbox）是另一条线，见 omk observe inbox --help。
 `,
         en: `
 omk observe — analyze production session traces and produce skill health reports
 
 Usage:
   omk observe <sessions-dir> [options]
-  omk observe ingest <sessions-dir> [options]
-  omk observe inbox [options]
-  omk observe show <inbox_id> [options]
 
 Options:
   --kb <path>                         Knowledge base root (default: infer from trace cwd)
@@ -43,18 +29,10 @@ Options:
   --from <iso>                        Window start, overrides --last
   --to <iso>                          Window end, overrides --last
   --skills <n1,n2,...>                Only analyze selected skills
-  --output-dir <path>                 Output directory (default: ~/.oh-my-knowledge/analyses)
-
-Inbox:
-  ingest --output-dir <path>           Write observe inbox data (default: .omk/observations; read fallback: ~/.oh-my-knowledge/observations)
-  inbox --input-dir <path>             Read observe inbox data
-  inbox --limit <n>                    Show top N (default: 20)
-  inbox --skill <name>                 Only show one skill
-  inbox --explore <n>                  Sample long-tail issues from the latest 50 medium/low items
-  inbox --include-noise                Explicitly include the noise bucket with --explore
-  inbox --by-skill                     Print the skill-level asset board
-  inbox --json                         Print JSON
-  show <inbox_id> --input-dir <path>    Show context around one observation
+  --output-dir <path>                 Output directory (default: project-level .omk/observe-health)
+  --global                            Write to global ~/.oh-my-knowledge/observe-health instead of project .omk/
+
+The observe inbox is a separate line; see omk observe inbox --help.
 `,
     },
     'cli.help.observe_ingest': {
@@ -65,7 +43,7 @@ omk observe ingest — 读取真实 session trace，写入 observe inbox 数据
   omk observe ingest <sessions-dir-or-file> [options]
 
 选项：
-  --output-dir <path>                输出目录（默认：.omk/observations；读取时兜底到 ~/.oh-my-knowledge/observations）
+  --output-dir <path>                输出目录（默认：.omk/observe-inbox；读取时兜底到 ~/.oh-my-knowledge/observe-inbox）
 
 支持：
   Claude Code JSONL
@@ -78,7 +56,7 @@ Usage:
   omk observe ingest <sessions-dir-or-file> [options]
 
 Options:
-  --output-dir <path>                Output directory (default: .omk/observations; read fallback: ~/.oh-my-knowledge/observations)
+  --output-dir <path>                Output directory (default: .omk/observe-inbox; read fallback: ~/.oh-my-knowledge/observe-inbox)
 
 Supported:
   Claude Code JSONL
@@ -93,7 +71,7 @@ omk observe inbox — 查看已写入的 observe inbox 问题列表
   omk observe inbox [options]
 
 选项：
-  --input-dir <path>                 读取目录（默认：.omk/observations；兜底到 ~/.oh-my-knowledge/observations）
+  --input-dir <path>                 读取目录（默认：.omk/observe-inbox；兜底到 ~/.oh-my-knowledge/observe-inbox）
   --limit <n>                        展示 top N（默认：20）
   --skill <name>                     只看指定 skill
   --explore <n>                      从最近 50 条 medium/low 问题里抽样查看长尾
@@ -112,7 +90,7 @@ Usage:
   omk observe inbox [options]
 
 Options:
-  --input-dir <path>                 Input directory (default: .omk/observations; fallback: ~/.oh-my-knowledge/observations)
+  --input-dir <path>                 Input directory (default: .omk/observe-inbox; fallback: ~/.oh-my-knowledge/observe-inbox)
   --limit <n>                        Show top N (default: 20)
   --skill <name>                     Only show one skill
   --explore <n>                      Sample long-tail issues from the latest 50 medium/low items
@@ -133,7 +111,7 @@ omk observe show — 查看单条 observation 的原始上下文
   omk observe show <inbox_id> [options]
 
 选项：
-  --input-dir <path>                 读取目录（默认：.omk/observations；兜底到 ~/.oh-my-knowledge/observations）
+  --input-dir <path>                 读取目录（默认：.omk/observe-inbox；兜底到 ~/.oh-my-knowledge/observe-inbox）
 `,
         en: `
 omk observe show — inspect the raw context around one observation
@@ -142,7 +120,7 @@ Usage:
   omk observe show <inbox_id> [options]
 
 Options:
-  --input-dir <path>                 Input directory (default: .omk/observations; fallback: ~/.oh-my-knowledge/observations)
+  --input-dir <path>                 Input directory (default: .omk/observe-inbox; fallback: ~/.oh-my-knowledge/observe-inbox)
 `,
     },
     'cli.help.evolve': {
@@ -243,16 +221,18 @@ omk studio——打开本地知识工作台
 选项：
   --port <n>                          本地服务端口（默认：7799）
   --host <host>                       监听地址（默认：127.0.0.1；局域网访问可用 0.0.0.0）
-  --reports-dir <path>                报告目录（默认：~/.oh-my-knowledge/reports）
-  --analyses-dir <path>               观测分析目录
-  --observations-dir <path>           observe inbox 数据目录（默认：.omk/observations）
+  --reports-dir <path>                只看指定报告目录（默认机器级聚合：当前项目 + 全局 + 别项目索引）
+  --analyses-dir <path>               观测健康报告目录（默认：项目级 .omk/observe-health，空则全局兜底）
+  --doctors-dir <path>                体检报告目录（默认：项目级 .omk/doctors，空则全局兜底）
+  --observations-dir <path>           observe inbox 数据目录（默认：.omk/observe-inbox）
+  --global                            只看全局 reports / observe-health / doctors 目录（~/.oh-my-knowledge/*），而非机器级聚合 / 项目优先；managed / observe-inbox 不受影响
   --no-open                           只启动服务，不自动打开浏览器
   --dev                               开发模式：文件变化时自动重启
 
 示例：
   omk studio
   omk studio --port 7798
-  omk studio --host 0.0.0.0 --observations-dir .omk/observations
+  omk studio --host 0.0.0.0 --observations-dir .omk/observe-inbox
   omk studio --no-open
 `,
         en: `
@@ -264,16 +244,18 @@ Usage:
 Options:
   --port <n>                          Local server port (default: 7799)
   --host <host>                       Listen address (default: 127.0.0.1; use 0.0.0.0 for LAN access)
-  --reports-dir <path>                Reports directory (default: ~/.oh-my-knowledge/reports)
-  --analyses-dir <path>               Observation analyses directory
-  --observations-dir <path>           Observe inbox data directory (default: .omk/observations)
+  --reports-dir <path>                View only this reports dir (default aggregates machine-wide: current project + global + other projects via index)
+  --analyses-dir <path>               Observe-health reports dir (default: project .omk/observe-health, falls back to global)
+  --doctors-dir <path>                Doctor reports dir (default: project .omk/doctors, falls back to global)
+  --observations-dir <path>           Observe inbox data directory (default: .omk/observe-inbox)
+  --global                            View only global reports / observe-health / doctors dirs (~/.oh-my-knowledge/*) instead of machine-wide / project-first; does not affect managed / observe-inbox
   --no-open                           Start the server without opening a browser
   --dev                               Dev mode: restart on file changes
 
 Examples:
   omk studio
   omk studio --port 7798
-  omk studio --host 0.0.0.0 --observations-dir .omk/observations
+  omk studio --host 0.0.0.0 --observations-dir .omk/observe-inbox
   omk studio --no-open
 `,
     },

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

@@ -1,7 +1,7 @@
 export const initDict = {
     'cli.init.scaffolded': {
-        zh: '已初始化测评项目: {dir}',
-        en: 'Eval project scaffolded at: {dir}',
+        zh: '已初始化 omk 项目: {dir}',
+        en: 'omk project initialized at: {dir}',
     },
     'cli.init.next_steps_title': {
         zh: '下一步:',

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

@@ -1,3 +1,3 @@
 import type { CliMessage } from './types.js';
-export type ListMessageKey = 'cli.list.header' | 'cli.list.empty' | 'cli.list.empty_hint' | 'cli.list.col_name' | 'cli.list.col_kind' | 'cli.list.col_state' | 'cli.list.col_verdict' | 'cli.list.col_evidence' | 'cli.list.col_source' | 'cli.list.drift_note' | 'cli.list.unreachable_note' | 'cli.list.legend';
+export type ListMessageKey = 'cli.list.header' | 'cli.list.empty' | 'cli.list.empty_hint' | 'cli.list.col_name' | 'cli.list.col_kind' | 'cli.list.col_state' | 'cli.list.col_verdict' | 'cli.list.col_evidence' | 'cli.list.col_source' | 'cli.list.drift_note' | 'cli.list.unreachable_note' | 'cli.list.promoted_note' | 'cli.list.legend';
 export declare const listDict: Record<ListMessageKey, CliMessage>;

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

@@ -25,6 +25,10 @@ export const listDict = {
         zh: '? = 源此处不可达 / 拒读，drift 未核（非 stale）；本地 git 源请在原仓库根目录跑 omk list。\n',
         en: '? = source unreachable / refused here, drift unchecked (not stale); for a local git source run omk list from the original repo root.\n',
     },
+    'cli.list.promoted_note': {
+        zh: '✓ = 当前版本已按证据人工接受为 promoted（omk promote）。\n',
+        en: '✓ = current version accepted as promoted on evidence (omk promote).\n',
+    },
     'cli.list.legend': {
         zh: '证据列 = 当前有效 / 全部（历史含旧内容证据，供回滚）。\n',
         en: 'EVIDENCE column = current / total (history keeps old-content evidence for rollback).\n',

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

@@ -0,0 +1,3 @@
+import type { CliMessage } from './types.js';
+export type PromoteMessageKey = 'cli.promote.kind_unsupported' | 'cli.promote.not_managed' | 'cli.promote.blocked_header' | 'cli.promote.drifted' | 'cli.promote.no_current_evidence' | 'cli.promote.incomparable' | 'cli.promote.incomparable_unverified' | 'cli.promote.verdict_blocked' | 'cli.promote.force_hint' | 'cli.promote.force_reason_required' | 'cli.promote.promoted' | 'cli.promote.forced_override' | 'cli.promote.already_promoted';
+export declare const promoteDict: Record<PromoteMessageKey, CliMessage>;

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

@@ -0,0 +1,54 @@
+export const promoteDict = {
+    'cli.promote.kind_unsupported': {
+        zh: 'promote 暂仅支持 kind=skill；收到 {kind}。',
+        en: 'promote supports only kind=skill today; got {kind}.',
+    },
+    'cli.promote.not_managed': {
+        zh: '未找到受管记录 {name}（kind={kind}）。先用 omk install 纳管、omk eval 取证，再 promote。',
+        en: 'No managed record {name} (kind={kind}). Run omk install to register, omk eval to gather evidence, then promote.',
+    },
+    'cli.promote.blocked_header': {
+        zh: 'promote 被门禁拦下（{name}）：',
+        en: 'promote was blocked by the gate ({name}):',
+    },
+    'cli.promote.drifted': {
+        zh: '· 源已漂移或不可达：当前源内容与受管基线不一致，证据对应的是旧内容。重跑 omk eval 重新取证。',
+        en: '· source drifted or unreachable: current source content differs from the managed baseline; the evidence is for old content. Re-run omk eval.',
+    },
+    'cli.promote.no_current_evidence': {
+        zh: '· 当前内容没有评测证据，无法 promote（force 也不行）。先跑 omk eval 取证（omk list 看证据状态）。',
+        en: '· no evaluation evidence for the current content; cannot promote (not even with --force). Run omk eval first (omk list shows evidence status).',
+    },
+    'cli.promote.incomparable': {
+        zh: '· 证据的评委提示词指纹 {judgePromptHash} 不是当前评委：judge prompt 已变、旧 verdict 不可比。重跑 omk eval。',
+        en: '· evidence judge-prompt fingerprint {judgePromptHash} is not the current judge: the judge prompt changed, the old verdict is incomparable. Re-run omk eval.',
+    },
+    'cli.promote.incomparable_unverified': {
+        zh: '⚠️ 证据缺评委提示词指纹，无法核对可比性（按未核处理，不拦门禁）。',
+        en: '⚠️ evidence has no judge-prompt fingerprint; comparability cannot be verified (treated as unchecked, not blocking).',
+    },
+    'cli.promote.verdict_blocked': {
+        zh: '· 当前证据 verdict={verdict}，不在接受集（默认仅 PROGRESS；CAUTIOUS 需 --accept-cautious）。',
+        en: '· current evidence verdict={verdict} is not in the accepted set (default PROGRESS only; CAUTIOUS needs --accept-cautious).',
+    },
+    'cli.promote.force_hint': {
+        zh: '如确需越门，加 --force 并用 --reason 写明理由（会记为人工 override 决定）。',
+        en: 'To override anyway, pass --force with --reason (recorded as a human override decision).',
+    },
+    'cli.promote.force_reason_required': {
+        zh: '--force 必须同时提供非空 --reason，说明人工越门理由。',
+        en: '--force requires a non-empty --reason explaining the human override.',
+    },
+    'cli.promote.promoted': {
+        zh: '已 promote {name}：接受内容 {hash}（verdict={verdict},report={reportId}）。',
+        en: 'Promoted {name}: accepted content {hash} (verdict={verdict}, report={reportId}).',
+    },
+    'cli.promote.forced_override': {
+        zh: '⚠️ 已 --force 越门 promote {name}：接受内容 {hash}（被越过的 verdict={verdict}）。越门已记为人工决定。',
+        en: '⚠️ force-promoted {name}: accepted content {hash} (overridden verdict={verdict}). The override is recorded as a human decision.',
+    },
+    'cli.promote.already_promoted': {
+        zh: '{name} 的当前内容已 promote 过，无需重复（幂等，未改动记录）。',
+        en: '{name} current content is already promoted; nothing to do (idempotent, record untouched).',
+    },
+};

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

@@ -0,0 +1,3 @@
+import type { CliMessage } from './types.js';
+export type RollbackMessageKey = 'cli.rollback.kind_unsupported' | 'cli.rollback.not_managed' | 'cli.rollback.not_promoted' | 'cli.rollback.rolled_back' | 'cli.rollback.already_rolled_back';
+export declare const rollbackDict: Record<RollbackMessageKey, CliMessage>;

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

@@ -0,0 +1,22 @@
+export const rollbackDict = {
+    'cli.rollback.kind_unsupported': {
+        zh: 'rollback 暂仅支持 kind=skill；收到 {kind}。',
+        en: 'rollback supports only kind=skill today; got {kind}.',
+    },
+    'cli.rollback.not_managed': {
+        zh: '未找到受管记录 {name}（kind={kind}）。omk rollback 只作用于已 install 的 skill。',
+        en: 'No managed record {name} (kind={kind}). omk rollback only operates on installed skills.',
+    },
+    'cli.rollback.not_promoted': {
+        zh: '{name} 的当前内容未处于 promoted 态，无可回退（omk list 看生命周期状态）。',
+        en: '{name} current content is not promoted; nothing to roll back (omk list shows the lifecycle state).',
+    },
+    'cli.rollback.rolled_back': {
+        zh: '已回退 {name}：撤销当前内容 {hash} 的 promoted 接受（已记为人工决定）。源仍匹配受管基线则 omk list 回到 measurable，源已漂移则仍为 stale。',
+        en: 'Rolled back {name}: revoked the promoted acceptance of current content {hash} (recorded as a human decision). omk list shows measurable if the source still matches the managed baseline, or stale if it has drifted.',
+    },
+    'cli.rollback.already_rolled_back': {
+        zh: '{name} 的当前内容本就未 promoted，无需回退（幂等，未改动记录）。',
+        en: '{name} current content is already not promoted; nothing to do (idempotent, record untouched).',
+    },
+};

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

@@ -57,8 +57,10 @@ import { type HelpMessageKey } from './i18n-dict/help.js';
 import { type InitMessageKey } from './i18n-dict/init.js';
 import { type InstallMessageKey } from './i18n-dict/install.js';
 import { type ListMessageKey } from './i18n-dict/list.js';
+import { type PromoteMessageKey } from './i18n-dict/promote.js';
+import { type RollbackMessageKey } from './i18n-dict/rollback.js';
 import { type RunMessageKey } from './i18n-dict/run.js';
 import type { CliMessage } from './i18n-dict/types.js';
 export type { CliMessage } from './i18n-dict/types.js';
-export type CliMessageKey = CommonMessageKey | EvolveMessageKey | GenMessageKey | HelpMessageKey | InitMessageKey | InstallMessageKey | ListMessageKey | RunMessageKey;
+export type CliMessageKey = CommonMessageKey | EvolveMessageKey | GenMessageKey | HelpMessageKey | InitMessageKey | InstallMessageKey | ListMessageKey | PromoteMessageKey | RollbackMessageKey | RunMessageKey;
 export declare const CLI_DICT: Record<CliMessageKey, CliMessage>;

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

@@ -57,6 +57,8 @@ import { helpDict } from './i18n-dict/help.js';
 import { initDict } from './i18n-dict/init.js';
 import { installDict } from './i18n-dict/install.js';
 import { listDict } from './i18n-dict/list.js';
+import { promoteDict } from './i18n-dict/promote.js';
+import { rollbackDict } from './i18n-dict/rollback.js';
 import { runDict } from './i18n-dict/run.js';
 export const CLI_DICT = {
     ...commonDict,
@@ -66,5 +68,7 @@ export const CLI_DICT = {
     ...initDict,
     ...installDict,
     ...listDict,
+    ...promoteDict,
+    ...rollbackDict,
     ...runDict,
 };

package/dist/cli/lib/parse-run-config.d.ts

@@ -83,7 +83,6 @@ export interface ParseRunConfigResult {
      *  (e.g. repeat / judgeRepeat / bootstrap — handled in `commands/eval-runner.ts` for input validation). */
     evalConfig: EvalConfig | null;
 }
-export declare const DEFAULT_REPORTS_DIR: string;
 /**
  * 接 typed flags(来自 oclif Command.parse() 输出)。oclif strict 模式已经在
  * 上游对未知 flag 拦截 exit 2,这里不再 parseArgs。eval-runner 等业务 caller