自动交接 S3K926/dsh-auto-handoff

⚠ 2026-09-28 合并记录：本插件现在也管「会话那一摊」

起因是一次「合插件」的需求 ——dsh-session-switch（建新会话、发交接包、写 pending、供界面切过去）整个搬进了本包，作为 switch-session.js 与 switch-store.js 两个模块：

* 内部握手改成直调（runSwitchDirect()），不再是 POST http://127.0.0.1:3080/api/session/switch 那条网络往返；
* 那四条 HTTP 路由照旧注册（/api/session/switch|pending|ack|health），自检、手工 curl、老调用方都还认；
* 状态目录不变：~/.dsh/session-switch/（DSH_SESSION_SWITCH_DIR 可覆盖）；
* 会话那一摊要的七个宿主服务改成运行时注入：缺谁只让这一摊缺席，档案那一摊照常（合并前是「整包卡 pending」）；
* 自检多了一个口：DSH_SESSION_SWITCH_DIR=/tmp/ss node index.js --switch-selftest（原样 19 项）。

撤下前的完整副本在 plugin-src/归档-合并前-20260927-232845/。

dsh-auto-handoff

DSH（DeepSeek Harness）插件：上下文占用到阈值时自动交接。

到阈值那一刻，它做这两件事：

1. 拼一份限长的交接包（默认 1200 字，只有它进新会话），请会话那一摊（2026-09-28 已并入本包的 switch-session.js）开新会话、把交接包当第一条消息送进去；
2. 记一笔幂等指纹到自己状态目录下的 handoff-fingerprints.json（跨重启有效，封顶 50 条）。

⚠️ 2026-10-16 起：默认 不写档案

以前它每交接一次就往日记里塞一条「上下文到阈值，插件自动做了一次交接」的流水账（外加状态一节、生长记录一行），一天能塞好几条、删了又长；接手那边还会被提示「再补一条」。现在默认 archiveOnHandoff: false：

* 交接只交接 —— 一个档案字节都不碰；
* 幂等指纹不再寄生在日记条目上，改落 ~/.dsh/session-switch/handoff-fingerprints.json；
* 日记／状态／生长记录只在人点「日记」或跑「收尾」时才更新；
* 想回到旧行为（写日记 ＋ 状态一节 ＋ 生长记录一行）就把 archiveOnHandoff 设成 true。

到阈值时的默认动作也变了：autoTrigger: true 时它不自己切会话，而是给 AI 塞一条【自动收尾提示】（先做收尾，做完写 fire-now 举手换会话）—— 免得在人正看着屏幕的时候把对话切走。

本插件不自己建会话。 建会话、切界面、归档原会话都是会话那一摊（已并入本包的 switch-session.js）的活；两者只靠一个 HTTP 调用握手，叫不动就走降级（把完整待接写到约定位置，由浏览器那半边自己切）。

它管什么 / 不管什么

| | 本插件 | dsh-session-switch |
| 管什么 | 交接包 ＋ 待接记录（archiveOnHandoff: true 时才写日记 / 状态 / 生长记录） | 会话：建、切、归档 |
| 触发 | 上下文到阈值自动；或手动打演练关键词 | 收到 /api/session/switch 才动 |

记忆的看 / 编 / 导入 / 导出是另一个插件（记忆面板）的事，本插件不碰。

安装

1. 把这个目录放进你的 DSH 插件源目录（本机示例：~/.dsh/plugin-src/dsh-auto-handoff）。
2. 把 cordis.patch.example.yml 里那一条按你的情况改好，插进 profile 的 cordis.patch.yml；或者用 Plugin Manager 的 install_bundle 把它当 bundle 装进 profile。
3. 重启宿主。实测：装 bundle、改 bundle 内代码、改 config 都认重启（HMR 不可靠）。

唯一的必填项是档案根：留空则依次尝试

config.root → 环境变量 DSH_MEMORY_ROOT → ~/.dsh/memory → 从当前目录逐级向上找

认根靠特征文件：身份.md + 日记.md + 生长\状态.md 三者齐备才算一份档案； 认不到就不动作（绝不拿一个猜出来的根去写真档案）。

配置

| 键 | 默认 | 说明 |
| root | '' | 档案根；留空按上面的顺序找 |
| triggerRatio | 0.65 | 占用到这个比例触发交接 |
| minTurns | 3 | 会话太短不触发 |
| cooldownMs | 180000 | 冷却 3 分钟；过了冷却还能再交一次（不是「一会话一次」） |
| handoffMaxChars | 1200 | 交接包上限 |
| dryRun | true | 首启只算不写：把「本来会写什么」记日志，一个字节都不落盘 |
| archiveOnHandoff | false | 交接要不要写档案：false = 只出交接包（默认、推荐）；true = 还写日记一条 ＋ 状态一节 ＋ 生长记录一行 |
| autoTrigger | false | true = 到阈值不自己切会话，而是给 AI 塞一条「该收尾了」的提示（见上文 2026-10-16 说明） |
| device | 【PC】 | 日记标题与状态节里的设备标签（archiveOnHandoff: true 时才用得上） |
| drillKeyword | #交接演练 | 手动演练关键词（只在用户消息里整句匹配） |
| gatewayBase | http://127.0.0.1:3080 | dsh-session-switch 的地址 |
| legacyDevice / legacyBoundary | '' | 旧条目设备归属判据；没配就完全不推断 |
占用率的取数口径：优先会话投影 contextPressure（跟页面上那个百分比同源），拿不到再退回 ctx.tokenMeter.measure() ÷ request/context().contextWindow； 两个都拿不到就返回「不动作」 —— 不许瞎猜分母。

