@shgroup/dsh-serenity-hooks 1.31.13 → 1.34.0

package/lib/ccc.d.ts

@@ -84,6 +84,16 @@ export interface SerenityConfig {
     autopilotTrajectory?: AutopilotTrajectorySettings;
     /** 旧键兼容（正式化前存量 CCC，如 pangu——新键 autopilotTrajectory 优先，旧键回退） */
     autotrajectory?: AutopilotTrajectorySettings;
+    /**
+     * trajectory 族配置（D58，S142 2026-09-13）：`trajectory` 是一等概念，
+     * **autopilot 降为其子集**——故 autopilot 的配置迁到 `trajectory.autopilot`。
+     * 读取顺序（逐级回退，**不回写**）：`trajectory.autopilot` → `autopilotTrajectory` → `autotrajectory`。
+     * 唤醒注册表（未来时刻一次性唤醒）为 CCC 级文件 `AGENT_SESSIONS/wake-registry.json`，不在此配置。
+     */
+    trajectory?: {
+        /** autopilot（周期自唤醒的特例；每 CCC 单例，D59） */
+        autopilot?: AutopilotTrajectorySettings;
+    };
     /**
      * 微信桥（F4c-3，v1.27.0 实验性）：**CCC 级**配置——dsh 一个进程含多个 CCC，
      * 每个 CCC 独立对接微信桥（S142 用户拍板：ACC 不绑定 role，配置归 CCC，手工）。
@@ -92,6 +102,14 @@ export interface SerenityConfig {
      * 未配置或 enabled=false → 该 CCC 桥完全不启动（零资源占用）。
      */
     weixin?: WeixinSettings;
+    /**
+     * 专属工具声明（v1.33，S142 §32.11）：**ACC 注册但默认对所有 CCC 隐藏**的工具，
+     * 只有在自己这里声明的 CCC 可见（例：`["acc-diag"]` = ACC 负责人的运行态诊断）。
+     *
+     * 归属判据（D23）：**机制在 ACC（通用，任何工具名皆可），声明在 CCC**——
+     * ACC 代码里不出现任何具体 CCC 的名字；未声明（含未配置/配置损坏）⇒ 隐藏。
+     */
+    exclusiveTools?: string[];
 }
 /**
  * Autopilot Trajectory 配置（CCC 定义；S142 用户拍板 v0.5 + 正式化 v1.27.4）：
@@ -264,6 +282,18 @@ export declare function __resetBrokenConfigWarningsForTest(): void;
  * @returns 解析后的配置；无文件/损坏 → `{}`
  */
 export declare function loadSerenityConfig(root: string, paths?: string[]): SerenityConfig;
+/**
+ * 读取 CCC 声明的「专属工具」清单（`exclusiveTools`，v1.33）。
+ *
+ * 失败语义：无配置/字段缺失/配置损坏 → **空数组**（= 不声明任何专属工具 ⇒ 专属工具保持隐藏）。
+ * 这里选 **fail-closed**（与 im-bridge 的 fail-open 相反）的理由：专属工具的默认态就是"隐藏"，
+ * 判据读不到 = 没有证据表明该 CCC 要它；而配置损坏本身已在 `loadSerenityConfig` 响亮告警
+ * （不会静默）。im-bridge 相反——隐藏一个**已在使用**的通道才会静默损害能力。
+ * @param root CCC 根
+ * @param paths 候选配置相对路径
+ * @returns 去空白后的工具名列表（非字符串项被丢弃）
+ */
+export declare function readExclusiveTools(root: string, paths?: string[]): string[];
 export declare const SAFE_MODE_MARKER = ".serenity-safe-on";
 export declare function isSafeModeOn(root: string): boolean;
 /** 黑名单条目（对齐 osp BlacklistEntry）：pattern + 可选自定义拦截提示 message */

package/lib/client.js

@@ -4788,13 +4788,15 @@ Instruction-following style:
 			const acpOn = value?.acpEnabled ?? false;
 			const acpPort = value?.acpHttpPort ?? 3100;
 			const publicAskOn = value?.publicAskEnabled ?? false;
-			const autopilotOn = value?.autopilotEnabled ?? false;
+			const autopilotOn = value?.autopilotWakeEnabled ?? value?.autopilotEnabled ?? false;
+			const wakeSchedOn = value?.wakeSchedulerEnabled ?? true;
 			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 [openAutopilot, setOpenAutopilot] = (0, react.useState)(false);
