@shgroup/dsh-serenity-hooks 1.57.2 → 1.58.0

package/dsh.plugin.json

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

package/lib/cro.d.ts

@@ -45,6 +45,14 @@
  */
 /** 入口文件名（**全写**，所有者令 2026-09-19；不改缩写） */
 export declare const CRO_FILENAME = "continuous-re-occurrence.ts";
+/**
+ * 机器绑定文件名（**全写**，与 `CRO_FILENAME` 同风格）。
+ *
+ * 🔴 **它随 CCC git 走是设计意图，不是缺陷**：
+ * 绑定声明必须跟着**轨迹**走，才能在第二台机器上被读到、并被判为"不是我的"。
+ * （这正是机器绑定的整个目的 —— 见 `resolveCroHostBinding` 的头注。）
+ */
+export declare const CRO_HOST_FILENAME = "cro-host-binding";
 /** 硬超时（沿用 `biasProvider` 先例的 60s；设计 §5 情形 2） */
 export declare const CRO_TIMEOUT_MS = 60000;
 /**
@@ -223,6 +231,88 @@ export type CroRunner = (scriptAbs: string, stdinJson: string, timeoutMs: number
 export declare function croScriptPath(root: string, dirName: string): string;
 /** CRO 是否启用（**判据 = 文件在不在**；设计 §2.1：无 enabled 字段、无注册表） */
 export declare function isCroEnabled(root: string, dirName: string): boolean;
