@shgroup/dsh-serenity-hooks 1.27.14 → 1.28.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.27.14",
+  "version": "1.28.0",
   "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": {
@@ -19,7 +19,8 @@
       "handyman",
       "session_rebuild",
       "localstore",
-      "skiff_admin"
+      "skiff_admin",
+      "autopilot-trajectory"
     ],
     "skills": []
   }

package/lib/{ccc-CfDrlfA7.js → ccc-CX48YNUL.js}

@@ -59,6 +59,24 @@ function resolveInside(root, p) {
 	return abs;
 }
 /**
+* CCC 名：从 .serenity 标记解析——**跳过 # 注释与空行的首个非空行**。
+* 注册表聚合档路径（.opencode/skills/<cccName>/references/mech-registry.json）以此为准，
+* 是 guards/fs-ops/msm-ops/kit-ops 四处解析的唯一真相源（review P2-2 收口，09-05：
+* 原四处分叉——msm-ops/kit-ops 取严格首行、guards/fs-ops 跳注释——首行为注释/空行时
+* register 目标路径与保护路径分叉，潜在隐患）。
+* @returns CCC 名；无标记/读失败/全注释空行 → null
+*/
+function readCccName(root) {
+	try {
+		const marker = resolve(root, ".serenity");
+		if (!existsSync(marker)) return null;
+		const line = readFileSync(marker, "utf-8").split("\n").map((l) => l.trim()).find((l) => l !== "" && !l.startsWith("#"));
+		return line && line !== "" ? line : null;
+	} catch {
+		return null;
+	}
+}
+/**
 * 解析 handyman 配置（v1.24.0：取代 loop.defaultModel；不兼容旧 loop 配置——用户拍板）。
 * @returns 白名单 + 缺省模型 + 上限；models 未配置返回 null（工具应报错要求配置）
 */
@@ -138,4 +156,4 @@ function matchBlacklist(relPath, rules) {
 	return null;
 }
 //#endregion
-export { findSerenityRoot as a, matchBlacklist as c, readHandymanConfig as d, readUtf8 as f, findGitRoot as i, pathInside as l, SAFE_MODE_MARKER as n, isSafeModeOn as o, resolveInside as p, classifyPath as r, loadSerenityConfig as s, DEFAULT_SERENITY_CONFIG_PATHS as t, readBlacklist as u };
+export { findSerenityRoot as a, matchBlacklist as c, readCccName as d, readHandymanConfig as f, findGitRoot as i, pathInside as l, resolveInside as m, SAFE_MODE_MARKER as n, isSafeModeOn as o, readUtf8 as p, classifyPath as r, loadSerenityConfig as s, DEFAULT_SERENITY_CONFIG_PATHS as t, readBlacklist as u };

package/lib/ccc.d.ts

@@ -22,6 +22,15 @@ export type PathClass = 'inside' | 'outside' | 'same';
 export declare function pathInside(rootAbs: string, abs: string, caseInsensitive?: boolean): boolean;
 export declare function classifyPath(p: string, root: string): PathClass;
 export declare function resolveInside(root: string, p: string): string;
+/**
+ * CCC 名：从 .serenity 标记解析——**跳过 # 注释与空行的首个非空行**。
+ * 注册表聚合档路径（.opencode/skills/<cccName>/references/mech-registry.json）以此为准，
+ * 是 guards/fs-ops/msm-ops/kit-ops 四处解析的唯一真相源（review P2-2 收口，09-05：
+ * 原四处分叉——msm-ops/kit-ops 取严格首行、guards/fs-ops 跳注释——首行为注释/空行时
+ * register 目标路径与保护路径分叉，潜在隐患）。
+ * @returns CCC 名；无标记/读失败/全注释空行 → null
+ */
+export declare function readCccName(root: string): string | null;
 export interface SerenityConfig {
     /** handyman（杂工）配置：模型白名单（v1.24.0 取代 loop） */
     handyman?: {

package/lib/client.js

@@ -4737,7 +4737,7 @@ Instruction-following style:
 				scope.set(field, on);
 			};
 			const setThreshold = (v) => {
-				scope.set("rebuildThreshold", Math.min(1, Math.max(.01, v)));
+				scope.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))));
@@ -4754,7 +4754,7 @@ Instruction-following style:
 			});
 			const gatewayOn = value?.gatewayEnabled ?? false;
 			const rebuildOn = value?.rebuildEnabled ?? true;
-			const threshold = value?.rebuildThreshold ?? .9;
+			const thresholdK = value?.rebuildThresholdK ?? 400;
 			const skiffOn = value?.skiffEnabled ?? false;
 			const skiffPort = value?.skiffDebugPort ?? 3099;
 			const acpOn = value?.acpEnabled ?? false;
@@ -4796,22 +4796,18 @@ Instruction-following style:
 							})
 						}) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 							title: "重建阈值",
