@shgroup/dsh-serenity-hooks 1.48.2 → 1.49.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.48.2",
+  "version": "1.49.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

@@ -4741,7 +4741,7 @@ Instruction-following style:
 							})
 						]
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					control !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "ss-rowControl",
 						children: control
 					}),
@@ -4804,7 +4804,6 @@ Instruction-following style:
 				set("acpHttpPort", Math.min(65535, Math.max(1024, Math.round(v))));
 			};
 			const gatewayOn = value?.gatewayEnabled ?? false;
-			const rebuildOn = value?.rebuildEnabled ?? true;
 			const thresholdK = value?.rebuildThresholdK ?? 400;
 			const skiffOn = value?.skiffEnabled ?? false;
 			const skiffPort = value?.skiffDebugPort ?? 3099;
@@ -4862,19 +4861,15 @@ Instruction-following style:
 							open: openRebuild,
 							onToggle: setOpenRebuild,
 							expandHint: "配置",
-							control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Toggle, {
-								checked: rebuildOn,
-								onChange: (on) => toggle("rebuildEnabled", on)
-							}),
 							detail: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "ss-detailStack",
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 									className: "ss-detailIntro",
-									children: "上下文超限自动重建（container_trajectory rebuild，v1.33 起 logbook 并入 trajectory）：\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· 无总开关（v1.49.0 砍掉）：长期验证下它已能很好地代替上下文压缩；\n  要调敏感度就改下面的阈值"
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 									title: "重建阈值",
 									desc: "上下文占用达到该 K 数值时提示（单位 K token，默认 400）",
-									help: "重建触发阈值（需求①：K 数值，默认 400K，范围 50~4000K）：\n· 含义：上下文 projected tokens 达到 thresholdK × 1000 时触发提醒\n· 纯绝对数值（不再依赖窗口比例）\n· 迁移：旧版 0~1 比例（settings.yaml rebuildThreshold）已废弃被忽略\n· 调低更早触发 / 调高更晚触发；仅「超限重建」开启时有意义",
+									help: "重建触发阈值（需求①：K 数值，默认 400K，范围 50~4000K）：\n· 含义：上下文 projected tokens 达到 thresholdK × 1000 时触发提醒\n· 纯绝对数值（不再依赖窗口比例）\n· 迁移：旧版 0~1 比例（settings.yaml rebuildThreshold）已废弃被忽略\n· 调低更早触发 / 调高更晚触发（v1.49.0 起无总开关，它恒生效）",
 									control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 										className: "ss-portInput",
 										type: "number",
@@ -4882,7 +4877,6 @@ Instruction-following style:
 										max: 4e3,
 										step: 50,
 										value: thresholdK,
-										disabled: !rebuildOn,
 										title: "重建阈值（K token，默认 400）",
 										onChange: (e) => setThreshold(Number(e.target.value))
 									})

package/lib/index.d.ts

