@shgroup/dsh-serenity-hooks 1.26.10 → 1.26.12

package/README.md

@@ -1,8 +1,8 @@
 # @shgroup/dsh-serenity-hooks
 
-宁静号 ACC（Abstract Cognitive Container）harness — **DeepSeek Harness 原生 Cordis 插件**。
+宁静号 ACC（Abstract Cognitive Container）harness — **DeepSeek Harness 原生 Cordis 插件**（npm 发布单元，v1.26.11）。
 
-为 DSH 会话提供认知容器基础设施：真实 DSH 工具（9 个）+ 拦截缝机械约束（safe-mode / 路径守卫 / 会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块，对齐 opencode-serenity-plugin）+ WebUI 状态徽章。
+为 DSH 会话提供认知容器基础设施：真实 DSH 工具（12 个）+ 拦截缝机械约束（safe-mode / 路径守卫 / 凭据守卫 / 输出守卫）+ 系统提示词注入（8 块，对齐 opencode-serenity-plugin）+ WebUI 状态胶囊 + 外部访问（双端口网关 / Skiff 问答 / ACP+建议问答页）。
 
 ## 安装
 
@@ -12,29 +12,34 @@ dsh plugin --profile web add @shgroup/dsh-serenity-hooks
 
 安装后重启 dsh web。在带 `.serenity` 标记的 CCC 目录中的会话自动获得全部能力。
 
-## 工具
+## 工具（12）
 
-`cc_fs` / `session` / `acc_kit` / `cc_git` / `acc_msm` / `eap` / `neat` / `cce` / `handyman`
+`cc_fs` / `session` / `acc_kit` / `cc_git` / `acc_msm` / `eap` / `neat` / `cce` / `handyman` / `session_rebuild` / `localstore` / `skiff_admin`
 
-## 系统提示词
+## 系统提示词（8 块）
 
