@shgroup/dsh-serenity-hooks 1.34.0 → 1.34.1

package/README.md

@@ -275,6 +275,7 @@ DSH 一个进程可以同时带多个工作区，每个工作区各自对接自
 - **多个工作区各自独立**：每个工作区自己的间隔/会话/焦点/窗口，互不干扰
 - **有审计**：每次唤醒都记一笔，面板里能看到最近几次；失败会指数退避重试
 - **还能预约未来某一刻**：用 `container_trajectory wake-later` 登记一条"唤醒"= 未来某时刻 + 一条消息——可以给自己预约，也可以唤醒别的轨迹；落在工作区内的 `AGENT_SESSIONS/wake-registry.json`（可读可审计），到点由中心调度器投递，不阻塞、不等待、也不回执
+- **轨迹可以自带 skill**：在它的 `SESSION.md` 顶部 frontmatter 写 `skills: [名字, …]`，这条轨迹**被绑定期间**的每个请求都会注入这些 skill 的全文（适合把某个领域的做事方法直接挂在轨迹上）；skill 名来自工作区数据，**先过安全校验才会用于拼路径**，找不到会在提示里明说"缺失"而**不静默跳过**
 - 没有"每天最多唤醒几次"的限制——频率只由间隔和窗口决定
 
 ### 6.6 安全模型

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.34.0",
+  "version": "1.34.1",
   "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/acp-core.d.ts

@@ -17,14 +17,7 @@
  * 未启用时本模块零副作用（无监听、无 agent）。
  */
 import type { Context } from 'cordis';
