@carljia/omd-dsh 0.1.5 → 0.1.8

package/README.md

@@ -1,10 +1,16 @@
 # @carljia/omd-dsh
 
-OMD 理念的 DSH 插件：两个 cordis 行 + 7 个模式 preset + 同步 CLI。总览、模式矩阵与安装见仓库根 [README.md](../../README.md)。
+OMD 理念的 DSH 插件：两个 cordis 行 + 7 个模式 preset + 同步 CLI。以 `dsh.bundle` 形式分发——`dsh plugin add @carljia/omd-dsh` 安装后重启即自动同步预设；也可全局安装后用 `omd-dsh sync`。总览、模式矩阵与安装见仓库根 [README.md](../../README.md)。
+
+## 分发：bundle + boot 行
+
+包声明 `dsh.bundle.patch` → `cordis.patch.yml`，后者注入宿主行 `@carljia/omd-dsh/boot`。该行在 profile 启动时执行与 `omd-dsh sync` 相同的内核（`lib/sync.js`）：渲染并复制 7 个 preset 与 `.omd-vendor/` 行模块、首次生成 `omd-matrix.json`。全程幂等、hash 保护、不覆盖本地修改。
+
+`.omd-vendor/` 里的行模块是**自包含 bundle**（`scripts/postbuild.mjs` 用 esbuild 把 schemastery / dsh-tools / dsh-llm / dsh-subagent 全部打进模块，唯一的例外是 `shared.js`——omd-mode 与 omd-task 共享的按 agent 键控状态，作为相对兄弟模块保持单一实例）。行模块不含任何 `@deepseek-ai/*` 导入，因此 sync **不需要知道 harness 装在哪里**，也不会出现"导入指向的树与运行进程不一致"导致的挂载失败——无论 DSH 从 npx 缓存、全局 npm 还是 profile bundles 加载 agent 机制都能工作。preset 组合里其余裸包名行（如 `@deepseek-ai/dsh-persona`）由 harness 的 loader 在运行时按宿主 base 解析。
 
 ## 行：omd-mode
 
-按模式（agent preset）固定模型路由。仅限 preset 作用域内挂载（无作用域挂载直接报错）。
+按模式（agent preset）固定模型路由。行模块是自包含 bundle，不再做 scope 守卫（bundle 内自带的 dsh-scope 副本读不到 harness 实例写入的 kScope Symbol，守卫会误报——见 docs/ARCHITECTURE.md）；请按 preset 组合挂载，误挂到全局组合会导致进程级钉模型。
 
 | 配置字段 | 含义 |
 |---|---|
@@ -20,7 +26,7 @@ OMD 理念的 DSH 插件：两个 cordis 行 + 7 个模式 preset + 同步 CLI
 1. 入口选择 == 矩阵模型 → 钉住矩阵模型（无操作）；
 2. 会话尚无任何请求（blank）且入口选择 == 挂载时的部署默认模型 → 视为未选择，钉住矩阵模型；
 3. 会话已跑过请求且刚发生 preset 切换（/mode 或 UI 选择，日志中 agent-preset/selected 在最后一次 request/header 之后）且入口选择 == 切换前的路由 → 新模式认领矩阵模型；
-4. 其余情况 → 入口选择与矩阵模型不同 = 用户显式切换：请求与 persona 变量均保持用户选择，本行在作用域 ctx 上记录 `omdModeOverride`（provider/model），omd-task 行据此把 deep tier 路由到用户选择的模型。
+4. 其余情况 → 入口选择与矩阵模型不同 = 用户显式切换：请求与 persona 变量均保持用户选择，本行在共享状态 `shared.js`（按顶层 agent 对象为键的 WeakMap）上记录用户选择，omd-task 行据此把 deep tier 路由到用户选择的模型。
 
 模型体验：persona 文本每次请求固定携带实际路由模型的声明；模式模型路由在 agent 生命周期内稳定（KV 前缀稳定）。
 
@@ -39,19 +45,19 @@ tier 差异化子代理委派（等价 OMD 的 task(category=…)）。仅限 pr
 
 模型可见参数：description（展示名）、prompt、tier（枚举见工具描述）、run_in_background（仅 continuable 模式）。工具描述枚举各 tier 的 hint 与模型，模型据此选型。
 
-**deep tier 与用户模型覆盖**：用户在 UI 显式切换模型后（omd-mode 让路并记录 `ctx.omdModeOverride`），名为 `deep` 的 tier 改用用户选择的模型（provider/model 整体替换），其余 tier 保持矩阵配置。
+**deep tier 与用户模型覆盖**：用户在 UI 显式切换模型后（omd-mode 让路并在 `shared.js` 里记录用户选择），名为 `deep` 的 tier 改用用户选择的模型（provider/model 整体替换），其余 tier 保持矩阵配置。
 
 ## CLI：omd-dsh
 
 ```
-omd-dsh <command> [--harness <路径>] [--dry-run]
+omd-dsh <command> [--dry-run]
 ```
 