+			const [openWakeSched, setOpenWakeSched] = (0, react.useState)(false);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "ss-section",
 				children: [
@@ -4832,7 +4834,7 @@ Instruction-following style:
 						title: "上下文",
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 							title: "超限重建",
-							desc: "上下文接近上限时提示调用 logbook rebuild 清空重建",
+							desc: "上下文接近上限时提示调用 container_trajectory rebuild 清空重建",
 							expandable: true,
 							open: openRebuild,
 							onToggle: setOpenRebuild,
@@ -4845,7 +4847,7 @@ Instruction-following style:
 								className: "ss-detailStack",
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 									className: "ss-detailIntro",
-									children: "上下文超限自动重建（logbook rebuild，v1.30 起并入 logbook）：\n· 机制：agent 上下文占用达到阈值时，由 LLM 主动调用重建\n· 语义：完全丢弃当前 dsh 会话 + 自动新建 + 注入「继续原 SESSION 的工作」\n· 效果：SESSION.md 原位不动，认知轨迹延续，上下文归零\n· 关闭后：上下文超限时不再提示，可能导致会话卡顿或丢失"
+									children: "上下文超限自动重建（container_trajectory rebuild，v1.33 起 logbook 并入 trajectory）：\n· 机制：agent 上下文占用达到阈值时，由 LLM 主动调用重建\n· 语义：完全丢弃当前 dsh 会话 + 自动新建 + 注入「继续原 SESSION 的工作」\n· 效果：SESSION.md 原位不动，认知轨迹延续，上下文归零\n· 关闭后：上下文超限时不再提示，可能导致会话卡顿或丢失"
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 									title: "重建阈值",
 									desc: "上下文占用达到该 K 数值时提示（单位 K token，默认 400）",
@@ -4941,22 +4943,40 @@ Instruction-following style:
 								})
 							}) }),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
-								title: "Autopilot Trajectory",
-								desc: "自动巡航轨迹（全局开关，默认关——只在指定电脑开启）",
+								title: "周期自唤醒（autopilot）",
+								desc: "定时唤起 autopilot 轨迹（全局开关，默认关——只在指定电脑开启）",
 								expandable: true,
 								open: openAutopilot,
 								onToggle: setOpenAutopilot,
 								control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Toggle, {
 									checked: autopilotOn,
-									onChange: (on) => toggle("autopilotEnabled", on)
+									onChange: (on) => toggle("autopilotWakeEnabled", on)
 								}),
 								detail: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "ss-detailStack",
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 										className: "ss-detailIntro",
-										children: "Autopilot Trajectory 全局总开关（v1.27.9）：\n· 作用：控制本机（本 dsh 实例）是否运行自动巡航轨迹\n· 默认关：未开启即使 CCC 配置 enabled=true 也不启动定时器\n· 定位：多台电脑装 dsp 时，只在指定电脑开启（其余默认关）\n· 双重门控：全局开关 AND CCC 级 enabled 都满足才运行\n· CCC 级配置（interval/session/偏见脚本/焦点）不受影响"
+										children: "周期自唤醒全局闸（v1.34 更名收窄，原 Autopilot Trajectory 全局总开关）：\n· 作用：控制本机（本 dsh 实例）是否运行**周期**自动巡航唤起\n· 语义边界：**只管周期自唤醒** —— 关掉它不影响一次性唤醒（wake-later，见下一行）\n· 默认关：未开启即使 CCC 配置 enabled=true 也不启动定时器\n· 定位：多台电脑装 dsp 时，只在指定电脑开启（其余默认关）\n· 双重门控：本开关 AND CCC 级 enabled 都满足才运行\n· CCC 级配置（interval/session/偏见脚本/焦点）不受影响"
 									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AutopilotTrajectoryStatusBlock, { autopilotOn })]
 								})
+							}) }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
+								title: "唤醒调度器（wake-later）",
+								desc: "投递已登记的“未来时刻 + 一条 message”（全局开关，默认开）",
+								expandable: true,
+								open: openWakeSched,
+								onToggle: setOpenWakeSched,
+								control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Toggle, {
+									checked: wakeSchedOn,
+									onChange: (on) => toggle("wakeSchedulerEnabled", on)
+								}),
+								detail: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "ss-detailStack",
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+										className: "ss-detailIntro",
+										children: "唤醒调度器全局闸（v1.34 新增独立开关）：\n· 作用：把 CCC 唤醒注册表（AGENT_SESSIONS/wake-registry.json）里到点的条目投递给目标轨迹\n· 条目来源：`container_trajectory wake-later`（对自己或别的 trajectory 预约未来时刻 + 一条 message）\n· 默认开：条目全部由人类/agent 显式登记，无环境自主性 ⇒ 不需要“默认关”的实验保护\n· 与上一行**互不连带**：关掉周期自唤醒不会关掉本调度器（用户 2026-09-15 裁决）\n· 精度：5min tick；补跑窗口 2h（超窗判 missed 留痕）；fire-and-forget 无回执"
+									})
+								})
 							}) })
 						]
 					}),
