宁静号 ACC —— 给 DeepSeek Harness 装一个「AI 工作区」

一句话：装上这个插件，你在电脑上给 AI 划一块自己的工作区（就是一个普通目录）， AI 在里面干活时就有了记忆、纪律、工具和边界——中途换模型、重启电脑、第二天再来，都能接着干。

适用 DeepSeek Harness（下称 DSH）0.1.5-rc.2 及以上。想了解背后的想法（为什么叫"认知容器"），看 docs/cognitive-container-theory.md；本文只讲能干什么、怎么用。

几个词先说明白（后面都用这几个词，不再解释）：

词	说人话
工作区 / CCC	一个目录，里面放一个 `.serenity` 空标记文件。DSH 在别的目录里跑，插件完全不插手；一旦你进到这种目录，它自动生效
插件 / ACC	就是这个仓库（npm 包 `@shgroup/dsh-serenity-hooks`）。它给 DSH 加工具、加约束、加记忆
MSM	你写在工作区里的可执行小工具（一个脚本 + 一行注册）。AI 通过 `msm("名字", ["参数"])` 调用它们
SESSION.md	工作区里的"工作日志"。AI 把目标、决定、进度写进去，中断后再来就从这里接着干

1. 它到底解决什么问题

不吹概念，直接说四个每天都会遇到的麻烦：

麻烦	没有它	有了它
AI 干到一半忘了自己在干什么	上下文一满，之前的目标、决定全丢，你得重讲一遍	每个工作区有一本工作日志，AI 每推进一段就写进去；上下文满了就"换载体"重来，日志还在原地，接着干
AI 到处乱翻、乱改文件	它能读你整台机器的文件，包括密钥	工作区有围墙：墙内随便用，墙外一律拒绝；密钥文件连"读"都读不到
出门在外想用	只能坐在那台电脑前	自带一个带登录的网页入口（密码或手机验证码二选一），手机也能用
家人想用微信问点事	得教他们装软件、开电脑	扫一次码把微信接上，家人在微信里说话，AI 用你定义的人格回话

2. 快速开始（2 分钟）

前置：Node ≥ 20（或 bun）、DSH 0.1.5-rc.2 及以上。

# 1. 装插件（自动加入 DSH 的 web profile）
dsh plugin --profile web add @shgroup/dsh-serenity-hooks

# 2. 重启 dsh web（插件和网页端界面一起生效）
dsh web

# 3. 验证：进到带 .serenity 标记的目录里开一个会话
#    · 会话开头会自动带上这个插件的身份说明和技能目录
#    · 网页端会话标题旁出现一个状态胶囊（绿点常亮 + SAFE 滑块）
#    · 输入 dashboard health，看到工作区三项检查全通过

卸载：dsh plugin --profile web remove @shgroup/dsh-serenity-hooks

从源码装（自己改代码时用）：

git clone https://github.com/tellmewhattodo/dsh-serenity-plugin.git
cd dsh-serenity-plugin
dsh plugin --profile web add link:$(pwd)/hooks/dsh-serenity-hooks

⚠️ 别用 dsh plugin add github:... 这种写法——那个地址指向的是仓库根目录（不是插件包本身），装上了也不会生效。用 npm 或上面的 link: 方式。

安全模式：点一下网页端胶囊里的 SAFE 滑块，bash 就会从 AI 的工具列表里直接消失（不是报错，是它根本看不到这个工具）。于是 AI 只能走你注册过、测试过的小工具通道。这个开关是给你用的——AI 看不见、也打不开。

3. 装完之后你多了什么

3.1 十一个工具（其中两个按条件出现）