-							desc: "上下文占用达到该比例时提示（0.10 ~ 1.00）",
-							help: "重建触发阈值（0.10~1.00，默认 0.90）：\n· 含义：上下文占用达到该比例时，轨迹跟踪器开始提醒重建\n· 调低：更早触发（适合长任务，避免上下文耗尽前措手不及）\n· 调高：更晚触发（适合短对话，减少不必要的重建提示）\n· 仅「超限重建」开启时有意义",
-							control: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "ss-threshold",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-									type: "range",
-									min: .1,
-									max: 1,
-									step: .05,
-									value: threshold,
-									disabled: !rebuildOn,
-									onChange: (e) => setThreshold(Number(e.target.value))
-								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: "ss-value",
-									children: threshold.toFixed(2)
-								})]
+							desc: "上下文占用达到该 K 数值时提示（单位 K token，默认 400）",
+							help: "重建触发阈值（需求①：K 数值，默认 400K，范围 50~4000K）：\n· 含义：上下文 projected tokens 达到 thresholdK × 1000 时，轨迹跟踪器开始提醒重建\n· 纯绝对数值（不再依赖窗口比例）——配多大就多大，无窗口上限保护\n· 迁移：旧版 0~1 比例（settings.yaml rebuildThreshold，如 0.9）已废弃并被忽略——\n  请按 K 数值在此重设（如 0.9 → 900）；若从未设置则默认 400K 生效\n· 调低：更早触发（适合长任务，避免上下文耗尽前措手不及）\n· 调高：更晚触发（适合短对话，减少不必要的重建提示）\n· 仅「超限重建」开启时有意义",
+							control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								className: "ss-portInput",
+								type: "number",
+								min: 50,
+								max: 4e3,
+								step: 50,
+								value: thresholdK,
+								disabled: !rebuildOn,
+								title: "重建阈值（K token，默认 400）",
+								onChange: (e) => setThreshold(Number(e.target.value))
 							})
 						}) })]
 					}),

package/lib/config-ops.d.ts

@@ -42,12 +42,6 @@ export interface GatewaySettings {
     /** 是否启用 Authenticator 第二因素（v1.22.4；false = TOTP 完全禁用——登录不要求、绑定入口隐藏） */
     totpEnabled: boolean;
 }
-/** F2 超限重建配置 */
-export interface RebuildSettings {
-    enabled: boolean;
-    /** contextPressure 触发比例（0~1） */
-    thresholdRatio: number;
-}
 /** 彩蛋功能：persona 模式（v1.23.1，S142 用户需求）
  * 配置后替换 ACC 系统提示词中"输出约束/指令遵循约束"部分（EAP 块 + MSM 原则段）；
  * 未配置（mode 空）→ 完全默认行为，零影响。 */
@@ -66,10 +60,15 @@ export interface PublicAskSettings {
     /** 开放容器白名单（CCC 目录名，如 home-serenity）；空数组 = 全部容器开放 */
     allowed: string[];
 }
-/** 高级设定全量（localstore.json 持久化形态；passHash 含 hash） */
+/**
+ * 高级设定全量（~/.dsh/serenity-hooks.json 持久化形态；passHash 含 hash）。
+ * review P2-3：**rebuild 已从高级配置删除**——rebuild 开关/阈值归"简单配置"
+ * （settings.yaml 原生面板，见 settings-section.ts），运行时只读 readSimpleSettings()；
+ * 旧高级 rebuild 字段是死双胞胎（/serenity/config PUT 回显但运行时从不读它）——
+ * 删除防误导（用户在高级面板改了却无效）。历史残留字段被 mergeWithDefaults 忽略（幂等安全）。
+ */
 export interface AdvancedSettings {
     gateway: GatewaySettings;
-    rebuild: RebuildSettings;
     persona: PersonaSettings;
     publicAsk: PublicAskSettings;
 }
@@ -131,7 +130,7 @@ export interface GatewayAccountWire {
     /** 该账号是否已绑定 TOTP（v1.22.4） */
     hasTotp: boolean;
 }
-/** 设定 wire 形态（GET /serenity/config 返回；rebuild 同持久化，gateway 去 hash） */
+/** 设定 wire 形态（GET /serenity/config 返回；gateway 去 hash） */
 export interface AdvancedSettingsWire {
     gateway: {
         enabled: boolean;
@@ -143,7 +142,6 @@ export interface AdvancedSettingsWire {
         allowWorkspaceCreate: boolean;
         totpEnabled: boolean;
     };
-    rebuild: RebuildSettings;
     persona: PersonaSettings;
     publicAsk: {
         /** 开放容器白名单（v1.26.2：容器名数组；空 = 全部开放） */

package/lib/index.d.ts

@@ -47,7 +47,7 @@ export interface Config {
     /** F2 超限重建（entry 默认值，运行时经 DSH settings） */
     rebuild?: {
         enabled?: boolean;
-        thresholdRatio?: number;
+        thresholdK?: number;
     };
     /** F4 Skiff（实验性）：调试服务启停（entry 默认值，运行时经 DSH settings） */
     skiff?: {