手动演练

在对话里整句打 #交接演练：

- 只写演练副本根（sandboxRoot），真档案一个字节不碰；
- 没配 sandboxRoot 就只做一次干跑，日志里能看到「本来会写什么」；
- sandboxRoot 落在真档案根里面时硬拒（那样「演练」就是真写）。

Host 侧路由

前缀 /api/handoff/，五条各自注册一次（requestBody 只能是 buffered，写别的会静默失败）。

| 路由 | 方法 | 用途 |
| pending | GET | 给客户端轮询的待接（完整交接包 + sourceSession + newSessionId） |
| take | GET/POST | 与 pending 同义（取一份待接） |
| ack | POST | 客户端切完回报，标记「已处理」 |
| health | GET | 一眼看配置与管道：阈值 / 冷却 / 上限 / 档案根 / gateway |
| status | GET | 最近 20 行诊断日志 + 上次判定 |
| draft-report | POST | 客户端上报输入框草稿状态（「别打断正在打字的人」用） |
| fire | POST | AI 举手请求换会话（只认「收尾」口令 ＋ 每小时 ≤2／每天 ≤8） |
| fire-ack | POST | 客户端替用户打完「换会话」后回来清标志 |

客户端半边（client.js）只做「轮询 + 调导航/归档」：不注册 slot、不写 DOM，出错只 console，绝不抛 —— 客户端入口抛错的代价是「整个页面打不开」。

「收尾后自动换会话」怎么举手（文件信令）

POST /api/handoff/fire 那条路要过宿主鉴权（实测在本机回 401，本机 curl 也一样），所以 AI 举手改用写一个文件：

: > ~/.dsh/session-switch/fire-now # 路径 = <状态目录>/fire-now，内容随便

- 插件每 1 秒看一次这个文件 → 删掉 → 设 fireRequested；
- 客户端本来就在轮询 /pending，看到 fire 就替用户打一条「换会话」，于是走既有那条触发路径（建新会话、送交接包、切界面），打完回 fire-ack 清标志；
- 闸没松：仍然受 每小时 ≤2／每天 ≤8 限制；fire 那条 HTTP 路由还额外要求「最近一条用户消息就是『收尾』」。
- 典型用法：AI 跑完收尾（日记 → 备份 → 体检）写一下这个文件，人就自动被带到新会话。

写档案的护栏（只在 archiveOnHandoff: true 时用得上）

默认不写档案（见上文），所以这一节只在把 archiveOnHandoff 打开时生效。写盘一律四条：

1. 改前备份（整份复制到 <根>\归档-旧版本与记录\写入备份\，.bak-YYYYMMDD-HHMMSS）；
2. 只改定位处（序号 +1、total_count +1、last_updated、unfinished，别的一字不动）；
3. 写完复核（读回来逐字比对 + 「旧内容只能是新内容的前缀/只差一处」的形状复核）；
4. 外部改动拒写（指纹比对：我们读过之后被改过 → 拒写）。

外加：

- 幂等：同一份交接重复跑不追加第二条 —— archiveOnHandoff: false 时指纹写在 <状态目录>/handoff-fingerprints.json，true 时写在日记条目里的注释标记；
- 写临时文件再 rename，不赌覆盖式写入；
- 行尾/编码：全文件 CRLF、UTF-8 无 BOM。

自检

node index.js --selftest # 在临时目录造假档案，跑全套回归（每项打实际输出）
node test-handoff-sandbox.mjs # 同一套，只打结论
node test-handoff-sandbox.mjs --verbose

自检口在模块层（不是 apply 里）—— 独立跑 node index.js 时 cordis 不会调 apply，写在里面会一声不吭。

已知边界

- 它不保证「交接的内容是这一轮的全文」：交接包是压缩后的接手起点，不是复制品—— 新会话一开就吃满上下文等于把坑搬过去。
- 日记正文里的 event_description 由「最近说过的话 + 动过的工具」拼成；没给 userMood 时那一栏会照实留白，不替你编心情。
- 跨设备没做：手机侧没有同一套 Web 客户端，切会话要另想办法。
- legacyDevice / legacyBoundary 只是判据：本插件不会去改写任何旧条目。

License

MIT