工具	干什么	什么时候用
`container_fs`	在工作区里管文件：列目录、找文件、复制、移动、新建、追加、在文件管理器里打开	需要看/整理工作区里的文件时
`container_trajectory`	一条轨迹：它的身体（SESSION.md）+ 它的时间轴。建/看/切换/原地重建之外，还能登记未来唤醒（= 未来某时刻 + 一条消息，可唤醒自己，也可唤醒别的轨迹）	任何多步骤的活儿，第一步就是它；想让 AI 未来某刻自动接着干也用它
`dashboard`	仪表盘：工作区健康检查（三项）、当前时间、等待	进工作区先自查一下；等外部服务时用
`container_git`	git 操作：status / commit / push / log / pull / diff	提交和推送代码；它绝不自动强推
`msm`	小工具执行入口：`msm("名字", ["参数"])`；名字记不全就给候选；`inspect=true` 看用法	调用工作区里注册的任何小工具
`praxis`	按需给 AI 注入三套"做事方法"：输出自检（eap）、设计对齐（neat）、认知连续性（cce）	要它把话说清楚 / 先对齐再动手时
`handyman`	杂工：派一个便宜模型的助手干活。默认模式（foreground）= 一次串行委派、拿回结果；background 模式= 循环干活直到完成（完成码校验 / 轮次上限 / 自动重启 / 进度文件），也可一次派多个并行	大批量、重复性的活（扫描几十个技能、逐用例回归）
`localstore`	存密钥和配置（凭据、偏好两个命名空间）	API key、密码集中放一处，不进 git
`container_admin`	机务舱：管理子角色、管理小工具注册表、查看全部配置	定义"子角色"、注册新小工具、改配置时
`im-bridge`	给 IM 联系人发消息（目前是微信）：发文本、发文件、查已配置联系人、查通道状态。每次成功发送自动进工作区的消息记录	想让 AI 主动给家人/同事发消息（见 §6.6）。只在工作区配了微信桥时才出现，且只能发本工作区的消息
`acc-diag`	ACC 运行态诊断：一次调用出全报告——当前有多少会话活着、各自属于哪个工作区、唤醒时钟的武装态与 tick 次数、唤醒登记表的每一条（含状态 / 投递结果 / 补跑窗口）	ACC 维护者专用。默认对所有工作区隐藏，只有在工作区配置里点名（`exclusiveTools`）才出现

改过名（旧名已彻底停用，没有兼容别名）：下面每组的箭头链是逐个发布版本的名字，末项才是今名——cc_fs → container_fs · cc_git → container_git · session+session_rebuild → logbook（v1.30/1.31）→ trajectory（v1.32）→ container_trajectory（v1.34，今名） · acc_kit → dashboard · acc_msm → msm（执行）+ container_admin（管理）· eap/neat/cce → praxis · skiff_admin → container_admin role · autopilot-trajectory → trajectory（v1.32）→ container_trajectory（v1.34，今名）。老会话里看到旧名，一律取所在那一组的末项。

3.2 机械约束（AI 绕不过去）

这些不是"提示词里劝它别做"，而是机制上做不到：

约束	你会看到的效果	为什么这样做
安全模式	bash 从工具列表里消失（每一步都同步一次），就算它想调也会被兜底拦下	走注册过的小工具，比让 AI 自己拼 shell 命令可靠得多
工作区围墙	墙内什么都能干，墙外一律拒绝（连路径都解析不出去）	AI 不该碰工作区之外的东西
黑名单 / 治理文件	可配黑名单；`.serenity` 这类治理文件禁止 AI 写	防止 AI 把自己所在的"地基"改坏
密钥文件守卫	`localstore.json` 对所有工具拒绝（包括 read/grep/glob）	密钥值在结构上就出不来
对外输出守卫	对外面的会话（子角色 / ACP / 重建会话）如果答出敏感词，会被打回重答，并告诉它命中了哪个词、该怎么改	外面的人不该看到内部机制
轨迹提醒	做久了会提醒 AI"把进度写回工作日志"，并要求它回一个确认码	提醒是机制，不是靠自觉
工作日志体积提醒	工作日志（SESSION.md）超过 200KB 时提醒 AI"停下来重写一遍"，并附四条重写原则（保留骨架 / 细节挪到附件文件 / 该合并的合并 / 其余你自己判断）	日志越写越厚就没人读得完；重写比堆积便宜。阈值按工作区可调（`sessionKeeper.sessionMdMaxKB`，0 = 关）
重建前交接	要重建上下文时，会要求 AI 先把"手头做到哪了 / 还差什么 / 下一步做什么"写进工作日志末尾的固定小标题下；重建后的它第一件事就是去读那一段接着干	上下文被清空，但手头的事不能丢——写侧与读侧用同一个标题，读的时候才找得到

3.3 对外的入口

入口	默认端口	给谁用
DSH 主界面	3080	你自己在本机用（插件不碰这个端口）
网页登录入口	3081	外部/手机访问完整界面：登录后反向代理到 3080，可配工作区白名单
微信主动发送入口	3082（只绑 127.0.0.1）	工作区外的脚本/集成用它给微信发消息（公网到不了，所以不需要密钥）。工作区里的 AI 不走这个端口，直接用 `im-bridge` 工具
子角色调试页	3099（只绑 127.0.0.1）	你调试"子角色"时用，能切换工作区、看对话轨迹
ACP + 对外问答页	3100（只绑 127.0.0.1）	程序化接入（JSON-RPC）+ 给别人用的问答页（key 认证，只返回答案，不返回内部轨迹）
微信桥	无需端口（出站长轮询）	家人在微信里直接和 AI 说话

