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

package/CHANGELOG.md

@@ -2,6 +2,92 @@
 
 本项目遵循 [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）
+
+- **默认 `judge.maxTokens` 256 → 4096**（`lib/policy.js` 默认配置与 `normalizeConfig`
+  合并值、`lib/judge.js` 兜底值同步）。根因：推理型裁判模型把 token 预算全部消耗在
+  reasoning 块上，`maxTokens` 过小时 `content` 为空（`finish_reason=length`），裁判抛
+  `BAD_OUTPUT` 并按 `error` 回退——`balanced` 预设下表现为「每次都转人工」，而
+  `judgeConfigured:true` 掩盖了失败。用户实测 4096 为可用值（256/1024 输出为 0）。
+- **审计条目新增 `error` 字段**（`lib/index.js`）：裁判失败时写入 `JudgeError.code`
+  （`BAD_OUTPUT` / `TIMEOUT` / `STREAM_ERROR` / `NO_ADAPTER` 等），使
+  `outcome:"delegate"` 的条目可区分「裁判失败转人工」与「裁判主动授意转人工」；
+  成功路径字段形状不变（不新增 `error`）。
+- **失败可见**（`lib/state.js`）：新增 `stats.judgeFailures` 计数与
+  `judgeHealth.lastError/lastErrorTime`，经 `getStatusPayload` 以
+  `judgeErrors: { count, lastError?, lastErrorTime? }` 暴露；裁判异常不再仅停留于
+  `logger.warn`。
+- **文档**：README 标注推理型模型必须调大 `judge.maxTokens`（默认已改 4096），并补充
+  审计 `error` 字段与 `judgeErrors` 载荷说明。
+
+### 测试
+
+- `test/policy.test.mjs`：默认 `maxTokens` 断言更新为 4096。
+- `test/judge.test.mjs`：新增「未显式传 `maxTokens` → 默认 4096 传入 `llm.stream`」用例。
+- `test/state.test.mjs`：新增裁判失败时 `judgeFailures` 递增、`judgeErrors` 载荷装配用例。
+- `test/probe.test.mjs`：新增真实-Cordis 用例——裁判产出非 JSON（`BAD_OUTPUT`）→
+  审计条目带 `error:"BAD_OUTPUT"` 且回退 delegate；成功路径断言 recent 条目**不含** `error`。
+
+### 兼容性
+
+- **新增 `dsh.compatibility` 声明**（DSH STORE 上架契约）：逐版本声明
+  `dshReleases` 兼容矩阵——`0.1.5-rc.1` / `0.1.5-rc.2` / `0.1.6-alpha.2` 均为
+  `compatible`（三版本已在本机真实装载运行，插件正常加载、零错误）；`node` 范围
+  `>=20`，与 `engines.node` 一致。未实测的版本不声明（扫描时按 `unknown` 处理）。
+
 ## [0.5.0] - 2026-09-04
 
 ### 兼容：DSH 0.1.2-alpha.4

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--alpha.4-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.0 支持 DSH **0.1.2-alpha.4+**（真实-Cordis 探针 125/125 通过；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**。
 
 ---
 
@@ -77,11 +77,13 @@ dsh plugin --profile web add <项目绝对路径>
 | `judge.model` | `string` | `''` | 裁判模型；与 provider 同非空才启用裁判 |
 | `judge.systemPrompt` | `string` | `''` | 裁判 system prompt；空 = 按预设取默认 |
 | `judge.timeoutMs` | `number` | `20000` | 单次裁判超时（毫秒） |
-| `judge.maxTokens` | `number` | `256` | 裁判输出最大 token 数 |
+| `judge.maxTokens` | `number` | `4096` | 裁判输出最大 token 数（推理型模型需调大，见下方说明） |
 | `judge.concurrency` | `number` | `2` | 并发裁判上限，溢出按错误回退 |
 | `includeSubagents` | `boolean` | `true` | 子代理会话是否同样裁决 |
 | `auditFile` | `string` | `''` | 审计日志路径；空 = `%TEMP%/dsh-yolo/judge.log` |
 
+> ⚠️ **推理型模型必须调大 `judge.maxTokens`**：若裁判模型会先输出一段内部推理（reasoning / chain-of-thought）再给出结论 JSON，则 token 预算会被推理内容消耗；预算过小时 `content` 为空、`finish_reason=length`，裁判以 `BAD_OUTPUT` 失败并回退为「转人工」（默认预设 `balanced` 下表现为**每次都弹人工审批**）。默认值已从 `256` 提升至 **`4096`**；若仍遇到回退，请继续调大（如 `8192`）。审计日志中此类失败会带 `error: "BAD_OUTPUT"`。
+
 ### 权限层级（`levels`）
 
 ```yaml
@@ -130,7 +132,8 @@ levels:
 - **防回环**：裁判 prompt 与 agent 上下文隔离，防止模型借 Web 审批回环自批准 `danger-full-access`。
 - **不改写策略**：仅在 `ask` 策略下作为应答者，不改变 DSH 的沙箱 / 审批词汇。
 - **默认保守**：默认预设 `balanced`（不确定转人工），不默认启用 `permissive` / `yolo`。
-- **审计**：每次裁决落一行 JSONL，含 `{time, sessionId, origin, toolName, callId?, targetMode, currentMode, justification, decision, outcome, reason?}`。
+- **审计**：每次裁决落一行 JSONL，含 `{time, sessionId, origin, toolName, callId?, targetMode, currentMode, justification, decision, outcome, reason?, error?}`。`error` 仅在**裁判失败**时出现（值为 `JudgeError` 错误码，如 `BAD_OUTPUT` / `TIMEOUT` / `STREAM_ERROR` / `NO_ADAPTER`）；`outcome:"delegate"` 且有 `error`＝裁判失败转人工，无 `error`＝裁判主动转人工，二者可区分。
+- **失败可见**：statusView 载荷携带 `judgeErrors: { count, lastError?, lastErrorTime? }`（累计裁判失败次数与最近一次错误码），裁判异常不再只停留在 `logger.warn`。
 
 ## 开发
 

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;
@@ -247,13 +239,17 @@ export function apply(ctx, rawConfig) {
 
     // 7. 裁决映射（judge 走裁判，含未配置/失败/不确定回退）。
     const judge = getJudge();
-    let judgeReason; // 裁判 reason 仅在 judge 路径产出时记录（审计 reason?）。
+    let judgeReason; // 裁判 reason 仅在 judge 路径产出时记录（审计 reason 字段）。
+    let judgeError; // 裁判失败的错误码（审计 error 字段；成功/非 judge 路径为 undefined）。
     const result = await (async () => {
       if (decision === 'allow') return { outcome: 'allowed-once' };
       if (decision === 'deny') return { outcome: 'rejected' };
       if (decision === 'delegate') return { delegate: true };
       // decision === 'judge'
-      if (!judge) return fallback('error', cfg);
+      if (!judge) {
+        judgeError = 'NO_ADAPTER'; // provider/model 未配置：与 judge.js 的 NO_ADAPTER 同语义
+        return fallback('error', cfg);
+      }
       try {
         const r = await judge({
           toolName: req.toolName,
@@ -268,6 +264,7 @@ export function apply(ctx, rawConfig) {
         if (r.decision === 'deny') return { outcome: 'rejected' };
         return fallback('unsure', cfg); // 不确定
       } catch (err) {
+        judgeError = (err && typeof err === 'object' && err.code) ? String(err.code) : 'UNKNOWN';
         logger.warn('LLM 裁判失败，按预设 error 回退', errorDescriptor(err));
         return fallback('error', cfg);
       }
@@ -275,7 +272,8 @@ export function apply(ctx, rawConfig) {
 
     const outcome = result.delegate ? 'delegate' : result.outcome;
 
-    // 8. 审计。
+    // 8. 审计。裁判失败时带 error 字段（区分「裁判失败」与「裁判主动转人工」）；
+    //    成功路径字段形状不变（不新增 error）。
     audit({
       time: Date.now(),
       sessionId: (session && session.id) || (req.agent && req.agent.id),
@@ -288,6 +286,7 @@ export function apply(ctx, rawConfig) {
       decision,
       outcome,
       reason: judgeReason,
+      ...(judgeError !== undefined ? { error: judgeError } : {}),
     });
 
     // 9. delegate → next() 透明委托；否则返回归一化 outcome。

package/lib/judge.js

@@ -151,7 +151,7 @@ function throwAbort(signal, upstream) {
  * @param {string} opts.model              model id
  * @param {string} [opts.systemPrompt]     空/缺省 → 内置裁判 prompt（含防回环要求）
  * @param {number} [opts.timeoutMs=20000]  单次裁判调用超时（毫秒）
- * @param {number} [opts.maxTokens=256]    最大输出 token
+ * @param {number} [opts.maxTokens=4096]   最大输出 token（推理型模型需调大，见 README）
  * @param {number} [opts.concurrency=2]    信号量上限
  * @param {AbortSignal} [opts.signal]      上游取消信号（ABORTED 时中止；可空）
  * @returns {Function} async judge(input) -> {{decision:'allow'|'deny'|'unsure', reason:string}}
@@ -159,7 +159,7 @@ function throwAbort(signal, upstream) {
 export function createJudge({ llm, provider, model, systemPrompt, timeoutMs, maxTokens, concurrency, signal }) {
   const sys = typeof systemPrompt === 'string' && systemPrompt.trim() !== '' ? systemPrompt : DEFAULT_SYSTEM_PROMPT
   const ms = isPositiveInt(timeoutMs) ? timeoutMs : 20000
-  const mt = isPositiveInt(maxTokens) ? maxTokens : 256
+  const mt = isPositiveInt(maxTokens) ? maxTokens : 4096
   const cap = isPositiveInt(concurrency) ? concurrency : 2
 
   // 信号量计数（活跃调用数）。进入者先同步占位，用后的 try/finally 释放。

package/lib/policy.js

@@ -87,7 +87,7 @@ function defaultConfig() {
     preset: 'balanced',
     modes: ['workspace-write'],
     levels: {},
-    judge: { provider: '', model: '', systemPrompt: '', timeoutMs: 20000, maxTokens: 256, concurrency: 2 },
+    judge: { provider: '', model: '', systemPrompt: '', timeoutMs: 20000, maxTokens: 4096, concurrency: 2 },
     includeSubagents: true,
     auditFile: '',
   }
@@ -187,7 +187,7 @@ export function normalizeConfig(raw) {
     model: jraw.model === undefined ? '' : jraw.model,
     systemPrompt: jraw.systemPrompt === undefined ? '' : jraw.systemPrompt,
     timeoutMs: jraw.timeoutMs === undefined ? 20000 : jraw.timeoutMs,
-    maxTokens: jraw.maxTokens === undefined ? 256 : jraw.maxTokens,
+    maxTokens: jraw.maxTokens === undefined ? 4096 : jraw.maxTokens,
     concurrency: jraw.concurrency === undefined ? 2 : jraw.concurrency,
   }
   for (const field of ['provider', 'model', 'systemPrompt']) {

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/lib/state.js

@@ -20,8 +20,13 @@ import { resolveAuditFile } from './audit.js'
 /** recent 环形缓冲上限（design.md §11.1/12.4，≤20）。 */
 export const RECENT_CAP = 20;
 
-/** 模块级统计计数（设计 §3.8/12.3；主条目内存写，桥接条目只读）。 */
-export const stats = { total: 0, allowed: 0, rejected: 0, delegated: 0 };
+/** 模块级统计计数（设计 §3.8/12.3；主条目内存写，桥接条目只读）。
+ *  judgeFailures 统计裁判失败次数（审计条目带 error 字段的次数），使「裁判挂了」
+ *  在状态面板可见、区别于「裁判主动转人工」。 */
+export const stats = { total: 0, allowed: 0, rejected: 0, delegated: 0, judgeFailures: 0 };
+
+/** 最近一次裁判失败的健康信息（code + 时间戳）；无失败时 lastError 为 undefined。 */
+export const judgeHealth = { lastError: undefined, lastErrorTime: undefined };
 
 /** recent 环形缓冲：新条目 unshift 到头部，超过上限截断尾部（倒序，≤RECENT_CAP）。 */
 const recent = [];
@@ -55,7 +60,8 @@ export function sessionOrigin(session) {
  * 记录一次裁决到模块级统计与 recent 环（主条目 audit() 调用）。
  * @param {object} entry 审计条目：
  *   { time, sessionId, origin, toolName?, callId?, targetMode, currentMode?,
- *     justification, decision, outcome, reason? }
+ *     justification, decision, outcome, reason?, error? }
+ *   error 仅在裁判失败时存在（JudgeError.code）；成功路径不携带该字段。
  */
 export function recordDecision(entry) {
   recent.unshift({
@@ -65,6 +71,7 @@ export function recordDecision(entry) {
     decision: entry.decision,
     outcome: entry.outcome,
     ...(entry.reason !== undefined ? { reason: entry.reason } : {}),
+    ...(entry.error !== undefined ? { error: entry.error } : {}),
   });
   if (recent.length > RECENT_CAP) recent.length = RECENT_CAP;
 
@@ -72,13 +79,18 @@ export function recordDecision(entry) {
   if (entry.outcome === 'delegate') stats.delegated += 1;
   else if (entry.outcome === 'allowed-once') stats.allowed += 1;
   else if (entry.outcome === 'rejected') stats.rejected += 1;
+  if (entry.error !== undefined) {
+    stats.judgeFailures += 1;
+    judgeHealth.lastError = entry.error;
+    judgeHealth.lastErrorTime = entry.time;
+  }
 }
 
 /**
  * 以浅拷贝装配 statusView 载荷（design.md §12.4）。
  * @param {object} cfg 含 { preset, judge?: { provider?, model? }, auditFile? } 的配置字形
  *   （主条目传 effectiveConfig()；桥接条目传 settings.describe 推导的 view 字形）
- * @returns {{preset:string, judgeConfigured:boolean, presetDefaults:object, stats:object, recent:Array<object>, auditFile:string}}
+ * @returns {{preset:string, judgeConfigured:boolean, presetDefaults:object, stats:object, judgeErrors:object, recent:Array<object>, auditFile:string}}
  */
 export function getStatusPayload(cfg) {
   const c = cfg && typeof cfg === 'object' ? cfg : {};
@@ -88,6 +100,13 @@ export function getStatusPayload(cfg) {
     judgeConfigured: Boolean(j.provider && j.model),
     presetDefaults,
     stats: { ...stats },
+    // 裁判失败健康信息：累计失败次数 + 最近一次错误码/时间（无失败时 lastError 缺省）。
+    judgeErrors: {
+      count: stats.judgeFailures,
+      ...(judgeHealth.lastError !== undefined
+        ? { lastError: judgeHealth.lastError, lastErrorTime: judgeHealth.lastErrorTime }
+        : {}),
+    },
     recent: recent.map((r) => ({ ...r })),
     // 生效的审计日志路径（resolveAuditFile 与主条目 audit() 同一解析规则），
     // 供客户端「打开日志」按钮展示/复用。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-yolo-mode",
-  "version": "0.5.0",
+  "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.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/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.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.4",
+    "@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": {
@@ -76,6 +76,15 @@
         "connection",
         "remote"
       ]
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.1.5-rc.1": "compatible",
+        "0.1.5-rc.2": "compatible",
+        "0.1.6-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible"
+      },
+      "node": ">=20"
     }
   }
-}
+}