@@ -5112,6 +5132,7 @@ Instruction-following style:
 			const [cccs, setCccs] = (0, react.useState)([]);
 			const [selectedRoot, setSelectedRoot] = (0, react.useState)("");
 			const [status, setStatus] = (0, react.useState)(null);
+			const [wakes, setWakes] = (0, react.useState)([]);
 			const [unavailable, setUnavailable] = (0, react.useState)(false);
 			const [waking, setWaking] = (0, react.useState)(false);
 			const [wakeResult, setWakeResult] = (0, react.useState)(null);
@@ -5135,9 +5156,10 @@ Instruction-following style:
 			const refresh = (0, react.useCallback)(async () => {
 				if (!selectedRoot) return;
 				try {
-					const res = await fetch(`/serenity/autopilot-trajectory?ccc=${encodeURIComponent(selectedRoot)}`, { headers: { accept: "application/json" } });
+					const res = await fetch(`/serenity/trajectory?ccc=${encodeURIComponent(selectedRoot)}`, { headers: { accept: "application/json" } });
 					if (!res.ok) return;
 					const body = await res.json();
+					if (Array.isArray(body.wakes)) setWakes(body.wakes);
 					if (body.status) {
 						setStatus(body.status);
 						setUnavailable(false);
@@ -5156,7 +5178,7 @@ Instruction-following style:
 				setWaking(true);
 				setWakeResult(null);
 				try {
-					const res = await fetch("/serenity/autopilot-trajectory", {
+					const res = await fetch("/serenity/trajectory", {
 						method: "POST",
 						headers: {
 							"content-type": "application/json",
@@ -5204,7 +5226,7 @@ Instruction-following style:
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 						title: "目标 CCC",
 						desc: "多 CCC 各自独立——选中哪个就查看/唤起哪个",
-						help: "Autopilot Trajectory 目标认知容器：\n· 机制：dsh 一个进程可挂载多个 CCC，每个 CCC 的 autopilot 独立配置\n· 选择：下拉切换要查看/唤起的目标 CCC（各 CCC 时钟独立）\n· 配置：各 CCC 在自身 .opencode/serenity.json 定义 autopilotTrajectory\n· 唤起：仅对选中 CCC 生效，互不干扰",
+						help: "Autopilot Trajectory 目标认知容器：\n· 机制：dsh 一个进程可挂载多个 CCC，每个 CCC 的 autopilot 独立配置\n· 选择：下拉切换要查看/唤起的目标 CCC（各 CCC 时钟独立）\n· 配置：各 CCC 在自身 .opencode/serenity.json 定义 trajectory.autopilot（旧键 autopilotTrajectory 兼容）\n· 唤起：仅对选中 CCC 生效，互不干扰",
 						control: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
 							className: "ss-select",
 							value: selectedRoot,
@@ -5224,7 +5246,7 @@ Instruction-following style:
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 						title: "运行状态",
 						desc: stateText,
-						help: "Autopilot Trajectory 运行状态含义：\n· 未配置：该 CCC 未定义 autopilotTrajectory（机制不开始）\n· 已配置未启用：enabled=false，零资源占用（不唤起不消耗）\n· 已启用：时钟驱动周期性自动唤起——无人类活动满间隔小时数后\n  启动一次前台 agent 轮（用户全程可见可介入）",
+						help: "Autopilot Trajectory 运行状态含义：\n· 未配置：该 CCC 未定义 trajectory.autopilot（机制不开始）\n· 已配置未启用：enabled=false，零资源占用（不唤起不消耗）\n· 已启用：时钟驱动周期性自动唤起——无人类活动满间隔小时数后\n  启动一次前台 agent 轮（用户全程可见可介入）",
 						control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: "ss-value",
 							children: status.enabled ? "● 运行中" : status.configured ? "○ 待启" : "—"
@@ -5255,6 +5277,16 @@ Instruction-following style:
 							}
 						] })
 					}) }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "ss-rowCard",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DefList, { items: [{
+							term: "唤醒注册表",
+							value: wakes.length === 0 ? "无条目（agent 用 container_trajectory wake-later 登记：未来时刻 + 一条 message）" : `${wakes.filter((w) => w.state === "pending").length} 条在办 / 共 ${wakes.length} 条`
+						}, ...wakes.slice(0, 5).map((w) => ({
+							term: w.state === "pending" ? "· 待唤醒" : `· ${w.state}`,
+							value: `${new Date(w.at).toLocaleString()} → ${w.target}${w.lastResult ? `（${w.lastResult}）` : ""}`
+						}))] })
+					}) }),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 						title: "立即唤起",
 						desc: wakeResult ?? "调试：手动触发一次（跳过窗口/间隔，仍校验配置与偏见脚本）",

