dsh-yolo-mode 0.5.1 → 0.5.3

package/CHANGELOG.md

@@ -2,6 +2,88 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)。
 
+## [0.5.3] - 2026-09-25
+
+### 兼容：适配 DSH 0.1.7-rc.2
+
+- 在本机 **0.1.7-rc.2** 上真实装载运行通过：全部入口激活、零错误、无 pending
+  （`did not activate` 告警不出现）；设置读写（`settingsView` / `settingsMutate`
+  乐观锁）实测往返成功。`dsh.compatibility.dshReleases` 新增
+  `"0.1.7-rc.2": "compatible"`；README 徽章与兼容性说明同步。
+- 0.1.7-rc.1 → rc.2 的官方 `@deepseek-ai/dsh-*` 公开 API **无移除、无改名**
+  （`dsh-settings` / `dsh-client-connection` / `dsh-client-ui-slots` 逐字节相同，
+  其余为增量新增），本插件无源码适配需求。
+
+### 修复：设置页「供应商」下拉为空
+
+设置页 `judgeProvider` 下拉始终为空。根因：0.1.7 起客户端 `connection.api.llm`
+已不存在，store 构造时 `this.llm` 恒为 `null`，`_fetchLlmDirectory()` 直接返回空数组。
+本次改为经客户端 Remote 服务读取：
+
+- **供应商**：`ctx.remote.llm.listProviders()`（已注册路由）与
+  `listConfigurableProviders()`（已声明可配置）经 `joinProviderDirectory` 合并为与官方
+  settings-models 页一致的 `{provider, displayName}` 行。
+- **模型**：`ctx.remote.session.modelCatalog()` 的 `groups`（按 provider 分组），
+  与官方同一数据源。
+- **inject**：`package.json` 的 `dsh.client.inject` 与客户端 `inject` 数组新增
+  `"remote.llm"`。
+- **降级保留**：无 `remote.llm` 命名空间时回退旧 `connection.api.llm`；目录读取失败
+  不致命，仍回退自由文本输入（既有设计不变）。
+
+### 测试
+
+- 新增 `store-logic.joinProviderDirectory` 与 4 项 `YoloStore` `remote.llm` /
+  `remote.session` 单测（目录填充、失败非致命、legacy 回退、remote 优先）；
+  `npm test` 137 项全绿。
+- 本机无浏览器，客户端 UI 未在浏览器中实际渲染验证；已核对 `npm pack` 产物经
+  0.1.7-rc.2 profile 装载后**被服务的**客户端 bundle 含 `remote.llm.listProviders`
+  / `listConfigurableProviders` / `session.modelCatalog`，且宿主 `llm/listProviders`、
+  `session/modelCatalog` 实测返回非空目录（供应商下拉将填充 5 项）。
+
+### Beta 说明
+
+- 测试版 `0.5.2-beta.0`（`--tag beta`）的内容——设置子系统迁移至 DSH 0.1.7 的
+  `SettingsForms`——随本版一并正式发布，详见下方 `0.5.2` 条目。
+
+## [0.5.2] - 2026-09-24
+
+### 兼容：设置子系统迁移至 DSH 0.1.7-rc.1 的 `SettingsForms`
+
+DSH 0.1.7 移除了 `@deepseek-ai/dsh-settings` 的 `SettingsProvider.installSection`
+（默认导出改为 `SettingsForms`），本插件原设置子系统因此在新版抛
+`TypeError: settings.installSection is not a function` 而无法激活。本次按官方新模型重写：
+
+- **设置声明 → 插件 Config schema**（`lib/settings.js` 的 `YoloSettingsSchema`，
+  经 `lib/index.js` 的 `export const Config` 暴露）：每个顶层字段标注
+  `.volatile()`，声明为可热更——写回经 loader 的就地更新，插件无需重启即可生效
+  （与旧模型「只改某些字段不重启」行为一致）。
+- **设置读取 → `config.<field>.get()`**（`readYoloConfig`）：`effectiveConfig()`
+  每次裁决读取实时解析值（schema 默认 + 条目 config），再 `normalizeConfig`。
+- **页面策略 → `settings.configure({ auto: false }, fiber)`**
+  （`installYoloSettingsPage`）：插件自带 Web 设置页，`auto:false` 禁止宿主再自动
+  生成重复页面；settings 服务缺失时零侵入跳过。
+- **自发布设置桥与客户端不变**：`lib/remote.js` 的 `settingsView` / `settingsMutate`
+  端点本就建立在 `describe` / `mutate` / `writable` / `SettingsConflictError` 之上，
+  这些方法面在 `SettingsForms` 中保持不变，端点形状与乐观锁语义无需改动，客户端
+  无需改动。
+- **双层 → 单层映射**：旧「插件行 config 为 base 层 + settings.yaml 用户层」映射为
+  0.1.7「Profile 插件条目 config 单层」；旧 `settings.yaml` 由
+  `SettingsForms.importLegacyDocument` 一次性导入到 Profile。
+
+### 兼容性
+
+- `peerDependencies` 的 `@deepseek-ai/dsh*` 下限提升至 `^0.1.7-rc.1`（`dsh-host-apiproxy`
+  / `dsh-client-runtime` 两个历史例外保持 `^0.1.1-rc.2`）。
+- `dsh.compatibility.dshReleases` 增列 `0.1.7-rc.1: compatible`。
+- README 徽章与兼容性行同步至 0.1.7-rc.1。
+
+### 测试
+
+- `test/probe.test.mjs` 重写至 0.1.7 API：真实 cordis 经 Config schema 解析条目
+  config、断言 `configure({auto:false})` 被调用、并用 cosmokit `updateVolatile`
+  （loader `_commitVolatile` 的同一原语）验证 volatile 就地更新后裁决即时生效。
+- 其余测试文件保持通过；`npm test` 132 项全绿。
+
 ## [0.5.1] - 2026-09-22
 
 ### 修复：裁判对推理型模型恒失败（Issue #1）

