@carljia/omd-dsh 0.1.7 → 0.1.9

package/README.md

@@ -1,14 +1,29 @@
 # @carljia/omd-dsh
 
-OMD 理念的 DSH 插件：两个 cordis 行 + 7 个模式 preset + 同步 CLI。以 `dsh.bundle` 形式分发——`dsh plugin add @carljia/omd-dsh` 安装后重启即自动同步预设；也可全局安装后用 `omd-dsh sync`。总览、模式矩阵与安装见仓库根 [README.md](../../README.md)。
+OMD 理念的 DSH 插件：host 行 + 客户端设置页 + 7 个模式 preset + 同步 CLI。以 `dsh.bundle` 形式分发——`dsh plugin add @carljia/omd-dsh` 安装后重启即自动同步预设，并在设置面板出现「omd模型分配」页；也可全局安装后用 `omd-dsh sync`。总览、模式矩阵与安装见仓库根 [README.md](../../README.md)。
 
-## 分发：bundle + boot 行
+## 分发：bundle + host 行 + 客户端插件
 
-包声明 `dsh.bundle.patch` → `cordis.patch.yml`，后者注入宿主行 `@carljia/omd-dsh/boot`。该行在 profile 启动时执行与 `omd-dsh sync` 相同的内核（`lib/sync.js`）：定位 harness、渲染并复制 7 个 preset 与 `.omd-vendor/` 行模块、把行模块的 `@deepseek-ai/*` 导入改写为 harness 树的 `file://` URL、首次生成 `omd-matrix.json`。全程幂等、hash 保护、不覆盖本地修改。
+包声明 `dsh.bundle.patch` → `cordis.patch.yml`，后者注入宿主行 `@carljia/omd-dsh`（包根，`lib/host.js`）。该行在 profile 启动时执行与 `omd-dsh sync` 相同的内核（`lib/sync.js`）并额外注册 settings 命名空间（见下节「设置页与数据流」）。**注入名必须是包根而不是 `/boot` 子路径**：`dsh-client-modules` 按 loader entry 的 `options.name` == 包名来发现客户端插件（读取 `dsh.client` 与 `exports["./client"]`），浏览器 half（`lib/client.js`，见下）由此被发现。`lib/boot.js` 保留为无 settings 场景的手动回退行，仍可通过 `@carljia/omd-dsh/boot` 挂载。
+
+`.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模型分配」与数据流
+
+设置 → 左侧导航 →「omd模型分配」（en: OMD model allocation）可视化编辑 7 个模式的模型矩阵（顶层 provider/model + 可选 reasoningEffort；有 tier 的模式逐档展示 provider/model，tier 的 `hint` 只读展示便于理解档位用途）。保存后**新会话**按新矩阵路由模型，运行中的会话保持创建时的组合。
+
+数据流（详见 docs/ARCHITECTURE.md「settings 命名空间数据流」）：
+
+- `settings.yaml` 的命名空间 `omd-model-allocation` 是**在线编辑的权威存储**（宿主行注册，`base` = 随包默认矩阵 `omd-matrix.default.json`，`applies: "live"`）。
+- 启动时宿主行**调和一次**：若 `<DSH_HOME>/omd-matrix.json` 存在且与命名空间解析值不同，把文件内容 `replace` 进命名空间——旧版/CLI 的自定义不丢，CLI 手改在下次重启被采纳。
+- 用命名空间解析出的完整矩阵渲染 presets，并写回 `omd-matrix.json`（**导出镜像 + CLI 兼容面**）。
+- 监听命名空间：UI 每次保存 → 重新渲染 presets + 更新镜像文件。保存走 `settings.replace`，携带 `expectedRevision`，冲突（`settings-rejected`）时拒绝并重载最新值。
+- `omd-dsh setup` / `omd-dsh sync` CLI 保持不变（读写 `omd-matrix.json`）；宿主运行中直接改文件不会实时生效，与「运行中会话不变、新会话重新 sync」的既有语义一致。
+- 边界：settings.yaml 中该段损坏 → 宿主回退纯文件 sync（老 boot 行为），不阻断启动；`omd-matrix.json` 缺失/损坏 → 用命名空间（默认矩阵）渲染并重建镜像；远程浏览器（非 loopback）→ 设置页只读/不可用；settings 只读 → 客户端禁用保存、宿主仍按解析值渲染。
 
 ## 行：omd-mode
 
-按模式（agent preset）固定模型路由。仅限 preset 作用域内挂载（无作用域挂载直接报错）。
+按模式（agent preset）固定模型路由。行模块是自包含 bundle，不再做 scope 守卫（bundle 内自带的 dsh-scope 副本读不到 harness 实例写入的 kScope Symbol，守卫会误报——见 docs/ARCHITECTURE.md）；请按 preset 组合挂载，误挂到全局组合会导致进程级钉模型。
 
 | 配置字段 | 含义 |
 |---|---|
@@ -24,7 +39,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 前缀稳定）。
 
@@ -43,40 +58,46 @@ 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 与 settings.yaml 命名空间
+
+所有模式的模型路由（provider/model/reasoningEffort）与 omd_task 各 tier 的模型集中在用户矩阵里。两种入口，同一份数据：
 
-## 集中配置：<DSH_HOME>/omd-matrix.json
+- **在线编辑（推荐）**：设置 →「omd模型分配」。保存写入 `settings.yaml` 的 `omd-model-allocation` 命名空间，宿主立即重渲染 presets 并把矩阵镜像回 `<DSH_HOME>/omd-matrix.json`。
+- **CLI**：`omd-dsh setup`（交互向导）/ 手改 `omd-matrix.json` 后 `omd-dsh sync`。宿主运行中直接改文件不会实时生效；下次重启时宿主把文件导入命名空间（与「新会话重新 sync」语义一致）。
 
-所有模式的模型路由（provider/model/reasoningEffort）与 omd_task 各 tier 的模型集中在用户矩阵 `<DSH_HOME>/omd-matrix.json`（默认 `~/.dsh/omd-matrix.json`）：`omd-dsh sync` 首次运行把随包的 deepseek 默认矩阵 `omd-matrix.default.json` 复制为默认配置（或从旧版本包内位置迁移一次），`omd-dsh setup` 更新它，`omd-dsh sync` 读取它并渲染进各 preset。仓库与 npm 包只携带默认矩阵文件，**不含任何个人模型配置**——个人模型配置只留在本机。preset 里 `# [omd-dsh:mode:start] / [omd-dsh:mode:end]` 与 `# [omd-dsh:task:start] / [omd-dsh:task:end]` 之间的区域是自动生成的——改模型请改矩阵后跑 sync，不要手改 fence 之间的内容。
+`omd-dsh sync` 首次运行把随包的 deepseek 默认矩阵 `omd-matrix.default.json` 复制为默认配置（或从旧版本包内位置迁移一次）。仓库与 npm 包只携带默认矩阵文件，**不含任何个人模型配置**——个人模型配置只留在本机（`~/.dsh/settings.yaml` 或 `~/.dsh/omd-matrix.json`）。preset 里 `# [omd-dsh:mode:start] / [omd-dsh:mode:end]` 与 `# [omd-dsh:task:start] / [omd-dsh:task:end]` 之间的区域是自动生成的——改模型请走设置页或矩阵后跑 sync，不要手改 fence 之间的内容。
 
 ## 开发
 
 ```bash
-npm install     # 触发 build（tsc + postbuild）
-npm test        # vitest，39 个测试
+npm install     # 触发 build（tsc + esbuild 打包自包含 bundle + 客户端 bundle）
+npm test        # vitest 全量测试
 npm pack        # prepack 自动重建，产出 tgz
 ```
 
