@shgroup/dsh-serenity-hooks 1.32.0 → 1.34.1

package/lib/seams/guards.d.ts

@@ -21,36 +21,7 @@ export interface GuardInput {
     /** 当前 agent 的 dsh 会话 id（Skiff 角色白名单判定；非 skiff 会话不判定） */
     skiffSessionId?: string;
 }
-/**
- * 凭据文件硬名单（数据面守卫，v1.26.3，S142 用户：localstore.json 需要在 read 工具的黑名单里）：
- * **任何工具**（含 read/grep/glob/container_fs 只读子命令）命中这些相对 CCC 根的路径 → deny。
- *
- * 与 safeMode.blacklist（写黑名单，v1.18.5 决策只拦写）语义独立：
- * - 黑名单 = 用户可配置的写保护（REPOSITORIES/ 等只读参考源不误伤读）
- * - 凭据硬名单 = **结构性数据面边界**（不依赖 safe-mode 开关，凭据文件任何时候不可读）——
- *   对齐 CCE Bounded Space + wardn "structural guarantee, not policy"：localstore.json
- *   含 API keys/tokens/SSH 密码，即使 prompt 纪律失败也无值可吐（机械保证）。
- */
-export declare const SENSITIVE_CREDENTIAL_FILES: Set<string>;
-/**
- * MSM 注册表写保护（需求⑤b S142 用户拍板："msm注册的文件需要写保护起来，避免CCC意外写坏搞崩自己"）：
- * mech-registry.json 是 CCC 执行层地基（坏 → loadMsmEntries 抛 → container_admin/output-guard 全崩，
- * register 也崩 → 自锁）。**写 deny、读 allow**（与 localstore 读 deny 语义区分 R6——注册表是
- * 结构核心不是秘密，需被 output-guard/skiff-admin 读取建 MSM 词表）。
- *
- * 单级化（需求⑤a）后**唯一合法注册表 = cccName 聚合档**
- * `.opencode/skills/<cccName>/references/mech-registry.json`（cccName = .serenity 首行）。
- * 历史 root 级 `mech-registry.json` 与各 skill 分散注册表已废弃：**不再保护**
- * （review P1：保护一个永不被读的文件 = 死锁——MSM 既不可见又不可删/迁移）。
- * 写工具命中聚合档 → deny（唯一合法写通道 = container_admin msm register/deregister
- * 内部 writeRegistry，走工具实现不经 pre-execute → 天然豁免）；读工具放行。
- */
-export declare function isProtectedRegistryRel(root: string, rel: string): boolean;
-/** 判定工具是否为读类（read/grep/glob + container_fs 只读子命令）：凭据文件对读工具同样 deny */
-export declare function isReadTool(toolName: string, action?: string): boolean;
-/** 判定工具是否为写类：普通工具按名；container_fs 复合工具按子命令 action */
-export declare function isWriteTool(toolName: string, action?: string): boolean;
-export interface GuardDecisionResult {
+interface GuardDecisionResult {
     deny?: string;
     kind: 'allow' | 'deny';
 }
@@ -62,7 +33,7 @@ export interface GuardDecisionResult {
  */
 export declare function decideGuard(input: GuardInput): GuardDecisionResult;
 /** restrict 诊断状态（status API 暴露；排查 restrict 未生效问题） */
-export interface RestrictDiagnostics {
+interface RestrictDiagnostics {
     lastKey: string | null;
     lastAttemptAt: string | null;
     lastSuccess: boolean | null;
@@ -75,8 +46,6 @@ export declare function getRestrictDiagnostics(): RestrictDiagnostics;
  * 标记消失 → 解除。pre-step 每步调用 → 切换实时生效。
  */
 export declare function syncSafeModeRestriction(agent: Agent, root: string): void;
-/** 条件可见的 IM 工具名（与 tools/im-bridge.ts 的注册名一致） */
-export declare const IM_BRIDGE_TOOL_NAME = "im-bridge";
 /** im-bridge 隐藏诊断（排查"工具为什么不在清单里"） */
 export declare function getImBridgeVisibilityDiagnostics(): {
     hiddenKeys: string[];
@@ -95,7 +64,25 @@ export declare function getImBridgeVisibilityDiagnostics(): {
 export declare function syncImBridgeVisibility(agent: Agent, root: string): void;
 /** 会话销毁清理（lifecycle 调用；防 per-会话 Map 无界增长——review F-08 同族） */
 export declare function forgetImBridgeVisibility(sessionId: string): void;
-export interface GuardRegistration {
+/** 专属工具隐藏诊断（排查"工具为什么不在清单里"） */
+export declare function getExclusiveToolsDiagnostics(): {
+    hidden: string[];
+};
+/**
+ * 同步专属工具可见性（v1.33）。
+ *
+ * 判据 = CCC 配置 `exclusiveTools`（`readExclusiveTools`）：
+ * - **未声明** → `agent.ctx.tools.restrict({ deny: [tool] })`：从 schema 移除（模型看不到）
+ * - **声明** → 解除隐藏（CCC 配置热更新即时生效）
+ *
+ * 判据失败按"未声明"处理（fail-closed：专属工具默认隐藏），原因见 `readExclusiveTools` 注释。
+ * 与 `syncImBridgeVisibility` 同点调用（pre-step 每步 + 会话就绪），失败不阻断一步——
+ * 最坏情况是"看得到但被拒"，而不是让 step 出错。
+ */
+export declare function syncExclusiveToolsVisibility(agent: Agent, root: string): void;
+/** 会话销毁清理（lifecycle 调用；本函数按 `${sessionId}::` 前缀回收全部专属工具项） */
+export declare function forgetExclusiveToolsVisibility(sessionId: string): void;
+interface GuardRegistration {
     /** 配置路径；缺省用 DEFAULT_SERENITY_CONFIG_PATHS */
     configPaths?: string[];
 }
@@ -104,3 +91,4 @@ export interface GuardRegistration {
  * 两者都从 CCC 根实时读取配置（无状态、无缓存）。
  */
 export declare function registerGuards(ctx: Context, opts?: GuardRegistration): void;
+export {};

package/lib/seams/keeper.d.ts

@@ -36,7 +36,7 @@ export declare function reminderText(code: string, score: number): string;
  * 简短留自由度（不提"加载 eap 工具"，模型自知；只说修订 skill + 新建 skill 落 SESSION）。
  *
  * escalated=true（v1.23.3）：连续多轮超阈值仍未 rebuild → 升级强制语气
- * （STOP and rebuild now，持续注入直到调用 logbook rebuild）。
+ * （STOP and rebuild now，持续注入直到调用 container_trajectory rebuild）。
  *
  * 需求①（S142 用户拍板）：百分比比例 → K 数值——tokensK = 实际占用（千 token），
  * thresholdK = 配置阈值（千 token）；文案 `Context usage at NNNK (threshold NNNK)`。
@@ -76,7 +76,7 @@ export declare function __resetLogbookCompactionForTest(): void;
  * 解析**活跃** SESSION.md 绝对路径（缓存 60s）。
  *
  * 候选链（刻意比 rebuild 的完整链短——这里每个工具调用都要跑，贵候选不划算）：
- * ① `getActiveSessionInfo(scope).mdPath`（`logbook use` / skiff 绑定 / 重启恢复都会写）
+ * ① `getActiveSessionInfo(scope).mdPath`（`container_trajectory use` / skiff 绑定 / 重启恢复都会写）
  * ② `readLastBound(session).mdPath`（`.bindings.json` 权威绑定——重启后内存空时兜底）
  * 两者都拿不到 → null（**不猜**：宁可不提醒，也不去猜别的轨迹——对齐 v1.30.13 D4 的教训）。
  */
@@ -98,13 +98,13 @@ export declare function readSessionMdMaxKB(root: string, configPaths?: string[],
  * ③ 允许整合不重要事项（被取代的决策 / 已解决问题 / 中间态）
  * ④ 自主裁量权充分允许（唯一硬要求 = 骨架 + 未决项/决策理由/下一步仍可重建）
  */
-export declare function logbookCompactionReminderText(input: {
+export declare function trajectoryCompactionReminderText(input: {
     sizeKB: number;
     limitKB: number;
     mdPath: string;
     escalated?: boolean;
 }): string;
-export interface KeeperRegistration {
+interface KeeperRegistration {
     /** 缺省阈值（serenity.json sessionKeeper.threshold 优先，其次此值） */
     defaultThreshold?: number;
     /** CCC 配置相对路径 */

package/lib/seams/system-prompt.d.ts

@@ -25,11 +25,6 @@
  */
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { Context } from 'cordis';
-/** 读取 persona 彩蛋配置（plugin 全局；未配置 → mode='' 彩蛋关闭） */
-export declare function readPersonaSettings(): {
-    mode: string;
-    overrideText: string;
-};
 /** 1) 身份块：ACC 身份 + CCC 名 + 平台工具说明（需求③ S142：工具清单移出为独立 toolsBlock 放装配末尾——身份先行、工具参考殿后） */
 export declare function identityBlock(root: string): string;
 /**
@@ -130,3 +125,4 @@ export declare function codeModeAdaptationLine(ctx: Context, scope?: unknown): s
  */
 export declare function registerEntrySkillSectionGlobal(ctx: Context): void;
 export declare function registerEntrySkillSection(agent: Agent, root: string): boolean;
+export declare function registerTrajectorySkillSection(agent: Agent, root: string): boolean;

package/lib/session-cleanup.d.ts

@@ -19,7 +19,7 @@
 /** DSH 会话 root：env DSH_HOME → ~/.dsh（config-ops globalConfigPath 同款推导） */
 export declare function sessionsRootDir(): string;
 /** 一个候选会话（删除前预览信息） */
-export interface CandidateSession {
+interface CandidateSession {
     /** 会话 id（目录名） */
     id: string;
     /** 项目目录（父目录名，如 --home-yh-home-home-serenity--） */
@@ -55,7 +55,7 @@ export declare function sessionLogArtifacts(sessionDirPath: string): Array<{
  */
 export declare function findSessionLog(sessionDirPath: string): string | null;
 /** 删除执行结果 */
-export interface CleanupResult {
+interface CleanupResult {
     deleted: string[];
     /** 尝试删除但失败的会话目录（权限/竞态） */
     errors: Array<{
@@ -75,3 +75,4 @@ export declare function performCleanup(root: string, cutoffMs: number, liveIds?:
 };
 /** 便捷：默认 N 天前为 cutoff（供 API/调用方） */
 export declare function cutoffDaysAgo(days: number, nowMs?: number): number;
+export {};

package/lib/{settings-section-Bm-xG-NR.js → settings-section-DTYZjwUs.js}

@@ -1,14 +1,70 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as hostSettings } from "./access-fiehjxV6.js";
 import z from "@deepseek-ai/schemastery";
+//#region src/ports.ts
+/**
+* 集中端口表。
+* A=宿主主面（插件不监听）/ B=网关（可配，默认关）/ C=微信发送（默认开，仅 loopback）
+* / D=Skiff 调试（默认关）/ E=ACP+问答（默认关）。
+*/
+const FACE_PORTS = {
+	main: {
+		port: 3080,
+		host: null,
+		defaultEnabled: true,
+		meaning: "宿主 DSH 主 WebUI + 插件 /serenity/* 路由面（**插件不起此 listener**，端口自宿主读）"
+	},
+	gateway: {
+		port: 3081,
+		host: "0.0.0.0",
+		defaultEnabled: false,
+		meaning: "双端口网关（外部登录 + 全量反代宿主主面；host/port 走 plugin 全局配置）"
+	},
+	weixinSend: {
+		port: 3082,
+		host: "127.0.0.1",
+		defaultEnabled: true,
+		meaning: "微信主动发送面（容器外进程 → POST /send；与 3080 显式解耦，不经网关）"
+	},
+	skiffDebug: {
+		port: 3099,
+		host: "127.0.0.1",
+		defaultEnabled: false,
+		meaning: "Skiff 调试问答面（人工调试子角色；无认证，仅靠 loopback）"
+	},
+	acpHttp: {
+		port: 3100,
+		host: "127.0.0.1",
+		defaultEnabled: false,
+		meaning: "ACP JSON-RPC + 对外问答面（外部程序 + key 认证的问答页共用一 listener）"
+	}
+};
+/** 宿主主 WebUI 端口（面 A：插件**不监听**，只读取；`readWebPort` 的回退值） */
+const MAIN_WEB_PORT = FACE_PORTS.main.port;
+/** 网关端口默认值（面 B） */
+const GATEWAY_PORT = FACE_PORTS.gateway.port;
+/** 微信主动发送端口默认值（面 C） */
+const WEIXIN_SEND_PORT = FACE_PORTS.weixinSend.port;
+/** Skiff 调试页端口默认值（面 D） */
+const SKIFF_DEBUG_PORT = FACE_PORTS.skiffDebug.port;
+/** ACP / 对外问答端口默认值（面 E） */
+const ACP_HTTP_PORT = FACE_PORTS.acpHttp.port;
+/**
+* **机制端口**词表（output-guard 用：agent 在**用户可见输出**里提及内部端口即打回）。
+*
+* 由 {@link FACE_PORTS} 机械派生 ⇒ 与面清单**永不漂移**。
+* ⚠️ 修复记录（C4 块 B，2026-09-15）：旧常量硬写 `['3080','3081','3099','3100']`
+* ——**漏 3082**（微信发送面，默认开）⇒ 守卫拦不住"3082"这类提及。现由表派生，五面齐全。
+*/
+const MECHANISM_PORTS = Object.keys(FACE_PORTS).map((id) => String(FACE_PORTS[id].port));
+//#endregion
 //#region src/settings-section.ts
 var settings_section_exports = /* @__PURE__ */ __exportAll({
 	SERENITY_SETTINGS_NS: () => SERENITY_SETTINGS_NS,
 	defaultSimpleSettings: () => defaultSimpleSettings,
 	entryDefaults: () => entryDefaults,
 	readSimpleSettings: () => readSimpleSettings,
-	registerSettingsSection: () => registerSettingsSection,
-	simpleSettingsSchema: () => simpleSettingsSchema
+	registerSettingsSection: () => registerSettingsSection
 });
 /** 简单配置命名空间（dsh 设置面板的 section id / settings.yaml section） */
 const SERENITY_SETTINGS_NS = "serenity-hooks";
@@ -18,12 +74,13 @@ const simpleSettingsSchema = z.object({
 	rebuildEnabled: z.boolean().default(true),
 	rebuildThresholdK: z.number().min(50).max(4e3).default(400),
 	skiffEnabled: z.boolean().default(false),
-	skiffDebugPort: z.number().min(1024).max(65535).default(3099),
+	skiffDebugPort: z.number().min(1024).max(65535).default(SKIFF_DEBUG_PORT),
 	acpEnabled: z.boolean().default(false),
-	acpHttpPort: z.number().min(1024).max(65535).default(3100),
+	acpHttpPort: z.number().min(1024).max(65535).default(ACP_HTTP_PORT),
 	publicAskEnabled: z.boolean().default(false),
-	autopilotEnabled: z.boolean().default(false),
-	trajectoryEnabled: z.boolean().default(false)
+	autopilotWakeEnabled: z.boolean().required(false),
+	autopilotEnabled: z.boolean().required(false),
+	wakeSchedulerEnabled: z.boolean().default(true)
 });
 /** 从插件 Config 提取 entry 默认（settings base 层） */
 function entryDefaults(config) {
@@ -32,12 +89,11 @@ function entryDefaults(config) {
 		rebuildEnabled: config.rebuild?.enabled ?? true,
 		rebuildThresholdK: config.rebuild?.thresholdK ?? 400,
 		skiffEnabled: config.skiff?.enabled ?? false,
-		skiffDebugPort: config.skiff?.debugPort ?? 3099,
+		skiffDebugPort: config.skiff?.debugPort ?? SKIFF_DEBUG_PORT,
 		acpEnabled: config.acp?.enabled ?? false,
-		acpHttpPort: config.acp?.httpPort ?? 3100,
+		acpHttpPort: config.acp?.httpPort ?? ACP_HTTP_PORT,
 		publicAskEnabled: config.publicAsk?.enabled ?? false,
-		autopilotEnabled: false,
-		trajectoryEnabled: false
+		wakeSchedulerEnabled: true
 	};
 }
 /** 运行时源（installSettingsSection 注入：settings scope 或 entry fallback） */
@@ -51,12 +107,11 @@ function defaultSimpleSettings() {
 		rebuildEnabled: true,
 		rebuildThresholdK: 400,
 		skiffEnabled: false,
-		skiffDebugPort: 3099,
+		skiffDebugPort: SKIFF_DEBUG_PORT,
 		acpEnabled: false,
-		acpHttpPort: 3100,
+		acpHttpPort: ACP_HTTP_PORT,
 		publicAskEnabled: false,
-		autopilotEnabled: false,
-		trajectoryEnabled: false
+		wakeSchedulerEnabled: true
 	};
 }
 /**
@@ -98,4 +153,4 @@ function registerSettingsSection(ctx, config) {
 	hooks.onChange();
 }
 //#endregion
-export { registerSettingsSection as n, settings_section_exports as r, readSimpleSettings as t };
+export { FACE_PORTS as a, MECHANISM_PORTS as c, ACP_HTTP_PORT as i, SKIFF_DEBUG_PORT as l, registerSettingsSection as n, GATEWAY_PORT as o, settings_section_exports as r, MAIN_WEB_PORT as s, readSimpleSettings as t, WEIXIN_SEND_PORT as u };

package/lib/settings-section.d.ts

@@ -16,9 +16,8 @@
  * 则显示降级提示（引导去宁静号面板），在则渲染 schema 表单。零配置自动适配。
  */
 import type { Context } from 'cordis';
-import z from '@deepseek-ai/schemastery';
 /** 插件 Config 的简单配置片段（index.ts Config 组合；settings entry base） */
-export interface SimpleConfigFragment {
+interface SimpleConfigFragment {
     gateway?: {
         enabled?: boolean;
     };
@@ -47,7 +46,7 @@ export declare const SERENITY_SETTINGS_NS = "serenity-hooks";
  * 简单配置 schema（schemastery）：三功能总开关 + F2 阈值 + F4 Skiff 启停。
  * 与 DSH settings 的 schema 语义一致（z.object 布尔/数字）。
  */
-export interface SerenitySimpleSettings {
+interface SerenitySimpleSettings {
     /** F1 双端口网关总开关 */
     gatewayEnabled: boolean;
     /** F2 超限重建总开关 */
@@ -64,41 +63,20 @@ export interface SerenitySimpleSettings {
     acpHttpPort: number;
     /** F4d 建议问答页总开关（实验性；默认关——按认知容器暴露问答页，key 认证） */
     publicAskEnabled: boolean;
-    /** Autopilot Trajectory 全局总开关（v1.27.9，默认关——只在指定电脑开启；
-     *  关了即使 CCC 配置 enabled=true 也不启动定时器；CCC 级 enabled 仍为必要条件） */
-    autopilotEnabled: boolean;
-    /** trajectory 全局总开关（D58/M-1，S142 2026-09-13）：**autopilot 与唤醒调度器共用**。
-     *  读取顺序：`trajectoryEnabled` → 旧键 `autopilotEnabled`（逐级回退，不回写）。 */
-    trajectoryEnabled: boolean;
+    /** **周期自唤醒（autopilot）全局闸** —— v1.34 更名收窄（原 `autopilotEnabled`）。
+     *  **只管周期自唤醒**：关掉它**不**影响一次性唤醒 `container_trajectory wake-later`（后者归 {@link wakeSchedulerEnabled}）。
+     *  缺省关（多台电脑装 dsp 时只在指定电脑跑周期自唤醒）。
+     *  可选类型是为了**迁移语义精确**：老装机里存的旧键 `autopilotEnabled` 仍应生效，而"新键显式 false"必须能覆盖它。 */
+    autopilotWakeEnabled?: boolean;
+    /** @deprecated v1.34 前的旧键（**仅迁移期回退读**，不回写）。新装/已迁移请用 `autopilotWakeEnabled` */
+    autopilotEnabled?: boolean;
+    /** **唤醒调度器全局闸** —— v1.34 更名（原 `trajectoryEnabled`）：投递已登记的"未来时刻 + 一条 message"。
+     *  **缺省开**：它是 trajectory 的基础能力（D58），且**不得**被"关掉周期自唤醒"连带关掉
+     *  ——用户 2026-09-15 裁决：「auto-trajectory 的开关只关闭 auto-trajectory 唤醒」。 */
+    wakeSchedulerEnabled: boolean;
 }
-/** schemastery schema（与 DSH 各插件 Config 同款） */
-export declare const simpleSettingsSchema: z<Schemastery.ObjectS<{
-    gatewayEnabled: z<boolean, boolean>;
-    rebuildEnabled: z<boolean, boolean>;
-    rebuildThresholdK: z<number, number>;
-    skiffEnabled: z<boolean, boolean>;
-    skiffDebugPort: z<number, number>;
-    acpEnabled: z<boolean, boolean>;
-    acpHttpPort: z<number, number>;
-    publicAskEnabled: z<boolean, boolean>;
-    autopilotEnabled: z<boolean, boolean>;
-    trajectoryEnabled: z<boolean, boolean>;
-}>, Schemastery.ObjectT<{
-    gatewayEnabled: z<boolean, boolean>;
-    rebuildEnabled: z<boolean, boolean>;
-    rebuildThresholdK: z<number, number>;
-    skiffEnabled: z<boolean, boolean>;
-    skiffDebugPort: z<number, number>;
-    acpEnabled: z<boolean, boolean>;
-    acpHttpPort: z<number, number>;
-    publicAskEnabled: z<boolean, boolean>;
-    autopilotEnabled: z<boolean, boolean>;
-    trajectoryEnabled: z<boolean, boolean>;
-}>>;
 /** 从插件 Config 提取 entry 默认（settings base 层） */
 export declare function entryDefaults(config: SimpleConfigFragment): SerenitySimpleSettings;
-/** 测试辅助：重置"缺 settings provider"告警去重（生产零调用） */
-export declare function __resetSettingsWarningsForTest(): void;
 /** 进程级默认（无 settings 服务时的兜底） */
 export declare function defaultSimpleSettings(): SerenitySimpleSettings;
 /**
@@ -120,3 +98,4 @@ export declare function __setSimpleSourceForTest(source: (() => SerenitySimpleSe
  * （owner = consumer 插件 ctx；ns 直接字符串）。
  */
 export declare function registerSettingsSection(ctx: Context, config: SimpleConfigFragment): void;
+export {};

package/lib/skiff-core.d.ts

@@ -31,7 +31,7 @@ export declare function skiffSessionSnapshot(): ReadonlyMap<string, {
  * 系统提示词中的**工作台纪律块**（v1.30.4 升级：从单行路径 → 完整 ACC 层约束）。
  * 用户点破（S142）：只给路径 LLM 不会主动用——需注入「已绑定 + 使用纪律 + 动作指引」。
  * SESSION = 工作台——skiff 与主舱同一套机制（零特调，用户拍板）：
- * 自动绑定已生效（无需 logbook use）、SESSION.md 是持久记忆载体、rebuild 自动从本 SESSION 续接。
+ * 自动绑定已生效（无需 container_trajectory use）、SESSION.md 是持久记忆载体、rebuild 自动从本 SESSION 续接。
  * 注入 agent 系统提示词（用户对话面不可见）。
  *
  * v1.30.13（S142 诊断 D5）：写入纪律**不点名具体工具**。旧文案写死 "with write/edit"，
@@ -81,13 +81,7 @@ export declare function ensureWorkspacePromptSection(agent: Agent, scope: string
  * @returns 绑定后的 SESSION.md 绝对路径（供提示词注入）；不适用/失败 → null
  */
 export declare function ensureSkiffSession(root: string, agent: Agent, roleName: string, role: SkiffRoleConfig, persistent?: boolean): string | null;
-/** 当前 scope 是否已激活（幂等判定：getActiveSessionInfo 命中同 dirName）——测试用 */
-export declare function skiffSessionActiveFor(sessionId: string): {
-    sessionId: string;
-    dirName: string;
-    mdPath: string;
-} | null;
-export interface SkiffAgentRef {
+interface SkiffAgentRef {
     handle: AgentHandle;
     agent: Agent;
     sessionId: string;
@@ -114,7 +108,7 @@ export interface SkiffTrajectoryEntry {
     /** assistant 的工具调用名（有则填） */
     tool?: string;
 }
-export interface SkiffAskResult {
+interface SkiffAskResult {
     answer: string;
     sessionId: string;
     trajectory: SkiffTrajectoryEntry[];
@@ -135,7 +129,7 @@ export declare function askSkiff(ctx: Context, agent: Agent, question: string, e
  * 注册表缺失（进程重启遗留等）→ 保守旁路（false，完全独立）。
  */
 export declare function skiffTrajectoryEnabled(root: string, sessionId: string | undefined, key: 'session' | 'keeper' | 'rebuild'): boolean;
-export interface SkiffMsmGate {
+interface SkiffMsmGate {
     /** 拒绝原因（有则拒绝执行） */
     reject?: string;
     /** list 显示白名单（msms）；仅 action==='list' 时有值 */
@@ -147,3 +141,4 @@ export interface SkiffMsmGate {
  * list 白名单过滤、check/guide/ccc-config 只读放行。
  */
 export declare function skiffMsmGate(root: string, sessionId: string | undefined, action: string, name?: string): SkiffMsmGate;
+export {};

package/lib/skiff-debug.d.ts

@@ -18,30 +18,19 @@
  * 实验性质：未开启时零资源占用（无监听、无 agent 创建）。
  */
 import type { Context } from 'cordis';
-import { type SkiffTrajectoryEntry } from './skiff-core.js';
+import { type CccEntry } from './ccc-roots.js';
+import { type FaceSpec } from './face-host.js';
 export declare function skiffDebugActive(): boolean;
 export declare function skiffDebugPort(): number | null;
-/** 候选 CCC 条目（调试页 CCC 切换器数据） */
-export interface SkiffCccEntry {
-    /** CCC 根（绝对路径） */
-    root: string;
-    /** 目录名（展示用） */
-    name: string;
-    /** 该 CCC 的 skiff 角色名列表（实时读取） */
-    roles: string[];
-}
 /**
- * 发现候选 CCC 列表（多 CCC 手工切换，v1.25.6）：
- * ① **dsh 工作区注册表**（workspaceRegistry.list，持久化——所有工作目录即使无 live 会话；
- *    S142 用户 2026-08-29：应直接拉 dsh 工作区，且只列具体 CCC）
- * ② **sessionPersistence 兜底**（持久化会话 headers——必装配服务，覆盖所有历史会话工作目录；
- *    用户实测 workspaceRegistry 拉取仍空时兜底）
- * ③ live 会话兜底
- * ④ 默认绑定 root 兜底（不在列表时放首位）
+ * 候选 CCC 条目（调试页 CCC 切换器数据）。
+ *
+ * C2：定义已迁至 `ccc-roots.ts`（L2 枚举的唯一真相源）——此处只在**类型层**转出
+ * （零运行时重导出，避免把 `ccc-roots` 拉进本模块的运行时静态链）。
  */
-export declare function discoverCccs(ctx: Context, defaultRoot: string): Promise<SkiffCccEntry[]>;
+export type { CccEntry };
 /** 问答页 HTML：CCC 切换器 + 角色下拉 + 输入 + 答案区 + 轨迹区（JS 渲染）+ WebUI 链接 */
-export declare function skiffDebugPage(cccs: SkiffCccEntry[], defaultRoot: string, webPort: number): string;
+export declare function skiffDebugPage(cccs: CccEntry[], defaultRoot: string, webPort: number): string;
 /**
  * JSC (Safari/iOS) JSON.parse 快速路径正则兼容化（v1.26.9，S142 调研定稿）。
  *
@@ -76,6 +65,11 @@ export declare function renderSkiffMarkdown(raw: string, hideThink?: boolean): s
  * 未闭合 think 优雅截断。适用于纯文本输出面（微信等不支持 think 折叠的通道）。
  */
 export declare function stripThink(raw: string): string;
+/**
+ * 本面的规格（C4 块 A/④：**只提供** name/port/host/enabled/handler）。
+ * 路由/鉴权/HTML 全部仍归本模块的 {@link handle}（面宿主不介入面语义）。
+ */
+export declare function skiffDebugSpec(ctx: Context, root: string, port: number, webPort: number): FaceSpec;
 /**
  * 启动调试问答服务（单实例；重复启动幂等返回既有实例）。
  *
@@ -83,11 +77,11 @@ export declare function stripThink(raw: string): string;
  * 解析：live 会话中**含 skiff.roles 的 CCC 优先**）；v1.25.4 起页面可**手工切换**到
  * 其它候选 CCC（live 会话发现的全部 CCC）；角色配置**每次请求实时读取**（不缓存快照）。
  *
+ * C4 块 A：listener 的创建/监听/错误/端口占用/关闭归 `face-host`（本函数只提供规格 + 记日志）。
+ *
  * @param root 默认绑定的 CCC 根（首次加载选中；角色配置读取 + skiff agent cwd）
  * @param port 调试端口（仅 127.0.0.1）
  * @param webPort 主 WebUI 端口（WebUI 链接）
  */
 export declare function startSkiffDebugServer(ctx: Context, root: string, port: number, webPort: number): Promise<void>;
 export declare function stopSkiffDebugServer(): void;
-/** 导出类型引用（测试断言轨迹结构） */
-export type { SkiffTrajectoryEntry };

package/lib/skiff-registry-FTjoWQTQ.js

@@ -0,0 +1,25 @@
+//#region src/skiff-registry.ts
+const skiffSessions = /* @__PURE__ */ new Map();
+/** 查 sessionId 的 Skiff 角色名（无 → null）——向后兼容（guards/seams 依赖） */
+function skiffRoleFor(sessionId) {
+	return skiffSessions.get(sessionId)?.role ?? null;
+}
+/** 查 sessionId 的完整绑定（role + ccc；无 → null）——v1.25.10 会话追问校验 */
+function skiffSessionInfo(sessionId) {
+	return skiffSessions.get(sessionId) ?? null;
+}
+function registerSkiffSession(sessionId, role, ccc) {
+	skiffSessions.set(sessionId, {
+		role,
+		ccc
+	});
+}
+function unregisterSkiffSession(sessionId) {
+	skiffSessions.delete(sessionId);
+}
+/** 测试/调试：注册表快照（sessionId → {role, ccc}） */
+function skiffSessionSnapshot() {
+	return new Map(skiffSessions);
+}
+//#endregion
+export { unregisterSkiffSession as a, skiffSessionSnapshot as i, skiffRoleFor as n, skiffSessionInfo as r, registerSkiffSession as t };

package/lib/skiff-registry.d.ts

@@ -11,7 +11,7 @@
  * 生命周期：进程内存态；连接/页面关闭时 unregister；进程重启自然清空（skiff 会话不复存在）。
  */
 /** 注册表值：会话绑定的角色 + CCC 根（追问延续校验用） */
-export interface SkiffSessionBinding {
+interface SkiffSessionBinding {
     role: string;
     ccc: string;
 }
@@ -23,3 +23,4 @@ export declare function registerSkiffSession(sessionId: string, role: string, cc
 export declare function unregisterSkiffSession(sessionId: string): void;
 /** 测试/调试：注册表快照（sessionId → {role, ccc}） */
 export declare function skiffSessionSnapshot(): ReadonlyMap<string, SkiffSessionBinding>;
+export {};

package/lib/{skiff-role-BYvNnwv1.js → skiff-role-CEHL5cek.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { m as resolveInside, p as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DAsSHsub.js";
+import { h as resolveInside, m as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-NlLr_sxy.js";
 import { existsSync, statSync } from "node:fs";
 //#region src/skiff-role.ts
 /**

package/lib/skiff-role.d.ts

@@ -20,7 +20,7 @@ export declare function isSkiffSessionId(sessionId: string | undefined): boolean
  */
 export declare function readSkiffRoles(root: string, paths?: string[]): Map<string, SkiffRoleConfig>;
 /** 某角色的轨迹纪律子集（缺省全 false = 完全独立） */
-export interface SkiffTrajectorySubset {
+interface SkiffTrajectorySubset {
     session: boolean;
     keeper: boolean;
     rebuild: boolean;
@@ -49,7 +49,7 @@ export declare function systemPromptSource(role: SkiffRoleConfig | undefined): '
  * - 缺省 = 隐式推断：调用方给出**稳定 sessionId** → persistent；否则 temporary
  *   （存量配置零迁移；微信桥传固定会话 id → persistent，ACP/调试页随机 id → temporary）
  */
-export type SkiffKind = 'temporary' | 'persistent';
+type SkiffKind = 'temporary' | 'persistent';
 export declare function resolveSkiffKind(role: SkiffRoleConfig | undefined, hasStableId: boolean): SkiffKind;
 /**
  * 角色提示词**读取器**（v1.30.15，方案 A：长期型热更新）。

package/lib/skills/opencode-scan.d.ts

@@ -4,12 +4,12 @@
  * 兼容 opencode 的 skill 标准：`.opencode/skills/<name>/SKILL.md`
  * （frontmatter: name/description/whenToUse；结构含 references/、scripts/）。
  */
-export interface OpencodeSkillMeta {
+interface OpencodeSkillMeta {
     name: string;
     description: string;
     whenToUse?: string;
 }
-export interface OpencodeSkill {
+interface OpencodeSkill {
     name: string;
     dir: string;
     meta: OpencodeSkillMeta;
@@ -25,3 +25,4 @@ export declare function parseFrontmatter(raw: string): {
 export declare function listOpencodeSkillDirs(root: string): string[];
 /** 加载一个 opencode skill（frontmatter 解析 + 正文）；读失败（EPERM/占用等）返回 null，单目录容错 */
 export declare function loadOpencodeSkill(skillDir: string): OpencodeSkill | null;
+export {};

package/lib/skills-discovery.d.ts

@@ -12,14 +12,27 @@
  *
  * 任何 CCC 都能自动注入其顶层入口 skill 全文（不硬编码名字）。
  */
-export type EntrySkillSource = 'serenity-marker' | 'pointer' | 'opencode' | 'dsh';
-export interface EntrySkill {
+type EntrySkillSource = 'serenity-marker' | 'pointer' | 'opencode' | 'dsh';
+interface EntrySkill {
     name: string;
     content: string;
     source: EntrySkillSource;
 }
+/**
+ * 防穿越：skill 名必须是简单目录名（拒绝分隔符与 `..`/`.` 路径段）。
+ * v1.34.1：导出——轨迹 skill 声明（CCC 数据）的名字也要**先过这一关**才能用于拼路径
+ * （规格 `docs/trajectory-skill-injection.md` §3「名字安全（必做）」）。
+ */
+export declare function isSafeSkillName(name: string): boolean;
+/**
+ * 按名在两个 skills 根下定位 SKILL.md（`.dsh/skills` 优先，其次 `.opencode/skills`）。
+ * v1.34.1：导出——轨迹 skill 注入复用本函数（不新造发现逻辑）；不安全名在此**先行拒绝**
+ * （返回 null，且不发生任何以该名拼出的 fs 访问）。
+ */
+export declare function findSkillMd(root: string, name: string): string | null;
 /** 发现全部入口技能（原文全量，不截断） */
 export declare function findEntrySkills(root: string): EntrySkill[];
 /** 兼容旧接口：第一个入口（或 null） */
 export declare function findEntrySkill(root: string): EntrySkill | null;
 export declare function truncateContent(content: string, maxChars: number): string;
+export {};

package/lib/status.d.ts

@@ -10,7 +10,7 @@
  * 依次尝试 npm_config_prefix / APPDATA\npm / ~/.npm-global。
  */
 export declare function readDshVersion(): string | null;
-export interface SerenityStatus {
+interface SerenityStatus {
     root: string | null;
     accVersion: string;
     dshVersion: string | null;
@@ -36,3 +36,4 @@ export declare function getStatus(cwd: string, configPaths?: string[]): Serenity
 export declare function setSafeMode(root: string, on: boolean): {
     on: boolean;
 };
+export {};

package/lib/tools/acc-diag.d.ts

@@ -0,0 +1,22 @@
+/**
+ * acc-diag.ts（工具面）— ACC 负责人专用的运行态诊断（v1.33，S142 §32.11）
+ *
+ * 用户裁决（2026-09-14）：「不要 diag-live 了；或者变成一个隐藏 tool **只对 home-serenity 可见**，
+ * 做成我们专属的运行时诊断工具」。⇒ 合并原 `diag`（脚本侧条件链）+ `diag-live`（进程内运行态），
+ * 一次调用出全报告，并**从 CCC 工具面默认移除**。
+ *
+ * 可见性不在本文件判定（与 im-bridge 同一套机制）：`seams/guards.ts`
+ * `syncExclusiveToolsVisibility` 在会话就绪 / pre-step 时按 CCC 配置
+ * `exclusiveTools` 决定是否 `agent.ctx.tools.restrict({ deny: ['acc-diag'] })`——
+ * **未声明的 CCC 看不到它**（不是"看得到但被拒"）。
+ *
+ * 为什么必须是独立工具而不是 `container_admin` 的一个域（§32.11 ②）：
+ * `tools.restrict` 是**工具级** deny，没有域级粒度——放进 container_admin 就等于
+ * 要隐藏它必须连 role/msm/config 一起隐藏。
+ */
+import type { Context } from 'cordis';
+/**
+ * 运行态诊断工具（`acc-diag`）。**无动作参数**：一次调用即全报告
+ * （live 运行态 / 面板解析 / 唤醒注册表 / 唤起条件链）。
+ */
+export declare function createAccDiagTool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;