package/README.md

@@ -6,10 +6,12 @@
 
 [![npm version](https://img.shields.io/npm/v/dsh-yolo-mode)](https://www.npmjs.com/package/dsh-yolo-mode)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-0.1.2--rc.1-blue)](https://github.com/deepseek-ai/deepseek-harness)
+[![DeepSeek Harness](https://img.shields.io/badge/DSH%200.1.5--rc.1%20%2F%20rc.2%20%2F%200.1.6--alpha.2%20%2F%200.1.7--rc.1%20%2F%20rc.2-blue)](https://github.com/deepseek-ai/deepseek-harness)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
-> **兼容性**：v0.5.1 支持 DSH **0.1.2-alpha.4+**，已在当前运行时 **0.1.2-rc.1** 实测（真实-Cordis 探针通过；settings 已迁移至 alpha.4 的 `SettingsProvider` 类服务）。旧版 DSH（0.1.0-rc.6 / rc.8）请使用最后兼容的 npm 版本 **0.4.1**。
+> **维护状态**：官方已在 DSH 中提供实验性 Auto review 能力（`@deepseek-ai/dsh-experimental-auto-review`，LLM 逐工具授权审查，在 `ask` 审批策略下替代人工审批），与本插件的「LLM 裁判自动审批」功能重叠。因此本插件**可能在未来停止维护**；如需官方原生的自动审批，可评估该实验性功能。当前版本仍会跟进 DSH 兼容（最近实测 **0.1.7-rc.2**）。
+
+> **兼容性**：v0.5.3 支持 DSH **0.1.5-rc.1+**，已在 **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1 / 0.1.7-rc.2** 实测（真实-Cordis 探针通过；设置子系统已迁移至 0.1.7 的 `SettingsForms`——插件 Config schema + volatile 热更 + 自建设置页；0.1.7-rc.2 上 provider/model 目录改由 client `remote.llm` + `remote.session` 读取）。旧版 DSH（0.1.0-rc.6 / rc.8）请使用最后兼容的 npm 版本 **0.4.1**。
 
 ---
 

package/lib/client/index.js

@@ -234,6 +234,42 @@ window.__ModuleLoader__.load({
 			if (code === "settings-rejected" || code === "schema-validation") return "rejected";
 			return "fatal";
 		}
+		/**
+		* Join the live provider routes (`remote.llm.listProviders`, rows `{id, name}`)
+		* with the declared configurable providers
+		* (`remote.llm.listConfigurableProviders`, rows `{provider, displayName, …}`)
+		* into one directory of `{ provider, displayName }` rows the select consumes.
+		* Declared entries lead (so a configured-but-not-yet-registered provider still
+		* appears), then any registered route the declaration does not name. Mirrors
+		* the official settings-models `joinProviderDirectory`.
+		*/
+		function joinProviderDirectory(registered, declared) {
+			const routes = Array.isArray(registered) ? registered : [];
+			const directory = Array.isArray(declared) ? declared : [];
+			const rows = [];
+			const named = /* @__PURE__ */ new Set();
+			for (const entry of directory) {
+				if (entry === null || typeof entry !== "object") continue;
+				if (typeof entry.provider !== "string" || entry.provider === "") continue;
+				named.add(entry.provider);
+				rows.push({
+					provider: entry.provider,
+					displayName: typeof entry.displayName === "string" && entry.displayName !== "" ? entry.displayName : void 0,
+					active: routes.some((route) => route && route.id === entry.provider)
+				});
+			}
+			for (const route of routes) {
+				if (route === null || typeof route !== "object") continue;
+				if (typeof route.id !== "string" || route.id === "") continue;
+				if (named.has(route.id)) continue;
+				rows.push({
+					provider: route.id,
+					displayName: typeof route.name === "string" && route.name !== "" ? route.name : void 0,
+					active: true
+				});
+			}
+			return rows;
+		}
 		//#endregion
 		//#region src/client/store.js
 		/**
@@ -266,9 +302,9 @@ window.__ModuleLoader__.load({
 				writable: true,
 				error: void 0,
 				open: false,
-				/** Configurable provider directory (llm.providers). */
+				/** Provider directory: remote.llm joined rows, or legacy llm.providers. */
 				providers: [],
-				/** Model catalog groups (llm.models). */
+				/** Model catalog groups: remote.session.modelCatalog, or legacy llm.models. */
 				models: []
 			};
 		}
@@ -279,14 +315,20 @@ window.__ModuleLoader__.load({
 		* @param {{ call: (channel: string, endpoint: string, payload: any) => Promise<any> }} options.rpc
 		*   rpc.call(channel, endpoint, payload) resolves to { ok: true, value } |
 		*   { ok: false, error }.
-		* @param {object|null} [options.llm] - optional `connection.api.llm` face
+		* @param {object|null} [options.llm] - optional legacy `connection.api.llm` face
 		*   ({ providers(), models() } returning { result: { ok, value } }); when null
 		*   the directory stays empty and the judge fields fall back to free text.
+		* @param {object|null} [options.remote] - optional client Remote service; when
+		*   it carries an `llm` namespace the directory comes from
+		*   `llm.listProviders()` + `llm.listConfigurableProviders()` (0.1.7+) and the
+		*   model catalog from `session.modelCatalog()`. Falls back to `llm` when the
+		*   Remote namespace is absent.
 		*/
 		var YoloStore = class {
-			constructor({ rpc, llm }) {
+			constructor({ rpc, llm, remote }) {
 				this.rpc = rpc;
 				this.llm = llm == null ? null : llm;
+				this.remote = remote == null ? null : remote;
 				this._state = initialYoloState();
 				this._listeners = /* @__PURE__ */ new Set();
 				this._generation = 0;
@@ -331,12 +373,54 @@ window.__ModuleLoader__.load({
 				if (error !== null && typeof error === "object" && typeof error.code === "string") return error.code;
 			}
 			/**
-			* Fetch the optional LLM directory (provider list + model catalog) when the
-			* store was constructed with an llm face. Directory failures are NOT fatal:
-			* they leave the snapshot's providers/models empty without flipping status
-			* to 'error' — only the settings/status bridge calls can do that.
+			* Fetch the optional LLM directory (provider list + model catalog).
+			*
+			* 0.1.7+ exposes it through the client Remote service: the provider directory
+			* is the join of `remote.llm.listProviders()` (registered routes) and
+			* `remote.llm.listConfigurableProviders()` (declared providers), and the model
+			* catalog is `remote.session.modelCatalog().value.groups` — the same sources
+			* the official settings-models page reads. Older hosts without a Remote `llm`
+			* namespace fall back to the legacy `connection.api.llm` face.
+			*
+			* Directory failures are NOT fatal: they leave the snapshot's providers/models
+			* empty without flipping status to 'error' — only the settings/status bridge
+			* calls can do that.
 			*/
 			async _fetchLlmDirectory() {
+				const fromRemote = await this._fetchRemoteDirectory();
+				if (fromRemote !== void 0) return fromRemote;
+				return await this._fetchLegacyDirectory();
+			}
+			/**
+			* Read the directory from the client Remote service. Returns undefined when
+			* no `remote.llm` namespace is present, so the caller can fall back.
+			*/
+			async _fetchRemoteDirectory() {
+				const llm = this.remote ? this.remote.llm : null;
+				if (llm === null || llm === void 0) return void 0;
+				let providers = [];
+				let models = [];
+				try {
+					const [registered, declared] = await Promise.all([typeof llm.listProviders === "function" ? llm.listProviders() : void 0, typeof llm.listConfigurableProviders === "function" ? llm.listConfigurableProviders() : void 0]);
+					providers = joinProviderDirectory(registered && registered.ok === true && Array.isArray(registered.value) ? registered.value : [], declared && declared.ok === true && Array.isArray(declared.value) ? declared.value : []);
+				} catch {
+					providers = [];
+				}
+				const session = this.remote ? this.remote.session : null;
+				if (session && typeof session.modelCatalog === "function") try {
+					const response = await session.modelCatalog();
+					const value = response && response.ok === true ? response.value : void 0;
+					if (value && Array.isArray(value.groups)) models = value.groups;
+				} catch {
+					models = [];
+				}
+				return {
+					providers,
+					models
+				};
+			}
+			/** Legacy directory read for hosts whose transport still exposes `api.llm`. */
+			async _fetchLegacyDirectory() {
 				if (this.llm === null || this.llm === void 0) return {
 					providers: [],
 					models: []
@@ -1349,13 +1433,15 @@ window.__ModuleLoader__.load({
 		*/
 		/**
 		* Services required by these slot registrations (dsh.client.inject is the same
-		* short-name set): slots, locale, connection, remote.
+		* short-name set): slots, locale, connection, remote, remote.llm. The dotted
+		* `remote.llm` namespace carries the provider/model directory on 0.1.7+.
 		*/
 		const inject = [
 			"slots",
 			"locale",
 			"connection",
-			"remote"
+			"remote",
+			"remote.llm"
 		];
 		/**
 		* Register the YOLO section/chip/popup once the slot declarations are on the
@@ -1374,6 +1460,7 @@ window.__ModuleLoader__.load({
 			const t = ctx.locale.bind(NS);
 			const store = new YoloStore({
 				rpc: connection.rpc,
+				remote: ctx.get("remote") ?? null,
 				llm: connection.api ? connection.api.llm : null
 			});
 			const useSnapshot = bindSnapshotSelector(store);

package/lib/index.js

@@ -5,10 +5,11 @@
  * 抢在 dsh-host-apiproxy 的人工应答者之前介入，对沙箱升权申请（
  * `escalate sandbox to <mode>: <justification>`）按预设策略自动裁决。
  *
- * v0.3.0 重做（design.md §12.3）：
+ * v0.3.0 重做（design.md §12.3）；v0.5.2 迁移至 0.1.7 的 SettingsForms：
  *   - `inject: ['llm','settings']`，用 `ctx.llm` / `ctx.settings`；
- *   - 经 `installYoloSettings` 注册 settings 分区，`effectiveConfig()` 每次裁决
- *     时取 resolved（默认 + base(行配置) + 用户层）后 `normalizeConfig`；
+ *   - 设置声明为本插件的 Config schema（`export const Config`，volatile 字段可热更），
+ *     `effectiveConfig()` 每次裁决用 `config.<field>.get()` 读取实时值后 `normalizeConfig`；
+ *   - 页面策略经 `installYoloSettingsPage`（`settings.configure({auto:false})`）注册；
  *   - `getJudge()` 按 judge 配置键缓存裁判实例（用 `ctx.llm`），键变化重建；
  *   - 审计统计写入 lib/state.js 模块级单例（bridge 条目已读）；
  *   - **不再注册任何 webServer 路由**（由独立 lib/bridge-entry.js 承担）。
@@ -28,13 +29,17 @@ import {
   ESCALATION_RE,
 } from './policy.js';
 import { createJudge, defaultJudgePromptFor } from './judge.js';
-import { installYoloSettings, validateYoloSettings, pruneEmpty } from './settings.js';
+import { YoloSettingsSchema, installYoloSettingsPage, readYoloConfig, pruneEmpty } from './settings.js';
 import { recordDecision, sessionOrigin } from './state.js';
 import { resolveAuditFile } from './audit.js';
 
 export const name = 'dsh-yolo-mode';
 
-/** settings 命名空间（与插件行 id 一致；纯小写 kebab-case）。主条目经 installYoloSettings 使用。 */
+/**
+ * 插件 Config schema（0.1.7 起即权威设置 schema；条目 id `yolo-mode` 即
+ * `describe()`/`mutate()` 的 ns）。cordis 从本导出读取并用其解析条目 config。
+ */
+export const Config = YoloSettingsSchema;
 
 /** 反向扫描会话事件，取与 req.callId 匹配的 tool/call 实参摘要（1200 字符截断）。 */
 function extractArgumentsSummary(req, session) {
@@ -76,35 +81,22 @@ export const inject = ['llm', 'settings'];
  * @param {import('@deepseek-ai/cordis').Context} ctx
  * @param {object} [rawConfig]  插件行 config（全字段可选）
  */
-export function apply(ctx, rawConfig) {
-  // 行配置通过（fail-loud）：非法配置立即抛错 → 加载失败。
-  const rowCfg = rawConfig ?? {};
-  normalizeConfig(rowCfg);
-
+export function apply(ctx, config) {
   const logger = ctx.logger('yolo-mode');
 
-  // ---- settings 分区（resolved = defaults + base(行配置) + 用户层）----
-  // installSettingsSection 在 settings 服务存在时，把 resolved scope 设为 active 源；
-  // 服务缺失/卸载时回退到 `entry`（插件行 config）。
-  let sourceThunk = undefined;
-  installYoloSettings(ctx, rowCfg, {
-    setSource: (thunk) => {
-      sourceThunk = thunk;
-    },
-    onChange: () => {
-      // resolved 已由 setSource 的 thunk 覆盖；judge 缓存按键在 getJudge 中自愈。
-    },
-    validate: validateYoloSettings,
-  });
-
-  /** 每次裁决读取的有效配置（resolved settings；未就绪时插件行 config）后规范化。 */
+  /** 每次裁决读取的有效配置（Config schema 默认 + 条目 config 实时值）后规范化。 */
   function effectiveConfig() {
-    const raw = sourceThunk ? sourceThunk() : rowCfg;
-    // resolved 含 schema 空集合默认（modes:[]/levels:{}），必须先剔除再 normalizeConfig，
-    // 否则 fail-loud 拒绝空 modes（与 settings.js 的 validate 钩子同一根因）。
-    return normalizeConfig(pruneEmpty(raw));
+    // 解析值含 schema 空集合默认（modes:[]/levels:{}），必须先剔除再 normalizeConfig，
+    // 否则 fail-loud 拒绝空 modes（与 settings.js 的写时校验同一根因）。
+    return normalizeConfig(pruneEmpty(readYoloConfig(config)));
   }
 
+  // 初始配置 fail-loud：非法配置立即抛错 → 加载失败（与旧 apply 行为一致）。
+  effectiveConfig();
+
+  // ---- settings 页面策略（0.1.7 SettingsForms；auto:false = 自建 UI）----
+  installYoloSettingsPage(ctx);
+
   const auditFile = () => resolveAuditFile(effectiveConfig());
 
   let dirEnsured = false;

package/lib/remote.js

@@ -28,10 +28,11 @@
 /**
  * 纯映射 / 线信封辅助在顶部（无 cordis），可在普通 node 环境单测。
  *
- * DSH 0.1.2-alpha.4 兼容：dsh-settings 的 `settingsNamespace()` 品牌函数已
- * 删除，命名空间为纯 kebab-case 字符串字面量（`yolo-mode`）；`mutate` /
- * `describe` / `writable` 仍为 `SettingsProvider` 实例方法，
- * `SettingsConflictError` 导出保留（code 'SETTINGS_CONFLICT'）。
+ * DSH 0.1.7-rc.1 兼容：dsh-settings 默认导出由 `SettingsProvider` 改为
+ * `SettingsForms`，但其 `describe` / `writable` / `mutate` / `replace` /
+ * `update` 方法面与 `SettingsConflictError`（code 'SETTINGS_CONFLICT'）不变，
+ * 故本桥的线协议与端点形状无需改动，仅内部实现改由 `SettingsForms` 承担。
+ * 命名空间仍为纯 kebab-case 字符串字面量（`yolo-mode`，等于插件条目 id）。
  *
  * @module lib/remote.js
  */
@@ -247,8 +248,8 @@ function yoloConflict(conflict) {
 /**
  * 对 settings seam 执行一次路径 op 变更并映射为 RpcResult（携带新 redacted view，
  * 或 settings-conflict / settings-rejected 错误）。纯函数可注入 mutate/describe 测试。
- * alpha.4 起命名空间为纯 kebab-case 字符串（`settingsNamespace()` 品牌已删除），
- * `ns` 原样透传给 SettingsProvider.mutate（其内部按 `^[a-z][a-z0-9-]*$` 校验）。
+ * 0.1.7 起 `ns` 即插件条目 id，原样透传给 SettingsForms.mutate；非 volatile 路径
+ * 会被其拒绝（映射为 settings-rejected）。
  * @param {Function} mutate settings.mutate 绑定
  * @param {Function} describe settings.describe 绑定
  * @param {string} ns 命名空间字符串

package/lib/settings.js

@@ -5,14 +5,18 @@
  * `yolo-mode`，用 schemastery 宽松 schema 解析分区值，写时校验委托
  * ./policy.js 的 `normalizeConfig`（fail-loud 抛错即拒绝写入）。
  *
- * 分层层（design.md §12.3）：插件行 config 作为 settings 的 `base` 层，
- * 用户文档写在上层；`installYoloSettings` 走 `SettingsProvider.installSection`
- * 的可选-settings 消费者接线，部署无 settings 服务时打 debug 日志跳过（零侵入）。
+ * 分层层（design.md §12.3 + 0.1.7 单层迁移）：0.1.7 起设置不再由
+ * settings.yaml 覆盖层承载，而是**当前 Profile 的插件条目 config 单层**——
+ * schemastery Config schema 的默认值即 base 层，用户在设置页的改动写回该
+ * 条目 config。故本模块导出的 `YoloSettingsSchema` 同时是插件 Config schema
+ * （见 lib/index.js 的 `export const Config`），每个可热更字段用 `.volatile()`
+ * 声明；读取用 `config.<field>.get()`。
  *
- * DSH 0.1.2-alpha.4 兼容：dsh-settings 改为类服务——默认导出 `SettingsProvider`，
- * `installSettingsSection` / `settingsNamespace` 函数导出已删除；命名空间改为
- * 纯 kebab-case 字符串字面量（模板校验 `^[a-z][a-z0-9-]*$`），消费接线改为
- * `ctx.settings.installSection(owner, ns, schema, entry, hooks)`。
+ * DSH 0.1.7-rc.1 兼容：dsh-settings 默认导出由 `SettingsProvider`
+ * （`installSection`）改为 `SettingsForms`（`describe/update/replace/mutate`）。
+ * `installSection` 已删除；页面策略改走
+ * `ctx.settings.configure({ auto }, ownerFiber)`（auto:false = 插件自建 UI）。
+ * 旧的 `settings.yaml` 由 `SettingsForms.importLegacyDocument` 一次性导入。
  *
  * 纯 JavaScript（ESM），宿主代码仅 import node: 内置与同包 peer
  * （@deepseek-ai/dsh-settings、@deepseek-ai/schemastery）。
@@ -29,26 +33,53 @@ export const YOLO_SETTINGS_NAMESPACE = 'yolo-mode';
 const PRESETS = ['off', 'strict', 'balanced', 'permissive', 'yolo', 'custom'];
 
 /**
- * schemastery 宽松 schema：全字段可选（object 字段默认可选），
- * 使未写入的空白分区解析为空对象，绝不泄漏默认值覆盖插件行 config。
- * 真正的形状/语义校验由写时 `validateYoloSettings = normalizeConfig` 完成（fail-loud）。
+ * schemastery Config schema（0.1.7 起同时是插件的权威设置 schema）：全字段可选
+ * （object 字段默认可选），使未写入的空白分区解析为空对象，绝不泄漏默认值覆盖
+ * 条目 config 的普通层。每个顶层字段用 `.volatile()` 声明为可热更——设置页的
+ * 写回经 loader 的 `_commitVolatile` 就地更新引用，插件无需重启；这与旧模型
+ * "只改某些字段不重启插件" 的行为一致。
+ *
+ * 注意：`.volatile()` 不可嵌套（schemastery 校验"volatile 字段需固定对象路径"），
+ * 故只标注顶层字段；其子路径由 `isVolatilePath` 视作可热更。
+ *
+ * 真正的形状/语义校验由写时 `validateYoloSettings = normalizeConfig` 完成（fail-loud）
+ * 以及 schemastery 在 configEditor 写回时的解析校验。
  */
 export const YoloSettingsSchema = z.object({
-  preset: z.union([...PRESETS]).default('balanced'),
-  modes: z.array(z.string()),
-  levels: z.dict(z.any()),
-  judge: z.object({
-    provider: z.string(),
-    model: z.string(),
-    systemPrompt: z.string(),
-    timeoutMs: z.natural(),
-    maxTokens: z.natural(),
-    concurrency: z.natural(),
-  }),
-  includeSubagents: z.boolean(),
-  auditFile: z.string(),
+  preset: z.union([...PRESETS]).default('balanced').volatile(),
+  modes: z.array(z.string()).volatile(),
+  levels: z.dict(z.any()).volatile(),
+  judge: z
+    .object({
+      provider: z.string(),
+      model: z.string(),
+      systemPrompt: z.string(),
+      timeoutMs: z.natural(),
+      maxTokens: z.natural(),
+      concurrency: z.natural(),
+    })
+    .volatile(),
+  includeSubagents: z.boolean().volatile(),
+  auditFile: z.string().volatile(),
 });
 
+/**
+ * 从已解析的 Config 读取当前设置值（0.1.7：`config.<field>.get()`）。
+ * volatile 引用由 loader 就地更新，故每次裁决读取即为最新值。
+ * @param {object} config apply(ctx, config) 收到的已解析 Config
+ * @returns {object} 仅含 schema 字段的普通对象（未设字段为 undefined/空集合）
+ */
+export function readYoloConfig(config) {
+  return {
+    preset: config.preset.get(),
+    modes: config.modes.get(),
+    levels: config.levels.get(),
+    judge: config.judge.get(),
+    includeSubagents: config.includeSubagents.get(),
+    auditFile: config.auditFile.get(),
+  };
+}
+
 /**
  * 剔除 schema 解析出的"空集合默认值"（schemastery 对 array/dict 缺省解析为
  * []/{}，标量缺省为 absent），避免把这些默认空值当成用户配置喂给
@@ -88,20 +119,17 @@ export function validateYoloSettings(value) {
 }
 
 /**
- * 安装 yolo-mode settings 分区（可选-settings 消费者接线）。
- * settings 服务缺失时打 debug 日志并跳过（插件继续按插件行 config 运行）。
- * @param {import('@deepseek-ai/cordis').Context} ctx
- * @param {object} entry 插件行 config（成为 settings `base` 层）
- * @param {import('@deepseek-ai/dsh-settings').SettingsSectionHooks<object>} hooks
- *   { setSource, onChange, validate? }
+ * 注册 yolo-mode 的设置页面策略（0.1.7 `SettingsForms.configure`）。
+ *
+ * 插件自带 Web 客户端设置页（slot `settings.section`），故 `auto:false`
+ * 禁止宿主再自动生成重复页面；页面策略注册到本插件 fiber 的 effects，
+ * 卸载时自动注销。settings 服务缺失时 `ctx.inject` 回调不运行（零侵入，
+ * 插件继续按 Config schema 默认 + 条目 config 运行）。
+ *
+ * @param {import('@deepseek-ai/cordis').Context} ctx 主插件 fiber 的上下文
  */
-export function installYoloSettings(ctx, entry, hooks) {
-  const settings = ctx.get('settings');
-  if (settings === undefined) {
-    ctx.logger.debug(
-      '[yolo-mode] no settings service mounted; using composition config and skipping settings section registration',
-    );
-    return;
-  }
-  settings.installSection(ctx, YOLO_SETTINGS_NAMESPACE, YoloSettingsSchema, entry, hooks);
+export function installYoloSettingsPage(ctx) {
+  ctx.inject(['settings'], (child) => {
+    child.effect(() => child.settings.configure({ auto: false }, ctx.fiber));
+  });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-yolo-mode",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "dsh-yolo-mode —— DeepSeek Harness 双面包插件：当会话处于可写沙箱模式且审批策略为 ask 时，用大模型自动裁决沙箱升权申请，支持内置预设与自定义权限层级，并提供宿主 settings + 自发布设置桥（/yolo-mode）与 Web 客户端 UI。",
   "type": "module",
   "main": "lib/index.js",
@@ -41,22 +41,22 @@
   "peerDependencies": {
     "react": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-timeout": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-timeout": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
     "@deepseek-ai/dsh-host-apiproxy": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
     "rolldown": "^1.2.4",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-timeout": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-timeout": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "scripts": {
@@ -74,14 +74,17 @@
         "slots",
         "locale",
         "connection",
-        "remote"
+        "remote",
+        "remote.llm"
       ]
     },
     "compatibility": {
       "dshReleases": {
         "0.1.5-rc.1": "compatible",
         "0.1.5-rc.2": "compatible",
-        "0.1.6-alpha.2": "compatible"
+        "0.1.6-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible",
+        "0.1.7-rc.2": "compatible"
       },
       "node": ">=20"
     }