@shgroup/dsh-serenity-hooks 1.45.1 → 1.47.0

package/README.md

@@ -3,7 +3,7 @@
 > **一句话**：装上这个插件，你在电脑上给 AI 划一块自己的工作区（就是一个普通目录），
 > AI 在里面干活时就有了**记忆、纪律、工具和边界**——中途换模型、重启电脑、第二天再来，都能接着干。
 >
-> 适用 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（下称 DSH）0.1.5-rc.2 及以上。
+> 适用 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（下称 DSH）0.1.7-rc.1 及以上。
 > 想了解背后的想法（为什么叫"认知容器"），看 [docs/cognitive-container-theory.md](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/docs/cognitive-container-theory.md)；本文只讲**能干什么、怎么用**。
 
 **几个词先说明白**（后面都用这几个词，不再解释）：
@@ -32,7 +32,7 @@
 
 ## 2. 快速开始（2 分钟）
 
-前置：Node ≥ 20（或 bun）、DSH 0.1.5-rc.2 及以上。
+前置：Node ≥ 20（或 bun）、DSH 0.1.7-rc.1 及以上。
 
 ```bash
 # 1. 装插件（自动加入 DSH 的 web profile）
@@ -423,4 +423,4 @@ pnpm build              # 打包（lib/index.js + client.js）
 
 MIT（见 [LICENSE](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/LICENSE)）
 
-> **版本**：v1.31.13 ｜ **前置**：DSH 0.1.5-rc.2+ / Node ≥ 20 或 bun ｜ **测试**：80 个文件 / 1186 个用例
+> **版本**：v1.47.0 ｜ **前置**：DSH 0.1.7-rc.1+ / Node ≥ 20 或 bun ｜ **测试**：107 个文件 / 1679 个用例

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.45.1",
+  "version": "1.47.0",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag；后两个按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2（deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/client.js

@@ -208,7 +208,7 @@ window.__ModuleLoader__.load({
 								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: cx("sp-switchThumb") })
 							})
 						] }),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, {
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineMedium, {
 							size: 12,
 							className: cx("sp-chev")
 						})
@@ -289,7 +289,7 @@ window.__ModuleLoader__.load({
 										disabled: busy,
 										onClick: () => void toggle(!status.safeModeOn),
 										children: [
-											status.safeModeOn && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, {
+											status.safeModeOn && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutlineMedium, {
 												size: 14,
 												className: cx("sp-toggleIcon")
 											}),
@@ -4672,8 +4672,6 @@ Instruction-following style:
 		}
 		//#endregion
 		//#region src/client/SettingsSection.tsx
-		/** 降级提示文案（旧 RC 白名单时引导去宁静号面板） */
-		const DEGRADE_NOTE = "当前运行版本未暴露 serenity-hooks 配置（旧 RC 白名单）。请升级 DSH 或使用会话头部 Serenity 状态栏。";
 		/** 开关（官方 settings 语言：label 右置 toggle，--dsw-alias-* token） */
 		function Toggle(props) {
 			const { checked, disabled, onChange } = props;
@@ -4791,32 +4789,20 @@ Instruction-following style:
 		}
 		/** dsh 原生设置面板：serenity-hooks 配置页（官方 settings 设计语言，多级标题） */
 		function SettingsSection(props) {
-			const { scope } = props;
-			const [snapshot, setSnapshot] = (0, react.useState)(() => scope.getSnapshot());
-			(0, react.useEffect)(() => {
-				return scope.subscribe(() => setSnapshot(scope.getSnapshot()));
-			}, [scope]);
-			const value = snapshot.value;
-			const ready = snapshot.status === "ready";
+			const { set, useSerenitySettings } = props;
+			const value = useSerenitySettings((s) => s).value;
 			const toggle = (field, on) => {
-				scope.set(field, on);
+				set(field, on);
 			};
 			const setThreshold = (v) => {
-				scope.set("rebuildThresholdK", Math.min(4e3, Math.max(50, Math.round(v))));
+				set("rebuildThresholdK", Math.min(4e3, Math.max(50, Math.round(v))));
 			};
 			const setSkiffPort = (v) => {
-				scope.set("skiffDebugPort", Math.min(65535, Math.max(1024, Math.round(v))));
+				set("skiffDebugPort", Math.min(65535, Math.max(1024, Math.round(v))));
 			};
 			const setAcpPort = (v) => {
-				scope.set("acpHttpPort", Math.min(65535, Math.max(1024, Math.round(v))));
+				set("acpHttpPort", Math.min(65535, Math.max(1024, Math.round(v))));
 			};
-			if (!ready) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "ss-section",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-					className: "ss-degrade",
-					children: DEGRADE_NOTE
-				})
-			});
 			const gatewayOn = value?.gatewayEnabled ?? false;
 			const rebuildOn = value?.rebuildEnabled ?? true;
 			const thresholdK = value?.rebuildThresholdK ?? 400;
@@ -4826,12 +4812,14 @@ Instruction-following style:
 			const acpPort = value?.acpHttpPort ?? 3100;
 			const publicAskOn = value?.publicAskEnabled ?? false;
 			const croOn = value?.croEnabled ?? true;
+			const unattendedOn = value?.unattendedEnabled ?? false;
 			const [openGateway, setOpenGateway] = (0, react.useState)(false);
 			const [openRebuild, setOpenRebuild] = (0, react.useState)(false);
 			const [openSkiff, setOpenSkiff] = (0, react.useState)(false);
 			const [openAcp, setOpenAcp] = (0, react.useState)(false);
 			const [openPublicAsk, setOpenPublicAsk] = (0, react.useState)(false);
 			const [openCro, setOpenCro] = (0, react.useState)(false);
+			const [openUnattended, setOpenUnattended] = (0, react.useState)(false);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "ss-section",
 				children: [
@@ -4902,6 +4890,27 @@ Instruction-following style:
 							})
 						}) })
 					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Group, {
+						title: "无人值守",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
+							title: "无人值守代理回复",
+							desc: "你走开后，会话被模型停下且无人应答时，由 ACC 代你回一句让它自己收束（默认关）",
+							expandable: true,
+							open: openUnattended,
+							onToggle: setOpenUnattended,
+							control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Toggle, {
+								checked: unattendedOn,
+								onChange: (on) => toggle("unattendedEnabled", on)
+							}),
+							detail: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "ss-detailStack",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: "ss-detailIntro",
+									children: "无人值守代理回复（unattended proxy）\n· 作用：你发完任务就走开，模型干一段停下来又没人接话 ⇒ 会话就挂住了；\n  本机制由 ACC 注入一条“代理用户”的结构化回复，让它自己接着干\n· 收束方式：每轮给一个验证码；只有四种明确收束才放过 —— 干完了 / 已通知你并停下等你 /\n  需确认但可自决（按最保守可逆的做并记理由）/ 撞上“不可代批”的事（立刻停并写待办）\n· 身份：代理消息会自报“无人值守代理 · 非本人”，不会被当成你说的话\n· 不适用：有 CRO 自编程唤起程序的轨迹（它自己会叫自己）、对外面与微信桥会话、子代理会话\n· 默认关：它把“人”从回路里拿掉，失败是静默的 ⇒ 只在你要离开时才开\n· 配套：你自己用 send-later 给自己排的“定时叫醒”（现在约每 2 小时一次）会改成“很久才叫一次”（6–12 小时）；\n  平时“接着干”的活交给本机制 —— ⚠️ 只在本机制上线之后才这么改，否则中间会出现没人管的空档\n· 本版现状：机制已实现（开关 ＋ 注入行为 ＋ 流水）；⚠️ 尚未部署 ⇒ 现在拨开关不会生效，等发布后生效"
+								})
+							})
+						}) })
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Group, {
 						title: "外部能力",
 						children: [
@@ -5147,19 +5156,16 @@ Instruction-following style:
 			"slots",
 			"conversation",
 			"sessions",
-			"settingsScope"
+			"configForms"
 		];
-		/** serenity-hooks 简单配置 scope spec（与 host 侧 registerSettingsSection 对齐） */
-		const SERENITY_SCOPE_SPEC = {
-			namespace: "serenity-hooks",
-			decode: (section) => section !== null && typeof section === "object" ? section : void 0
-		};
+		/** 设置页命名空间 = profile 条目 id（与 host 侧 `SERENITY_SETTINGS_NS` 同值；单一真相源在 host 侧常量，此处只作字面量引用） */
+		const SERENITY_SETTINGS_NS = "serenity-hooks";
 		function apply(ctx) {
 			ctx.inject([
 				"slots",
 				"conversation",
 				"sessions",
-				"settingsScope"
+				"configForms"
 			], (scope) => {
 				scope.effect(() => scope.slots.register({
 					name: "conversation.session.header.actions",
@@ -5182,14 +5188,19 @@ Instruction-following style:
 					order: 110,
 					inject: () => ({ uploadFile: (file, sessionId) => uploadFile(file, sessionId) })
 				}, FileFallbackDock), "serenity: file fallback dock");
-				const serenityScope = scope.get("settingsScope").bind(SERENITY_SCOPE_SPEC);
-				scope.effect(() => scope.slots.register({
+				const serenityForm = scope.configForms.get(SERENITY_SETTINGS_NS);
+				scope.effect(() => scope.configForms.whileServed([SERENITY_SETTINGS_NS], () => scope.slots.inject("settings.section", () => scope.slots.register({
 					name: "settings.section",
-					id: "serenity-hooks",
+					id: SERENITY_SETTINGS_NS,
 					order: 90,
 					label: () => "Serenity",
-					inject: () => ({ scope: serenityScope })
-				}, SettingsSection), "serenity: simple settings section");
+					inject: () => ({
+						hooks: { serenitySettings: serenityForm },
+						set: (field, value) => {
+							serenityForm.set(field, value).catch((_error) => {});
+						}
+					})
+				}, SettingsSection))), "serenity: simple settings section");
 			});
 		}
 		//#endregion

package/lib/cro-turns.d.ts

@@ -12,7 +12,7 @@
  *
  * | 事件 | 动作 | 出处 |
  * |---|---|---|
- * | `agent/session-start` | 标记「在跑」 | `host/contract.ts:275`（dsp 已在 `seams/context.ts:235` 订阅） |
+ * | `agent/created` | 标记「在跑」 | `host/contract.ts`（dsp 已在 `seams/context.ts` 订阅）。⚠️ v0.1.7 前名为 `agent/session-start`；新事件 `@mode = serial` ⇒ 处理函数须快速返回 |
  * | `agent/turn-stopping` | 清除标记 | `host/contract.ts:277`（dsp 已在 `rebuild.ts:442` 等 4 处订阅） |
  * | `agent/disposed` | **清该载体的项** | `host/contract.ts:280` |
  * | `session/disposed` | **清该载体的项** | `host/contract.ts:283` |
@@ -52,7 +52,7 @@ import type { Context } from 'cordis';
 import type { Agent } from '@deepseek-ai/dsh-agent';
 /** 一次「在跑」记录的 TTL（见文件头的方向性判据） */
 export declare const TURN_TTL_MS: number;
-/** 标记「在跑」（`agent/session-start` + `agent/status=running` 调用） */
+/** 标记「在跑」（`agent/created` + `agent/status=running` 调用） */
 export declare function markTurnRunning(sessionId: string, nowMs: number, turn?: number | null): void;
 /** 清除「在跑」（`turn-stopping` / disposed 调用） */
 export declare function clearTurnRunning(sessionId: string): void;
@@ -82,7 +82,7 @@ export declare function __resetCroTurnsForTest(): void;
  * 装配追踪（`index.ts` apply 调用）：订阅四个既有事件 + 拆卸。
  *
  * **为什么订阅四个而不是两个**（R↓）：
- * · 前两个（`session-start` / `turn-stopping`）负责**语义**——"在不在跑"；
+ * · 前两个（`agent/created` / `turn-stopping`）负责**语义**——"在不在跑"；
  * · 后两个（`agent/disposed` / `session/disposed`）负责**生命周期**——
  *   载体没了必须清项，否则表按载体只增（本模块的头号风险）。
  *

package/lib/host/access.d.ts

@@ -55,8 +55,18 @@ interface HostWebServer {
     register?: (registration: unknown) => unknown;
     port?: number;
 }
+/** `ctx.settings`（v0.1.7 起为 `SettingsForms`：按条目 Config 投影表单 + 页策略） */
 interface HostSettings {
-    installSection?: (...args: unknown[]) => unknown;
+    /** 页策略（本插件用它关掉自动生成页；v0.1.7 前无此成员） */
+    configure?: (presentation: {
+        auto?: boolean;
+    }, owner?: unknown) => unknown;
+    /** 读各条目表单（含 live 值 / 用户层）；保留可选读取，供诊断面取证 */
+    describe?: (options?: {
+        redactSecrets?: boolean;
+    }) => unknown;
+    /** 写一个条目的 config（宿主负责落 profile 文档 + 校验） */
+    update?: (ns: string, patch: object, expectedRevision?: number) => Promise<void>;
 }
 /** `ctx.web`（injected；v1.30.12：fetch provider 注册通道） */
 interface HostWeb {

package/lib/host/contract.d.ts

@@ -55,14 +55,14 @@ interface HostEventContract {
  * 在名字写错/宿主改名时**编译失败**（v1.30.7，review F-04/F-05）。
  * 该 import 为 type-only，编译期擦除，不产生运行时依赖。
  */
-export declare const HOST_EVENT_NAMES: readonly ["agent/session-start", "agent/pre-step", "agent/turn-stopping", "agent/status", "agent/inbox/inserted", "agent/disposed", "session/event", "session/created", "session/disposed", "settings/updated", "tools/pre-execute", "tools/post-execute", "system-prompt/assemble"];
+export declare const HOST_EVENT_NAMES: readonly ["agent/created", "agent/pre-step", "agent/turn-stopping", "agent/status", "agent/inbox/inserted", "agent/inbox/claimed", "agent/disposed", "session/event", "session/created", "session/disposed", "settings/document-updated", "tools/pre-execute", "tools/post-execute", "system-prompt/assemble"];
 type HostEventName = (typeof HOST_EVENT_NAMES)[number];
 /**
  * dsp 订阅的宿主事件清单（与 HOST_EVENT_NAMES 同源；impact/site 供 health 报告与文档）。
  */
 export declare const HOST_EVENTS: readonly HostEventContract[];
 /** dsp 被验证过的宿主版本范围（与 package.json peerDependencies 同源，单一真相源） */
-export declare const REQUIRED_HOST_RANGE = "^0.1.5-rc.2";
+export declare const REQUIRED_HOST_RANGE = "^0.1.7-rc.1";
 interface HostContractIssue {
     id: string;
     kind: 'service' | 'member' | 'version';

package/lib/index.d.ts

@@ -82,6 +82,26 @@ export interface Config {
     visionPatch?: {
         enabled?: boolean;
     };
+    /** F1 双端口网关总开关（面板层；部署层同义键 = `gateway.enabled`） */
+    gatewayEnabled?: boolean;
+    /** F2 超限重建总开关（面板层；部署层同义键 = `rebuild.enabled`） */
+    rebuildEnabled?: boolean;
+    /** F2 触发阈值（K token；面板层；部署层同义键 = `rebuild.thresholdK`） */
+    rebuildThresholdK?: number;
+    /** F4 Skiff 调试服务总开关（面板层；部署层同义键 = `skiff.enabled`） */
+    skiffEnabled?: boolean;
+    /** F4 Skiff 调试端口（面板层；部署层同义键 = `skiff.debugPort`） */
+    skiffDebugPort?: number;
+    /** F4c ACP HTTP 端点总开关（面板层；部署层同义键 = `acp.enabled`） */
+    acpEnabled?: boolean;
+    /** F4c ACP HTTP 端口（面板层；部署层同义键 = `acp.httpPort`） */
+    acpHttpPort?: number;
+    /** F4d 建议问答页总开关（面板层；无部署层同义键） */
+    publicAskEnabled?: boolean;
+    /** CRO（轨迹自编程唤起）总闸（面板层；无部署层同义键；缺省开） */
+    croEnabled?: boolean;
+    /** 无人值守代理回复总闸（面板层；无部署层同义键；缺省关） */
+    unattendedEnabled?: boolean;
 }
 export declare const Config: z<Config>;
 export declare function apply(ctx: Context, config: Config): void;