-五块注入（`systemPrompt.section`，order -50）：`=== Serenity ACC ===` / `=== Serenity CCE ===` / `=== Serenity Constraints ===` / 顶层入口 skill 全文（按 `.serenity` 记号发现）/ `=== Serenity Session ===` —— 平台无关文本与 [opencode-serenity-plugin](https://github.com/tellmewhattodo/opencode-serenity-plugin) 逐字节对齐；同一 CCC 可任意换用 osp / dsh 运行时。
+`systemPrompt.section`（order -50）：`=== Serenity ACC ===`（身份+工具清单）/ `=== Serenity Metaphor ===`（世界模型三层隐喻）/ `=== Serenity Principles ===`（认知容器本体论 + MSM 原则）/ `=== Serenity CCE ===`（5 行为约束）/ `=== Serenity EAP ===`（E↑R↓S↑ 自检）/ 状态块（Safe Mode / Localstore）/ 顶层入口 skill 全文（按 `.serenity` 记号发现）/ `=== Serenity Session ===`（活跃会话 + Trajectory Steward 预声明）—— 平台无关文本与 [opencode-serenity-plugin](https://github.com/tellmewhattodo/opencode-serenity-plugin) 逐字节对齐；同一 CCC 可任意换用 osp / dsh 运行时。
 
 ## 配置
 
-`.dsh/serenity.json`（回退 `.opencode/serenity.json`）：
+`.opencode/serenity.json`（CCC 级）：
 
 ```jsonc
 {
   "handyman": { "models": ["provider/model"], "defaultModel": "provider/model" },
   "sessionKeeper": { "threshold": 100 },
-  "safeMode": { "blacklist": [".secrets/", "regex:\\.env$"] }
+  "safeMode": { "blacklist": [".secrets/", "regex:\\.env$"] },
+  "skiff": { "roles": { "qa": { "msms": [], "tools": [], "systemPrompt": "" } } }
 }
 ```
 
+plugin 级配置（账号/开关/阈值）在 DSH 设置面板 + `~/.dsh/serenity-hooks.json`（0600）。
+
 ## 文档
 
-完整文档见仓库 [README](https://github.com/tellmewhattodo/dsh-serenity-plugin)。
+- 完整文档：仓库 [README](https://github.com/tellmewhattodo/dsh-serenity-plugin)（能力为主）
+- 理论叙述：`docs/cognitive-container-theory.md`
+- 设计决策与架构：`CHANGELOG.md` + 维护 skill（`dsh-serenity-plugin-development`）
 
 ## 许可
 

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.26.10",
+  "version": "1.26.12",
   "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/experiments/autotrajectory/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: autotrajectory-experiment
+description: 自主轨迹实验（Self-Sustaining Trajectory Experiment）参与 skill。本 skill 让 CCC 完整理解实验的背景（人类 waiting 是 trajectory 速度瓶颈）、目的（验证"无人等待的 trajectory"能否加速认知推进）、方式（时钟唤起 + 先验偏见 + 前台运行），并提供一站式实验管理 MSM（autotrajectory-exp：无参全报告 / init 初始化 / random 验证偏见内容）。任何希望参与实验的 CCC 复制本目录到 .opencode/skills/ 即可开始。
+---
+
+# Skill: autotrajectory-experiment
+
+> 本 skill 是自主轨迹实验的 **CCC 参与入口**——加载本 skill 即完整理解实验的**背景、目的、方式**。
+> 实验管理：`acc_msm exec autotrajectory-exp <doc|check|status|guide>`
+> 理论依据：serenity-acc-specs `docs/self-sustaining-trajectory-hypothesis.md`（v0.1 猜想）
+
+## 触发条件/何时加载
+
+- CCC 被选为自主轨迹实验对象时（用户指定）
+- 需要理解"无人等待的 trajectory"实验的背景/目的/参与方式时
+- 需要预检/查看实验配置时
+
+---
+
+## 1. 背景：为什么有这个实验
+
+认知容器理论（specs §0）确立：**Trajectory 是主体**（Agent 可替换、Session 载体可重建、LLM 是认知介质）；认知容器 = 发生/存储/再发生的地方。
+
+由此观察到**结构性瓶颈**：
+
+> **人类 waiting 拖慢 trajectory**：当轨迹以"等待人类"为推进条件时，其事件序列时间被人类响应间隔（钟表时间）锚定。等待人类 = 轨迹空转——人类响应越慢，轨迹运转越慢。
+
+**猜想**：设计"无人等待"的 trajectory——不依赖人类输入而自动唤起，唤起时携带先验偏见（自主动机）。若成立，轨迹运转速度提升，更快产生让人类满意的效果。
+
+## 2. 实验目的（验证什么）
+
+| 命题 | 内容 |
+|------|------|
+| P4 | 无人等待的 trajectory 可以时钟驱动自动唤起并携带先验偏见（自生+随机） |
+| P5 | 轨迹运转速度提升 → 更快产生让人类满意的效果 |
+| 反证 | 熵增失控 / 自我确认循环 / 随机噪音化 / 资源无界 / 反馈脱节——任一显著 → 猜想不成立 |
+
+## 3. 参与方式（CCC 侧三步——第一步可一键 init）
+
+### ① 初始化（一键）：`acc_msm exec autotrajectory-exp init`
+
+自动完成：写配置（`.opencode/serenity.json` autotrajectory 段）+ 生成偏见提供者脚本模板（CCC 根 `autotrajectory-bias.ts`）。
+
+```jsonc
+// 写入的配置（init 后可在 .opencode/serenity.json 查看/调整）
+{
+  "autotrajectory": {
+    "enabled": true,                  // 总开关（缺省 false，默认关零资源占用）
+    "intervalHours": 12,              // 无人类活动 N 小时后唤起（缺省 12）
+    "biasProvider": "autotrajectory-bias.ts", // 偏见内容提供者脚本（CCC 根下）
+    "avoidWakeHours": { "start": 8, "end": 18 }  // 可选：避开北京高峰（缺省 8~18 省钱）
+  }
+}
+```
+
+### ② 实现偏见内容提供者（`autotrajectory-bias.ts`）
+
+CCC 根目录下一个脚本，**stdout 输出本轮唤起注入的偏见内容**（反事实问题/探索方向/任何让轨迹偏离既有路径的输入）。**偏见内容归 CCC**——用本 CCC 自己的反馈信息来源保证"足够随机"。`acc_msm exec autotrajectory-exp random` 可验证输出。
+
+### ③ 标记目标会话（可选自生动机段）
+
+- 目标会话目录名加 `--auto` 后缀：`AGENT_SESSIONS/<date>--<desc>--auto/`——**只有带标志的轨迹走自主形态**，同 CCC 其他会话不受影响
+- 可选：该 SESSION.md 写「下一轮动机」段（上一轮预写 → 下一轮唤起的自生偏见）
+
+## 4. 机制运行（dsp 侧，CCC 无需干预）
+
+```
+定时器（每 10min）→ 唤起条件全满足 →
+  ① 运行 <biasProvider> 脚本 → stdout = 偏见内容（CCC 自定）
+  ② 读 SESSION.md「下一轮动机」段 → 自生动机
+  ③ 定位活跃会话 agent → 注入唤起消息（前台运行——用户全程可见、随时可介入）
+→ 模型自动继续：探索/反事实检验 → 产出落 SESSION.md「自主探索日志」+ 预写「下一轮动机」
+```
+
+**唤起条件**（全部满足）：① enabled ② 会话目录 `--auto` ③ SESSION.md mtime 距今 > intervalHours ④ 北京时间非高峰（缺省避开 8~18）⑤ 无运行中的唤起轮。**偏见提供者脚本缺失 → 唤起中止并报错要求实现**（不静默）。
+
+**人类角色**：不触发、不中断；回复/评价天然并入（同一前台会话）；轨迹不等人类。
+
+## 5. 实验管理（autotrajectory-exp MSM）——一站式
+
+| 用法 | 功能 |
+|------|------|
+| `acc_msm exec autotrajectory-exp`（**推荐，无参**） | **一站式全报告**：背景摘要 + 就绪度检查 + 当前状态 + 下一步指引 + 步骤——CCC agent 看一次即完整理解并知道怎么开始 |
+| `acc_msm exec autotrajectory-exp init` | **一键初始化**：写配置 + 生成偏见提供者脚本模板（CCC 根 autotrajectory-bias.ts） |
+| `acc_msm exec autotrajectory-exp random` | 运行偏见提供者脚本，输出当前偏见内容（验证） |
+| `acc_msm exec autotrajectory-exp doc` | 实验定义说明全文（本 SKILL.md） |
+| `acc_msm exec autotrajectory-exp check` | 仅就绪度检查（配置/偏见提供者/--auto 标志/动机段） |
+| `acc_msm exec autotrajectory-exp status` | 仅当前状态（配置快照/目标会话/距上次活动/唤起窗口/可唤起性） |
+| `acc_msm exec autotrajectory-exp guide` | 仅步骤指引 |
+
+## 6. 观察与验证
+
+- **观察**：无人类活动满 intervalHours 且非高峰 → 前台会话自动出现 `[自主轨迹唤起]` 消息（可见可介入）
+- **验证阶段**：A 机制可行性（3~5 轮）→ B 速度对比（72h 有/无等待）→ C 质量与熵（人类评审 + H_op）→ D 长期（数周，检验自我确认/熵增）
+- **成功判据**：自主轮产出有意义的比例 ≥ 阈值，且 H_op 维持可运转
+
+## 7. 边界
+
+- 本实验**非标准条款**——不修改 Serenity-ACC 标准正文；验证成立后才评估进入标准演化议程
+- 默认关闭；未配置 = 零资源占用；不触碰 CCC 其他会话/机制
+
+## 相关
+
+- 猜想全文：serenity-acc-specs `docs/self-sustaining-trajectory-hypothesis.md`
+- 机制定义：dsh-serenity-plugin `docs/autotrajectory-experiment.md`
+- 标准理论：serenity-acc-specs README §0

package/experiments/autotrajectory/scripts/autotrajectory-exp.ts

@@ -0,0 +1,383 @@
+#!/usr/bin/env bun
+/**
+ * autotrajectory-exp.ts — 自主轨迹实验管理 MSM（Mech，纯 TS 零 LLM 决策）——一站式
+ *
+ * 一个 tool 整合实验全部所需：
+ *   acc_msm exec autotrajectory-exp            → 一站式全报告（背景 + 就绪 + 状态 + 下一步）
+ *   acc_msm exec autotrajectory-exp init       → 初始化实验（写配置 + 生成偏见提供者脚本模板）
+ *   acc_msm exec autotrajectory-exp random     → 运行偏见提供者脚本，输出当前偏见内容（验证）
+ *   acc_msm exec autotrajectory-exp doc        → 实验定义说明全文（SKILL.md）
+ *   acc_msm exec autotrajectory-exp check      → 仅就绪度检查
+ *   acc_msm exec autotrajectory-exp status     → 仅当前状态
+ *   acc_msm exec autotrajectory-exp guide      → 仅步骤指引
+ *
+ * 概念（用户拍板命名）：偏见内容提供者（bias provider）——CCC 根目录下一个脚本，
+ * stdout 输出本轮唤起要注入的偏见内容（反事实方向/探索动机等）。tool 直接运行它；
+ * 脚本缺失 → 报错要求实现（不再经 mech-registry 注册 MSM）。
+ *
+ * 零 DSH 依赖，任何 CCC 可运行。环境：SERENITY_ROOT（acc_msm exec 注入）或 cwd 上溯 .serenity。
+ */
+
+import { existsSync, readFileSync, statSync, readdirSync, writeFileSync, mkdirSync } from 'node:fs'
+import { join, resolve, basename, dirname } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+const DEFAULT_BIAS_PROVIDER = 'autotrajectory-bias.ts'
+const AUTO_SUFFIX = '--auto'
+const MOTIVATION_MARKER = '下一轮动机'
+const CONFIG_PATHS = ['.opencode/serenity.json', '.dsh/serenity.json']
+
+/** 偏见内容提供者脚本脚手架模板（init 生成；CCC 按自己的反馈信息来源改写） */
+const BIAS_TEMPLATE = `#!/usr/bin/env bun
+/**
+ * autotrajectory-bias.ts — 自主轨迹偏见内容提供者（CCC 实现）
+ *
+ * stdout 输出一行/一段文本 = 本轮唤起注入的偏见内容（反事实问题 / 探索方向 /
+ * 任何让轨迹偏离既有路径的输入）。偏见内容归 CCC——用本 CCC 自己的反馈信息来源
+ * 保证"足够随机"（历史会话 / 技能 / 文档 / 外部信息 / 真随机源……）。
+ *
+ * 本文件为脚手架——请按本 CCC 的信息来源改写。
+ */
+const sources = [
+  'AGENT_SESSIONS 中的历史会话',
+  '.opencode/skills 技能目录',
+  'docs/ 设计文档',
+  '…（CCC 自己的信息来源）',
+]
+const pick = sources[Math.floor(Math.random() * sources.length)]
+console.log(\`反事实：如果「\${pick}」换个做法会怎样？\`)
+`
+
+/** 背景摘要（一站式的第一节——CCC agent 快速理解"为什么/验证什么"） */
+const BACKGROUND = [
+  '═══ 自主轨迹实验（Self-Sustaining Trajectory）═══',
+  '背景：Trajectory 是主体（Agent 可替换、Session 载体可重建）。瓶颈 = 人类 waiting——',
+  '      轨迹以"等待人类"为推进条件时，事件序列时间被人类响应间隔锚定，运转被拖慢。',
+  '猜想：无人等待的 trajectory——时钟自动唤起 + 先验偏见（自生动机 + 偏见内容）→ 运转加速。',
+  '验证：P4 可自动唤起并携带偏见 / P5 速度提升→更快产生满意效果；反证=熵增失控/自我确认/噪音化。',
+  '理论：specs §0.7 记录器→校准器（预测加工）。完整定义：doc（SKILL.md）。',
+  '',
+].join('\n')
+
+interface AutoConfig {
+  enabled?: boolean
+  intervalHours?: number
+  biasProvider?: string
+  session?: string
+  avoidWakeHours?: { start?: number; end?: number }
+}
+
+// ── 基础设施 ──
+
+function findRoot(): string | null {
+  const fromEnv = process.env.SERENITY_ROOT
+  if (fromEnv && existsSync(join(fromEnv, '.serenity'))) return fromEnv
+  let cur = resolve(process.cwd())
+  while (true) {
+    if (existsSync(join(cur, '.serenity'))) return cur
+    const parent = dirname(cur)
+    if (parent === cur) return null
+    cur = parent
+  }
+}
+
+function readUtf8(p: string): string {
+  return readFileSync(p, 'utf-8').replace(/^\uFEFF/, '')
+}
+
+function loadConfig(root: string): AutoConfig | null {
+  for (const rel of CONFIG_PATHS) {
+    const p = join(root, rel)
+    if (!existsSync(p)) continue
+    try {
+      const cfg = JSON.parse(readUtf8(p)) as { autotrajectory?: AutoConfig }
+      return cfg.autotrajectory ?? null
+    } catch {
+      return null
+    }
+  }
+  return null
+}
+
+/** 偏见提供者脚本绝对路径（根内强制——逃逸拒绝） */
+function biasProviderPath(root: string, providerRel: string): string {
+  const rootAbs = resolve(root)
+  const abs = resolve(root, providerRel)
+  if (abs !== rootAbs && !abs.startsWith(rootAbs + '/')) {
+    throw new Error(`biasProvider 路径逃逸（须在 CCC 根内）: ${providerRel}`)
+  }
+  return abs
+}
+
+/** 运行偏见提供者脚本（bun 优先，node 兜底），返回偏见内容或错误信息 */
+function runBiasProvider(root: string, providerRel: string): { text: string | null; error: string | null } {
+  let scriptAbs: string
+  try {
+    scriptAbs = biasProviderPath(root, providerRel)
+  } catch (e) {
+    return { text: null, error: String((e as Error).message) }
+  }
+  if (!existsSync(scriptAbs)) {
+    return { text: null, error: `请在 CCC 根目录实现偏见内容提供者脚本: ${providerRel}（acc_msm exec autotrajectory-exp init 可生成模板）` }
+  }
+  for (const cmd of ['bun', process.execPath]) {
+    try {
+      const r = spawnSync(cmd, [scriptAbs], { encoding: 'utf-8', timeout: 600_000, stdio: ['ignore', 'pipe', 'pipe'] })
+      if (r.status === 0) {
+        const text = (r.stdout ?? '').trim()
+        return { text: text || null, error: null }
+      }
+      if ((r.error as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') continue
+      return { text: null, error: `偏见内容提供者脚本执行失败（exit ${r.status ?? '?'}）: ${r.stderr?.trim() || r.stdout?.trim() || ''}` }
+    } catch {
+      continue
+    }
+  }
+  return { text: null, error: '偏见内容提供者脚本无法运行（bun 与 node 均不可用）' }
+}
+
+/** 目标 SESSION.md：**session 必填**（S###/目录名匹配）——自动唤起不默认任何会话（CCC 日常多轨迹并行）；未配置/未命中 → null */
+function resolveTargetMd(root: string, cfg: AutoConfig): string | null {
+  if (!cfg?.session) return null
+  const sessionsDir = join(root, 'AGENT_SESSIONS')
+  if (!existsSync(sessionsDir)) return null
+  const dirs = readdirSync(sessionsDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory())
+    .map((d) => join(sessionsDir, d.name))
+  for (const d of dirs) {
+    const md = join(d, 'SESSION.md')
+    if (existsSync(md) && basename(d).includes(cfg.session)) return md
+  }
+  return null
+}
+
+function beijingHour(nowMs: number): number {
+  return Math.floor(((nowMs + 8 * 3600_000) % 86400_000) / 3600_000)
+}
+
+function inAllowedWindow(nowMs: number, avoid?: { start?: number; end?: number }): boolean {
+  const start = avoid?.start ?? 8
+  const end = avoid?.end ?? 18
+  const h = beijingHour(nowMs)
+  if (start <= end) return h < start || h >= end
+  return h >= end && h < start
+}
+
+// ── 子命令实现 ──
+
+function doc(root: string): string {
+  const p = join(dirname(process.argv[1] ?? ''), '..', 'SKILL.md')
+  if (existsSync(p)) return readUtf8(p)
+  return `SKILL.md 未找到（${p}）——实验定义见 serenity-acc-specs docs/self-sustaining-trajectory-hypothesis.md §7.1`
+}
+
+function check(root: string): string {
+  const cfg = loadConfig(root)
+  const lines: string[] = [`[autotrajectory-exp] 实验就绪度检查（CCC: ${basename(root)}）`, '']
+  const fail: string[] = []
+
+  if (!cfg) {
+    lines.push('✗ 未配置 autotrajectory（.opencode/serenity.json 缺段）——acc_msm exec autotrajectory-exp init 一键初始化')
+    fail.push('config')
+  } else if (!cfg.enabled) {
+    lines.push('✗ autotrajectory.enabled = false（未开启）')
+    fail.push('enabled')
+  } else {
+    lines.push(`✓ enabled = true`)
+    lines.push(`  intervalHours = ${cfg.intervalHours ?? 12}`)
+    lines.push(`  biasProvider = ${cfg.biasProvider?.trim() || DEFAULT_BIAS_PROVIDER}`)
+    if (cfg.session) lines.push(`  session = ${cfg.session}`)
+    const avoid = cfg.avoidWakeHours
+    lines.push(`  唤起窗口避开北京 ${avoid?.start ?? 8}~${avoid?.end ?? 18} 点（用量峰谷省钱）`)
+  }
+
+  const provider = cfg?.biasProvider?.trim() || DEFAULT_BIAS_PROVIDER
+  if (cfg?.enabled) {
+    const bias = runBiasProvider(root, provider)
+    if (bias.error) {
+      lines.push(`✗ 偏见内容提供者未就绪: ${bias.error}`)
+      fail.push('biasProvider')
+    } else {
+      lines.push(`✓ 偏见内容提供者可运行（输出示例: ${bias.text ?? '（空输出）'}）`)
+    }
+  }
+
+  const md = resolveTargetMd(root, cfg ?? {})
+  if (!cfg?.session) {
+    lines.push('✗ 未配置 session（必填——自动唤起不默认任何会话，CCC 日常多轨迹并行）')
+    fail.push('session')
+  } else if (md) {
+    const flag = basename(dirname(md)).endsWith(AUTO_SUFFIX)
+    lines.push(`${flag ? '✓' : '✗'} 目标会话目录${flag ? '带' : '未带'} --auto 标志：${basename(dirname(md))}`)
+    if (!flag) {
+      lines.push(`  → 目录名需以 --auto 结尾（AGENT_SESSIONS/<date>--<desc>--auto/）`)
+      fail.push('autoFlag')
+    }
+    const content = readUtf8(md)
+    if (content.includes(MOTIVATION_MARKER)) {
+      lines.push(`✓ SESSION.md 含「下一轮动机」段（自生偏见）`)
+    } else {
+      lines.push(`· SESSION.md 无「下一轮动机」段（可选——纯偏见内容亦可）`)
+    }
+  } else {
+    lines.push(`✗ 目标会话未命中：${cfg.session}（AGENT_SESSIONS 无匹配目录）`)
+    fail.push('session')
+  }
+
+  lines.push('')
+  lines.push(fail.length === 0 ? '✅ 实验就绪——等待时钟唤起（前台可见）' : `⚠️ 未就绪：${fail.join(', ')}`)
+  return lines.join('\n')
+}
+
+function status(root: string): string {
+  const cfg = loadConfig(root)
+  const now = Date.now()
+  const lines: string[] = [`[autotrajectory-exp] 实验状态（CCC: ${basename(root)}，北京 ${beijingHour(now)} 点）`, '']
+  if (!cfg?.enabled) {
+    lines.push('autotrajectory 未启用（enabled=false 或未配置）——零资源占用')
+    return lines.join('\n')
+  }
+  lines.push(`配置: intervalHours=${cfg.intervalHours ?? 12} | biasProvider=${cfg.biasProvider?.trim() || DEFAULT_BIAS_PROVIDER}${cfg.session ? ` | session=${cfg.session}` : ''}`)
+  const md = resolveTargetMd(root, cfg)
+  if (!md) {
+    lines.push('目标会话：未找到')
+    return lines.join('\n')
+  }
+  const mtime = statSync(md).mtimeMs
+  const idleHours = (now - mtime) / 3600_000
+  const interval = Math.max(1, cfg.intervalHours ?? 12)
+  lines.push(`目标会话：${basename(dirname(md))}${basename(dirname(md)).endsWith(AUTO_SUFFIX) ? '（--auto ✓）' : '（无 --auto 标志）'}`)
+  lines.push(`上次轨迹活动：${idleHours.toFixed(1)} 小时前（阈值 ${interval}h）`)
+  lines.push(`唤起窗口：${inAllowedWindow(now, cfg.avoidWakeHours) ? '✅ 允许唤起' : '⏸ 高峰避开中（北京 8~18）'}`)
+  const wakeable = inAllowedWindow(now, cfg.avoidWakeHours) && idleHours >= interval
+  lines.push(`是否可唤起：${wakeable ? '✅ 是（等待下一个 10min tick）' : idleHours < interval ? `否——距上次活动不足 ${interval}h` : '否——高峰避开中'}`)
+  return lines.join('\n')
+}
+
+function guide(): string {
+  return [
+    '[autotrajectory-exp] 实验步骤指引',
+    '',
+    '① 初始化（一键）：acc_msm exec autotrajectory-exp init',
+    '   ——写配置（.opencode/serenity.json autotrajectory 段）+ 生成偏见提供者脚本模板（CCC 根 autotrajectory-bias.ts）',
+    '② 实现偏见内容提供者：编辑 autotrajectory-bias.ts，stdout 输出偏见内容（反事实方向/探索动机，',
+    '   用本 CCC 自己的信息来源保证"足够随机"）；acc_msm exec autotrajectory-exp random 验证',
+    '③ 标记目标会话：目录名加 --auto 后缀 AGENT_SESSIONS/<date>--<desc>--auto/',
+    '   （可选）该 SESSION.md 写「下一轮动机」段作自生偏见',
+    '④ 验证就绪：acc_msm exec autotrajectory-exp（一站式报告应为 ✅）',
+    '⑤ 观察：无人类活动满 intervalHours 且北京非高峰 → 前台会话自动出现 [自主轨迹唤起]',
+    '   产出落 SESSION.md「自主探索日志」+ 预写「下一轮动机」',
+    '',
+    '完整定义见 SKILL.md（acc_msm exec autotrajectory-exp doc）',
+  ].join('\n')
+}
+
+/** 初始化：合并写配置（不覆盖其他段）+ 生成偏见提供者脚本模板（已存在则跳过） */
+function init(root: string): string {
+  const out: string[] = ['[autotrajectory-exp] 初始化实验', '']
+
+  // ① 写配置
+  let cfgPath = join(root, CONFIG_PATHS[0]!)
+  if (!existsSync(cfgPath)) {
+    const alt = join(root, CONFIG_PATHS[1]!)
+    cfgPath = existsSync(alt) ? alt : cfgPath
+  }
+  mkdirSync(dirname(cfgPath), { recursive: true })
+  let merged: Record<string, unknown> = {}
+  if (existsSync(cfgPath)) {
+    try {
+      merged = JSON.parse(readUtf8(cfgPath)) as Record<string, unknown>
+    } catch {
+      /* 损坏则重建 */
+    }
+  }
+  const at = (merged.autotrajectory as Record<string, unknown> | undefined) ?? {}
+  merged.autotrajectory = {
+    enabled: true,
+    intervalHours: 12,
+    biasProvider: DEFAULT_BIAS_PROVIDER,
+    ...at,
+  }
+  writeFileSync(cfgPath, `${JSON.stringify(merged, null, 2)}\n`)
+  out.push(`✓ 配置写入: ${cfgPath}`)
+  out.push(`  autotrajectory = ${JSON.stringify(merged.autotrajectory)}`)
+
+  // ② 生成偏见提供者脚本模板
+  const scriptAbs = biasProviderPath(root, DEFAULT_BIAS_PROVIDER)
+  if (existsSync(scriptAbs)) {
+    out.push(`· 偏见提供者脚本已存在（保留）: ${DEFAULT_BIAS_PROVIDER}`)
+  } else {
+    writeFileSync(scriptAbs, BIAS_TEMPLATE)
+    out.push(`✓ 已生成偏见提供者脚本模板: ${DEFAULT_BIAS_PROVIDER}（编辑它，stdout 输出偏见内容）`)
+  }
+
+  out.push('', '下一步：③ 标记目标会话 --auto 后缀 → ④ acc_msm exec autotrajectory-exp 验证就绪')
+  return out.join('\n')
+}
+
+/** random：运行偏见提供者脚本，输出当前偏见内容（验证） */
+function random(root: string): string {
+  const cfg = loadConfig(root)
+  const provider = cfg?.biasProvider?.trim() || DEFAULT_BIAS_PROVIDER
+  const bias = runBiasProvider(root, provider)
+  if (bias.error) return `[autotrajectory-exp] ✗ ${bias.error}`
+  return `[autotrajectory-exp] 当前偏见内容（${provider}）:\n${bias.text ?? '（空输出）'}`
+}
+
+/** 一站式全报告：背景 + 就绪检查 + 状态 + 下一步 + 指引（CCC agent 看一次即懂并知道下一步） */
+function all(root: string): string {
+  const cfg = loadConfig(root)
+  const ready = check(root)
+  const stat = status(root)
+  const next: string[] = ['═══ 下一步 ═══']
+  if (!cfg) {
+    next.push('→ 本 CCC 尚未配置 autotrajectory。开始实验：acc_msm exec autotrajectory-exp init 一键初始化。')
+  } else if (!cfg.enabled) {
+    next.push('→ autotrajectory.enabled 为 false——置 true 开启实验（或 init 重新初始化）。')
+  } else if (ready.includes('✗')) {
+    next.push('→ 存在未就绪项（见上）。补齐后重跑本命令确认 ✅。')
+  } else {
+    next.push('→ 已就绪 ✅。保持会话空闲满 intervalHours 且北京非高峰 → 自动唤起（前台可见）。')
+    next.push('→ 之后可随时 acc_msm exec autotrajectory-exp status 查看距下次唤起的进度。')
+  }
+  return [BACKGROUND, ready, '', stat, '', next.join('\n'), '', guide()].join('\n')
+}
+
+function main(): void {
+  const cmd = process.argv[2] ?? 'all'
+  const root = findRoot()
+  if (!root) {
+    console.error('[autotrajectory-exp] ✗ 未找到 CCC 根（无 .serenity；acc_msm exec 会自动注入 SERENITY_ROOT）')
+    process.exit(1)
+  }
+  switch (cmd) {
+    case 'all':
+      console.log(all(root))
+      break
+    case 'init':
+      console.log(init(root))
+      break
+    case 'random':
+      console.log(random(root))
+      break
+    case 'doc':
+      console.log(doc(root))
+      break
+    case 'check':
+      console.log(check(root))
+      break
+    case 'status':
+      console.log(status(root))
+      break
+    case 'guide':
+      console.log(guide())
+      break
+    default:
+      console.error(`[autotrajectory-exp] 未知子命令: ${cmd}（可用: 无参一站式 / init / random / doc / check / status / guide）`)
+      process.exit(2)
+  }
+}
+
+if (import.meta.main) {
+  main()
+}