默认只监听 127.0.0.1 的入口，要暴露到公网由你自己决定（隧道 / 反代 / 端口映射都行），插件不绑定任何特定做法。

3.4 省你一步：用 opencode 的模型

想在 DSH 里用 opencode 的网关（opencode.ai/zen），本来除了配路由还得手抄一串请求头—— 这些头是 opencode 用来做会话亲和路由的，少写一个 x-opencode-session，/zen/go 面就直接 400 拒绝。 插件装好就自动配，这一步你不用管：

你的情况	插件做什么
已经配了 opencode 路由，但缺头	只补缺的那几个；你手写过的值一律不动（头名不分大小写，`X-Title` 和 `x-title` 一样算数）
一个 opencode 路由都没有，但环境里有 `OPENCODE_API_KEY`	自动建 `opencode-go` 路由并带全头（没有 key 的人不受影响，不会平白多出一组模型）

只管"会话族"的头：x-opencode-session / X-Session-ID / x-opencode-client / x-opencode-project。前两个名字是同一个值的两个别名——你写了其中一个，就用你的值补上另一个，不会出现两个互相打架的会话 id
不冒充 opencode 官方客户端：X-Title / HTTP-Referer 这类"身份头"只在免费档的滥用判别里起作用，插件不注入（替你骗额度不是我们该做的事，付费面本来也不需要它们）；User-Agent 是 DSH 的保留名，想注也注不了
会话标识是固定的（dsh-serenity）：DSH 的请求头在路由解析时一次算好，只能给静态值。好处是同一台机器的请求稳定落同一个上游（对缓存友好）；代价是做不到"按会话分区"
配的是你自己的文件：写入 DSH 的 settings（llm-pi-ai.providers.<路由>.headers），随时可改可删。不想要这个自动配置，就把本插件的 opencodeProvider.autoConfigure 关掉（关掉后一切回到手抄）
密钥不碰：插件只补路由和头，OPENCODE_API_KEY 放环境变量即可

4. 一个工作区长什么样

工作区就是一个普通目录，加一个标记文件：

my-workspace/                     ← 工作区根目录（放一个 .serenity 就成）
├── .serenity                     ← 标记：这个目录是一个工作区
├── .opencode/
│   ├── serenity.json             ← 工作区级配置：助手模型白名单 / 日志阈值 / 子角色
│   └── skills/                   ← 领域技能（每个技能 = 一个领域的知识 + 可能有小工具）
│       ├── home-media/           ←   例如：媒体（找片源 / 做字幕 / 推送）
│       ├── home-wealth/          ←   例如：家庭财务
│       └── …（每个技能可以自带脚本）
├── AGENT_SESSIONS/               ← 工作日志库：每个目录一本 SESSION.md
│   └── 2026-09-08--S142--xxx/
│       └── SESSION.md            ← 目标 / 决定 / 进度（永远留在这里，不会被搬走）
└── _tmp/                         ← 运行时落盘：你粘贴的图片和文件
    ├── images_from_user/
    └── files_from_user/

5. 能拿它做什么（12 个真实用例）

下面这些都在真实部署里跑着。地址、账号、路径都做了泛化。

#	你想干的事	实际怎么走
1	长期项目不断线	`container_trajectory create` 建轨迹 → 每推进一段写进去 → 中断后 `container_trajectory use` 接上 → 上下文满了 `container_trajectory rebuild` 原地重建并自动继续
2	批量同步代码	当前仓库 `container_git commit/push`；多个子仓库一条命令全同步（自动提交 + 推送）
3	做一集字幕	搜片源 → 下载 → Whisper 转写 → 翻译 → 双语 SRT → 机械质检（7 项）→ 推送订阅/邮件
4	服务器巡检	一条命令出 CPU/内存/GPU/容器/服务报告；重启容器也在同一条白名单通道里
5	内网服务定位	仓库全景（分类/技术栈/关联）+ 设备端口扫描
6	家庭财务	结构化记录资产/负债/收支/预算，随时查询汇总；房贷利率对比这类宏观跟踪
7	家人档案	成员资料统一维护，工作区是唯一真相源
8	想法随手记	想到什么就聊，AI 访谈式问清 → 结构化归档 → 定期回顾你的思考模式
9	手机/外出使用	浏览器打开 `http://内网地址:3081` → 输密码或 6 位验证码 → 直接用完整界面
10	粘贴资料自动处理	粘图片 → 自动落盘 → 视觉模型识别（快递单/截图/图表）；粘 PDF/压缩包 → 自动落盘 → 提取文本/解压/读表格
11	微信里用 AI	面板扫一次码 → 家人在微信发消息（文字/语音/图片/文件）→ 路由到指定子角色 → 回复回到微信
12	定时自己干活	工作区配好巡航（间隔/目标会话/焦点/偏见脚本）→ 到点自动唤醒并注入焦点，全程在你眼前发生，可随时介入