@@ -121,10 +121,8 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, "plain">;
     rebuild: z<Schemastery.ObjectS<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
         thresholdK: z<number, number, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
         thresholdK: z<number, number, "defined">;
     }>>, "plain">;
     skiff: z<Schemastery.ObjectS<NoInfer<{
@@ -157,7 +155,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, "plain">;
     gatewayEnabled: z<boolean, boolean, "volatile">;
-    rebuildEnabled: z<boolean, boolean, "volatile">;
     rebuildThresholdK: z<number, number, "volatile">;
     skiffEnabled: z<boolean, boolean, "volatile">;
     skiffDebugPort: z<number, number, "volatile">;
@@ -184,10 +181,8 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, "plain">;
     rebuild: z<Schemastery.ObjectS<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
         thresholdK: z<number, number, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
         thresholdK: z<number, number, "defined">;
     }>>, "plain">;
     skiff: z<Schemastery.ObjectS<NoInfer<{
@@ -220,7 +215,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, "plain">;
     gatewayEnabled: z<boolean, boolean, "volatile">;
-    rebuildEnabled: z<boolean, boolean, "volatile">;
     rebuildThresholdK: z<number, number, "volatile">;
     skiffEnabled: z<boolean, boolean, "volatile">;
     skiffDebugPort: z<number, number, "volatile">;

package/lib/index.js

@@ -6,7 +6,7 @@ import { A as localIdStamp, C as setActiveSessionInfo, D as isoLocal, E as useSe
 import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, g as runLocalStore, h as readStore, i as matchWeixinRoute, l as weixinSessionIdFor, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, s as sanitizeFileName$1, t as extractWeixinMedia } from "./weixin-route-CWMRa36W.js";
 import { a as unregisterSkiffSession$1, i as skiffSessionSnapshot$1, n as skiffRoleFor$1, o as ACC_VERSION, r as skiffSessionInfo$1, t as registerSkiffSession$1 } from "./skiff-registry-BjIX_KD1.js";
 import { a as readSkiffRoles, c as roleMsmWhitelist, d as systemPromptSource, f as trajectorySubset, i as isSkiffSessionId, l as roleToolWhitelist, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-KqQA6pkr.js";
-import { a as FACE_PORTS, c as MECHANISM_PORTS, i as ACP_HTTP_PORT, l as SKIFF_DEBUG_PORT, n as registerSettingsSection, o as GATEWAY_PORT, s as MAIN_WEB_PORT, t as readSimpleSettings, u as WEIXIN_SEND_PORT } from "./settings-section-DxMwlCv9.js";
+import { a as FACE_PORTS, c as MECHANISM_PORTS, i as ACP_HTTP_PORT, l as SKIFF_DEBUG_PORT, n as registerSettingsSection, o as GATEWAY_PORT, s as MAIN_WEB_PORT, t as readSimpleSettings, u as WEIXIN_SEND_PORT } from "./settings-section-B-KOyOYn.js";
 import { a as markdownToPlainText, c as sendTyping, i as getUpdates, l as sniffImageExt, n as downloadMedia, o as sendFileMessage, r as getConfig, s as sendTextMessage, t as TypingStatus } from "./weixin-api-CtFYm53S.js";
 import z from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
@@ -9235,7 +9235,12 @@ const EVENT_LABEL = {
 	/** 敏感输出边界守卫（原 SERENITY OUTPUT GUARD） */
 	guard: "BOUNDARY GUARD",
 	/** SESSION.md 体积超限重写提醒（v1.31.1，S142 用户需求） */
-	compaction: "LOGBOOK COMPACTION"
+	compaction: "LOGBOOK COMPACTION",
+	/** **交界便签（REBUILD-TODO.md）体积超限清理提醒**（v1.49.0，owner 2026-09-26 需求）。
+	*
+	*  🔴 **刻意与 `compaction` 分开**：那条要求"**重写 SESSION.md 并保留 EAP 骨架**"，
+	*  本条只要求"**清理便签**"——共用一个 token 会让模型误以为要动 SESSION.md。 */
+	scratchPrune: "SCRATCH PRUNE"
 };
 /** 家族标识（所有动态注入统一前缀） */
 const ASSISTANT_PREFIX = "TRAJECTORY-ASSISTANT";
@@ -9246,16 +9251,24 @@ function eventToken(event) {
 /** ACK 确认码前缀（recorded/skipped 语义不变，仅家族名更新） */
 const ACK_PREFIX = `${ASSISTANT_PREFIX}-recorded`;
 /**
-* rebuild 交接区块标题（v1.31.1，S142 用户需求）。
+* rebuild 交界便签的**文件名**（v1.49.0；owner 2026-09-26 需求）。
+*
+* ## 它取代了什么（owner 原话：*"砍掉 in-flight，这正是目的"*）
+* v1.31.1 的交界协议要求把手头事项写进 **SESSION.md 末尾**的 `## In-flight (rebuild handover)` 段。
+* 实测的代价（S142 自身取证）：In-flight 段曾积 **12 块**（含多份**已被取代**的交接），
+* 而 SESSION.md 是**有格式义务**的持久文件（7 段固定 ＋ 粒度受 EAP 约束）⇒
+* ① 持久文件被临时物污染 ② 每次整理都要付"压缩＋归档＋保真"三件套（该文件曾达 292 KB）。
+*
+* ⇒ 分家：**只用一次的交界材料**写进这份**临时便签**（无格式义务、无留档义务、可随时丢弃）。
 *
-* 用途：rebuild 提醒要求模型把**当前手头事项**写到 SESSION.md **末尾**的这个小标题之下；
-* rebuild 锚点随后要求重建后的自己去读这一段并处理。两侧引用**同一个常量**——
-* 标题一旦漂移，读侧就找不到写侧写的东西（单一真相源）。
+* ## 🔴 三处引用同一常量（单一真相源）
+* **写侧** = `seams/keeper.ts` 的 `rebuildReminderText()`｜**读侧** = `rebuild.ts` 的重建锚点｜
+* **体积提醒** = `seams/keeper.ts` 的 `rebuildTodoReminderText()`。
+* 文件名一旦漂移，写侧写的东西读侧就找不到 —— **且没有任何机械信号会报警**。
 *
-* 形态（用户拍板 Q2）：**固定英文标题行**（不是 HTML 注释锚）——人读友好；ACC 写死英文，
-* 因为 SESSION.md 的正文语言归 CCC，但两侧的**机械锚点**必须逐字一致。
+* 🔴 **不得改名**（owner 已具名）。形态 = **固定文件名**（人读友好；比照旧 IN_FLIGHT_HEADING 的取舍）。
 */
-const IN_FLIGHT_HEADING = "## In-flight (rebuild handover)";
+const REBUILD_TODO_FILENAME = "REBUILD-TODO.md";
 //#endregion
 //#region src/seams/keeper.ts
 const SCORES = {
@@ -9328,12 +9341,15 @@ function reminderText(code) {
 *   使用者若要查看当前占用/阈值：看面板（`rebuildThresholdK` 滑块 + 状态显示）——那是给人看的。
 *
 * v1.31.1 交接协议（S142 用户需求"要求 LLM 将当前手头事项写在 SESSION.md 尾部，并要求
-* rebuild 后去读并处理"）：**写侧** = 这里（两条文案都要求把 in-flight 事项写在
-* SESSION.md 末尾的 `IN_FLIGHT_HEADING` 之下）；**读侧** = rebuild 锚点（rebuild.ts）。
-* 两侧共用 trajectory-assistant 的标题常量（单一真相源）。
+* rebuild 后去读并处理"）：**写侧** = 这里；**读侧** = rebuild 锚点（rebuild.ts）。
+* 两侧共用 trajectory-assistant 的常量（单一真相源）。
+*
+* 🔴 **v1.49.0（owner 2026-09-26 裁决："砍掉 in-flight，这正是目的"）**：写侧**不再**指向
+* SESSION.md 末尾的段，改指**独立便签文件** `REBUILD-TODO_FILENAME`（轨迹目录下）——
+* 理由见该常量的头注（持久文件 vs 只用一次的交界材料必须分家）。
 */
 function rebuildReminderText(escalated = false) {
-	const handover = ` Before rebuilding, write your current in-flight items (the exact step you are in the middle of, what is not finished yet, and what the next action is) at the very end of SESSION.md under the heading "${IN_FLIGHT_HEADING}" — the rebuilt conversation reads that section first and continues from it.`;
+	const handover = ` Before rebuilding, write your current in-flight items (the exact step you are in the middle of, what is not finished yet, and what the next action is) into "${REBUILD_TODO_FILENAME}" in this trajectory's directory — create it if it does not exist. That file is a scratch note for the handover only: no format obligation, no archival duty, safe to discard at any time. The rebuilt conversation reads it first and continues from it.`;
 	if (escalated) return `${eventToken("limitMandatory")} Context usage has reached the configured rebuild threshold — you have been reminded repeatedly and have NOT called the container_trajectory rebuild action. This is now mandatory: STOP at the current task step, preserve valuable cognition into the CCC skills (or write a new-skill proposal into SESSION.md), then call container_trajectory rebuild immediately, passing --summary "<content summary ≤20 chars>" (required; the dsh session title is renamed to S###-YYYY-MM-DD-<summary> after rebuild).${handover} The conversation will be cleared and rebuilt in place; SESSION.md is the persistent trajectory and stays in place — identity continues from it. Do not continue working without rebuilding; this reminder persists until you call container_trajectory rebuild.`;
 	return `${eventToken("limit")} Context usage has reached the configured rebuild threshold. This session is the rebuildable carrier of the trajectory: SESSION.md is the persistent body, this conversation is only a temporary work copy. Before rebuilding: if this conversation produced valuable cognition, revise the relevant existing skill of this CCC (structure it with eap); if a new skill is warranted, write a short proposal into SESSION.md for the user to review — do not create it yourself.${handover} ACT NOW: at the next natural pause (end of the current task step), call the container_trajectory rebuild action — passing --summary "<content summary ≤20 chars>" describing the next work phase (required; the dsh session title is renamed to S###-YYYY-MM-DD-<summary> after rebuild) — to clear and rebuild this conversation: the current copy is discarded, identity continues from SESSION.md. If you are in the middle of an unbreakable step, continue it, then rebuild at its end. Do not ignore this; rebuild is the expected action, not an option.`;
 }
@@ -9443,6 +9459,37 @@ function trajectoryCompactionReminderText(input) {
 	if (escalated) return `${eventToken("compaction")} ${facts} — you have been reminded repeatedly and have NOT compacted SESSION.md. This is now mandatory: STOP the current task step, load eap (praxis eap), rewrite SESSION.md, then resume. ${principles} ${frontmatterGuard} This reminder persists until the file is under the limit.`;
 	return `${eventToken("compaction")} ${facts}. Pause the current work and compact this trajectory's log (SESSION.md) before continuing — that log is the persistent body of this trajectory, and its size is operational entropy (H_op) the container pays on every read. ${principles} ${frontmatterGuard} After rewriting, resume the paused work; this reminder stops once the file is under the limit.`;
 }
+/** 连续超限轮数达此值 → 语气升级（对齐 COMPACTION_ESCALATE_AFTER / REBUILD_ESCALATE_AFTER） */
+const REBUILD_TODO_ESCALATE_AFTER = 3;
+const rebuildTodoStates = /* @__PURE__ */ new Map();
+/**
+* 交界便签超限提醒文案（v1.49.0）。
+*
+* ## 与 SESSION.md 档的**语义差别**（刻意，不是疏漏）
+*
+* | | SESSION.md 超限（`trajectoryCompactionReminderText`） | 便签超限（本条） |
+* |---|---|---|
+* | 动作 | **重写**（compaction） | **清理／丢弃**（prune） |
+* | 结构义务 | 保 EAP 骨架 ＋ 4 条重写原则 ＋ frontmatter 护栏 | **无** |
+* | 强度 | 升级后**强制**（"STOP…必须先重写"） | 升级后**语气加重，但动作仍只是"清理"** |
+* | 授权 | — | 🔴 **明确授权整份删除** |
+*
+* ## 归属（D23）
+* 机制（文件名 ／ 上限 ／ 注入时机）归 **ACC**；**写什么、怎么组织、何时丢**归 **CCC**。
+* 🔴 owner 裁决（逐字）：*"rebuild 提示 Agent 去写，清空我们就不干涉了，只管最大量"* ⇒
+* **ACC 只提醒，不做任何写／删／归档操作**（自动删 = 数据丢失风险：rebuild 时序上新我还没读就被删）。
+*
+* ## 为什么要求"参照 eap"
+* owner 裁决（逐字）：*"不规定，但要求参照 eap 来编写（这样质量会好点）"* ⇒
+* **不规定内部结构**（不给骨架），但**要求按 EAP 写**（显式 ／ 可重建 ／ 稳定）。
+*/
+function rebuildTodoReminderText(input) {
+	const { sizeKB, limitKB, mdPath, escalated = false } = input;
+	const facts = `${REBUILD_TODO_FILENAME} is ${sizeKB} KB (limit ${limitKB} KB): ${mdPath}`;
+	const action = "This file is a scratch note for the rebuild handover — it carries no archival duty and you may discard it wholesale at any time. Prune it now, writing in the spirit of eap (praxis eap): (1) delete what is already done; (2) delete what has been superseded; (3) delete what is already recorded in SESSION.md — that file is the trajectory's persistent body, this one only carries what the next self needs once. Do not restructure it into a formal document: the only mechanical constraint on this file is its size.";
+	if (escalated) return `${eventToken("scratchPrune")} ${facts} — you have been reminded repeatedly and have NOT pruned it. Prune it now. ${action} This reminder persists until the file is under the limit.`;
+	return `${eventToken("scratchPrune")} ${facts}. ${action} This reminder stops once the file is under the limit.`;
+}
 /** 每 agent 一个跟踪器（进程内存态，agent token 维度） */
 const trackers = /* @__PURE__ */ new Map();
 /** 连续超阈值轮数达此值 → 升级为 [TRAJECTORY-ESCALATED] 强制语气（此后持续升级催，直到 rebuild） */
@@ -9482,7 +9529,7 @@ function registerKeeper(ctx, opts = {}) {
 				text: reminderText(code)
 			});
 		}
-		if (skiffRebuild && readSimpleSettings().rebuildEnabled) {
+		if (skiffRebuild) {
 			const session = exec.agent?.session;
 			if (session) {
 				const pressure = readContextPressure(ctx, session);
@@ -9525,6 +9572,27 @@ function registerKeeper(ctx, opts = {}) {
 				} else compactionStates.delete(scope);
 			}
 		}
+		if (skiffTrajectoryEnabled(root, sessionId, "session")) {
+			const scope = sessionId ?? "global";
+			const session = exec.agent?.session;
+			const mdPath = resolveActiveSessionMdPath(root, scope, session);
+			const todoPath = mdPath ? join(dirname(mdPath), REBUILD_TODO_FILENAME) : null;
+			const size = todoPath ? readFileSize(todoPath) : null;
+			if (todoPath && size !== null && size > 10240) {
+				const st = rebuildTodoStates.get(scope) ?? { consecutive: 0 };
+				st.consecutive += 1;
+				blocks.push({
+					type: "text",
+					text: rebuildTodoReminderText({
+						sizeKB: Math.round(size / 1024),
+						limitKB: 10,
+						mdPath: todoPath,
+						escalated: st.consecutive >= REBUILD_TODO_ESCALATE_AFTER
+					})
+				});
+				rebuildTodoStates.set(scope, st);
+			} else rebuildTodoStates.delete(scope);
+		}
 		if (blocks.length === 0) return downstream;
 		const reminderAll = createUserMessage({
 			content: blocks,
@@ -10181,7 +10249,7 @@ function registerStatusApi(ctx, opts = {}) {
 					return;
 				}
 				const settings = readAdvancedSettings();
-				const { readSimpleSettings } = await import("./settings-section-DxMwlCv9.js").then((n) => n.r);
+				const { readSimpleSettings } = await import("./settings-section-B-KOyOYn.js").then((n) => n.r);
 				const simple = readSimpleSettings();
 				const allowed = settings.publicAsk.allowed;
 				const port = simple.acpHttpPort ?? ACP_HTTP_PORT;
@@ -12172,6 +12240,8 @@ function stripAckSuffix(text) {
 */
 function buildRebuildAnchor(root, sessionName, activeMdPath, anchorMessages = DEFAULT_ANCHOR_MESSAGES, focus) {
 	const rel = activeMdPath.startsWith(root) ? activeMdPath.slice(root.length + 1) : activeMdPath;
+	const todoAbs = join(dirname(activeMdPath), REBUILD_TODO_FILENAME);
+	const todoRel = todoAbs.startsWith(root) ? todoAbs.slice(root.length + 1) : todoAbs;
 	const sessionDir = basename(dirname(activeMdPath));
 	const sessionLine = sessionDir !== "AGENT_SESSIONS" ? `- Serenity session: ${sessionName !== "" ? `${sessionName} (${sessionDir})` : sessionDir}` : null;
 	const focusLine = sanitizeFocusLine(focus);
@@ -12184,7 +12254,7 @@ function buildRebuildAnchor(root, sessionName, activeMdPath, anchorMessages = DE
 		`- Persistent trajectory — SESSION.md path: ${rel}`,
 		`  (the trajectory's persistent body — stays in place through rebuilds)`,
 		`- Read that SESSION.md first (goal/decisions/progress/unresolved), then continue from the last checkpoint.`,
-		`- Then read the "${IN_FLIGHT_HEADING}" section at the very end of SESSION.md and work through those in-flight items (the previous self paused mid-task and handed them over). If that section is missing, infer the in-flight items from the latest progress entries.`,
+		`- Then read the handover scratch note: ${todoRel} (path: ${todoAbs}) — the previous self paused mid-task and left its in-flight items there. That file carries no format obligation and may be discarded at any time; it is NOT the authoritative state. If it is missing, infer the in-flight items from SESSION.md's latest progress entries.`,
 		...focusLine ? [`- Task focus: ${focusLine}`] : []
 	].join("\n");
 }
@@ -12290,7 +12360,6 @@ function writeRebuildDiag(root, entry) {
 * @returns 排队结果；rebuild.enabled=false 或非 CCC 抛错
 */
 async function queueRebuild(ctx, opts) {
-	if (!readSimpleSettings().rebuildEnabled) throw new Error("container_trajectory rebuild is disabled (rebuild.enabled=false — enable it in the dsh settings panel)");
 	const { root, note, summary, dshSessionId } = opts;
 	const session = ctx.sessions?.get?.(dshSessionId);
 	if (!session) throw new Error(`Unable to locate dsh session ${dshSessionId} (session may be closed)`);
@@ -18699,10 +18768,7 @@ const Config = z.object({
 	env: z.boolean().default(true),
 	opencodeSkills: z.boolean().default(true),
 	gateway: z.object({ enabled: z.boolean().default(false) }),
-	rebuild: z.object({
-		enabled: z.boolean().default(true),
-		thresholdK: z.number().min(50).max(4e3).default(400)
-	}),
+	rebuild: z.object({ thresholdK: z.number().min(50).max(4e3).default(400) }),
 	skiff: z.object({
 		enabled: z.boolean().default(false),
 		debugPort: z.number().min(1024).max(65535).default(SKIFF_DEBUG_PORT)
@@ -18715,7 +18781,6 @@ const Config = z.object({
 	opencodeProvider: z.object({ autoConfigure: z.boolean().default(true) }),
 	visionPatch: z.object({ enabled: z.boolean().default(true) }),
 	gatewayEnabled: z.boolean().volatile(),
-	rebuildEnabled: z.boolean().volatile(),
 	rebuildThresholdK: z.number().min(50).max(4e3).volatile(),
 	skiffEnabled: z.boolean().volatile(),
 	skiffDebugPort: z.number().min(1024).max(65535).volatile(),

package/lib/seams/keeper.d.ts

@@ -48,9 +48,12 @@ export declare function reminderText(code: string): string;
  *   使用者若要查看当前占用/阈值：看面板（`rebuildThresholdK` 滑块 + 状态显示）——那是给人看的。
  *
  * v1.31.1 交接协议（S142 用户需求"要求 LLM 将当前手头事项写在 SESSION.md 尾部，并要求
- * rebuild 后去读并处理"）：**写侧** = 这里（两条文案都要求把 in-flight 事项写在
- * SESSION.md 末尾的 `IN_FLIGHT_HEADING` 之下）；**读侧** = rebuild 锚点（rebuild.ts）。
- * 两侧共用 trajectory-assistant 的标题常量（单一真相源）。
+ * rebuild 后去读并处理"）：**写侧** = 这里；**读侧** = rebuild 锚点（rebuild.ts）。
+ * 两侧共用 trajectory-assistant 的常量（单一真相源）。
+ *
+ * 🔴 **v1.49.0（owner 2026-09-26 裁决："砍掉 in-flight，这正是目的"）**：写侧**不再**指向
+ * SESSION.md 末尾的段，改指**独立便签文件** `REBUILD-TODO_FILENAME`（轨迹目录下）——
+ * 理由见该常量的头注（持久文件 vs 只用一次的交界材料必须分家）。
  */
 export declare function rebuildReminderText(escalated?: boolean): string;
 /** 读取会话 contextPressure 投影（sessionProjections 可选服务；未装配返回 null） */
@@ -110,6 +113,51 @@ export declare function trajectoryCompactionReminderText(input: {
     mdPath: string;
     escalated?: boolean;
 }): string;
+/**
+ * 交界便签体积上限（KB）—— **硬编码，刻意不设配置键**。
+ *
+ * 🔴 owner 2026-09-26 裁决（逐字）：*"不需要设定，很多设定项我想砍掉了，好的功能用久了就发现
+ * 离不开，就不需要了"* ⇒ **不提供 `sessionKeeper.rebuildTodoMaxKB`**（设计件 Q4 的原倾向被否）。
+ * 对照：SESSION.md 的上限**保留可配置**（既有面，本版不动）。
+ */
+export declare const DEFAULT_REBUILD_TODO_MAX_KB = 10;
+interface RebuildTodoState {
+    /** 连续超限轮数（文件降回限内即清零 → 清理完成后提醒自动停止） */
+    consecutive: number;
+}
+/** 测试/调试：查看交界便签超限提醒状态 */
+export declare function rebuildTodoStateSnapshot(): ReadonlyMap<string, RebuildTodoState>;
+/** 会话销毁/测试重置：清理超限计数（防 per-会话 Map 无界增长） */
+export declare function forgetRebuildTodoState(scope: string): void;
+/** 测试辅助：清空交界便签提醒状态 */
+export declare function __resetRebuildTodoForTest(): void;
+/**
+ * 交界便签超限提醒文案（v1.49.0）。
+ *
+ * ## 与 SESSION.md 档的**语义差别**（刻意，不是疏漏）
+ *
+ * | | SESSION.md 超限（`trajectoryCompactionReminderText`） | 便签超限（本条） |
+ * |---|---|---|
+ * | 动作 | **重写**（compaction） | **清理／丢弃**（prune） |
+ * | 结构义务 | 保 EAP 骨架 ＋ 4 条重写原则 ＋ frontmatter 护栏 | **无** |
+ * | 强度 | 升级后**强制**（"STOP…必须先重写"） | 升级后**语气加重，但动作仍只是"清理"** |
+ * | 授权 | — | 🔴 **明确授权整份删除** |
+ *
+ * ## 归属（D23）
+ * 机制（文件名 ／ 上限 ／ 注入时机）归 **ACC**；**写什么、怎么组织、何时丢**归 **CCC**。
+ * 🔴 owner 裁决（逐字）：*"rebuild 提示 Agent 去写，清空我们就不干涉了，只管最大量"* ⇒
+ * **ACC 只提醒，不做任何写／删／归档操作**（自动删 = 数据丢失风险：rebuild 时序上新我还没读就被删）。
+ *
+ * ## 为什么要求"参照 eap"
+ * owner 裁决（逐字）：*"不规定，但要求参照 eap 来编写（这样质量会好点）"* ⇒
+ * **不规定内部结构**（不给骨架），但**要求按 EAP 写**（显式 ／ 可重建 ／ 稳定）。
+ */
+export declare function rebuildTodoReminderText(input: {
+    sizeKB: number;
+    limitKB: number;
+    mdPath: string;
+    escalated?: boolean;
+}): string;
 interface KeeperRegistration {
     /** 缺省阈值（serenity.json sessionKeeper.threshold 优先，其次此值） */
     defaultThreshold?: number;

package/lib/{settings-section-DxMwlCv9.js → settings-section-B-KOyOYn.js}

@@ -70,7 +70,6 @@ var settings_section_exports = /* @__PURE__ */ __exportAll({
 function defaultSimpleSettings() {
 	return {
 		gatewayEnabled: false,
-		rebuildEnabled: true,
 		rebuildThresholdK: 400,
 		skiffEnabled: false,
 		skiffDebugPort: SKIFF_DEBUG_PORT,
@@ -116,7 +115,6 @@ function simpleSettingsFromConfig(config) {
 	const d = defaultSimpleSettings();
 	return {
 		gatewayEnabled: unwrapVolatile(config.gatewayEnabled) ?? config.gateway?.enabled ?? d.gatewayEnabled,
-		rebuildEnabled: unwrapVolatile(config.rebuildEnabled) ?? config.rebuild?.enabled ?? d.rebuildEnabled,
 		rebuildThresholdK: unwrapVolatile(config.rebuildThresholdK) ?? config.rebuild?.thresholdK ?? d.rebuildThresholdK,
 		skiffEnabled: unwrapVolatile(config.skiffEnabled) ?? config.skiff?.enabled ?? d.skiffEnabled,
 		skiffDebugPort: unwrapVolatile(config.skiffDebugPort) ?? config.skiff?.debugPort ?? d.skiffDebugPort,

package/lib/settings-section.d.ts

@@ -49,7 +49,6 @@ interface SimpleConfigFragment {
         enabled?: boolean;
     };
     rebuild?: {
-        enabled?: boolean;
         thresholdK?: number;
     };
     /** F4 Skiff（实验性）：调试服务启停（人工） */
@@ -63,7 +62,6 @@ interface SimpleConfigFragment {
         httpPort?: number;
     };
     gatewayEnabled?: PanelBoolean;
-    rebuildEnabled?: PanelBoolean;
     rebuildThresholdK?: PanelNumber;
     skiffEnabled?: PanelBoolean;
     skiffDebugPort?: PanelNumber;
@@ -81,8 +79,6 @@ export declare const SERENITY_SETTINGS_NS = "serenity-hooks";
 interface SerenitySimpleSettings {
     /** F1 双端口网关总开关 */
     gatewayEnabled: boolean;
-    /** F2 超限重建总开关 */
-    rebuildEnabled: boolean;
     /** F2 触发阈值（需求① S142 用户拍板：百分比比例 → K 数值；projectedTokens ≥ thresholdK*1000 触发） */
     rebuildThresholdK: number;
     /** F4 Skiff 调试服务总开关（实验性；默认关——不随插件加载自动启动，人工开启） */

package/lib/trajectory-assistant.d.ts

@@ -33,6 +33,11 @@ export declare const EVENT_LABEL: {
     readonly guard: "BOUNDARY GUARD";
     /** SESSION.md 体积超限重写提醒（v1.31.1，S142 用户需求） */
     readonly compaction: "LOGBOOK COMPACTION";
+    /** **交界便签（REBUILD-TODO.md）体积超限清理提醒**（v1.49.0，owner 2026-09-26 需求）。
+     *
+     *  🔴 **刻意与 `compaction` 分开**：那条要求"**重写 SESSION.md 并保留 EAP 骨架**"，
+     *  本条只要求"**清理便签**"——共用一个 token 会让模型误以为要动 SESSION.md。 */
+    readonly scratchPrune: "SCRATCH PRUNE";
 };
 /** 家族标识（所有动态注入统一前缀） */
 export declare const ASSISTANT_PREFIX = "TRAJECTORY-ASSISTANT";
@@ -42,16 +47,24 @@ export declare function eventToken(event: keyof typeof EVENT_LABEL): string;
 export declare const ACK_PREFIX = "TRAJECTORY-ASSISTANT-recorded";
 export declare const ACK_SKIP_PREFIX = "TRAJECTORY-ASSISTANT-skipped";
 /**
- * rebuild 交接区块标题（v1.31.1，S142 用户需求）。
+ * rebuild 交界便签的**文件名**（v1.49.0；owner 2026-09-26 需求）。
  *
- * 用途：rebuild 提醒要求模型把**当前手头事项**写到 SESSION.md **末尾**的这个小标题之下；
- * rebuild 锚点随后要求重建后的自己去读这一段并处理。两侧引用**同一个常量**——
- * 标题一旦漂移，读侧就找不到写侧写的东西（单一真相源）。
+ * ## 它取代了什么（owner 原话：*"砍掉 in-flight，这正是目的"*）
+ * v1.31.1 的交界协议要求把手头事项写进 **SESSION.md 末尾**的 `## In-flight (rebuild handover)` 段。
+ * 实测的代价（S142 自身取证）：In-flight 段曾积 **12 块**（含多份**已被取代**的交接），
+ * 而 SESSION.md 是**有格式义务**的持久文件（7 段固定 ＋ 粒度受 EAP 约束）⇒
+ * ① 持久文件被临时物污染 ② 每次整理都要付"压缩＋归档＋保真"三件套（该文件曾达 292 KB）。
  *
- * 形态（用户拍板 Q2）：**固定英文标题行**（不是 HTML 注释锚）——人读友好；ACC 写死英文，
- * 因为 SESSION.md 的正文语言归 CCC，但两侧的**机械锚点**必须逐字一致。
+ * ⇒ 分家：**只用一次的交界材料**写进这份**临时便签**（无格式义务、无留档义务、可随时丢弃）。
+ *
+ * ## 🔴 三处引用同一常量（单一真相源）
+ * **写侧** = `seams/keeper.ts` 的 `rebuildReminderText()`｜**读侧** = `rebuild.ts` 的重建锚点｜
+ * **体积提醒** = `seams/keeper.ts` 的 `rebuildTodoReminderText()`。
+ * 文件名一旦漂移，写侧写的东西读侧就找不到 —— **且没有任何机械信号会报警**。
+ *
+ * 🔴 **不得改名**（owner 已具名）。形态 = **固定文件名**（人读友好；比照旧 IN_FLIGHT_HEADING 的取舍）。
  */
-export declare const IN_FLIGHT_HEADING = "## In-flight (rebuild handover)";
+export declare const REBUILD_TODO_FILENAME = "REBUILD-TODO.md";
 /** 风格档位：plain（默认，精确文本）/ metaphor（借星舰词——产品隐喻非游戏词） */
 type TrajectoryStyle = 'plain' | 'metaphor';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.48.2",
+  "version": "1.49.0",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1。",
   "license": "MIT",
   "repository": {