-import type { SessionId } from '@deepseek-ai/dsh-session';
-export interface JsonRpcRequest {
-    jsonrpc: '2.0';
-    id?: string | number;
-    method: string;
-    params?: Record<string, unknown>;
-}
-export interface JsonRpcResponse {
+interface JsonRpcResponse {
     jsonrpc: '2.0';
     id: string | number | null;
     result?: unknown;
@@ -34,11 +27,6 @@ export interface JsonRpcResponse {
         data?: unknown;
     };
 }
-export interface JsonRpcNotification {
-    jsonrpc: '2.0';
-    method: string;
-    params?: Record<string, unknown>;
-}
 /** JSON-RPC 错误码（对齐标准） */
 export declare const RPC_ERROR: {
     readonly PARSE: -32700;
@@ -47,13 +35,6 @@ export declare const RPC_ERROR: {
     readonly INVALID_PARAMS: -32602;
     readonly INTERNAL: -32603;
 };
-export interface AcpSessionHandle {
-    sessionId: string;
-    role: string;
-    ccc: string;
-    /** 会话是否可复用（进程内延续） */
-    continued: boolean;
-}
 /**
  * ACP 会话管理器：持有 skiff agent 会话（与 skiff-core 注册表同源——
  * 创建走 createSkiffAgent（自动注册），关闭走 unregisterSkiffSession）。
@@ -96,5 +77,4 @@ export declare class RpcInvalidParams extends Error {
  * @returns 响应帧数组（请求有响应；通知无；解析失败 → 单错误响应）
  */
 export declare function dispatchRpc(server: AcpServer, frame: unknown): Promise<JsonRpcResponse[]>;
-/** 断言 SessionId 类型（ACP 会话 id 即 skiff sessionId） */
-export type { SessionId };
+export {};

package/lib/acp-http.d.ts

@@ -17,10 +17,18 @@
  * 实验性质：未开启时零资源占用（无监听、无 agent 创建）。
  */
 import type { Context } from 'cordis';
+import { type FaceSpec } from './face-host.js';
 export declare function acpHttpActive(): boolean;
 export declare function acpHttpPort(): number | null;
+/**
+ * 本面的规格（C4 块 A/④：**只提供** name/port/host/enabled/handler）。
+ * 两个子面（ACP JSON-RPC / 对外问答页）的路由与鉴权仍全部归 {@link handle}——
+ * 面宿主不介入面语义，也**不合并** D/E 两面（两者共用会话核心但各有独立 listener/路由/HTML）。
+ */
+export declare function acpHttpSpec(ctx: Context, port: number, defaultRoot?: string): FaceSpec;
 /**
  * 启动 ACP HTTP JSON-RPC + 建议问答页服务（单实例；重复启动幂等返回既有实例）。
+ * C4 块 A：listener 的创建/监听/错误/端口占用/关闭归 `face-host`。
  * @param ctx 插件上下文（AcpServer 内部经 skiff-core 创建 agent）
  * @param port 监听端口（仅 127.0.0.1）
  * @param defaultRoot 默认 CCC 根（问答页候选发现兜底；resolveSkiffRoot 传入）

package/lib/api.d.ts

@@ -10,13 +10,11 @@
  * 经 ctx.webServer（webserver 服务，公开版由 httpServer 改名）注册；客户端与服务器同源，调用无信任围栏问题。
  */
 import type { Context } from 'cordis';
+import type { IncomingMessage } from 'node:http';
 /** 图片落盘目录（CCC 根相对；S142 图片自动识别基础设施——粘贴图片落盘供 agent 经 CCC vlm MSM 自主处理） */
 export declare const IMAGE_UPLOAD_DIR = "_tmp/images_from_user";
-export declare const IMAGE_MEDIA_TYPES: Set<string>;
 /** 文件落盘目录（CCC 根相对；v1.24.1 粘贴任意文件自动落盘——agent 经 CCC 既有 MSM（pdf-extract/archive-extract 等）自主处理） */
 export declare const FILE_UPLOAD_DIR = "_tmp/files_from_user";
-/** 拒绝的可执行/危险扩展名（安全边界：不落盘可执行文件，防 agent 被诱导执行） */
-export declare const BLOCKED_FILE_EXTS: Set<string>;
 /**
  * 图片落盘核心逻辑（可测）：校验 mediaType 白名单 + base64 解码 + 大小上限 →
  * 写 CCC 根 _tmp/images_from_user/<ts>-<rand>.<ext>，返回相对路径。
@@ -34,7 +32,16 @@ export declare function sanitizeFileName(name: string): string;
  * 校验失败抛 Error（handler 转 400）。
  */
 export declare function saveFileToTmp(root: string, fileName: string, data: string): string;
-export interface StatusApiRegistration {
+/**
+ * WebUI 专属动作的来源判别（C4 块 C：此前 **9 处内联** `req.headers['x-serenity-ui'] !== '1'`）。
+ *
+ * ⚠️ 语义边界（勿误读为认证）：这是**客户端判别头**——任何本机能发 HTTP 的进程都可自带它
+ * （无密钥、无签名、不校验来源，见现状取证 §② 面 A "认证与守卫"）。它区分的是
+ * "WebUI 触发的动作"与"agent/curl 触发的动作"（如 safe-mode 不可由 agent 自行开关）。
+ * 本 helper 只做**同一判据的归一**，不放宽也不收紧：判据、状态码、文案均由调用方给出。
+ */
+export declare function senderIsWebUi(req: IncomingMessage): boolean;
+interface StatusApiRegistration {
     configPaths?: string[];
 }
 /**
@@ -45,3 +52,4 @@ export interface StatusApiRegistration {
  */
 export declare function resolveWorkspaceCore(sessionCwd: string | undefined, workspaceParam: string | undefined, listCwds: () => string[], fallback: string): string;
 export declare function registerStatusApi(ctx: Context, opts?: StatusApiRegistration): void;
+export {};

package/lib/autopilot-chain.d.ts

@@ -0,0 +1,76 @@
+/**
+ * autopilot-chain.ts — **唤起条件链的唯一实现**（"为什么这轮没被唤起"）
+ *
+ * 为什么单独成模块（R↓，⑥ C6a 的硬约束）：
+ * C6 裁决把 autopilot 拆两半——**入口**分两处（CCC 工具面 / 开发面），但**判据只能有一份**。
+ * 若开发面另写"文件读取版"，刚消掉的分歧会在开发面复活。故：
+ *   · `acc-diag` ④ 段（进程内，带运行态事实）—— `./diag-ops.ts` 调 {@link buildWakeChain}
+ *   · 开发面 `dsh-develop diag [--ccc <path>]`（离线 bun 进程，无运行态事实）—— **import 同一实现**
+ * 两者的差别**只是传入的 facts**（进程内三项已知 / 离线三项不可知），判据本身不复制。
+ *
+ * 本模块**零 DSH 依赖**（只 node:fs/path + `ccc.js` + `autopilot-core.js`）——离线 bun 进程
+ * 才 import 得动。判据一律取自 {@link judgeWake}（判据唯一真相源），本模块只做**分解与分类**。
+ *
+ * 判决语义（§12.7 修复，**不得回退**）：
+ *   `✗` = 配置/环境问题（需人改，如 enabled=false / session 未命中 / agent 未加载）
+ *   `⏸` = 等待中（到点/出窗口/上一轮跑完自会满足——**非**配置问题）
+ *   `?` = 不可知（离线通道看不到的运行态；**不**当成满足）
+ *   **只有 `✗` 与 `⏸` 都为空、且无 `?` 时才印 ✅**——旧实现只统计 `✗` ⇒ 每天北京 8~18 点
+ *   （10 小时）都印「✅ 唤起条件全部满足」而插件实际不唤起（假阳性，已实测复现）。
+ */
+/**
+ * 条件链的**运行态事实**（只有插件进程知道的那部分；离线通道传 null = 不可知）。
+ * 由 `autopilot-trajectory.ts` 的 `autopilotRuntimeFacts(ctx, root)` 产出。
+ */
+export interface WakeChainFacts {
+    /** 周期自唤醒全局闸（`autopilotGloballyEnabled()`）；null = 不可知（离线通道） */
+    globalGate: boolean | null;
+    /** 该 CCC 是否已有唤起轮在进行中（重入守卫）；null = 不可知 */
+    running: boolean | null;
+    /** live 运行态；null = 不可知（离线通道） */
+    live: {
+        /** 该 CCC 的 live 会话数 */
+        sessionCount: number;
+        /** 目标 agent 能否解析；null = 不适用（目标会话未命中，已由 session 条件判 ✗） */
+        agentResolved: boolean | null;
+        /** agent 不可解析时的诊断文本（`diagnoseTargetUnavailable`） */
+        diagnosis: string | null;
+    } | null;
+}
+/** 离线通道事实（三项运行态全不可知） */
+export declare const NO_RUNTIME_FACTS: WakeChainFacts;
+/** 判决档（`ready` 只有在**没有** unknowns 时才可能给出——离线通道永远不会印 ✅） */
+export type WakeChainVerdict = 'ready' | 'waiting' | 'blocked' | 'unknown';
+export interface WakeChainReport {
+    root: string;
+    /** 逐条件行（人读；行首 = ✓/✗/⏸/?/·） */
+    lines: string[];
+    /** `✗` 行（配置/环境问题，需人改） */
+    blockers: string[];
+    /** `⏸` 行（等待中） */
+    waiting: string[];
+    /** `?` 行（不可知——不当作满足） */
+    unknowns: string[];
+    /** 修复建议（仅在存在阻断点时输出） */
+    suggestions: string[];
+    verdict: WakeChainVerdict;
+    /** 判决行原文 */
+    judgement: string;
+}
+/** 运行偏见脚本的注入点（测试可替换；生产 = `fetchBiasContent`——插件 tick 的同一执行路径） */
+export type BiasProbe = (root: string, providerRel: string) => Promise<{
+    text: string | null;
+    error: string | null;
+}>;
+/**
+ * 组装条件链（**唯一实现**）。
+ *
+ * @param root CCC 根
+ * @param facts 运行态事实（离线通道传 {@link NO_RUNTIME_FACTS}）
+ * @param now 当前时刻（测试注入）
+ * @param biasProbe 偏见执行（默认 {@link fetchBiasContent}——**不另写 spawn**）
+ * @returns 结构化报告（渲染见 {@link renderWakeChain}）
+ */
+export declare function buildWakeChain(root: string, facts?: WakeChainFacts, now?: number, biasProbe?: BiasProbe): Promise<WakeChainReport>;
+/** 条件链渲染（④ 段文本；`renderAccDiag` 与开发面 `diag` 共用） */
+export declare function renderWakeChain(r: WakeChainReport): string;

package/lib/autopilot-core-DCRkiWEe.js

@@ -0,0 +1,229 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { h as resolveInside, s as loadSerenityConfig } from "./ccc-NlLr_sxy.js";
+import { m as sessionsRoot, o as findSession } from "./trajectory-ops-mrXK0H0I.js";
+import { basename, dirname, join } from "node:path";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+//#region src/autopilot-core.ts
+/**
+* autopilot-core.ts — autopilot **纯判据层**（零 DSH 依赖，可独立单测、可被开发面脚本 import）
+*
+* 为什么单独成模块（R↓，S142 §12.13 ⑥ C6a）：
+* C6 裁决把 autopilot 拆两半——**机制那半**（配置读写 / 状态报告 / 偏见执行 / 唤起判据）
+* 进插件进程，**排障那半**（完整条件链）留开发面。但两侧**必须用同一份判据**——若各自
+* 实现一遍，"为什么这轮没唤起"的报告就会与实际唤起行为分歧（这正是旧
+* `experiments/autopilot-trajectory/scripts/autopilot-trajectory.ts` 的病：它只能读文件，
+* 看不到 live 会话 / 全局闸 / agent 可解析性 ⇒ 8 项结构性分歧）。
+*
+* ⇒ 本模块承载**判据原语**（读配置 / 目标定位 / 间隔+窗口判决 / 偏见脚本执行），
+* 由三个消费方共用，**没有任何一方自算**：
+*   · tick 与面板 —— `autopilot-trajectory.ts`（`shouldWake` / `getAutopilotStatus`）
+*   · CCC 工具面   —— `autopilot-ops.ts`（`container_admin autopilot status|init|generate-bias`）
+*   · 条件链报告   —— `autopilot-chain.ts`（`acc-diag` ④ 段 + 开发面 `dsh-develop diag`）
+*
+* 本模块**零 DSH 依赖**（只 node:fs/path/child_process + `ccc.ts` + `trajectory-ops.ts`）
+* ——这是刻意的：开发面 `dsh-develop diag` 是独立 bun 进程，import 不了 cordis/DSH 面。
+*/
+var autopilot_core_exports = /* @__PURE__ */ __exportAll({
+	AUTO_DIR_SUFFIX: () => AUTO_DIR_SUFFIX,
+	DEFAULT_AVOID_HOURS: () => DEFAULT_AVOID_HOURS,
+	DEFAULT_BIAS_PROVIDER: () => DEFAULT_BIAS_PROVIDER,
+	LEGACY_BIAS_PROVIDER: () => LEGACY_BIAS_PROVIDER,
+	MIN_INTERVAL_HOURS: () => MIN_INTERVAL_HOURS,
+	MOTIVATION_MARKER: () => MOTIVATION_MARKER,
+	TICK_MINUTES: () => 5,
+	TICK_MS: () => TICK_MS,
+	beijingHour: () => beijingHour,
+	biasProviderAbsPath: () => biasProviderAbsPath,
+	fetchBiasContent: () => fetchBiasContent,
+	inAllowedWakeWindow: () => inAllowedWakeWindow,
+	isAutopilotSession: () => isAutopilotSession,
+	judgeWake: () => judgeWake,
+	readAutopilotSettings: () => readAutopilotSettings,
+	readSelfGeneratedMotivation: () => readSelfGeneratedMotivation,
+	readUtf8: () => readUtf8,
+	resolveTargetMd: () => resolveTargetMd,
+	shouldWake: () => shouldWake
+});
+/** 偏见内容提供者脚本缺省名（CCC 根目录下；正式版 autopilot-bias.ts） */
+const DEFAULT_BIAS_PROVIDER = "autopilot-bias.ts";
+/** 旧默认偏见脚本名（autotrajectory 时代；未显式配置时回退——pangu 等已配置 CCC 零迁移） */
+const LEGACY_BIAS_PROVIDER = "autotrajectory-bias.ts";
+/** 自主轨迹会话目录后缀标志（--auto 保留——简短且历史会话 S060--auto 已存在） */
+const AUTO_DIR_SUFFIX = "--auto";
+/** 调度 tick 周期（5min——用户"tick改为5分钟吧"；0.01h 间隔下每 5min 评估一次） */
+const TICK_MS = 3e5;
+/** 间隔下限（支持小数——用户"让它支持小数行吗，这样可以配0.01"；0.01h ≈ 36s） */
+const MIN_INTERVAL_HOURS = .01;
+/** SESSION.md 内「下一轮动机」段标记（自生偏见载体——轨迹预设自己的未来） */
+const MOTIVATION_MARKER = "下一轮动机";
+/** 缺省避开的高峰时段（北京时间 [start, end) 不唤起——用量峰谷省钱） */
+const DEFAULT_AVOID_HOURS = {
+	start: 8,
+	end: 18
+};
+/** 偏见脚本输出上限（沙箱：截断防失控——正式版 v1.27.4） */
+const BIAS_OUTPUT_MAX = 8192;
+/** 偏见脚本执行超时（正式版沙箱；原 600s 过长阻塞 tick） */
+const BIAS_RUN_TIMEOUT_MS = 6e4;
+/** 读配置：`trajectory.autopilot`（D58 新键）优先 → 旧键 autopilotTrajectory → 旧键 autotrajectory */
+function readAutopilotSettings(root) {
+	const cfg = loadSerenityConfig(root);
+	return cfg.trajectory?.autopilot ?? cfg.autopilotTrajectory ?? cfg.autotrajectory ?? null;
+}
+/**
+* 北京时间（UTC+8）当前小时——不依赖服务器时区（服务器可能 UTC/本地任意）。
+*/
+function beijingHour(nowMs) {
+	return Math.floor((nowMs + 288e5) % 864e5 / 36e5);
+}
+/**
+* 唤起窗口判定：北京时间 [avoidStart, avoidEnd) 内不唤起（缺省 8~18）。
+* 单段避开（start<=end）：窗口 = [0,start) ∪ [end,24)；跨零点避开（start>end）：窗口 = [end,start)。
+*/
+function inAllowedWakeWindow(nowMs, avoid) {
+	const start = avoid?.start ?? DEFAULT_AVOID_HOURS.start;
+	const end = avoid?.end ?? DEFAULT_AVOID_HOURS.end;
+	const h = beijingHour(nowMs);
+	if (start <= end) return h < start || h >= end;
+	return h >= end && h < start;
+}
+/** 标志位判定：SESSION.md 所在目录名以 --auto 结尾 → 自主轨迹形态 */
+function isAutopilotSession(mdPath) {
+	return basename(dirname(mdPath)).endsWith(AUTO_DIR_SUFFIX);
+}
+/**
+* 目标会话定位：**必须配置 cfg.session**（S###/目录名）——CCC 日常有多条 trajectory 在跑，
+* 绝不默认唤起（缺省最近活跃会误伤其他正在运行的轨迹；用户拍板：必须配置才生效）。
+* 未配置 session 或未命中 → null（不唤起）。
+*/
+function resolveTargetMd(root, cfg) {
+	if (!cfg?.session) return null;
+	const found = findSession(sessionsRoot(root), cfg.session);
+	if (!found) return null;
+	const md = join(found.path, "SESSION.md");
+	return existsSync(md) ? md : null;
+}
+/**
+* **唤起判据唯一真相源**（间隔 + 窗口）：`shouldWake`（tick / 面板）、`autopilot-ops`
+* （status/check）、`autopilot-chain`（条件链）三处共用本函数——**没有任何一方自算**。
+*
+* 为什么必须共用（v1.34.1 事故留档）：旧实现在同一个脚本里存在**两份判断**——
+* `status()` 算 `intervalOk && windowOk` 而条件链的判决行只统计 `✗` 开头项，把 `⏸`
+* （间隔未到 / 高峰避开）排除在阻断之外 ⇒ **每天北京 8~18 点（10 小时）都印
+* 「✅ 唤起条件全部满足」而插件实际不唤起**（假阳性，已实测复现）。合成一处后不可能再分叉。
+*
+* 间隔下限取 `MIN_INTERVAL_HOURS`（=0.01，与 tick 同源）。旧脚本取 `1`（`SCRIPT_MIN_INTERVAL_HOURS`）
+* ——那会让配置 `intervalHours < 1` 的 CCC 在报告里**假阴性**（报"未到"而插件已唤起）；
+* 该分歧随独立脚本退场一并消失（报告与真实唤起行为同源，正是本轮的目标）。
+*/
+function judgeWake(settings, mdPath, now = Date.now()) {
+	const interval = Math.max(MIN_INTERVAL_HOURS, settings?.intervalHours ?? 12);
+	let idleHours = null;
+	if (mdPath) try {
+		idleHours = (now - statSync(mdPath).mtimeMs) / 36e5;
+	} catch {
+		idleHours = null;
+	}
+	const intervalOk = idleHours !== null && idleHours >= interval;
+	const windowOk = inAllowedWakeWindow(now, settings?.avoidWakeHours);
+	return {
+		interval,
+		idleHours,
+		intervalOk,
+		windowOk,
+		wakeable: intervalOk && windowOk
+	};
+}
+/**
+* 唤起条件（纯逻辑，可测）：enabled + 未在运行 + 目录标志 + mtime 超间隔 + 窗口允许。
+* v1.27.12：移除每日唤起预算上限（用户"把这个上限删了吧，没意义"——高频实验不受限）。
+*
+* 判据来源全部来自本模块（`judgeWake` / `isAutopilotSession`）——本函数只做**组合**，
+* 不重复实现时间/窗口计算。
+*/
+function shouldWake(settings, mdPath, nowMs, running, _history = []) {
+	if (!settings?.enabled || running) return false;
+	if (!mdPath || !isAutopilotSession(mdPath)) return false;
+	return judgeWake(settings, mdPath, nowMs).wakeable;
+}
+/** 自生动机读取：SESSION.md「下一轮动机」段内容（到下一个二级标题或文件尾；无 → null） */
+function readSelfGeneratedMotivation(mdPath) {
+	try {
+		const content = readFileSync(mdPath, "utf-8");
+		const idx = content.indexOf(MOTIVATION_MARKER);
+		if (idx < 0) return null;
+		const rest = content.slice(idx + 5);
+		const nextHeading = rest.search(/\n## /);
+		return (nextHeading >= 0 ? rest.slice(0, nextHeading) : rest).trim() || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* 偏见内容：直接运行 CCC 根目录下偏见提供者脚本（biasProvider，缺省 autopilot-bias.ts；
+* 未显式配置且新默认缺失 → 回退旧默认 autotrajectory-bias.ts——pangu 兼容）→ stdout。
+* 脚本缺失 → 返回 { text: null, error: 提示实现 }（唤起侧报错要求实现，不静默跳过）。
+* 路径逃逸校验（resolveInside）；bun 优先，node 兜底；**60s 超时 + 8KB 输出截断（沙箱）**。
+*
+* 唯一执行点（不另写 spawn）：tick 的唤起路径（`performAutopilotWake`）、`container_admin
+* autopilot generate-bias`、条件链的偏见就绪探测**三处都调本函数**（§12.13：`random` → 复用
+* 插件 tick 里既有的偏见执行代码）。旧脚本另有一套 spawn 且**参数不同**（600s 超时、无 8KB
+* 截断、无旧默认名回退）⇒ 那是"bias 运行参数"与"仅存旧名 bias 脚本时报假阴性"两项分歧的由来。
+*/
+async function fetchBiasContent(root, providerRel) {
+	let scriptAbs;
+	try {
+		scriptAbs = resolveInside(root, providerRel);
+	} catch {
+		return {
+			text: null,
+			error: `biasProvider 路径逃逸（须在 CCC 根内）: ${providerRel}`
+		};
+	}
+	if (!existsSync(scriptAbs) && providerRel === "autopilot-bias.ts") {
+		const legacy = resolveInside(root, LEGACY_BIAS_PROVIDER);
+		if (existsSync(legacy)) scriptAbs = legacy;
+	}
+	if (!existsSync(scriptAbs)) return {
+		text: null,
+		error: `请在 CCC 根目录实现偏见内容提供者脚本: ${providerRel}（或旧默认 ${LEGACY_BIAS_PROVIDER}；stdout 输出偏见内容一行；container_admin autopilot init 可生成模板）`
+	};
+	const runs = [["bun", [scriptAbs]], [process.execPath, [scriptAbs]]];
+	for (const [cmd, args] of runs) try {
+		const r = spawnSync(cmd, args, {
+			encoding: "utf-8",
+			timeout: BIAS_RUN_TIMEOUT_MS,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		if (r.status === 0) return {
+			text: (r.stdout ?? "").trim().slice(0, BIAS_OUTPUT_MAX) || null,
+			error: null
+		};
+		if (r.error?.code === "ENOENT") continue;
+		return {
+			text: null,
+			error: `偏见内容提供者脚本执行失败（exit ${r.status ?? "?"}）: ${r.stderr?.trim() || r.stdout?.trim() || ""}`
+		};
+	} catch {
+		continue;
+	}
+	return {
+		text: null,
+		error: "偏见内容提供者脚本无法运行（bun 与 node 均不可用）"
+	};
+}
+/** 偏见提供者脚本绝对路径（根内强制——逃逸拒绝）；供文件写入侧（init 生成模板）使用 */
+function biasProviderAbsPath(root, providerRel) {
+	return resolveInside(root, providerRel);
+}
+/** 读 UTF-8（去 BOM）——init 写配置前的读回 */
+function readUtf8(p) {
+	return readFileSync(p, "utf-8").replace(/^\uFEFF/, "");
+}
+//#endregion
+export { shouldWake as _, TICK_MS as a, biasProviderAbsPath as c, isAutopilotSession as d, judgeWake as f, resolveTargetMd as g, readUtf8 as h, MIN_INTERVAL_HOURS as i, fetchBiasContent as l, readSelfGeneratedMotivation as m, DEFAULT_AVOID_HOURS as n, autopilot_core_exports as o, readAutopilotSettings as p, DEFAULT_BIAS_PROVIDER as r, beijingHour as s, AUTO_DIR_SUFFIX as t, inAllowedWakeWindow as u };

package/lib/autopilot-core.d.ts

@@ -0,0 +1,132 @@
+/**
+ * autopilot-core.ts — autopilot **纯判据层**（零 DSH 依赖，可独立单测、可被开发面脚本 import）
+ *
+ * 为什么单独成模块（R↓，S142 §12.13 ⑥ C6a）：
+ * C6 裁决把 autopilot 拆两半——**机制那半**（配置读写 / 状态报告 / 偏见执行 / 唤起判据）
+ * 进插件进程，**排障那半**（完整条件链）留开发面。但两侧**必须用同一份判据**——若各自
+ * 实现一遍，"为什么这轮没唤起"的报告就会与实际唤起行为分歧（这正是旧
+ * `experiments/autopilot-trajectory/scripts/autopilot-trajectory.ts` 的病：它只能读文件，
+ * 看不到 live 会话 / 全局闸 / agent 可解析性 ⇒ 8 项结构性分歧）。
+ *
+ * ⇒ 本模块承载**判据原语**（读配置 / 目标定位 / 间隔+窗口判决 / 偏见脚本执行），
+ * 由三个消费方共用，**没有任何一方自算**：
+ *   · tick 与面板 —— `autopilot-trajectory.ts`（`shouldWake` / `getAutopilotStatus`）
+ *   · CCC 工具面   —— `autopilot-ops.ts`（`container_admin autopilot status|init|generate-bias`）
+ *   · 条件链报告   —— `autopilot-chain.ts`（`acc-diag` ④ 段 + 开发面 `dsh-develop diag`）
+ *
+ * 本模块**零 DSH 依赖**（只 node:fs/path/child_process + `ccc.ts` + `trajectory-ops.ts`）
+ * ——这是刻意的：开发面 `dsh-develop diag` 是独立 bun 进程，import 不了 cordis/DSH 面。
+ */
+import { type AutopilotTrajectorySettings } from './ccc.js';
+/** 偏见内容提供者脚本缺省名（CCC 根目录下；正式版 autopilot-bias.ts） */
+export declare const DEFAULT_BIAS_PROVIDER = "autopilot-bias.ts";
+/** 旧默认偏见脚本名（autotrajectory 时代；未显式配置时回退——pangu 等已配置 CCC 零迁移） */
+export declare const LEGACY_BIAS_PROVIDER = "autotrajectory-bias.ts";
+/** 自主轨迹会话目录后缀标志（--auto 保留——简短且历史会话 S060--auto 已存在） */
+export declare const AUTO_DIR_SUFFIX = "--auto";
+/** 调度 tick 周期（5min——用户"tick改为5分钟吧"；0.01h 间隔下每 5min 评估一次） */
+export declare const TICK_MS: number;
+/**
+ * tick 周期（分钟）——**报告文案的唯一来源**：此前脚本文案写死 `10min`，与插件 `TICK_MS`
+ * （5min）不符，用户看到"等下个 10min tick"而实际 5min（§12.7 文案纠错）。由 `TICK_MS` 派生。
+ */
+export declare const TICK_MINUTES: number;
+/** 间隔下限（支持小数——用户"让它支持小数行吗，这样可以配0.01"；0.01h ≈ 36s） */
+export declare const MIN_INTERVAL_HOURS = 0.01;
+/** SESSION.md 内「下一轮动机」段标记（自生偏见载体——轨迹预设自己的未来） */
+export declare const MOTIVATION_MARKER = "\u4E0B\u4E00\u8F6E\u52A8\u673A";
+/** 缺省避开的高峰时段（北京时间 [start, end) 不唤起——用量峰谷省钱） */
+export declare const DEFAULT_AVOID_HOURS: {
+    start: number;
+    end: number;
+};
+/** 读配置：`trajectory.autopilot`（D58 新键）优先 → 旧键 autopilotTrajectory → 旧键 autotrajectory */
+export declare function readAutopilotSettings(root: string): AutopilotTrajectorySettings | null;
+/**
+ * 北京时间（UTC+8）当前小时——不依赖服务器时区（服务器可能 UTC/本地任意）。
+ */
+export declare function beijingHour(nowMs: number): number;
+/**
+ * 唤起窗口判定：北京时间 [avoidStart, avoidEnd) 内不唤起（缺省 8~18）。
+ * 单段避开（start<=end）：窗口 = [0,start) ∪ [end,24)；跨零点避开（start>end）：窗口 = [end,start)。
+ */
+export declare function inAllowedWakeWindow(nowMs: number, avoid?: {
+    start?: number;
+    end?: number;
+}): boolean;
+/** 标志位判定：SESSION.md 所在目录名以 --auto 结尾 → 自主轨迹形态 */
+export declare function isAutopilotSession(mdPath: string): boolean;
+/**
+ * 目标会话定位：**必须配置 cfg.session**（S###/目录名）——CCC 日常有多条 trajectory 在跑，
+ * 绝不默认唤起（缺省最近活跃会误伤其他正在运行的轨迹；用户拍板：必须配置才生效）。
+ * 未配置 session 或未命中 → null（不唤起）。
+ */
+export declare function resolveTargetMd(root: string, cfg: AutopilotTrajectorySettings): string | null;
+/** 两次唤起之间的"等待"判据结果（`judgeWake` 返回值） */
+export interface WakeJudge {
+    /** 生效的间隔阈值（小时；下限 `MIN_INTERVAL_HOURS`） */
+    interval: number;
+    /** 距上次轨迹活动（小时）；目标会话不存在/不可 stat 时为 null */
+    idleHours: number | null;
+    /** 间隔条件是否满足 */
+    intervalOk: boolean;
+    /** 是否在允许唤起的窗口内 */
+    windowOk: boolean;
+    /** 两条件同时满足（"此刻到点了"） */
+    wakeable: boolean;
+}
+/**
+ * **唤起判据唯一真相源**（间隔 + 窗口）：`shouldWake`（tick / 面板）、`autopilot-ops`
+ * （status/check）、`autopilot-chain`（条件链）三处共用本函数——**没有任何一方自算**。
+ *
+ * 为什么必须共用（v1.34.1 事故留档）：旧实现在同一个脚本里存在**两份判断**——
+ * `status()` 算 `intervalOk && windowOk` 而条件链的判决行只统计 `✗` 开头项，把 `⏸`
+ * （间隔未到 / 高峰避开）排除在阻断之外 ⇒ **每天北京 8~18 点（10 小时）都印
+ * 「✅ 唤起条件全部满足」而插件实际不唤起**（假阳性，已实测复现）。合成一处后不可能再分叉。
+ *
+ * 间隔下限取 `MIN_INTERVAL_HOURS`（=0.01，与 tick 同源）。旧脚本取 `1`（`SCRIPT_MIN_INTERVAL_HOURS`）
+ * ——那会让配置 `intervalHours < 1` 的 CCC 在报告里**假阴性**（报"未到"而插件已唤起）；
+ * 该分歧随独立脚本退场一并消失（报告与真实唤起行为同源，正是本轮的目标）。
+ */
+export declare function judgeWake(settings: {
+    intervalHours?: number;
+    avoidWakeHours?: {
+        start?: number;
+        end?: number;
+    };
+} | null, mdPath: string | null, now?: number): WakeJudge;
+/** 审计记录（每 CCC ring buffer——正式版 v1.27.4：可回看、可分析） */
+export interface WakeRecord {
+    time: number;
+    ok: boolean;
+    detail: string;
+}
+/**
+ * 唤起条件（纯逻辑，可测）：enabled + 未在运行 + 目录标志 + mtime 超间隔 + 窗口允许。
+ * v1.27.12：移除每日唤起预算上限（用户"把这个上限删了吧，没意义"——高频实验不受限）。
+ *
+ * 判据来源全部来自本模块（`judgeWake` / `isAutopilotSession`）——本函数只做**组合**，
+ * 不重复实现时间/窗口计算。
+ */
+export declare function shouldWake(settings: AutopilotTrajectorySettings, mdPath: string | null, nowMs: number, running: boolean, _history?: readonly WakeRecord[]): boolean;
+/** 自生动机读取：SESSION.md「下一轮动机」段内容（到下一个二级标题或文件尾；无 → null） */
+export declare function readSelfGeneratedMotivation(mdPath: string): string | null;
+/**
+ * 偏见内容：直接运行 CCC 根目录下偏见提供者脚本（biasProvider，缺省 autopilot-bias.ts；
+ * 未显式配置且新默认缺失 → 回退旧默认 autotrajectory-bias.ts——pangu 兼容）→ stdout。
+ * 脚本缺失 → 返回 { text: null, error: 提示实现 }（唤起侧报错要求实现，不静默跳过）。
+ * 路径逃逸校验（resolveInside）；bun 优先，node 兜底；**60s 超时 + 8KB 输出截断（沙箱）**。
+ *
+ * 唯一执行点（不另写 spawn）：tick 的唤起路径（`performAutopilotWake`）、`container_admin
+ * autopilot generate-bias`、条件链的偏见就绪探测**三处都调本函数**（§12.13：`random` → 复用
+ * 插件 tick 里既有的偏见执行代码）。旧脚本另有一套 spawn 且**参数不同**（600s 超时、无 8KB
+ * 截断、无旧默认名回退）⇒ 那是"bias 运行参数"与"仅存旧名 bias 脚本时报假阴性"两项分歧的由来。
+ */
+export declare function fetchBiasContent(root: string, providerRel: string): Promise<{
+    text: string | null;
+    error: string | null;
+}>;
+/** 偏见提供者脚本绝对路径（根内强制——逃逸拒绝）；供文件写入侧（init 生成模板）使用 */
+export declare function biasProviderAbsPath(root: string, providerRel: string): string;
+/** 读 UTF-8（去 BOM）——init 写配置前的读回 */
+export declare function readUtf8(p: string): string;

package/lib/autopilot-ops.d.ts

@@ -0,0 +1,48 @@
+/**
+ * autopilot-ops.ts — `container_admin autopilot` 三动作的**进程内实现**（⑥ C6a 块 A）
+ *
+ * 为什么搬到进程内（R↓，S142 §12.8 裁决「拆两半、退掉独立脚本」）：
+ * 三个动作（`status` / `init` / `generate-bias`）的逻辑原先**全在**独立脚本
+ * `experiments/autopilot-trajectory/scripts/autopilot-trajectory.ts` 里，插件只 spawn 转发。
+ * 该脚本是独立进程 ⇒ **只能读文件** ⇒ 看不到全局闸 / live 会话 / agent 可解析性 ⇒
+ * 它印出的"状态"与插件实际行为**结构性分歧**（8 项，见现状稿 §4.4；含"闸关着也印 ✅"
+ * 这种用户可见的假报告）。搬进进程内后，`status`/`check` 读的就是
+ * {@link autopilotRuntimeFacts}——**与 tick 同一份判据**。
+ *
+ * 三个动作（对外名字与语义不变）：
+ *   · `status`        —— 一站式全报告：背景 + 就绪检查（条件链）+ 进程态 + 状态快照 + 下一步 + 指引
+ *   · `init`          —— 写/迁移 CCC 配置 `trajectory.autopilot`（**迁移后删旧键**）+ 生成偏见脚本模板
+ *   · `generate-bias` —— 运行偏见提供者脚本，输出本轮偏见内容（**复用 tick 的 `fetchBiasContent`**）
+ *
+ * 边界（**不碰 tick**）：本模块只做"报告 / 配置 / 跑偏见"，**不参与**真正的唤起决策——
+ * 唤起决策仍在 `autopilot-trajectory.ts` 的 tick（D59 单例语义、串行链、per-CCC 重入守卫未动）。
+ */
+import type { Context } from 'cordis';
+import { type WakeChainReport } from './autopilot-chain.js';
+/** 一次动作的结果（`container_admin` 直接透出；`error` 非空即失败，不静默） */
+export interface AutopilotActionResult {
+    action: 'status' | 'init' | 'generate-bias';
+    output: string;
+    error?: string;
+}
+/** 就绪检查（= 旧脚本 `check`）：条件链的逐条件报告 + 判决（判据单一真相源 = `buildWakeChain`） */
+export declare function autopilotCheck(root: string, ctx?: Context): Promise<WakeChainReport>;
+/**
+ * `status` —— 一站式全报告（背景 + 就绪检查 + 进程态 + 状态 + 下一步 + 指引）。
+ * 由进程内数据组装（旧实现是 `bun` 子进程跑脚本，故看不到任何运行态）。
+ */
+export declare function autopilotStatus(root: string, ctx?: Context): Promise<AutopilotActionResult>;
+/**
+ * `init` —— 写/迁移 CCC 配置 + 生成偏见脚本模板。
+ *
+ * 迁移语义（沿用旧脚本，理由写在码内）：写入**新键** `trajectory.autopilot`（D58）；
+ * 旧键 `autopilotTrajectory` / `autotrajectory` 存在则**迁移并删除**——保留两处会形成
+ * "改了不生效"的双真相源（读侧新键优先，旧键是死数据）。
+ */
+export declare function autopilotInit(root: string): AutopilotActionResult;
+/**
+ * `generate-bias` —— 运行偏见提供者脚本并打印本轮内容（验证用）。
+ * **复用 tick 的 {@link fetchBiasContent}**（同一份执行代码：60s 超时 / 8KB 截断 /
+ * 旧默认名回退）——不另写 spawn（§12.13）。
+ */
+export declare function autopilotGenerateBias(root: string): Promise<AutopilotActionResult>;