典型一天：

早上  服务器巡检（一条命令）→ 一切正常
上午  同步昨天的代码 → 子仓库全部推送
午间  收到 PDF 账单 → 粘进对话 → 自动落盘 + 表格提取 → 记进财务
下午  做一集视频字幕（转写 → 翻译 → 双语 SRT → 质检）→ 推送订阅
晚间  手机登录 3081 处理运维（验证码验证）
全程  每段工作都落在 SESSION.md 里 → 轨迹连续，随时换人/换模型/换机器接着干

6. 对外入口详解

6.1 网页登录入口（3081）

插件自己起第二个监听器，请求流程是：

外部浏览器 → http://内网IP:3081
  → 没登录 → 极简登录页（用户名 + 密码，或 6 位动态验证码，二选一；手机端适配）
  → 提交 → scrypt 校验 / TOTP 校验 + CSRF 校验 + 连续失败锁定（5 次 → 15 分钟指数退避）
  → 通过 → 下发 HttpOnly cookie（SameSite=Strict，24 小时滑动续期）→ 302 跳转
  → 已登录 → 反向代理到 127.0.0.1:3080（改写过 Host/Origin，作为信任栅栏）
  → 工作区列表按白名单过滤 + 新建工作区做校验
  → WebSocket 升级也转发（101 回写 + 双向错误监听，防止连接被压垮）

6.2 微信桥

工作区级配置（.opencode/serenity.json 的 weixin 段），凭据放在工作区的 localstore.json（不落 git 明文）。 DSH 一个进程可以同时带多个工作区，每个工作区各自对接自己的微信。

扫码绑定：设置面板 → 微信桥 → 选工作区 → 扫码（手机微信确认）→ 机器人 token 自动写入凭据
多账号：每个账号独立扫码、独立移除
能收什么：文字、语音（微信服务端自带转写，无需额外识别）、图片、文件（图片和文件会从微信 CDN 下载并解密，落到 _tmp/weixin-inbound/，再把路径告诉 AI）
正在输入：处理期间微信会显示"正在输入…"
回复干净：自动剥掉思考过程，微信只看到正文
记得住：同一个微信号对应固定会话，重启后恢复历史，不会"失忆"
路由：微信号 → 子角色（精确匹配优先，* 兜底）
主动发消息（v1.31.0）：用 im-bridge 工具，AI 自己就能发—— im-bridge({channel:"weixin", action:"send", user:"yh", text:"内容"}) （发文件：action:"send-file" + file:"<工作区内的路径>"，可加 caption）。这个工具只能发本工作区的消息（没有"目标工作区"参数，不会发错容器），发出的消息会自动被记录。它只在工作区配了微信桥时才出现在工具列表里——没配就看不到，而不是"看得到但一调就报错"。（旧办法是工作区里自己写个小工具走 3082 端口，v1.31.0 起已退役；3082 保留给工作区外的脚本。）
让 AI 自己决定怎么回（v1.30.10）：配置 "weixin": { "autoReplyWithLastMessage": false } 后，插件不再自动把 AI 最后那段话转给用户，而是每轮告诉它"你必须自己发"，并附上一条可直接照抄的 im-bridge 调用。适合需要过程汇报、想分多条发、或者该安静就安静的角色。默认 true（保持原行为）。该发却没发时，插件会打回提醒（最多 2 次）；还是不发送，可以再开 "fallbackOnNoSend": true 让插件兜底把那轮的话转给用户（记录为 source: "reply-fallback"），保证"消息不丢"。
消息记录：配一个 weixin.hook 脚本，每收/发一条消息就把事件（JSON）喂给它，存哪里由你决定。记录里 source: "reply" 表示"回复用户"，source: "proactive" 表示"AI 主动发起"， source: "reply-fallback" 表示"AI 没发、插件兜底发的"。
排障：msm("weixin-doctor", ["status"|"diag"|"verify"|"guide"])

6.3 子角色（Skiff）

你可以从一个"什么都能干"的助手身上，切出一个能力受限的小角色——不只是问答，也可以带操作能力：