-测试桩在 test/stubs/（dsh-scope/dsh-tools/dsh-subagent 的轻量替身），不依赖真实 harness。
+构建产出：`lib/host.js`（宿主行）、`lib/client.js`（客户端 bundle，`window.__ModuleLoader__.load` 信封 + esbuild CJS，仅外部依赖 react）、`lib/vendor/*.mjs`（自包含行 bundle）。测试桩在 test/stubs/（dsh-tools/dsh-subagent 的轻量替身），不依赖真实 harness；`test/sync.test.ts` / `test/host.test.ts` / `test/client-store.test.ts` 覆盖矩阵注入渲染、启动调和判定与客户端保存状态机。
 
 
 ### 子代理透传语义
 
 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

@@ -1,10 +1,17 @@
-# 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).
+# omd-dsh bundle patch: inject the host row under the PACKAGE ROOT name.
 #
-# 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:
+# The row (lib/host.js) registers the `omd-model-allocation` settings
+# namespace (settings.yaml = online-edit source), imports CLI/legacy edits
+# from <DSH_HOME>/omd-matrix.json once at startup, renders the 7 OMD presets
+# from the resolved matrix, mirrors the matrix back to omd-matrix.json, and
+# re-renders + re-mirrors on every UI save.
+#
+# The entry name MUST be the bare package name `@carljia/omd-dsh`, not a
+# subpath: dsh-client-modules discovers client plugins by matching loader
+# entry names against package names (reading dsh.client + exports["./client"]),
+# and the browser half (lib/client.js) provides the "omd模型分配" settings
+# section. Install with:
 #   dsh plugin --profile web add @carljia/omd-dsh   # then restart dsh.
 - insert:
     - id: omd-dsh
-      name: '@carljia/omd-dsh/boot'
+      name: '@carljia/omd-dsh'

package/lib/boot.d.ts

@@ -4,12 +4,12 @@
  * 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" needed.
+ * 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 harness node_modules is located from
- * this module's own resolution path first (the profile exposes the harness
- * tree via its flat module fallback), then through the CLI's detection chain.
+ * 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.

package/lib/boot.js

