@shgroup/dsh-serenity-hooks 1.29.1 → 1.29.2

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.29.1",
+  "version": "1.29.2",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/handyman/session_rebuild/skiff_admin + 拦截缝机械约束（safe-mode/路径守卫）+ 高级设定面板（双端口网关/账号管理）+ Skiff 认知子集角色（实验性）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/index.js

@@ -4015,15 +4015,19 @@ function stripAckSuffix(text) {
 /**
 * 构建重建锚点消息（v1.22.4 定稿语义 + v1.22.5 保留 first-anchor 正文）：
 * 「[TRAJECTORY-REBUILD] + first-anchor 协议正文（去 acknowledge 尾句）+ 继续 {SESSION 名} 的工作」。
+* v1.29.2（R1）：可选 task focus 段——简短任务焦点文字传入重建后会话（不含历史，
+* 历史完整在 SESSION.md；让重建后的自己第一时间理解本轮焦点，降低冷启动认知成本）。
 * @param root - CCC 根
 * @param sessionName - 当前 use 的宁静号 SESSION 名（如 S142）；无激活则通用指令
 * @param activeMdPath - 持久轨迹 SESSION.md 绝对路径（保持原位）
 * @param anchorMessages - first-anchor 协议消息序列（缺省 DEFAULT_ANCHOR_MESSAGES；可注入测试）
+* @param focus - 可选任务焦点（单行化 + ≤200 字消毒；无则不输出 focus 段——向后兼容）
 */
-function buildRebuildAnchor(root, sessionName, activeMdPath, anchorMessages = DEFAULT_ANCHOR_MESSAGES) {
+function buildRebuildAnchor(root, sessionName, activeMdPath, anchorMessages = DEFAULT_ANCHOR_MESSAGES, focus) {
 	const rel = activeMdPath.startsWith(root) ? activeMdPath.slice(root.length + 1) : activeMdPath;
 	const sessionDir = basename(dirname(activeMdPath));
 	const sessionLine = sessionDir !== "AGENT_SESSIONS" ? `- Serenity session: ${sessionName !== "" ? `${sessionName} (${sessionDir})` : sessionDir}` : null;
+	const focusLine = sanitizeFocusLine(focus);
 	return [
 		`${eventToken("rebuild")} The conversation has been cleared and rebuilt (Ship of Theseus: the carrier is replaced, the trajectory continues).`,
 		"",
@@ -4032,9 +4036,22 @@ function buildRebuildAnchor(root, sessionName, activeMdPath, anchorMessages = DE
 		...sessionLine ? [sessionLine] : [],
 		`- 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.`
+		`- Read that SESSION.md first (goal/decisions/progress/unresolved), then continue from the last checkpoint.`,
+		...focusLine ? [`- Task focus: ${focusLine}`] : []
 	].join("\n");
 }
+/**
+* 任务焦点行消毒（纯函数可单测）：单行化（换行/回车 → 空格）+ 控制字符清除 +
+* ≤200 字截断。空/纯空白 → null（不输出 focus 段）。防 LLM 传多行注入伪造锚点结构。
+*/
+function sanitizeFocusLine(focus) {
+	if (!focus) return null;
+	const single = focus.replace(/[\r\n\t]+/g, " ").replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, "").trim();
+	if (single === "") return null;
+	return single.length <= FOCUS_MAX_CHARS ? single : single.slice(0, FOCUS_MAX_CHARS);
+}
+/** 任务焦点最大长度（字/码点；200 足够一句话任务焦点——非历史） */
+const FOCUS_MAX_CHARS = 200;
 /** 从会话 surface 首条 user 消息（重建锚点）解析 SESSION.md 路径（events 异常/缺失时的兜底） */
 function parseAnchorMdPath(session) {
 	try {
@@ -4121,7 +4138,8 @@ async function queueRebuild(ctx, opts) {
 	const mdPath = resolveSessionMdPath(root, dshSessionId, session);
 	if (!mdPath) throw new Error("Unable to determine the active SESSION.md — no session context found in this conversation. Run \"session use <S###> --summary <内容概括 ≤20 字>\" first to activate the trajectory to resume, then retry session_rebuild.");
 	const sessionName = getActiveSessionInfo(dshSessionId)?.sessionId ?? sessionNameFromMdPath(mdPath);
-	const anchor = buildRebuildAnchor(root, sessionName, mdPath);
+	const focus = note && note.trim() !== "" ? note : void 0;
+	const anchor = buildRebuildAnchor(root, sessionName, mdPath, DEFAULT_ANCHOR_MESSAGES, focus);
 	appendBound(session, "rebuild", {
 		dirName: basename(dirname(mdPath)),
 		mdPath,
@@ -4132,6 +4150,7 @@ async function queueRebuild(ctx, opts) {
 		anchor,
 		summary,
 		mdPath,
+		focus,
 		queuedAt: Date.now()
 	});
 	writeRebuildDiag(root, {
@@ -4323,7 +4342,7 @@ function createRebuildTool(ctx) {
 		parameters: {
 			note: {
 				type: "string",
-				description: "Optional: one-sentence rebuild background note (for the rebuilt self)"
+				description: "Optional: task focus ≤200 chars for the rebuilt self — what to work on next (short, no history; SESSION.md holds the full history). Injected as \"- Task focus: …\" into the rebuild anchor."
 			},
 			summary: {
 				type: "string",
@@ -4951,25 +4970,60 @@ function registerAutopilot(ctx) {
 		ctx.on("serenity/settings-changed", () => startTimer());
 	} catch {}
 }
-/** 目标 agent：从 SESSION.md 反向定位 dsh 会话（标题 F3 命名 S###-日期 匹配 + cwd 归属校验）；不可得 → null */
+/**
+* 目标 agent：从 SESSION.md 反向定位 dsh 会话（cwd 归属校验 + **bound 精确匹配优先**，
+* 标题 F3 命名回退）；不可得 → null。
+*
+* v1.29.2（R2，用户"autopilot 会话绑定应当更稳固——唤起的时候能唤起最新的、
+* 绑定 autopilot SESSION 的会话"）：v1.29.1 `serenity/bound` 事件是权威绑定
+* （session use 激活时 append，dirName = 完整 AGENT_SESSIONS 目录名，编码无关 U4）。
+* 旧实现只按标题猜（=== sid / startsWith(sid-)）——若绑定该 SESSION 的 dsh 会话
+* 标题不是 S###- 前缀（LLM 改过/重建后 rename 异常），绑定明明在却唤起失败。
+* 加强：**bound.dirName 精确匹配优先**（权威证据），标题匹配降级为回退（存量
+* 无 bound 的 live 会话兼容）；多候选（罕见：同 SESSION 绑定多个 live 会话）取
+* **绑定最新**（bound.at 最大——最近 use 过 = 最可能当前在用）。
+*/
 function resolveTargetAgent(ctx, mdPath) {
-	const idMatch = basename(dirname(mdPath)).match(/--S(\d{3,})--/);
+	const dirName = basename(dirname(mdPath));
+	const idMatch = dirName.match(/--S(\d{3,})--/);
 	const sid = idMatch ? `S${idMatch[1]}` : null;
 	const targetRoot = findSerenityRoot(mdPath);
+	const sessions = ctx.sessions;
+	const agents = ctx.agents;
+	const candidates = [];
 	try {
-		const sessions = ctx.sessions;
 		for (const s of sessions?.list?.() ?? []) {
-			const cwd = s?.header?.cwd ?? "";
+			const sess = s;
+			const cwd = sess?.header?.cwd ?? "";
 			if (targetRoot) {
 				if (findSerenityRoot(cwd) !== targetRoot) continue;
 			} else if (cwd !== "" && !mdPath.startsWith(cwd.endsWith("/") ? cwd : cwd + "/")) continue;
-			const title = readSessionTitle(s);
-			if (sid && title && (title === sid || title.startsWith(`${sid}-`))) {
-				const agent = ctx.agents?.get?.(s.id ?? "");
-				if (agent) return agent;
-			}
+			const bound = readLastBound(sess);
+			const title = readSessionTitle(sess);
+			const boundMatched = bound !== null && bound.dirName === dirName;
+			const titleMatched = sid !== null && title !== null && (title === sid || title.startsWith(`${sid}-`));
+			if (boundMatched) candidates.push({
+				session: sess,
+				boundAt: bound?.at ?? null,
+				titleMatched
+			});
+			else if (titleMatched) candidates.push({
+				session: sess,
+				boundAt: null,
+				titleMatched
+			});
 		}
 	} catch {}
+	if (candidates.length === 0) return null;
+	candidates.sort((a, b) => {
+		const aBound = a.boundAt !== null;
+		if (aBound !== (b.boundAt !== null)) return aBound ? -1 : 1;
+		return (b.boundAt ?? 0) - (a.boundAt ?? 0);
+	});
+	for (const c of candidates) {
+		const agent = agents?.get?.(c.session.id ?? "");
+		if (agent) return agent;
+	}
 	return null;
 }
 /**
@@ -4989,31 +5043,38 @@ function readSessionTitle(session) {
 }
 /**
 * 诊断：目标会话 agent 为何不可得（供 performAutopilotWake 失败信息——
-* 区分"live 会话里无匹配" vs "匹配但 agent 未加载"）。返回诊断文本（无则 null）。
+* 区分"无 live 会话" / "标题不匹配" / "bound 或标题命中但 agent 未加载"）。
+* v1.29.2（R2）：bound 命中但 agent 未加载也归入「已匹配未加载」（原只查标题）。
+* 返回诊断文本（无则 null）。
 */
 function diagnoseTargetUnavailable(ctx, mdPath) {
-	const idMatch = basename(dirname(mdPath)).match(/--S(\d{3,})--/);
+	const dirName = basename(dirname(mdPath));
+	const idMatch = dirName.match(/--S(\d{3,})--/);
 	const sid = idMatch ? `S${idMatch[1]}` : null;
 	const targetRoot = findSerenityRoot(mdPath);
 	const sameCccTitles = [];
-	const agentMissing = { sid: false };
+	const agentMissing = { matched: false };
 	try {
 		const sessions = ctx.sessions;
 		for (const s of sessions?.list?.() ?? []) {
-			const cwd = s?.header?.cwd ?? "";
+			const sess = s;
+			const cwd = sess?.header?.cwd ?? "";
 			if (targetRoot) {
 				if (findSerenityRoot(cwd) !== targetRoot) continue;
 			} else if (cwd !== "" && !mdPath.startsWith(cwd.endsWith("/") ? cwd : cwd + "/")) continue;
-			const title = readSessionTitle(s);
+			const bound = readLastBound(sess);
+			const title = readSessionTitle(sess);
 			if (title) sameCccTitles.push(title);
-			if (sid && title && (title === sid || title.startsWith(`${sid}-`))) {
-				if (!ctx.agents?.get?.(s.id ?? "")) agentMissing.sid = true;
+			const boundMatched = bound !== null && bound.dirName === dirName;
+			const titleMatched = sid !== null && title !== null && (title === sid || title.startsWith(`${sid}-`));
+			if (boundMatched || titleMatched) {
+				if (!ctx.agents?.get?.(sess.id ?? "")) agentMissing.matched = true;
 			}
 		}
 	} catch {}
-	if (agentMissing.sid) return `会话 ${sid} 已打开但 agent 未加载（会话可能刚创建/正在恢复——稍后重试）`;
-	if (sameCccTitles.length > 0) return `目标 CCC 内 live 会话标题: [${sameCccTitles.join(", ")}]——均不匹配 ${sid}（目标会话未在 WebUI 打开，或命名未生效）`;
-	return `目标 CCC 内无 live 会话（先在 WebUI 打开 ${sid} 会话后重试）`;
+	if (agentMissing.matched) return `会话已绑定/匹配 ${sid ?? dirName} 但 agent 未加载（会话可能刚创建/正在恢复——稍后重试）`;
+	if (sameCccTitles.length > 0) return `目标 CCC 内 live 会话标题: [${sameCccTitles.join(", ")}]——均不匹配 ${sid ?? dirName}（目标会话未在 WebUI 打开，或绑定/命名未生效）`;
+	return `目标 CCC 内无 live 会话（先在 WebUI 打开 ${sid ?? dirName} 会话后重试）`;
 }
 /** Autopilot 绑定的回退 CCC 根：进程 cwd 上溯 .serenity 优先，回退任一 live 会话 root */
 function resolveAutopilotRoot(ctx) {

package/lib/rebuild.d.ts

@@ -45,12 +45,20 @@ export declare function stripAckSuffix(text: string): string;
 /**
  * 构建重建锚点消息（v1.22.4 定稿语义 + v1.22.5 保留 first-anchor 正文）：
  * 「[TRAJECTORY-REBUILD] + first-anchor 协议正文（去 acknowledge 尾句）+ 继续 {SESSION 名} 的工作」。
+ * v1.29.2（R1）：可选 task focus 段——简短任务焦点文字传入重建后会话（不含历史，
+ * 历史完整在 SESSION.md；让重建后的自己第一时间理解本轮焦点，降低冷启动认知成本）。
  * @param root - CCC 根
  * @param sessionName - 当前 use 的宁静号 SESSION 名（如 S142）；无激活则通用指令
  * @param activeMdPath - 持久轨迹 SESSION.md 绝对路径（保持原位）
  * @param anchorMessages - first-anchor 协议消息序列（缺省 DEFAULT_ANCHOR_MESSAGES；可注入测试）
+ * @param focus - 可选任务焦点（单行化 + ≤200 字消毒；无则不输出 focus 段——向后兼容）
  */
-export declare function buildRebuildAnchor(root: string, sessionName: string, activeMdPath: string, anchorMessages?: string[]): string;
+export declare function buildRebuildAnchor(root: string, sessionName: string, activeMdPath: string, anchorMessages?: string[], focus?: string | null): string;
+/**
+ * 任务焦点行消毒（纯函数可单测）：单行化（换行/回车 → 空格）+ 控制字符清除 +
+ * ≤200 字截断。空/纯空白 → null（不输出 focus 段）。防 LLM 传多行注入伪造锚点结构。
+ */
+export declare function sanitizeFocusLine(focus: string | null | undefined): string | null;
 export interface RebuildResult {
     /** 是否成功排队（turn 结束时执行清空重建） */
     queued: boolean;
@@ -73,6 +81,8 @@ interface PendingRebuild {
     summary: string;
     /** 持久轨迹 SESSION.md（重建后重命名标题的编号/日期来源） */
     mdPath: string;
+    /** v1.29.2（R1）：任务焦点（可选——重建后会话理解当前任务；不含历史） */
+    focus?: string;
     /** 排队时间（防陈旧队列误清空——超时丢弃） */
     queuedAt: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.29.1",
+  "version": "1.29.2",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {