dsh-yolo-mode 0.5.1 → 0.5.2-beta.0

package/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)。
 
+## [0.5.2-beta.0] - 2026-09-24
+
+### Beta（DSH 0.1.7-rc.1 适配，测试版）
+
+- 本分支（`dev-0.1.7.rc1`，尚未合并 `main`）相对 `main` 的适配改动：设置子系统按
+  0.1.7 的 `SettingsForms` 新模型重写（`lib/settings.js` / `lib/index.js` /
+  `lib/remote.js`），`@deepseek-ai/dsh-llm`、`dsh-timeout`、`dsh-settings`、
+  `dsh-client-connection`、`dsh-client-ui-slots`、`dsh-client-locale` 的 peer 范围升至
+  `^0.1.7-rc.1`，`dsh.compatibility.dshReleases` 新增 `"0.1.7-rc.1": "compatible"`，
+  README 徽章与兼容性说明同步。详见下方 `0.5.2` 条目。
+- 发布为 npm 测试版（`--tag beta`）；`latest` 保持不变。正式版 `0.5.2` 待 `main` 合并后发布。
+
+## [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,10 @@
 
 [![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-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**。
+> **兼容性**：v0.5.2 支持 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** 实测（真实-Cordis 探针通过；设置子系统已迁移至 0.1.7 的 `SettingsForms`——插件 Config schema + volatile 热更 + 自建设置页）。旧版 DSH（0.1.0-rc.6 / rc.8）请使用最后兼容的 npm 版本 **0.4.1**。
 
 ---
 

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.2-beta.0",
   "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": {
@@ -81,7 +81,8 @@
       "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"
       },
       "node": ">=20"
     }