@@ -1,16 +1,16 @@
-import { runSync, resolveHarnessFromSelf, resolveHarness } from "./sync.js";
+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" needed.
+ * 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 harness node_modules is located from
- * this module's own resolution path first (the profile exposes the harness
- * tree via its flat module fallback), then through the CLI's detection chain.
+ * 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.
@@ -32,12 +32,7 @@ function log(ctx, level, message) {
 }
 export async function apply(ctx) {
     try {
-        const harness = resolveHarnessFromSelf() ?? resolveHarness({ harness: undefined, dryRun: false, verbose: false });
-        if (harness === undefined) {
-            log(ctx, "error", "omd-dsh: cannot locate the DSH harness node_modules — presets were not synced. Run `omd-dsh sync --harness <path>` once to point it at the harness, then restart.");
-            return;
-        }
-        await runSync({ harness: undefined, dryRun: false, verbose: false }, harness, (message) => log(ctx, "info", message));
+        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)));

package/lib/cli.js

@@ -2,7 +2,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { createInterface } from "node:readline/promises";
-import { runSync, resolveHarness, loadMatrix, saveMatrix, dshHome, MATRIX_PATH, } from "./sync.js";
+import { runSync, loadMatrix, saveMatrix, dshHome, MATRIX_PATH, } from "./sync.js";
 /**
  * omd-dsh CLI
  *
@@ -15,7 +15,9 @@ import { runSync, resolveHarness, loadMatrix, saveMatrix, dshHome, MATRIX_PATH,
  *
  * The sync core lives in ./sync.js and is also invoked automatically by the
  * bundle boot row (lib/boot.js), so `dsh plugin add @carljia/omd-dsh` + restart
- * installs the presets without this CLI.
+ * installs the presets without this CLI. The vendored rows are self-contained
+ * bundles: no `--harness` flag exists because the sync needs no harness tree
+ * knowledge.
  */
 function usage() {
     return [
@@ -25,7 +27,6 @@ function usage() {
         "    setup    interactive: discover DSH models, then guide per-mode/tier model selection",
         "    models   print the discovered DSH model catalog",
         "  options:",
-        "    --harness <path>  node_modules dir of the DSH harness install (saved locally after first use; otherwise auto-detected)",
         "    --dry-run         (sync) print planned writes without touching the filesystem",
         "    --verbose         (sync) print per-file detail",
     ].join("\n");
@@ -73,7 +74,7 @@ function splitModel(answer) {
     }
     return { provider: "deepseek-official", model: a };
 }
-async function runSetup(flags, harnessNodeModules) {
+async function runSetup(flags) {
     const matrix = loadMatrix(flags);
     const { models, currentDefault } = discoverModels();
     console.log("omd-dsh setup: 发现 DSH 已有模型：");
@@ -112,12 +113,7 @@ async function runSetup(flags, harnessNodeModules) {
     const syncNow = await ask("是否立即同步到 " + join(dshHome(), ".agent-presets") + "? [Y/n] ");
     rl.close();
     if (syncNow === "" || /^y/i.test(syncNow)) {
-        if (harnessNodeModules === undefined) {
-            console.error("omd-dsh setup: 无法定位 DSH harness node_modules，跳过同步。首次请运行 `omd-dsh sync --harness <路径>`（之后会自动缓存，无需重复指定）。");
-        }
-        else {
-            await runSync(flags, harnessNodeModules);
-        }
+        await runSync(flags);
     }
     else {
         console.log("omd-dsh setup: 已跳过同步；稍后运行 `omd-dsh sync` 生效。");
@@ -130,9 +126,7 @@ async function main() {
     let command = "";
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
-        if (arg === "--harness")
-            flags.harness = argv[++i];
-        else if (arg === "--dry-run")
+        if (arg === "--dry-run")
             flags.dryRun = true;
         else if (arg === "--verbose")
             flags.verbose = true;
@@ -163,16 +157,10 @@ async function main() {
         return;
     }
     if (command === "setup") {
-        await runSetup(flags, resolveHarness(flags));
-        return;
-    }
-    const harnessNodeModules = resolveHarness(flags);
-    if (harnessNodeModules === undefined || !existsSync(join(harnessNodeModules, "@deepseek-ai", "dsh-scope", "package.json"))) {
-        console.error("omd-dsh sync: cannot locate the DSH harness node_modules.\n  - ensure the dsh executable is on PATH, or\n  - pass --harness <path to the harness node_modules directory> (saved for later runs).\n\n" + usage());
-        process.exitCode = 2;
+        await runSetup(flags);
         return;
     }
-    await runSync(flags, harnessNodeModules);
+    await runSync(flags);
 }
 main().catch((error) => {
     console.error("omd-dsh failed: " + (error instanceof Error ? error.message : String(error)));

package/lib/client.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+import { OmdMatrixController } from "./omd-matrix-controller.js";
+import type { OmdScope } from "./omd-matrix-controller.js";
+/** Cordis services this browser plugin requires (fiber service waiting). */
+export declare const inject: string[];
+export declare function apply(ctx: any): void;
+export declare function OmdModelAllocationSection(props: {
+    scope: OmdScope;
+    controller: OmdMatrixController;
+    t: (key: string) => string;
+}): React.ReactElement;