{
  "skiff": {
    "roles": {
      "qa": {
        "model": "provider/model",              // 这个角色单独用哪个模型
        "msms": ["web-search", "vlm-describe"], // 它能调哪些小工具
        "tools": ["read", "grep", "glob"],      // 它能用哪些平台工具
        "systemPromptFile": "roles/qa.md"       // 它的人格与边界（也可以直接内联）
      }
    }
  }
}

两份白名单分开配（小工具 / 平台工具），没列出来的一律隐藏
调试页（3099）可以切工作区、看轨迹；回答用 markdown 渲染，思考过程折叠
container_admin role validate 校验配置，apply 才真正生效

6.4 对外问答页（3100）

key 认证（常量时间比较 + 失败 IP 锁定 + 可轮换）+ 容器白名单（留空 = 全部开放）
只给答案：响应里只有 answer / answer_html / sessionId——内部轨迹、工具结果、机制信息都不出去
默认只监听 127.0.0.1；要给别人用，怎么暴露（隧道/反代/端口映射）由你决定

6.5 轨迹与定时唤醒（trajectory）

trajectory（轨迹）是一等概念：一个工作区里可以有任意多条轨迹并行。

定时唤醒：用 container_trajectory send-later 登记一条"唤醒" = 未来某时刻 + 一条消息——可以给自己预约，也可以唤醒别的轨迹；落在工作区内的 AGENT_SESSIONS/wake-registry.json（可读可审计），到点由中心调度器投递，不阻塞、不等待、也不回执。

即时投递：用 container_trajectory send-now 把一条消息现在就递过去，并且不排队——目标在内存里且正在跑轮次，就 steer 当场注入当前轮；目标空闲就立即起一轮；目标不在内存里就冷载入后投递（等效于直接唤醒，但不等调度器的 5 分钟节拍）。它有同步回执（告诉你走了 live 还是冷载入），不落注册表（那张表专管"未来时刻"）。

两者只差两处：时刻（现在 / 未来）与回执（有 / 无）。"预约"天生是 fire-and-forget（不可回收、不回执），"递话"则是一次调用一次答复——各自语义干净，不把两种语义塞进同一个动作（🔴 更名：这对动作原名 wake-later / send-message，现名 send-later / send-now——族名取共享词干 send-、轴取 -later/-now，因为「唤醒」是两条路径共有的属性，不配做区分；硬切无别名）
⚠️ 回执只到"已注入 / 已起轮"：它不表示目标已经执行或答复。要确证"目标真的动了"，得看它自己的 SESSION.md（不得凭回执结案）
⚠️ 唯一的例外路径：steer 不可用时退回排队（fail-safe：宁可排队，不可静默丢消息）——此时回执文案写明"steer 不可用 ⇒ 退回 followup"。send-later 不受影响：预约的本职是"到点唤起"，在跑时排队不打断当前轮是它被实证验收过的行为
目标没打开也能唤醒：会话不在内存里时先把它载入再投递（冷唤醒）；载入不了则条目留在登记表里并记下原因，不静默丢弃
"周期"归工作区自己：要一轮接一轮，就由收到唤醒的那条轨迹在每轮结束时再排一次下一轮——ACC 只提供"到点投递一条消息"这个原语，不替工作区决定节拍（焦点、节拍、偏见都由工作区自定；任意条轨迹并行、互不干扰）
轨迹可以带上 skill（两种写法，取并集）：① 一处声明、全容器生效——在 .opencode/serenity.json 写 trajectory.skills: [名字, …]，本 CCC 的每条轨迹被绑定期间都注入这些 skill 的全文（连 skiff 角色会话也算）；② 只给这一条——在它的 SESSION.md 顶部 frontmatter 写 skills: [名字, …]。两者是并集：容器级在前（底座）、轨迹级追加（这条额外的）。⚠️ 是"绑定期间一直供着"而非"use 时灌一次"——改了配置或 frontmatter立即生效，也不随对话压缩消失；而 create 只新建、不夺走当前绑定 ⇒ 新轨迹要显式 use 才挂上。skill 名来自工作区数据，先过安全校验才会用于拼路径，找不到会在提示里明说"缺失"而不静默跳过；⚠️ 重写 SESSION.md 时务必原样保留顶部 frontmatter（抹掉 = 静默撤销该轨迹的声明）

CRO —— 让轨迹自己判断什么时候该被叫醒

问题：上面那两条都要求先算好一个时刻（"3 点叫我"）。可该不该醒往往不是时间说了算：某条轨迹应该在"天亮 + 家里有人 + 非高峰"才醒；已经在干活就不该再叫一次；日志快满了，下次叫它时该要求它先整理。

做法：让一条轨迹自己带一段程序，由 ACC 在每次检查时跑它，由这段程序决定"现在该不该叫我、叫我的时候说什么"。

	内容