-- `omd-dsh sync` — 把 presets/ 与 vendored 行模块同步到 `<DSH_HOME>/.agent-presets/`（hash 保护、orphan 报告、非管理目录零操作）。每个 preset 的 omd-mode / omd-task 行由用户矩阵 `<DSH_HOME>/omd-matrix.json` 渲染。
+- `omd-dsh sync` — 把 presets/ 与 vendored 行模块同步到 `<DSH_HOME>/.agent-presets/`（hash 保护、orphan 报告、非管理目录零操作）。每个 preset 的 omd-mode / omd-task 行由用户矩阵 `<DSH_HOME>/omd-matrix.json` 渲染。不需要任何 harness 路径配置。
 - `omd-dsh setup` — 交互式向导：先读取 DSH 已有模型，再引导逐模式/逐 tier 选择模型，写回 `<DSH_HOME>/omd-matrix.json` 并可选立即同步。
 - `omd-dsh models` — 打印发现的 DSH 模型目录（非交互）。
 
-细节见 docs/ARCHITECTURE.md 的「vendored 分发与跨树符号风险」。
+细节见 docs/ARCHITECTURE.md 的「vendored 分发与自包含 bundle」。
 
 ## 集中配置：<DSH_HOME>/omd-matrix.json
 
@@ -60,19 +66,20 @@ omd-dsh <command> [--harness <路径>] [--dry-run]
 ## 开发
 
 ```bash
-npm install     # 触发 build（tsc + postbuild）
-npm test        # vitest，39 个测试
+npm install     # 触发 build（tsc + esbuild 打包自包含 bundle）
+npm test        # vitest 全量测试
 npm pack        # prepack 自动重建，产出 tgz
 ```
 
-测试桩在 test/stubs/（dsh-scope/dsh-tools/dsh-subagent 的轻量替身），不依赖真实 harness。
+测试桩在 test/stubs/（dsh-tools/dsh-subagent 的轻量替身），不依赖真实 harness。
 
 
 ### 子代理透传语义
 
 omd-mode 对 subagentDepth > 0 的子代理一律透传（不覆盖 provider/model/变量）：
 omd-task 的 tier 模型通过显式 agentOptions 生效；顶层 agent 才被钉到模式模型
-（除非用户显式切换模型——此时顶层跟随用户选择，deep tier 通过 `ctx.omdModeOverride` 同步）。
+（除非用户显式切换模型——此时顶层跟随用户选择，deep tier 通过 `shared.js` 里
+按 agent 记录的覆盖值同步）。
 这保证「强模型顶层 + tier 差异化子代理」的优先级正确。
 
 ### toolFilter 注意

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# omd-dsh bundle patch: inject the boot row that, on startup, materializes
+# the 7 OMD agent presets into the user preset root (<DSH_HOME>/.agent-presets).
+#
+# The boot row (lib/boot.js) resolves the harness tree, copies the presets and
+# the vendored row modules, rewrites their @deepseek-ai/* imports to the harness,
+# and generates the model matrix on first run — idempotently. Install with:
+#   dsh plugin --profile web add @carljia/omd-dsh   # then restart dsh.
+- insert:
+    - id: omd-dsh
+      name: '@carljia/omd-dsh/boot'

package/lib/boot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module @carljia/omd-dsh/boot
+ *
+ * omd-dsh bundle boot row: materialize the 7 OMD agent presets into the user
+ * preset root (<DSH_HOME>/.agent-presets) when the profile boots, so
+ * "dsh plugin add @carljia/omd-dsh" + a restart is the whole install — no
+ * manual "omd-dsh sync" and no harness configuration needed.
+ *
+ * The sync is idempotent (hash-aware, conflict-protected) and reuses the same
+ * core as the "omd-dsh sync" CLI. The vendored rows are self-contained
+ * bundles (see scripts/postbuild.mjs), so the sync needs no harness tree
+ * knowledge and cannot break on harness/profile layout differences.
+ *
+ * A sync failure is logged, not thrown: a broken omd-dsh should never brick
+ * the host's boot.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "omd-dsh";
+/** No service injection: this row only runs its idempotent install at mount. */
+export declare const inject: string[];
+export declare function apply(ctx: any): Promise<void>;

package/lib/boot.js

@@ -0,0 +1,40 @@
+import { runSync } from "./sync.js";
+/**
+ * @module @carljia/omd-dsh/boot
+ *
+ * omd-dsh bundle boot row: materialize the 7 OMD agent presets into the user
+ * preset root (<DSH_HOME>/.agent-presets) when the profile boots, so
+ * "dsh plugin add @carljia/omd-dsh" + a restart is the whole install — no
+ * manual "omd-dsh sync" and no harness configuration needed.
+ *
+ * The sync is idempotent (hash-aware, conflict-protected) and reuses the same
+ * core as the "omd-dsh sync" CLI. The vendored rows are self-contained
+ * bundles (see scripts/postbuild.mjs), so the sync needs no harness tree
+ * knowledge and cannot break on harness/profile layout differences.
+ *
+ * A sync failure is logged, not thrown: a broken omd-dsh should never brick
+ * the host's boot.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export const name = "omd-dsh";
+/** No service injection: this row only runs its idempotent install at mount. */
+export const inject = [];
+function log(ctx, level, message) {
+    try {
+        const logger = ctx?.logger;
+        if (logger !== undefined && logger !== null) {
+            logger[level](message);
+            return;
+        }
+    }
+    catch { /* fall through to console */ }
+    (level === "error" ? console.error : console.log)(message);
+}
+export async function apply(ctx) {
+    try {
+        await runSync({ dryRun: false, verbose: false }, (message) => log(ctx, "info", message));
+    }
+    catch (error) {
+        log(ctx, "error", "omd-dsh: preset sync failed: " + (error instanceof Error ? error.message : String(error)));
+    }
+}