+/**
+ * 机器绑定判定结果（**永不抛**）。
+ *
+ * 三态而非布尔：**「没绑」与「绑给别人」必须分得开**（见下"为什么三态"）。
+ */
+export interface CroHostVerdict {
+    /** 这台机器可以跑吗（唯一决定投递与否的字段） */
+    allowed: boolean;
+    /** 绑定文件里写的机器名（未绑/读不到 ⇒ `null`） */
+    bound: string | null;
+    /** 本机机器名 */
+    self: string;
+    /**
+     * 机器可读的判定原因（稳定码，供测试与日志断言）。
+     * · `bound-to-self` —— 已绑且是本机 ⇒ 跑
+     * · `not-bound` —— **没有绑定文件**（或文件是空的）⇒ **不跑**（fail-closed）
+     * · `bound-to-other` —— 绑给了别的机器 ⇒ 不跑
+     * · `read-error` —— 文件在但读不了 ⇒ 不跑（fail-closed）
+     */
+    code: 'bound-to-self' | 'not-bound' | 'bound-to-other' | 'read-error';
+    /** 人读说明（进 tick 日志） */
+    detail: string;
+}
+/**
+ * 解析机器绑定 —— 「**这条轨迹由哪台机器负责自唤醒**」（所有者令 2026-10-15）。
+ *
+ * ## 所有者裁定的语义（逐字，D135）
+ *
+ * 「**CRO 必须指定绑定机器，否则不运行，唤醒器 检查这个**」⇒ 三条同时成立：
+ * ① **只许这一台**（白名单，不是"排除这一台"）；
+ * ② **fail-closed** —— **没绑 = 不跑**（不是"没绑 = 随便跑"）；
+ * ③ **检查者在唤醒器**（本函数由 `runCroPhase` 调用，不是程序自己判）。
+ *
+ * ## 绑定键 = 机器名（所有者 2026-10-15 裁「用 hostname 吧，比较合理」）
+ *
+ * ⚠️ **已接受的取舍**：本机机器名是 QEMU 机型派生的默认形
+ * （`yh-Standard-PC-Q35-ICH9-2009`）⇒ 同法新建的同名用户 VM 会取到同一个名字。
+ * 所有者 2026-10-15 明确「**不改名，家里就这几台机器没必要**」⇒ **风险由所有者接受**。
+ *
+ * ## 🔴 为什么必须是三态，「没绑」不能并进「绑给别人」
+ *
+ * 2026-10-15 已发生过**同族事故**：`send-now` 失败时报的是「无绑定会话记录」，
+ * 而真因是"那条轨迹不可寻址"—— **文案相同、原因不同**，害得排查方向错了一次
+ * （S142 §日志 续 129 / D134）。
+ * ⇒ 绑定这一层**不许再造同样的坑**：「你没绑」与「你绑给了别人」是**两件不同的事**，
+ *   日志必须分开写 —— 否则将来"为什么这条轨迹不跑了"会又一次指错方向。
+ *
+ * ## 文件形态（刻意的极简）
+ *
+ * · 位置 = `<轨迹目录>/cro-host-binding`（与 CRO 程序**同级**）
+ * · 内容 = **一行机器名**（首尾空白裁掉；只取第一行有效内容）
+ * · 不用 JSON —— 它只有一个值，JSON 只会多一种写错的方式
+ * · 支持 `#` 注释行与空行（方便人写、方便留痕）
+ *
+ * 🔴 **它必须随 git 入库**（不是"运行态"）：绑定声明要**跟着轨迹走到第二台机器**，
+ *   在那里被判成「绑给了别人」而**正确地不跑** —— 那就是本机制在工作。
+ *   ⇒ ⛔ **不要把它加进 `.gitignore`**（那会让第二台机器读到"没绑"而同样不跑，
+ *   表面上结果一样，但**判据从"明确绑给别人"退化成"什么都没说"**，失去可诊断性）。
+ *
+ * ## 为什么读文件而不是读快照字段
+ *
+ * 快照（`CroSnapshot`）是喂给**程序**的；而本判定发生在**程序被 spawn 之前**
+ * —— 程序还没跑，没有快照可读。⇒ 只能读文件。（这也是"机制属 ACC"的体现：
+ * ACC 在调用用户程序前先判定自己该不该调用。）
+ *
+ * @param root CCC 根
+ * @param dirName 轨迹目录名
+ * @param selfHost 本机机器名（**注入** ⇒ 可测；生产调用方传 `hostname()`）
+ * @returns 判定结果（**永不抛** —— 旁路容忍铁律）
+ */
+export declare function resolveCroHostBinding(root: string, dirName: string, selfHost: string): CroHostVerdict;
+/**
+ * 解析绑定文件正文 ⇒ 机器名（取不到 ⇒ `null`）。
+ *
+ * 规则（刻意宽松：**只认一行，其余都当注释**）：
+ * · 逐行扫；跳过空行与 `#` 开头的行；
+ * · **第一条有效行** = 机器名（裁首尾空白）；
+ * · 无有效行 ⇒ `null`。
+ * @param raw 文件正文
+ * @returns 机器名；无有效内容 ⇒ `null`
+ */
+export declare function parseCroHostBinding(raw: string): string | null;
 /**
  * 列出**启用了 CRO 的轨迹目录名**（供调度器每 tick 扫描，设计 §6.1）。
  *

package/lib/index.js

@@ -13,7 +13,7 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 import { appendFileSync, chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, rmdirSync, statSync, unlinkSync, utimesSync, writeFileSync } from "node:fs";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
-import { homedir, platform } from "node:os";
+import { homedir, hostname, platform } from "node:os";
 import { promisify } from "node:util";
 import { platform as platform$1 } from "node:process";
 import { fileURLToPath } from "node:url";
@@ -9971,10 +9971,20 @@ function listWakes(root, opts = {}) {
 */
 /** 入口文件名（**全写**，所有者令 2026-09-19；不改缩写） */
 const CRO_FILENAME = "continuous-re-occurrence.ts";
+/**
+* 机器绑定文件名（**全写**，与 `CRO_FILENAME` 同风格）。
+*
+* 🔴 **它随 CCC git 走是设计意图，不是缺陷**：
+* 绑定声明必须跟着**轨迹**走，才能在第二台机器上被读到、并被判为"不是我的"。
+* （这正是机器绑定的整个目的 —— 见 `resolveCroHostBinding` 的头注。）
+*/
+const CRO_HOST_FILENAME = "cro-host-binding";
 /** 硬超时（沿用 `biasProvider` 先例的 60s；设计 §5 情形 2） */
 const CRO_TIMEOUT_MS = 6e4;
 /** stdout 上限（防一个坏程序把日志撑爆；沿用 hook 截断思路） */
 const CRO_STDOUT_MAX = 65536;
