@carljia/omd-dsh 0.1.8 → 0.1.9

package/README.md

@@ -1,13 +1,26 @@
 # @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`）：渲染并复制 7 个 preset 与 `.omd-vendor/` 行模块、首次生成 `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）固定模型路由。行模块是自包含 bundle，不再做 scope 守卫（bundle 内自带的 dsh-scope 副本读不到 harness 实例写入的 kScope Symbol，守卫会误报——见 docs/ARCHITECTURE.md）；请按 preset 组合挂载，误挂到全局组合会导致进程级钉模型。
@@ -59,19 +72,24 @@ omd-dsh <command> [--dry-run]
 
 细节见 docs/ARCHITECTURE.md 的「vendored 分发与自包含 bundle」。
 
-## 集中配置：<DSH_HOME>/omd-matrix.json
+## 集中配置：<DSH_HOME>/omd-matrix.json 与 settings.yaml 命名空间
+
+所有模式的模型路由（provider/model/reasoningEffort）与 omd_task 各 tier 的模型集中在用户矩阵里。两种入口，同一份数据：
+
+- **在线编辑（推荐）**：设置 →「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 + esbuild 打包自包含 bundle）
+npm install     # 触发 build（tsc + esbuild 打包自包含 bundle + 客户端 bundle）
 npm test        # vitest 全量测试
 npm pack        # prepack 自动重建，产出 tgz
 ```
 
-测试桩在 test/stubs/（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` 覆盖矩阵注入渲染、启动调和判定与客户端保存状态机。
 
 
 ### 子代理透传语义

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/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;

package/lib/client.js