package/lib/diag-ops.d.ts

@@ -0,0 +1,61 @@
+/**
+ * diag-ops.ts — `acc-diag` 报告装配（v1.33，S142 §32.11）
+ *
+ * 为什么单独成模块（R↓）：工具面（`tools/acc-diag.ts`）只做"取 CCC 根 + 渲染"，
+ * 装配逻辑放这里 ⇒ 纯函数可单测、不依赖 DSH 工具注册。
+ *
+ * 为什么**无动作参数**：诊断是低频动作（§32.9 收敛取向），一次调用即出全报告，
+ * 不需要子命令面；动作越多，模型选择成本越高。
+ *
+ * 四段内容（数据来源各自单一真相源，本模块只聚合不复制语义）：
+ *   ① live 运行态 —— 插件进程内 `diagLive(ctx)`（live 会话清单 + 各 autopilot CCC 的
+ *      目标命中 / agent 定位诊断）——**脚本侧看不到运行时**，这正是本工具存在的理由
+ *   ② 面板解析 —— `diagLive.panelResolved`（无参面板请求会落到哪个 CCC）
+ *   ③ 唤醒注册表 —— `wake-registry.json` 全量条目（state / at / target / lastResult）+ 补跑窗口
+ *   ④ 唤起条件链 —— 包内脚本 `diag`（`runAutopilotScript(root,'diag')`）：逐条件值 + 阻断点 + 修复建议
+ */
+import { type DiagLiveReport, autopilotClockState } from './autopilot-trajectory.js';
+import { wakeSchedulerState } from './wake-scheduler.js';
+import type { Context } from 'cordis';
+/** 进程内时钟状态（唤醒调度器 / autopilot 时钟；判据各自单一真相源） */
+type ClockState = ReturnType<typeof wakeSchedulerState> | ReturnType<typeof autopilotClockState>;
+export interface AccDiagReport {
+    /** 调用方会话所属 CCC 根（脚本诊断的目标） */
+    ccc: string;
+    live: DiagLiveReport;
+    /**
+     * 进程内两个时钟的武装状态（2026-09-14 F 段缺陷**新暴露面**）。
+     * 为什么必须有（R↓）：此前"条目为何滞留在 pending"无法从报告回答——④ 段只算**配置**条件，
+     * 而真正的原因可能在"时钟根本没在跑"这一层。有了它，同类故障一眼可判。
+     */
+    clocks: {
+        wake: ClockState;
+        autopilot: ClockState;
+    };
+    wakes: {
+        /** 注册表文件路径问题（读不到时非空——不得静默） */
+        error: string | null;
+        entries: Array<{
+            id: string;
+            target: string;
+            at: string;
+            state: string;
+            createdBy: string;
+            attempts: number;
+            lastResult: string | null;
+        }>;
+        pending: number;
+    };
+    /** 唤起条件链（脚本输出原文；失败时给出错误文本，不吞） */
+    autopilotChain: string;
+}
+/**
+ * 装配报告（一次调用即全报告）。
+ * @param ctx 插件上下文（进程内读 sessions/agents）
+ * @param root 调用方 CCC 根（脚本诊断目标）
+ * @returns 结构化报告（渲染由 {@link renderAccDiag} 负责）
+ */
+export declare function runAccDiag(ctx: Context, root: string): AccDiagReport;
+/** 人读渲染（四段；空段也要显式说明"无"，避免"沉默 = 一切正常"的误读） */
+export declare function renderAccDiag(r: AccDiagReport): string;
+export {};

package/lib/index.d.ts

@@ -4,7 +4,7 @@
  * 形态（DSH 官方 native hook 约定）：name / inject / Config / apply，无 default export。
  *
  * 能力：
- *   1. 真实 DSH 工具注册：container_fs（文件系统 15 子命令，含 reveal）、logbook（会话全周期含 rebuild）
+ *   1. 真实 DSH 工具注册：container_fs（文件系统 15 子命令，含 reveal）、container_trajectory（轨迹生命周期 + 一次性安排，含 rebuild）
  *   2. 拦截缝机械约束：tools/pre-execute + ctx.tools.guard（安全模式/黑名单/路径守卫）
  *
  * 加载：~/.dsh/config.yaml 加 insert 行（免改 DSH 源码），插件包装入 DSH node_modules。