+/** 绑定文件体积上限（它只是个机器名 ⇒ 超过这个数一定是写错了，不读） */
+const CRO_HOST_FILE_MAX = 1024;
 /** SESSION.md 文件名（与 `trajectory-ops.ts` 同值；此处本地常量避免反向依赖） */
 const SESSION_MD = "SESSION.md";
 /**
@@ -10109,6 +10119,135 @@ function croScriptPath(root, dirName) {
 	return resolveInside(root, join("AGENT_SESSIONS", dirName, CRO_FILENAME));
 }
 /**
+* 解析机器绑定 —— 「**这条轨迹由哪台机器负责自唤醒**」（所有者令 2026-10-15）。
+*
+* ## 所有者裁定的语义（逐字，D135）
+*
+* 「**CRO 必须指定绑定机器，否则不运行，唤醒器 检查这个**」⇒ 三条同时成立：
+* ① **只许这一台**（白名单，不是"排除这一台"）；
+* ② **fail-closed** —— **没绑 = 不跑**（不是"没绑 = 随便跑"）；
+* ③ **检查者在唤醒器**（本函数由 `runCroPhase` 调用，不是程序自己判）。
+*
+* ## 绑定键 = 机器名（所有者 2026-10-15 裁「用 hostname 吧，比较合理」）
+*
+* ⚠️ **已接受的取舍**：本机机器名是 QEMU 机型派生的默认形
+* （`yh-Standard-PC-Q35-ICH9-2009`）⇒ 同法新建的同名用户 VM 会取到同一个名字。
+* 所有者 2026-10-15 明确「**不改名，家里就这几台机器没必要**」⇒ **风险由所有者接受**。
+*
+* ## 🔴 为什么必须是三态，「没绑」不能并进「绑给别人」
+*
+* 2026-10-15 已发生过**同族事故**：`send-now` 失败时报的是「无绑定会话记录」，
+* 而真因是"那条轨迹不可寻址"—— **文案相同、原因不同**，害得排查方向错了一次
+* （S142 §日志 续 129 / D134）。
+* ⇒ 绑定这一层**不许再造同样的坑**：「你没绑」与「你绑给了别人」是**两件不同的事**，
+*   日志必须分开写 —— 否则将来"为什么这条轨迹不跑了"会又一次指错方向。
+*
+* ## 文件形态（刻意的极简）
+*
+* · 位置 = `<轨迹目录>/cro-host-binding`（与 CRO 程序**同级**）
+* · 内容 = **一行机器名**（首尾空白裁掉；只取第一行有效内容）
+* · 不用 JSON —— 它只有一个值，JSON 只会多一种写错的方式
+* · 支持 `#` 注释行与空行（方便人写、方便留痕）
+*
+* 🔴 **它必须随 git 入库**（不是"运行态"）：绑定声明要**跟着轨迹走到第二台机器**，
+*   在那里被判成「绑给了别人」而**正确地不跑** —— 那就是本机制在工作。
+*   ⇒ ⛔ **不要把它加进 `.gitignore`**（那会让第二台机器读到"没绑"而同样不跑，
+*   表面上结果一样，但**判据从"明确绑给别人"退化成"什么都没说"**，失去可诊断性）。
+*
+* ## 为什么读文件而不是读快照字段
+*
+* 快照（`CroSnapshot`）是喂给**程序**的；而本判定发生在**程序被 spawn 之前**
+* —— 程序还没跑，没有快照可读。⇒ 只能读文件。（这也是"机制属 ACC"的体现：
+* ACC 在调用用户程序前先判定自己该不该调用。）
+*
+* @param root CCC 根
+* @param dirName 轨迹目录名
+* @param selfHost 本机机器名（**注入** ⇒ 可测；生产调用方传 `hostname()`）
+* @returns 判定结果（**永不抛** —— 旁路容忍铁律）
+*/
+function resolveCroHostBinding(root, dirName, selfHost) {
+	const self = String(selfHost ?? "").trim();
+	let fileAbs;
+	try {
+		fileAbs = resolveInside(root, join("AGENT_SESSIONS", dirName, CRO_HOST_FILENAME));
+	} catch (err) {
+		return {
+			allowed: false,
+			bound: null,
+			self,
+			code: "read-error",
+			detail: `绑定文件路径非法（已忽略）：${String(err?.message ?? err)}`
+		};
+	}
+	let raw;
+	try {
+		if (!existsSync(fileAbs)) return {
+			allowed: false,
+			bound: null,
+			self,
+			code: "not-bound",
+			detail: `未绑定机器（缺 ${CRO_HOST_FILENAME}）⇒ 按"必须指定"不运行`
+		};
+		const st = statSync(fileAbs);
+		if (st.size > CRO_HOST_FILE_MAX) return {
+			allowed: false,
+			bound: null,
+			self,
+			code: "read-error",
+			detail: `绑定文件过大（${st.size} B > ${CRO_HOST_FILE_MAX} B）⇒ 判为写错，不运行`
+		};
+		raw = readFileSync(fileAbs, "utf-8");
+	} catch (err) {
+		return {
+			allowed: false,
+			bound: null,
+			self,
+			code: "read-error",
+			detail: `绑定文件读取失败 ⇒ 不运行：${String(err?.message ?? err)}`
+		};
+	}
+	const bound = parseCroHostBinding(raw);
+	if (bound === null) return {
+		allowed: false,
+		bound: null,
+		self,
+		code: "not-bound",
+		detail: `绑定文件为空（只有注释/空行）⇒ 按"必须指定"不运行`
+	};
+	if (bound === self) return {
+		allowed: true,
+		bound,
+		self,
+		code: "bound-to-self",
+		detail: `已绑定本机（${bound}）`
+	};
+	return {
+		allowed: false,
+		bound,
+		self,
+		code: "bound-to-other",
+		detail: `绑定给别的机器（绑定=${bound}，本机=${self}）⇒ 本机不运行`
+	};
+}
+/**
+* 解析绑定文件正文 ⇒ 机器名（取不到 ⇒ `null`）。
+*
+* 规则（刻意宽松：**只认一行，其余都当注释**）：
+* · 逐行扫；跳过空行与 `#` 开头的行；
+* · **第一条有效行** = 机器名（裁首尾空白）；
+* · 无有效行 ⇒ `null`。
+* @param raw 文件正文
+* @returns 机器名；无有效内容 ⇒ `null`
+*/
+function parseCroHostBinding(raw) {
+	for (const line of String(raw ?? "").split(/\r?\n/)) {
+		const t = line.trim();
+		if (t === "" || t.startsWith("#")) continue;
+		return t;
+	}
+	return null;
+}
+/**
 * 列出**启用了 CRO 的轨迹目录名**（供调度器每 tick 扫描，设计 §6.1）。
 *
 * ## 判据与形态（R↓）
@@ -11441,10 +11580,18 @@ async function runCroPhase(ctx, root, registry, log) {
 		lastSkipReason: s.lastSkipReason
 	};
 	const agents = hostAgents(ctx);
+	const selfHost = safeHostname();
+	let hostSkips = 0;
 	let wakes = 0;
 	let quiet = 0;
 	let skips = 0;
 	for (const dirName of dirs) try {
+		const verdict = resolveCroHostBinding(root, dirName, selfHost);
+		if (!verdict.allowed) {
+			hostSkips += 1;
+			log.push(`· ${root}: ${dirName}: CRO 机器绑定未通过（${verdict.code}）：${verdict.detail}`);
+			continue;
+		}
 		const bound = listBoundSessionIds(root, dirName);
 		const running = runningCarriersOf(bound, nowMs);
 		const outcome = await evaluateCro(root, dirName, readCroSnapshotInput(root, dirName, nowMs, {
@@ -11481,7 +11628,22 @@ async function runCroPhase(ctx, root, registry, log) {
 		skips += 1;
 		log.push(`· ${root}: ${dirName}: CRO 内部异常（已忽略，不影响既有链路）: ${String(err?.message ?? err)}`);
 	}
-	log.push(`· ${root}: CRO 评估 ${dirs.length} 条（唤起 ${wakes}，不唤起 ${quiet}，跳过 ${skips}）`);
+	log.push(`· ${root}: CRO 评估 ${dirs.length} 条（唤起 ${wakes}，不唤起 ${quiet}，跳过 ${skips}${hostSkips > 0 ? `，非本机绑定 ${hostSkips}` : ""}）`);
+}
+/**
+* 取本机机器名（**永不抛**）。
+*
+* `os.hostname()` 理论上可能抛（极少数环境）⇒ 这里兜底成空串。
+* ⚠️ **空串的后果是"全部不通过"**（`bound === self` 永不成立）⇒ 即 **fail-closed**，
+* 与所有者裁定同向（宁可都不跑，也不会"名字取不到就随便跑"）。
+* @returns 本机机器名；取不到 ⇒ `''`
+*/
+function safeHostname() {
+	try {
+		return hostname();
+	} catch {
+		return "";
+	}
 }
 /** 一次调度 tick：遍历已知 CCC → 到期项串行投递 / 超窗项置 missed；返回人读摘要 */
 async function runWakeTick(ctx) {
@@ -11641,6 +11803,36 @@ const CRO_GUIDE = `CRO（Continuous Re-Occurrence · 持续再发生）编写指
    （tick 日志里会记一行跳过理由 —— 这是为了让你事后能分辨
    「**总闸关着没跑**」和「**跑了、程序自己判了不叫**」这两件完全不同的事）。
 
+## 2b. 🔴 机器绑定（**必须指定，否则不运行** —— 所有者令 2026-10-15）
+
+同目录再放一个文件：
+
+  <CCC 根>/AGENT_SESSIONS/<轨迹目录>/cro-host-binding
+
+内容 = **一行机器名**（就是本机 \`hostname\`）。也支持 \`#\` 注释行，方便留痕：
+
+  # 这条轨迹的自唤醒只在 CCC 宿主机上跑
+  yh-Standard-PC-Q35-ICH9-2009
+
+**语义（三条，缺一不可）**：
+· **只许这一台** —— 文件名里写的那台；别处**不跑**；
+· 🔴 **fail-closed** —— **没写这个文件 ⇒ 不跑**（不是"没写就随便跑"）；
+· **检查者是唤醒器**（ACC），**不是**你的程序 —— 你的程序**根本不会被调用**。
+
+**为什么要有它**：CRO 程序本身**随 git 走**（它在你轨迹目录里，会跟着 CCC 到第二台机器）。
+没有这道门，**同一段程序会在两台机器各跑一次**（同一轨迹被叫两次）。
+有了它，第二台机器读到"绑给了别人"就**正确地不跑**。
+
+⚠️ **两条与它有关的纪律**：
+1. 🔴 **不要把这个文件加进 \`.gitignore\`** —— 它**必须**跟着仓走。
+   否则第二台机器读到的是"没绑"，结果**碰巧一样**（也不跑），
+   但你的判据从「**明确绑给了别人**」退化成「**什么都没说**」⇒ 排查时看不出真因。
+2. 🔴 **tick 日志会区分两种跳过**：
+   「\`not-bound\` 你没绑」与「\`bound-to-other\` 你绑给了别人」是**两件事**，文案不同。
+   （2026-10-15 有过一次教训：两种不同的原因报同一句话，害排查指错方向。）
+
+**改绑 / 解除**：直接改这个文件（或删掉 ⇒ 变回"没绑 ⇒ 不跑"）。**没有额外命令**。
+
 ## 3. 我给你什么（输入）
 ACC 把这条轨迹的状态做成一个 **JSON 快照**，从 **stdin** 喂给你的程序。
 字段分四组：identity（身份）/ time（时间）/ body（轨迹身体）/ binding + scheduling（绑定与调度）。

package/package.json

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