@@ -0,0 +1,427 @@
+window.__ModuleLoader__.load({
+	id: "@carljia/omd-dsh",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/client.tsx
+var client_exports = {};
+__export(client_exports, {
+  OmdModelAllocationSection: () => OmdModelAllocationSection,
+  apply: () => apply,
+  inject: () => inject
+});
+module.exports = __toCommonJS(client_exports);
+var React = __toESM(require("react"), 1);
+
+// src/omd-matrix-controller.ts
+var OMD_SETTINGS_NS = "omd-model-allocation";
+function cloneMatrix(value) {
+  if (value === void 0) return null;
+  return JSON.parse(JSON.stringify(value));
+}
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var OmdMatrixController = class {
+  constructor(api, scope, describe) {
+    __publicField(this, "api", api);
+    __publicField(this, "scope", scope);
+    __publicField(this, "describe", describe);
+    __publicField(this, "draft");
+    __publicField(this, "status", "idle");
+    __publicField(this, "error", null);
+    __publicField(this, "saved", false);
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+    __publicField(this, "unsubscribeScope");
+    /**
+     * Cached snapshot handed to `useSyncExternalStore`. React requires
+     * `getSnapshot()` to return the SAME reference between changes — a fresh
+     * object per call throws "The result of getSnapshot should be cached" and
+     * crashes the whole settings entry (blank page). Rebuilt only in `emit()`.
+     */
+    __publicField(this, "snapshot");
+    this.draft = cloneMatrix(scope.getSnapshot().value);
+    this.snapshot = { draft: this.draft, status: this.status, error: this.error, saved: this.saved };
+    this.unsubscribeScope = scope.subscribe(() => this.onScopeChange());
+  }
+  /** Release the scope subscription (plugin fiber teardown). */
+  dispose() {
+    this.unsubscribeScope();
+    this.listeners.clear();
+  }
+  /** Stable snapshot reference (uSES-safe): the SAME object until state changes. */
+  getSnapshot() {
+    return this.snapshot;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  emit() {
+    this.snapshot = { draft: this.draft, status: this.status, error: this.error, saved: this.saved };
+    for (const listener of [...this.listeners]) listener();
+  }
+  /** External change (mirror reload after a rejected write, another window):
+   *  rebuild the draft from the fresh value, unless a save is in flight. */
+  onScopeChange() {
+    if (this.status === "saving") return;
+    this.refreshDraft();
+    this.emit();
+  }
+  refreshDraft() {
+    const value = this.scope.getSnapshot().value;
+    if (value !== void 0) this.draft = cloneMatrix(value);
+  }
+  /** Whether the Save / Reset controls may run. */
+  get canSave() {
+    const snap = this.scope.getSnapshot();
+    return snap.status === "ready" && snap.writable && this.status !== "saving" && this.draft !== null;
+  }
+  /** Whether the namespace accepts writes at all (read-only provider / memory mode). */
+  get writable() {
+    return this.scope.getSnapshot().writable;
+  }
+  /** Edit one mode's top-level field; an empty string removes the override
+   *  (the field re-inherits the composition base / schema default). */
+  patchMode(modeId, field, value) {
+    const draft = this.draft;
+    if (draft === null) return;
+    const modes = { ...draft.modes };
+    const cfg = { ...modes[modeId] ?? {} };
+    if (value === "") delete cfg[field];
+    else cfg[field] = value;
+    modes[modeId] = cfg;
+    this.draft = { ...draft, modes };
+    this.saved = false;
+    this.emit();
+  }
+  /** Edit one tier's provider/model; an empty string removes the override. */
+  patchTier(modeId, tier, field, value) {
+    const draft = this.draft;
+    if (draft === null) return;
+    const modes = { ...draft.modes };
+    const cfg = { ...modes[modeId] ?? {} };
+    const tiers = { ...cfg.tiers ?? {} };
+    const tierCfg = { ...tiers[tier] ?? {} };
+    if (value === "") delete tierCfg[field];
+    else tierCfg[field] = value;
+    tiers[tier] = tierCfg;
+    cfg.tiers = tiers;
+    modes[modeId] = cfg;
+    this.draft = { ...draft, modes };
+    this.saved = false;
+    this.emit();
+  }
+  /**
+   * Persist the whole draft matrix through `settings.replace` (wholesale
+   * section replacement — the removal/reset path merge cannot express). The
+   * revision fence makes a stale editor fail loudly instead of overwriting.
+   * @returns once the write settled and the snapshot reflects the outcome.
+   */
+  async save() {
+    if (!this.canSave || this.draft === null) return;
+    const snap = this.scope.getSnapshot();
+    this.status = "saving";
+    this.error = null;
+    this.emit();
+    const response = await this.replace({ section: this.draft, revision: snap.revision });
+    if (response.ok) this.saved = true;
+    else {
+      this.error = response.message;
+      await this.describe.load();
+    }
+    this.refreshDraft();
+    this.status = "idle";
+    this.emit();
+  }
+  /** Restore the shipped default matrix: replace with an empty section. */
+  async reset() {
+    if (!this.canSave) return;
+    const snap = this.scope.getSnapshot();
+    this.status = "saving";
+    this.error = null;
+    this.emit();
+    const response = await this.replace({ section: {}, revision: snap.revision });
+    if (response.ok) this.saved = true;
+    else this.error = response.message;
+    await this.describe.load();
+    this.refreshDraft();
+    this.status = "idle";
+    this.emit();
+  }
+  async replace(request) {
+    try {
+      const response = await this.api.settings.replace({
+        ns: OMD_SETTINGS_NS,
+        section: request.section,
+        ...request.revision === void 0 ? {} : { expectedRevision: request.revision }
+      });
+      if (response.result.ok) return { ok: true };
+      return { ok: false, message: response.result.error.message };
+    } catch (error) {
+      return { ok: false, message: messageOf(error) };
+    }
+  }
+};
+
+// src/client.tsx
+var NS = "settings.omd";
+var MODE_ORDER = ["executor", "ultraworker", "planner", "reviewer", "explorer", "librarian", "chat"];
+var en = {
+  nav: "OMD model allocation",
+  title: "OMD model allocation",
+  intro: "Model routes for the 7 OMD agent presets. Changes apply to sessions you start from now on \u2014 running sessions keep the models they began with.",
+  loading: "Loading the model matrix\u2026",
+  unavailable: "The model matrix is not available from this browser (settings are process-local for remote connections).",
+  readOnly: "The settings document is read-only here; the current matrix is shown for reference.",
+  mode: "Mode",
+  provider: "Provider",
+  model: "Model",
+  reasoningEffort: "Reasoning effort",
+  reasoningEffortHint: "Optional; leave empty to let the provider decide.",
+  tiers: "Tiers",
+  tier: "Tier",
+  hint: "Purpose",
+  save: "Save",
+  saving: "Saving\u2026",
+  reset: "Restore defaults",
+  saved: "Saved \u2014 new sessions will use the new matrix.",
+  errorPrefix: "Save failed:",
+  renderError: "The model matrix form could not be rendered:",
+  conflict: "The matrix changed on the host; the form was reloaded with the latest values.",
+  executor: "Executor",
+  ultraworker: "Ultraworker",
+  planner: "Planner",
+  reviewer: "Reviewer",
+  explorer: "Explorer",
+  librarian: "Librarian",
+  chat: "Chat"
+};
+var zh = {
+  nav: "omd\u6A21\u578B\u5206\u914D",
+  title: "omd \u6A21\u578B\u5206\u914D",
+  intro: "7 \u4E2A OMD agent \u9884\u8BBE\u7684\u6A21\u578B\u8DEF\u7531\u3002\u4FDD\u5B58\u540E\u5BF9\u4E4B\u540E\u65B0\u5EFA\u7684\u4F1A\u8BDD\u751F\u6548\u2014\u2014\u8FD0\u884C\u4E2D\u7684\u4F1A\u8BDD\u4FDD\u6301\u5B83\u5F00\u59CB\u65F6\u7684\u6A21\u578B\u3002",
+  loading: "\u6B63\u5728\u52A0\u8F7D\u6A21\u578B\u77E9\u9635\u2026",
+  unavailable: "\u5F53\u524D\u6D4F\u89C8\u5668\u65E0\u6CD5\u8BBF\u95EE\u6A21\u578B\u77E9\u9635\uFF08\u8FDC\u7A0B\u8FDE\u63A5\u65F6\u8BBE\u7F6E\u4EC5\u5728\u672C\u673A\u8FDB\u7A0B\u5185\u6709\u6548\uFF09\u3002",
+  readOnly: "\u8BBE\u7F6E\u6587\u6863\u5F53\u524D\u53EA\u8BFB\uFF1B\u4EE5\u4E0B\u5C55\u793A\u73B0\u6709\u77E9\u9635\uFF0C\u4EC5\u4F9B\u53C2\u8003\u3002",
+  mode: "\u6A21\u5F0F",
+  provider: "Provider",
+  model: "Model",
+  reasoningEffort: "\u63A8\u7406\u5F3A\u5EA6",
+  reasoningEffortHint: "\u53EF\u9009\uFF1B\u7559\u7A7A\u4EA4\u7ED9 provider \u9ED8\u8BA4\u3002",
+  tiers: "\u6863\u4F4D\uFF08Tiers\uFF09",
+  tier: "\u6863\u4F4D",
+  hint: "\u7528\u9014",
+  save: "\u4FDD\u5B58",
+  saving: "\u4FDD\u5B58\u4E2D\u2026",
+  reset: "\u6062\u590D\u9ED8\u8BA4",
+  saved: "\u5DF2\u4FDD\u5B58\u2014\u2014\u65B0\u4F1A\u8BDD\u5C06\u6309\u65B0\u77E9\u9635\u8DEF\u7531\u6A21\u578B\u3002",
+  errorPrefix: "\u4FDD\u5B58\u5931\u8D25\uFF1A",
+  renderError: "\u6A21\u578B\u77E9\u9635\u8868\u5355\u6E32\u67D3\u5931\u8D25\uFF1A",
+  conflict: "\u77E9\u9635\u5DF2\u5728\u5BBF\u4E3B\u4FA7\u53D8\u66F4\uFF0C\u8868\u5355\u5DF2\u6309\u6700\u65B0\u503C\u91CD\u65B0\u52A0\u8F7D\u3002",
+  executor: "\u6267\u884C\u8005",
+  ultraworker: "\u8D85\u80FD\u5DE5\u4F5C\u8005",
+  planner: "\u89C4\u5212\u8005",
+  reviewer: "\u8BC4\u5BA1\u8005",
+  explorer: "\u63A2\u7D22\u8005",
+  librarian: "\u56FE\u4E66\u7BA1\u7406\u5458",
+  chat: "\u5BF9\u8BDD"
+};
+var inject = ["slots", "locale", "connection", "settingsScope"];
+function apply(ctx) {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), "omd-dsh: settings section dictionaries");
+  const { api } = ctx.get("connection");
+  const describe = ctx.settingsScope.describe();
+  const scope = ctx.settingsScope.bind({ namespace: OMD_SETTINGS_NS });
+  const controller = new OmdMatrixController(api, scope, describe);
+  const t = ctx.locale.bind(NS);
+  ctx.slots.inject("settings.section", () => ctx.slots.register({
+    name: "settings.section",
+    id: "omd-model-allocation",
+    order: 30,
+    // after Models (10) and Agent presets (20)
+    label: () => t("nav"),
+    locale: NS,
+    inject: () => ({ scope, controller, t })
+  }, OmdModelAllocationSection));
+}
+var styles = {
+  section: { maxWidth: 720, color: "var(--dsw-alias-label-primary)", display: "flex", flexDirection: "column", gap: 12 },
+  title: { margin: 0, fontSize: 18, fontWeight: 600 },
+  intro: { color: "var(--dsw-alias-label-tertiary)", margin: 0, fontSize: 13, lineHeight: "20px" },
+  notice: { color: "var(--dsw-alias-state-warn-label)", margin: 0, fontSize: 12, lineHeight: "18px" },
+  savedNotice: { color: "var(--dsw-alias-state-success-primary)", margin: 0, fontSize: 12, lineHeight: "18px" },
+  error: { color: "var(--dsw-alias-state-error-primary)", margin: 0, fontSize: 12, lineHeight: "18px" },
+  card: { border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-3)", borderRadius: 12, padding: "14px 16px", display: "flex", flexDirection: "column", gap: 10 },
+  cardHead: { display: "flex", alignItems: "baseline", gap: 8 },
+  cardTitle: { margin: 0, fontSize: 15, fontWeight: 600 },
+  cardRoute: { color: "var(--dsw-alias-label-tertiary)", fontSize: 12, lineHeight: "18px" },
+  field: { display: "flex", flexDirection: "column", gap: 4 },
+  fieldLabel: { color: "var(--dsw-alias-label-secondary)", fontSize: 12, fontWeight: 500, lineHeight: "18px" },
+  input: { boxSizing: "border-box", border: "1px solid var(--dsw-alias-border-l2)", width: "100%", height: 32, font: "inherit", background: "var(--dsw-alias-bg-layer-1)", color: "var(--dsw-alias-label-primary)", borderRadius: 8, padding: "0 10px", fontSize: 14, lineHeight: "22px" },
+  inputDisabled: { opacity: 0.6, cursor: "default" },
+  tierRow: { borderTop: "1px solid var(--dsw-alias-border-l2)", paddingTop: 10, display: "flex", flexDirection: "column", gap: 8 },
+  tierHead: { display: "flex", alignItems: "baseline", gap: 8 },
+  tierName: { margin: 0, fontSize: 13, fontWeight: 600 },
+  tierHint: { color: "var(--dsw-alias-label-tertiary)", fontSize: 12, lineHeight: "18px", flex: 1, overflowWrap: "anywhere" },
+  grid2: { display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(200px, 1fr))", gap: 8 },
+  actions: { display: "flex", alignItems: "center", gap: 8, marginTop: 4 },
+  primaryButton: { boxSizing: "border-box", height: 36, font: "inherit", cursor: "pointer", border: "none", borderRadius: 18, padding: "0 14px", fontSize: 14, lineHeight: "22px", background: "var(--dsw-alias-button-primary-fill)", color: "var(--dsw-alias-label-primary-foreground)" },
+  secondaryButton: { boxSizing: "border-box", height: 36, font: "inherit", cursor: "pointer", border: "1px solid var(--dsw-alias-border-l2)", background: "transparent", color: "var(--dsw-alias-label-primary)", borderRadius: 18, padding: "0 14px", fontSize: 14, lineHeight: "22px" },
+  buttonDisabled: { opacity: 0.4, cursor: "default" }
+};
+var OmdRenderBoundary = class extends React.Component {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "state", { error: null });
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  render() {
+    if (this.state.error !== null) {
+      return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, this.props.t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.error, role: "alert" }, this.props.t("renderError"), " ", this.state.error instanceof Error ? this.state.error.message : String(this.state.error)));
+    }
+    return this.props.children ?? null;
+  }
+};
+function OmdModelAllocationSection(props) {
+  return /* @__PURE__ */ React.createElement(OmdRenderBoundary, { t: props.t }, /* @__PURE__ */ React.createElement(OmdModelAllocationBody, { ...props }));
+}
+function OmdModelAllocationBody(props) {
+  const { scope, controller, t } = props;
+  const scopeSnapshot = React.useSyncExternalStore(
+    React.useCallback((listener) => scope.subscribe(listener), [scope]),
+    React.useCallback(() => scope.getSnapshot(), [scope]),
+    React.useCallback(() => scope.getSnapshot(), [scope])
+    // SSR/test renderers; no-op in the browser
+  );
+  const ui = React.useSyncExternalStore(
+    React.useCallback((listener) => controller.subscribe(listener), [controller]),
+    React.useCallback(() => controller.getSnapshot(), [controller]),
+    React.useCallback(() => controller.getSnapshot(), [controller])
+  );
+  if (scopeSnapshot.status === "unavailable") {
+    return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.intro }, t("unavailable")));
+  }
+  if (scopeSnapshot.status !== "ready" || ui.draft === null) {
+    return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.intro }, t("loading")));
+  }
+  const matrix = ui.draft;
+  const readOnly = !controller.writable;
+  return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.intro }, t("intro")), readOnly ? /* @__PURE__ */ React.createElement("p", { style: styles.notice }, t("readOnly")) : null, ui.saved ? /* @__PURE__ */ React.createElement("p", { style: styles.savedNotice, role: "status" }, t("saved")) : null, ui.error !== null ? /* @__PURE__ */ React.createElement("p", { style: styles.error, role: "alert" }, t("errorPrefix"), " ", ui.error, ui.error.toLowerCase().includes("revision") || ui.error.toLowerCase().includes("changed") ? ` ${t("conflict")}` : "") : null, MODE_ORDER.map((modeId) => {
+    const cfg = matrix.modes[modeId] ?? {};
+    const route = cfg.provider !== void 0 || cfg.model !== void 0 ? `${cfg.provider ?? "?"}/${cfg.model ?? "?"}` : "";
+    const modeName = t(modeId) ?? modeId;
+    return /* @__PURE__ */ React.createElement("div", { key: modeId, style: styles.card }, /* @__PURE__ */ React.createElement("div", { style: styles.cardHead }, /* @__PURE__ */ React.createElement("h3", { style: styles.cardTitle }, modeName), /* @__PURE__ */ React.createElement("span", { style: styles.cardRoute }, modeId, route !== "" ? ` \xB7 ${route}` : "")), /* @__PURE__ */ React.createElement("div", { style: styles.grid2 }, /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("provider")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: cfg.provider ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        placeholder: "deepseek-official",
+        onChange: (event) => controller.patchMode(modeId, "provider", event.target.value)
+      }
+    )), /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("model")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: cfg.model ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        placeholder: "deepseek-v4-pro",
+        onChange: (event) => controller.patchMode(modeId, "model", event.target.value)
+      }
+    ))), /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("reasoningEffort")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: cfg.reasoningEffort ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        placeholder: "",
+        title: t("reasoningEffortHint"),
+        onChange: (event) => controller.patchMode(modeId, "reasoningEffort", event.target.value)
+      }
+    )), cfg.tiers !== void 0 && Object.keys(cfg.tiers).length > 0 ? /* @__PURE__ */ React.createElement("div", { style: styles.tierRow }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("tiers")), Object.entries(cfg.tiers).map(([tierName, tier]) => /* @__PURE__ */ React.createElement("div", { key: tierName, style: styles.tierRow }, /* @__PURE__ */ React.createElement("div", { style: styles.tierHead }, /* @__PURE__ */ React.createElement("h4", { style: styles.tierName }, tierName), /* @__PURE__ */ React.createElement("span", { style: styles.tierHint }, tier.hint ?? "")), /* @__PURE__ */ React.createElement("div", { style: styles.grid2 }, /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("provider")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: tier.provider ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        onChange: (event) => controller.patchTier(modeId, tierName, "provider", event.target.value)
+      }
+    )), /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("model")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: tier.model ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        onChange: (event) => controller.patchTier(modeId, tierName, "model", event.target.value)
+      }
+    )))))) : null);
+  }), !readOnly ? /* @__PURE__ */ React.createElement("div", { style: styles.actions }, /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      type: "button",
+      style: { ...styles.primaryButton, ...!controller.canSave ? styles.buttonDisabled : {} },
+      disabled: !controller.canSave,
+      onClick: () => {
+        controller.save();
+      }
+    },
+    ui.status === "saving" ? t("saving") : t("save")
+  ), /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      type: "button",
+      style: { ...styles.secondaryButton, ...!controller.canSave ? styles.buttonDisabled : {} },
+      disabled: !controller.canSave,
+      onClick: () => {
+        controller.reset();
+      }
+    },
+    t("reset")
+  )) : null);
+}
+
+		return module.exports;
+	}
+});

package/lib/host.d.ts

@@ -0,0 +1,42 @@
+import type { Matrix } from "./sync.js";
+/**
+ * @module @carljia/omd-dsh
+ *
+ * omd-dsh host row (package root entry, injected by cordis.patch.yml):
+ *
+ *  1. registers the `omd-model-allocation` settings namespace (base = the
+ *     shipped default matrix, `applies: "live"`), making the settings
+ *     document (<DSH_HOME>/settings.yaml) the authoritative "online edit"
+ *     store for the model matrix;
+ *  2. reconciles once at startup: if <DSH_HOME>/omd-matrix.json exists and
+ *     differs from the namespace's resolved value, its content is imported
+ *     into the namespace (`replace`) — CLI edits and pre-settings installs
+ *     survive the migration, and CLI edits are picked up on the next restart;
+ *  3. renders the 7 presets from the namespace's resolved matrix and mirrors
+ *     that matrix back to omd-matrix.json (the export mirror + CLI face);
+ *  4. watches the namespace: every UI save re-renders the presets and
+ *     re-mirrors the file. New sessions route with the new matrix; running
+ *     sessions keep the combination they started with.
+ *
+ * The browser half (lib/client.js) binds the same namespace and renders the
+ * "omd模型分配" settings section (see src/client.tsx). Because the client
+ * plugin discovery (dsh-client-modules) matches loader entries by package
+ * name, the bundle patch injects THIS row under the bare package name
+ * `@carljia/omd-dsh` — not a `/boot` subpath.
+ *
+ * Failure policy: a broken settings document / namespace must never brick the
+ * host's boot — any failure here falls back to the plain file sync (the old
+ * boot behavior) and is logged.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "omd-dsh";
+/** Requires the settings service (provided by dsh-base → dsh-settings-file in every profile). */
+export declare const inject: string[];
+/**
+ * Startup reconciliation decision (pure, unit-tested): the file matrix is
+ * imported into the settings namespace exactly when it exists AND differs
+ * from the namespace's currently resolved value. Equal values need no write;
+ * a missing file leaves the namespace (defaults / user section) authoritative.
+ */
+export declare function shouldImportFile(fileMatrix: Matrix | undefined, resolved: Matrix): boolean;
+export declare function apply(ctx: any): Promise<void>;

package/lib/host.js

@@ -0,0 +1,103 @@
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { readDefaultMatrix, readMatrixFileIfExists, matrixEquals, runSyncWithMatrix, runSync, saveMatrix, MatrixSchema, MATRIX_PATH, } from "./sync.js";
+/**
+ * @module @carljia/omd-dsh
+ *
+ * omd-dsh host row (package root entry, injected by cordis.patch.yml):
+ *
+ *  1. registers the `omd-model-allocation` settings namespace (base = the
+ *     shipped default matrix, `applies: "live"`), making the settings
+ *     document (<DSH_HOME>/settings.yaml) the authoritative "online edit"
+ *     store for the model matrix;
+ *  2. reconciles once at startup: if <DSH_HOME>/omd-matrix.json exists and
+ *     differs from the namespace's resolved value, its content is imported
+ *     into the namespace (`replace`) — CLI edits and pre-settings installs
+ *     survive the migration, and CLI edits are picked up on the next restart;
+ *  3. renders the 7 presets from the namespace's resolved matrix and mirrors
+ *     that matrix back to omd-matrix.json (the export mirror + CLI face);
+ *  4. watches the namespace: every UI save re-renders the presets and
+ *     re-mirrors the file. New sessions route with the new matrix; running
+ *     sessions keep the combination they started with.
+ *
+ * The browser half (lib/client.js) binds the same namespace and renders the
+ * "omd模型分配" settings section (see src/client.tsx). Because the client
+ * plugin discovery (dsh-client-modules) matches loader entries by package
+ * name, the bundle patch injects THIS row under the bare package name
+ * `@carljia/omd-dsh` — not a `/boot` subpath.
+ *
+ * Failure policy: a broken settings document / namespace must never brick the
+ * host's boot — any failure here falls back to the plain file sync (the old
+ * boot behavior) and is logged.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export const name = "omd-dsh";
+/** Requires the settings service (provided by dsh-base → dsh-settings-file in every profile). */
+export const inject = ["settings"];
+const NS = settingsNamespace("omd-model-allocation");
+/**
+ * Startup reconciliation decision (pure, unit-tested): the file matrix is
+ * imported into the settings namespace exactly when it exists AND differs
+ * from the namespace's currently resolved value. Equal values need no write;
+ * a missing file leaves the namespace (defaults / user section) authoritative.
+ */
+export function shouldImportFile(fileMatrix, resolved) {
+    return fileMatrix !== undefined && !matrixEquals(fileMatrix, resolved);
+}
+function makeLog(ctx) {
+    return {
+        info: (message) => { try {
+            ctx?.logger?.info?.(message);
+        }
+        catch {
+            console.log(message);
+        } },
+        error: (message) => { try {
+            ctx?.logger?.error?.(message);
+        }
+        catch {
+            console.error(message);
+        } },
+    };
+}
+export async function apply(ctx) {
+    const log = makeLog(ctx);
+    const flags = { dryRun: false, verbose: false };
+    try {
+        const settings = ctx.settings; // SettingsProvider (dsh-base provides it in every profile)
+        const scope = settings.register(NS, MatrixSchema, {
+            base: readDefaultMatrix(),
+            applies: "live",
+        });
+        // 启动期调和：文件 → 命名空间（幂等；导入 CLI/旧版自定义，CLI 手改在下次重启被采纳）
+        const fileMatrix = readMatrixFileIfExists();
+        if (shouldImportFile(fileMatrix, scope.get())) {
+            log.info("omd-dsh: importing " + MATRIX_PATH + " into settings namespace " + NS);
+            await scope.replace(fileMatrix);
+        }
+        // 用命名空间解析出的完整矩阵渲染 presets，并把该矩阵写回镜像文件
+        const resolved = scope.get();
+        saveMatrix(resolved);
+        await runSyncWithMatrix(resolved, flags, log.info);
+        // 后续 UI 编辑：重渲染 + 更新镜像（watch 仅在解析值真正变化时触发）
+        scope.watch((next) => {
+            log.info("omd-dsh: matrix changed via settings — re-syncing presets and mirroring omd-matrix.json");
+            try {
+                saveMatrix(next);
+            }
+            catch (error) {
+                log.error("omd-dsh: failed to mirror " + MATRIX_PATH + ": " + (error instanceof Error ? error.message : String(error)));
+            }
+            runSyncWithMatrix(next, flags, log.info).catch((error) => log.error("omd-dsh re-sync failed: " + (error instanceof Error ? error.message : String(error))));
+        });
+    }
+    catch (error) {
+        // settings 不可用 / 命名空间已损坏时退回纯文件 sync（保持老 boot 行为）
+        log.error("omd-dsh: settings namespace failed, falling back to file sync: " + (error instanceof Error ? error.message : String(error)));
+        try {
+            await runSync(flags, log.info);
+        }
+        catch (fallbackError) {
+            log.error("omd-dsh: file sync fallback failed: " + (fallbackError instanceof Error ? fallbackError.message : String(fallbackError)));
+        }
+    }
+}