程序放哪	`<CCC 根>/AGENT_SESSIONS/<轨迹目录>/continuous-re-occurrence.ts`（放轨迹自己目录里 ⇒ 跟随轨迹跨载体存活、天然进 git）
开关	① 逐轨迹：文件在 = 启用，文件不在 = 禁用（无 enabled 字段、无注册表）② 🔴 总闸：设置面板「CRO（轨迹自编程唤起）」（`croEnabled`，缺省开）——关掉只停 CRO 阶段，`send-later` / `send-now` / 唤醒表投递照常工作
谁跑它	ACC 的唤醒调度器（既有 5 分钟 tick）
给它什么	一条 stdin 进来的 JSON 快照：身份 / 时间 / 轨迹身体（SESSION.md 体积与 mtime、`references/` 清单）/ 绑定与载体（绑定的、live 的、🔴 正在跑轮次的）/ 调度面（本轨迹在办唤醒、调度器状态）
它给我什么	stdout 一行 JSON：`{"wake":true,"prompt":"…","reason":"…"}` 或 `{"wake":false}`（缺省 = 不打扰）
写程序前先读	`container_trajectory cro-guide` —— 指南 + 一份可直接拿去自测的样例快照

几条设计上的硬约束（都不是随便定的）：

🔴 ACC 只"起进程"，从不 import 你的程序——进程边界同时挡掉两件事：ACC 不必依赖工作区的源码路径（装机版在别处，两条路径就是两个真相源），以及一个用户程序的语法错会放倒整个容器
🔴 半成品报错就行：程序报错 / 超时（60 秒硬超时，超了 kill）/ 输出非法 ⇒ 记一行 + 跳过本轮
🔴 CRO 的任何失败都不影响既有机制——send-later / send-now / 唤醒表投递照常工作（这条有实测用例钉住，不是口头承诺）
🔴 reason 强烈建议填：改成程序判定之后，"当时为什么叫了"不再能从时间表重建（原因在程序肚子里）；不写，以后出事无法复现
程序想要记住"上次判了什么"，得自己记——写在自己轨迹目录里的状态文件（那是它自己的进程状态，ACC 物理上拿不到）。所以防抖也归程序：想"别叫太频繁"就自己记时间戳
⚠️ 它不自带自测：指南里给的流程是先用开发名写（如 continuous-re-occurrence.dev.ts，不会被启用）→ 配自测跑绿 → 再改名为正式名（因为"文件在 = 启用"，改名这个动作就是上线动作）

🔵 不是 autopilot 回归：退场的 autopilot 删的是判据内容（周期节拍 + 提示词），留下的是调度能力；CRO 补的是"在没人醒着的时候判断该不该醒"——那正是工作区自己做不到的那件（工作区的自排是"被唤起时才跑"）。

⚠️ 历史（v1.35.0 起已退场）：ACC 曾自带一套"周期自唤醒 autopilot"——插件内时钟 + 工作区配置里的 topPrompt/偏见脚本 + 面板「周期自唤醒」开关 + container_admin autopilot 三动作（status/init/generate-bias）。v1.35.0 起整段删除。理由：它相对当时的 wake-later（今 send-later）只多两样——"周期节拍"与"提示词注入"，而这两样工作区自己就能做（见上）；且后者反而更强（支持冷会话唤醒，而 autopilot 要求目标会话已在内存里）。老会话 / 老文档里看到 container_admin autopilot、autopilot-trajectory、--auto 目录后缀、[Autopilot Trajectory · 唤起] 等字样，均按本条理解：那是已删除的机制。

6.6 安全模型

层面	做了什么
登录	scrypt 密码哈希 + 常量时间比较 + 256-bit token + 24 小时滑动有效期 + 审计日志
双因素	TOTP（兼容 Authenticator），扫码绑定；密码和验证码二选一
防爆破	按账号锁定：连续失败 5 次 → 锁 15 分钟，且指数退避
防 CSRF	登录双提交 + 配置写入校验 Origin + 服务端 token 集合（多标签页不冲突）
凭据	集中放 `localstore.json`（默认禁止提交到 git）；密钥文件对工具结构性隔离
对外输出	敏感词检测 → 打回重答，并告知命中词和规避方向

7. 配置分四层

层	位置	放什么
DSH 原生设置	DSH 的 settings.yaml	简单开关：网关 / 重建 / 会话命名、重建阈值、子角色开关与调试端口、ACP 与问答页开关、巡航总开关（默认关）、opencode 路由自动配置（默认开）
插件全局文件	`~/.dsh/serenity-hooks.json`（权限 0600）	网关账号（scrypt + TOTP）、监听地址与端口、工作区白名单、cookie 安全开关、问答页 key
工作区配置	`.opencode/serenity.json`	助手模型白名单、日志阈值、安全模式黑名单、子角色、巡航（间隔/会话/焦点/窗口）、微信（账号/路由/开关）
工作区凭据	`localstore.json`	密钥与本地偏好；微信机器人 token 也在这一层

原则：插件是全局的，工作区是具体的——账号、开关、阈值归插件层；角色、凭据、本地偏好归工作区层。

8. 上下文快满了怎么办

AI 一次能"记住"的内容有上限。满了不用你手动开新会话：

机制	说人话
工作日志（SESSION.md）	AI 的"笔记本"，永远留在原地。目标、决定、进度都写这儿
原地重建（container_trajectory rebuild）	快满时它会提示 AI 主动重建：把这一轮对话清空，但重新注入"你是谁 + 继续 S### 的工作"——载体换了，活儿接着干。重建后的 token 计量也正确回落
进度提醒	做久了会按计分提醒 AI 把进度写回日志，并要求它回确认码
沉淀纪律	重建前如果产生了有价值的认知，先把它写进相关技能（而不是丢掉）

9. 给插件开发者

pnpm typecheck          # 类型检查（node + 浏览器端两套）
pnpm test               # 全量测试（当前 80 个文件 / 1186 个用例）
pnpm build              # 打包（lib/index.js + client.js）