package/lib/omd-matrix-controller.d.ts

@@ -0,0 +1,108 @@
+import type { Matrix } from "./sync.js";
+/**
+ * Client-side edit state machine for the omd model matrix — deliberately free
+ * of React and DOM so it can be unit-tested against fake wire faces
+ * (test/client-store.test.ts).
+ *
+ * The controller mirrors one settings namespace scope (`ctx.settingsScope`
+ * bind) and writes through `api.settings.replace` with the scope's revision
+ * as `expectedRevision` — a stale editor is refused rather than silently
+ * overwriting a concurrent change (`settings-rejected` on the wire).
+ */
+/** Settings namespace the host row registers (src/host.ts) — must stay in step. */
+export declare const OMD_SETTINGS_NS = "omd-model-allocation";
+/** Client-side sync state of one settings namespace (wire-contract subset). */
+export interface OmdScopeSnapshot {
+    status: "loading" | "ready" | "unavailable";
+    value: Matrix | undefined;
+    revision: number | undefined;
+    writable: boolean;
+    mode: "host" | "memory";
+}
+/** The `settings.replace` wire face this controller needs. */
+export interface OmdSettingsApi {
+    settings: {
+        replace(request: {
+            ns: string;
+            section: object;
+            expectedRevision?: number;
+        }): Promise<{
+            result: {
+                ok: true;
+                value: unknown;
+            };
+        } | {
+            result: {
+                ok: false;
+                error: {
+                    message: string;
+                };
+            };
+        }>;
+    };
+}
+/** The shared describe mirror face (used to reload Host state after a rejected write). */
+export interface OmdDescribeFace {
+    load(): Promise<unknown>;
+}
+/** The bound scope as the controller consumes it. */
+export interface OmdScope {
+    getSnapshot(): OmdScopeSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+export interface OmdControllerSnapshot {
+    draft: Matrix | null;
+    status: "idle" | "saving";
+    error: string | null;
+    saved: boolean;
+}
+type ModeField = "provider" | "model" | "reasoningEffort";
+export declare class OmdMatrixController {
+    private readonly api;
+    private readonly scope;
+    private readonly describe;
+    draft: Matrix | null;
+    status: "idle" | "saving";
+    error: string | null;
+    saved: boolean;
+    private readonly listeners;
+    private readonly unsubscribeScope;
+    /**
+     * Cached snapshot handed to `useSyncExternalStore`. React requires
+     * `getSnapshot()` to return the SAME reference between changes — a fresh
+     * object per call throws "The result of getSnapshot should be cached" and
+     * crashes the whole settings entry (blank page). Rebuilt only in `emit()`.
+     */
+    private snapshot;
+    constructor(api: OmdSettingsApi, scope: OmdScope, describe: OmdDescribeFace);
+    /** Release the scope subscription (plugin fiber teardown). */
+    dispose(): void;
+    /** Stable snapshot reference (uSES-safe): the SAME object until state changes. */
+    getSnapshot(): OmdControllerSnapshot;
+    subscribe(listener: () => void): () => void;
+    private emit;
+    /** External change (mirror reload after a rejected write, another window):
+     *  rebuild the draft from the fresh value, unless a save is in flight. */
+    private onScopeChange;
+    private refreshDraft;
+    /** Whether the Save / Reset controls may run. */
+    get canSave(): boolean;
+    /** Whether the namespace accepts writes at all (read-only provider / memory mode). */
+    get writable(): boolean;
+    /** Edit one mode's top-level field; an empty string removes the override
+     *  (the field re-inherits the composition base / schema default). */
+    patchMode(modeId: string, field: ModeField, value: string): void;
+    /** Edit one tier's provider/model; an empty string removes the override. */
+    patchTier(modeId: string, tier: string, field: "provider" | "model", value: string): void;
+    /**
+     * Persist the whole draft matrix through `settings.replace` (wholesale
+     * section replacement — the removal/reset path merge cannot express). The
+     * revision fence makes a stale editor fail loudly instead of overwriting.
+     * @returns once the write settled and the snapshot reflects the outcome.
+     */
+    save(): Promise<void>;
+    /** Restore the shipped default matrix: replace with an empty section. */
+    reset(): Promise<void>;
+    private replace;
+}
+export {};

package/lib/omd-matrix-controller.js

@@ -0,0 +1,180 @@
+/**
+ * Client-side edit state machine for the omd model matrix — deliberately free
+ * of React and DOM so it can be unit-tested against fake wire faces
+ * (test/client-store.test.ts).
+ *
+ * The controller mirrors one settings namespace scope (`ctx.settingsScope`
+ * bind) and writes through `api.settings.replace` with the scope's revision
+ * as `expectedRevision` — a stale editor is refused rather than silently
+ * overwriting a concurrent change (`settings-rejected` on the wire).
+ */
+/** Settings namespace the host row registers (src/host.ts) — must stay in step. */
+export const OMD_SETTINGS_NS = "omd-model-allocation";
+function cloneMatrix(value) {
+    if (value === undefined)
+        return null;
+    return JSON.parse(JSON.stringify(value));
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export class OmdMatrixController {
+    api;
+    scope;
+    describe;
+    draft;
+    status = "idle";
+    error = null;
+    saved = false;
+    listeners = new Set();
+    unsubscribeScope;
+    /**
+     * Cached snapshot handed to `useSyncExternalStore`. React requires
+     * `getSnapshot()` to return the SAME reference between changes — a fresh
+     * object per call throws "The result of getSnapshot should be cached" and
+     * crashes the whole settings entry (blank page). Rebuilt only in `emit()`.
+     */
+    snapshot;
+    constructor(api, scope, describe) {
+        this.api = api;
+        this.scope = scope;
+        this.describe = describe;
+        this.draft = cloneMatrix(scope.getSnapshot().value);
+        this.snapshot = { draft: this.draft, status: this.status, error: this.error, saved: this.saved };
+        this.unsubscribeScope = scope.subscribe(() => this.onScopeChange());
+    }
+    /** Release the scope subscription (plugin fiber teardown). */
+    dispose() {
+        this.unsubscribeScope();
+        this.listeners.clear();
+    }
+    /** Stable snapshot reference (uSES-safe): the SAME object until state changes. */
+    getSnapshot() {
+        return this.snapshot;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    emit() {
+        this.snapshot = { draft: this.draft, status: this.status, error: this.error, saved: this.saved };
+        for (const listener of [...this.listeners])
+            listener();
+    }
+    /** External change (mirror reload after a rejected write, another window):
+     *  rebuild the draft from the fresh value, unless a save is in flight. */
+    onScopeChange() {
+        if (this.status === "saving")
+            return;
+        this.refreshDraft();
+        this.emit();
+    }
+    refreshDraft() {
+        const value = this.scope.getSnapshot().value;
+        if (value !== undefined)
+            this.draft = cloneMatrix(value);
+    }
+    /** Whether the Save / Reset controls may run. */
+    get canSave() {
+        const snap = this.scope.getSnapshot();
+        return snap.status === "ready" && snap.writable && this.status !== "saving" && this.draft !== null;
+    }
+    /** Whether the namespace accepts writes at all (read-only provider / memory mode). */
+    get writable() {
+        return this.scope.getSnapshot().writable;
+    }
+    /** Edit one mode's top-level field; an empty string removes the override
+     *  (the field re-inherits the composition base / schema default). */
+    patchMode(modeId, field, value) {
+        const draft = this.draft;
+        if (draft === null)
+            return;
+        const modes = { ...draft.modes };
+        const cfg = { ...(modes[modeId] ?? {}) };
+        if (value === "")
+            delete cfg[field];
+        else
+            cfg[field] = value;
+        modes[modeId] = cfg;
+        this.draft = { ...draft, modes };
+        this.saved = false;
+        this.emit();
+    }
+    /** Edit one tier's provider/model; an empty string removes the override. */
+    patchTier(modeId, tier, field, value) {
+        const draft = this.draft;
+        if (draft === null)
+            return;
+        const modes = { ...draft.modes };
+        const cfg = { ...(modes[modeId] ?? {}) };
+        const tiers = { ...(cfg.tiers ?? {}) };
+        const tierCfg = { ...(tiers[tier] ?? {}) };
+        if (value === "")
+            delete tierCfg[field];
+        else
+            tierCfg[field] = value;
+        tiers[tier] = tierCfg;
+        cfg.tiers = tiers;
+        modes[modeId] = cfg;
+        this.draft = { ...draft, modes };
+        this.saved = false;
+        this.emit();
+    }
+    /**
+     * Persist the whole draft matrix through `settings.replace` (wholesale
+     * section replacement — the removal/reset path merge cannot express). The
+     * revision fence makes a stale editor fail loudly instead of overwriting.
+     * @returns once the write settled and the snapshot reflects the outcome.
+     */
+    async save() {
+        if (!this.canSave || this.draft === null)
+            return;
+        const snap = this.scope.getSnapshot();
+        this.status = "saving";
+        this.error = null;
+        this.emit();
+        const response = await this.replace({ section: this.draft, revision: snap.revision });
+        if (response.ok)
+            this.saved = true;
+        else {
+            this.error = response.message;
+            await this.describe.load();
+        }
+        this.refreshDraft();
+        this.status = "idle";
+        this.emit();
+    }
+    /** Restore the shipped default matrix: replace with an empty section. */
+    async reset() {
+        if (!this.canSave)
+            return;
+        const snap = this.scope.getSnapshot();
+        this.status = "saving";
+        this.error = null;
+        this.emit();
+        const response = await this.replace({ section: {}, revision: snap.revision });
+        if (response.ok)
+            this.saved = true;
+        else
+            this.error = response.message;
+        await this.describe.load();
+        this.refreshDraft();
+        this.status = "idle";
+        this.emit();
+    }
+    async replace(request) {
+        try {
+            const response = await this.api.settings.replace({
+                ns: OMD_SETTINGS_NS,
+                section: request.section,
+                ...(request.revision === undefined ? {} : { expectedRevision: request.revision }),
+            });
+            if (response.result.ok)
+                return { ok: true };
+            return { ok: false, message: response.result.error.message };
+        }
+        catch (error) {
+            return { ok: false, message: messageOf(error) };
+        }
+    }
+}

package/lib/sync.d.ts

@@ -1,10 +1,17 @@
 /**
  * omd-dsh sync core — materialize the OMD presets into <DSH_HOME>/.agent-presets.
  *
- * Shared by the CLI (`omd-dsh sync`) and the bundle boot row (`dsh plugin add`
- * + restart): render each preset's omd-mode / omd-task rows from the user's
- * model matrix, and copy the presets plus the vendored row modules into
- * .agent-presets.
+ * Shared by the CLI (`omd-dsh sync`), the bundle boot row (`dsh plugin add`
+ * + restart), and the host settings row (lib/host.js): render each preset's
+ * omd-mode / omd-task rows from the model matrix, and copy the presets plus
+ * the vendored row modules into .agent-presets.
+ *
+ * The matrix has two faces: `runSync` reads/writes the CLI face
+ * (<DSH_HOME>/omd-matrix.json, the `omd-dsh setup` target), while the host
+ * settings row resolves the matrix from the settings namespace
+ * (`omd-model-allocation` in settings.yaml) and feeds it to
+ * `runSyncWithMatrix` — the file becomes an exported mirror of the namespace
+ * plus the CLI compatibility face (see src/host.ts).
  *
  * The vendored rows are SELF-CONTAINED bundles (see scripts/postbuild.mjs):
  * every dependency is bundled in and they carry no @deepseek-ai imports, so
@@ -48,6 +55,26 @@ export declare const VENDOR_SOURCES: string[];
 /** User-owned model matrix: lives under DSH_HOME, never inside the package or the repo. */
 export declare const MATRIX_PATH: string;
 export declare function dshHome(): string;
+export declare const MatrixSchema: any;
+export declare function readDefaultMatrix(): Matrix;
+/**
+ * Read the user's matrix file (<DSH_HOME>/omd-matrix.json) without touching
+ * the filesystem beyond the read: missing or malformed returns undefined and
+ * NEVER auto-generates — the caller decides what to fall back to (settings
+ * namespace resolved value / default matrix). This is the host row's
+ * "import CLI / legacy edits into the settings namespace" read.
+ */
+export declare function readMatrixFileIfExists(): Matrix | undefined;
+/** Structural equality over the small JSON matrix (stringify equality suffices). */
+export declare function matrixEquals(a: Matrix, b: Matrix): boolean;
 export declare function loadMatrix(flags: SyncFlags, log?: (msg: string) => void): Matrix;
 export declare function saveMatrix(m: Matrix): void;
+/**
+ * Render and materialize the presets from an ALREADY-RESOLVED matrix. This is
+ * the shared core between the CLI file path (`runSync`) and the settings
+ * namespace path (host row): the matrix comes from the caller, everything
+ * after `loadMatrix(...)` is here.
+ */
+export declare function runSyncWithMatrix(matrix: Matrix, flags: SyncFlags, log?: (msg: string) => void): Promise<void>;
+/** CLI / manual-fallback path: load the matrix from <DSH_HOME>/omd-matrix.json (generating/migrating it on first run), then render. */
 export declare function runSync(flags: SyncFlags, log?: (msg: string) => void): Promise<void>;

package/lib/sync.js

@@ -3,6 +3,7 @@ import { createHash } from "node:crypto";
 import { dirname, join, relative, resolve } from "node:path";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
+import z from "@deepseek-ai/schemastery";
 export const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 export const VENDOR_SOURCES = ["omd-mode.mjs", "omd-task.mjs", "omd-ulw.mjs", "omd-plan.mjs", "omd-start-work.mjs", "omd-mode-switch.mjs", "shared.js"];
 /** User-owned model matrix: lives under DSH_HOME, never inside the package or the repo. */
@@ -45,6 +46,32 @@ async function collectSourceFiles(rootDir) {
 }
 // ── matrix ──
 const DEFAULT_MATRIX_PATH = join(PACKAGE_ROOT, "omd-matrix.default.json");
+/** Settings-namespace schema for the model matrix (see plan §5). Every field
+ *  is optional: `base` (the shipped default matrix) fills whatever the user
+ *  document omits, and extra keys (future fields) pass through untouched. */
+const TierSchema = z.object({
+    provider: z.string(),
+    model: z.string(),
+    hint: z.string(),
+    persona: z.string(),
+    maxTokens: z.number(),
+    toolFilter: z.object({
+        allow: z.array(z.string()),
+        deny: z.array(z.string()),
+        denyShell: z.boolean(),
+    }),
+});
+const ModeSchema = z.object({
+    provider: z.string(),
+    model: z.string(),
+    reasoningEffort: z.string(),
+    tiers: z.dict(TierSchema),
+});
+export const MatrixSchema = z.object({
+    version: z.number(),
+    defaults: z.object({ provider: z.string() }),
+    modes: z.dict(ModeSchema),
+});
 function parseMatrix(text) {
     try {
         const parsed = JSON.parse(text);
@@ -54,7 +81,7 @@ function parseMatrix(text) {
     catch { /* fall through */ }
     return undefined;
 }
-function readDefaultMatrix() {
+export function readDefaultMatrix() {
     if (!existsSync(DEFAULT_MATRIX_PATH))
         throw new Error("omd-dsh: missing default matrix file " + DEFAULT_MATRIX_PATH + " (broken package — reinstall @carljia/omd-dsh)");
     const parsed = parseMatrix(readFileSync(DEFAULT_MATRIX_PATH, "utf8"));
@@ -62,6 +89,27 @@ function readDefaultMatrix() {
         throw new Error("omd-dsh: malformed default matrix file " + DEFAULT_MATRIX_PATH + " (broken package — reinstall @carljia/omd-dsh)");
     return parsed;
 }
+/**
+ * Read the user's matrix file (<DSH_HOME>/omd-matrix.json) without touching
+ * the filesystem beyond the read: missing or malformed returns undefined and
+ * NEVER auto-generates — the caller decides what to fall back to (settings
+ * namespace resolved value / default matrix). This is the host row's
+ * "import CLI / legacy edits into the settings namespace" read.
+ */
+export function readMatrixFileIfExists() {
+    if (!existsSync(MATRIX_PATH))
+        return undefined;
+    try {
+        return parseMatrix(readFileSync(MATRIX_PATH, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Structural equality over the small JSON matrix (stringify equality suffices). */
+export function matrixEquals(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
 function writeMatrixFile(path, text) {
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, text, "utf8");
@@ -192,8 +240,13 @@ async function locallyModified(dir, meta) {
     }
     return undefined;
 }
-export async function runSync(flags, log = console.log) {
-    const matrix = loadMatrix(flags, log);
+/**
+ * Render and materialize the presets from an ALREADY-RESOLVED matrix. This is
+ * the shared core between the CLI file path (`runSync`) and the settings
+ * namespace path (host row): the matrix comes from the caller, everything
+ * after `loadMatrix(...)` is here.
+ */
+export async function runSyncWithMatrix(matrix, flags, log = console.log) {
     const manifest = JSON.parse(readFileSync(join(PACKAGE_ROOT, "package.json"), "utf8"));
     const sourceVersion = manifest.version;
     const presetsSourceDir = join(PACKAGE_ROOT, "presets");
@@ -343,3 +396,7 @@ export async function runSync(flags, log = console.log) {
     const summary = ["synced", "updated", "conflicts", "orphan", "removed"].map((key) => report[key].length + " " + key).join(", ");
     log("omd-dsh sync: " + summary + (flags.dryRun ? " (dry-run)" : ""));
 }
+/** CLI / manual-fallback path: load the matrix from <DSH_HOME>/omd-matrix.json (generating/migrating it on first run), then render. */
+export async function runSync(flags, log = console.log) {
+    await runSyncWithMatrix(loadMatrix(flags, log), flags, log);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carljia/omd-dsh",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "OMD 理念的 DeepSeek Harness 插件：模式能力边界 + 按模式配模型 + tier 差异化子代理委派",
   "keywords": [
     "deepseek-harness",
@@ -24,10 +24,14 @@
     "node": ">=20"
   },
   "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "main": "lib/host.js",
+  "types": "lib/host.d.ts",
   "exports": {
     ".": {
+      "types": "./lib/host.d.ts",
+      "default": "./lib/host.js"
+    },
+    "./omd-mode": {
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
@@ -39,6 +43,7 @@
       "types": "./lib/boot.d.ts",
       "default": "./lib/boot.js"
     },
+    "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },
   "bin": {
@@ -47,6 +52,10 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
     }
   },
   "files": [
@@ -62,15 +71,21 @@
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-scope": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@types/node": "^24.0.0",
+    "@types/react": "^18.3.1",
+    "@types/react-dom": "^18.3.0",
     "esbuild": "^0.28.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
     "typescript": "^5.6.0",
     "vitest": "^3.0.0"
   },