开发用小工具：scripts/dsh-develop.ts——typecheck / test / build / status / commit / push / version / bump / deploy / lockfile / host-upgrade / restart-web / publish / pack-check / github-push 一条龙。 lockfile = 重生成锁文件 + 用 --frozen-lockfile 自检（CI 的 Install (hooks) 同款判定）； pack-check 会在发布前核对打包产物是否完整（曾经踩过"发到 npm 少了文件"的坑）；scripts/dsh-crash-investigate.ts 用来查崩溃（只读）。 ⚠️ 改完 package.json 依赖后必须跑 lockfile 并提交锁文件 —— v1.31.6 漏了这一步，CI 从此一直红（红在"测试根本没跑"，见 CHANGELOG v1.31.10）
宿主类型基准 = devDependencies（v1.31.11）：tsconfig.json / client/tsconfig.json 的 paths 指向仓库内 node_modules/@deepseek-ai/*，由精确钉版的 devDependencies 提供 → 新增 paths 条目必须同时加 devDependency（否则 tsc 静默回落 node_modules = 假绿，CI 的 typecheck 也就形同虚设）。机械闸门见 tests/compliance.test.ts F7；升级宿主时只改 package.json 一处 + 重跑 lockfile
升级宿主（v1.31.12）：dsh-develop host-upgrade <版本|dist-tag> 全局升级 DSH CLI（包名硬编码 @deepseek-ai/dsh、默认官方源、--dry-run 预览）→ 把 package.json 的 peer/devDeps 基准抬到同一版本 + 重跑 lockfile（compliance.test.ts F6c/F7d 与 host-manifest.test.ts 会强制各声明面同步，漏一处必红）→ restart-web → dashboard health 看 dshVersion
诊断会话打不开（v1.31.13）：dsh-develop session-doctor —— 会话日志体检（只读）。 --probe 走宿主真实读取路径判定（msm("dsh-develop", ["session-doctor","--probe","--summary"]) 可全量跑）。 ⚠️ 两个易误读点：① readStoredLog 是存储层读、不走格式迁移 ⇒ 它对历史世代报 "no upgrade path" 属正常现象，不是损坏证据；判断"用户能不能打开"要看应用面 open(id,'read')。② 本工具修的两个真实缺陷见 CHANGELOG v1.31.13（rebuild 写的 user/message 缺 id/role ⇒ 会话永久打不开；findSessionLog 不认 session.vN.jsonl.zstd ⇒ 清理静默失效）
架构：Cordis 原生插件，用 DSH 的正式接口注册工具和拦截点——从不修改 DSH 本体
代码地图：docs/codebase-overview-v1.22.md
设计决策：见 CHANGELOG.md 和维护技能 dsh-serenity-plugin-development
发布：npm @shgroup/dsh-serenity-hooks + GitHub 双仓库同步推送

10. 和 opencode 版是什么关系

	opencode-serenity-plugin	dsh-serenity-plugin（本仓库）
跑在	OpenCode	DeepSeek Harness
实现	独立	独立（不复用源码，但遵循同一套标准）
系统提示词	`system.transform`	`systemPrompt.section`，平台无关的部分逐字对齐
工具	msm / container_fs / logbook 等	container_fs / container_trajectory / dashboard / container_git / msm / praxis / handyman / localstore / container_admin ＋两个条件出现的（`im-bridge` / `acc-diag`）

同一个工作区可以随时换运行时：.serenity 标记、.opencode/skills/、配置、AGENT_SESSIONS/ 的文件格式都一致；差别只在平台层（工具名、注入方式），换过去以后 AI 收到的约束是一样的。

11. 常见问题

Q：装完没反应？ 先确认你进的是带 .serenity 标记的目录。不是工作区的话，插件完全不介入。进去后输入 dashboard health 看三项检查。

Q：bash 怎么不见了？ 安全模式开着——这是设计，不是 bug。走注册过的小工具比让 AI 自己拼命令可靠。关掉胶囊里的 SAFE 滑块就回来了。

Q：3081 登录被锁了？ 连续失败 5 次锁 15 分钟（指数退避）。等锁过期，或检查账号的验证码绑定状态。

Q：上下文快满了怎么办？ 先让 AI 把进度写回 SESSION.md，然后按提示调用 container_trajectory rebuild。轨迹会自动接续，不用手动开新会话。

Q：对外问答页会返回内部信息吗？ 不会。只返回答案本身，内部轨迹和工具结果都不出去。

Q：微信桥里，AI 的回复是怎么发出去的？ 默认由插件自动把它的最后一段话转发给你。如果配了 autoReplyWithLastMessage: false，插件就不转了，改由 AI 自己发——所以这时候它如果没发，你就收不到消息（没有兜底，这是刻意设计）。

Q：主动发的微信消息会被记录吗？ 会。和工作区里配的 weixin.hook 记录脚本走同一条路，事件里标 source: "proactive"；自动回复标 source: "reply"。

12. 延伸阅读

这套东西的想法从哪来：docs/cognitive-container-theory.md——认知容器是什么、认知的"发生/存储/再发生"、轨迹与载体
权威标准：serenity-acc-specs——理论根基、注入规范、不变量
改了什么：CHANGELOG.md——每个版本做了什么、为什么这么做

许可

MIT（见 LICENSE）

版本：v1.31.13 ｜前置：DSH 0.1.5-rc.2+ / Node ≥ 20 或 bun ｜测试：80 个文件 / 1186 个用例

Name		Name	Last commit message	Last commit date
bin		bin
docs		docs
hooks/dsh-serenity-hooks		hooks/dsh-serenity-hooks
scripts		scripts
src		src
tests		tests
.gitignore		.gitignore
.npmrc		.npmrc
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
SESSION.md		SESSION.md
mech-registry.json		mech-registry.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Navigation Menu

Repository files navigation

宁静号 ACC —— 给 DeepSeek Harness 装一个「AI 工作区」

1. 它到底解决什么问题

2. 快速开始（2 分钟）

3. 装完之后你多了什么

3.1 十一个工具（其中两个按条件出现）

3.2 机械约束（AI 绕不过去）

3.3 对外的入口

3.4 省你一步：用 opencode 的模型

4. 一个工作区长什么样

5. 能拿它做什么（12 个真实用例）

6. 对外入口详解

6.1 网页登录入口（3081）

6.2 微信桥

6.3 子角色（Skiff）

6.4 对外问答页（3100）

6.5 轨迹与定时唤醒（trajectory）

CRO —— 让轨迹自己判断什么时候该被叫醒

6.6 安全模型

7. 配置分四层

8. 上下文快满了怎么办

9. 给插件开发者

10. 和 opencode 版是什么关系

11. 常见问题

12. 延伸阅读

许可

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

宁静号 ACC —— 给 DeepSeek Harness 装一个「AI 工作区」

1. 它到底解决什么问题

2. 快速开始（2 分钟）

3. 装完之后你多了什么

3.1 十一个工具（其中两个按条件出现）

3.2 机械约束（AI 绕不过去）

3.3 对外的入口

3.4 省你一步：用 opencode 的模型

4. 一个工作区长什么样

5. 能拿它做什么（12 个真实用例）

6. 对外入口详解

6.1 网页登录入口（3081）

6.2 微信桥

6.3 子角色（Skiff）

6.4 对外问答页（3100）

6.5 轨迹与定时唤醒（trajectory）

CRO —— 让轨迹自己判断什么时候该被叫醒

6.6 安全模型

7. 配置分四层

8. 上下文快满了怎么办

9. 给插件开发者

10. 和 opencode 版是什么关系

11. 常见问题

12. 延伸阅读

许可

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages