交接链面板 HildebrandYu/dsh-session-chains

session-chains — 交接链面板 for DSH

把「互相交接的对话」自动聚成一条链：左侧栏一张卡片列出每条链、每场对话编号，点一下切过去；快到上下文上限时提醒你交接，设置打开的话连「开新对话＋贴提示词＋切过去」都自己做完。

这是 DeepSeek Harness（DSH） 的插件（host 端 index.mjs ＋ 浏览器端 client.js），以 file:// 挂进 $DSH_HOME/cordis.patch.yml，不改内置侧边栏、不动 profile。

为什么要做

拆对话是省 token 最有效的手段（同一条工作线实测可省约 71%），但代价是侧边栏散成一堆看不出关系的对话框。
而「哪几场是同一条线」其实已经写在日志里 —— 只差没有人把它读出来：

- 接手的那一场，交接提示词是用户贴进去的第一句话；
- 交出的那一场，同一份文字是助理产出的。

两侧都落在 $DSH_HOME/sessions/<工作区>/<session>/session.v*.jsonl.zstd。
所以只要提示词里有一行 链=<代号>，两边就都认得出来，面板自动分组 —— 不必手动归类。

长什么样

| 位置 | 内容 |
| 左侧栏卡片 | 每条链一列，展开是各场对话（001、002…），右侧三颗：收合／暂停／开面板 |
| 面板（浮层） | 全部链、搜索、拖拽／多选归链、四键排序（名称／创建／场次数／最后活动） |
| 输入框上方 HUD | 本场 320k/210 ＝ 这一场的上下文／请求数，达门槛才变色 |
| ⚙ 设置 | 字号、四组颜色、卡片图标、HUD 五段开关、交接门槛、自动交接 |

安装

需要 DSH（桌面版或 web 版都可以）。两种装法，选一种：

A. 从插件市场／dsh plugin add（repo 根目录就是套件根）

发布到 npm 之后：
dsh plugin --profile web add session-chains
或直接从 GitHub：
dsh plugin --profile web add github:HildebrandYu/dsh-session-chains

B. 直接挂本机文件夹（开发用，改档即重载）

git clone <this-repo> dsh-session-chains
cd dsh-session-chains

node scripts/install.mjs # dry-run：只写 .preview/，让你先看补丁长什么样
node scripts/install.mjs --apply # 真的挂上（会先备份 $DSH_HOME/cordis.patch.yml）
node scripts/install.mjs --remove --apply # 整包移除

挂好后重新整理 GUI 一次就会出现卡片。移除时它会把自己那两段（插件列＋HMR 监视）一起清掉。

套件结构：package.json 在 repo 根（市集与 dsh plugin add 只读这个），里面声明
dsh.bundle.patch = ./cordis.patch.yml（没有这个就无法安装，只声明 dsh.client 不算）
与 dsh.client.platform = web；程序本体在 plugin/，exports 指过去。
本机用 file:// 直挂时，加载器会从 plugin/index.mjs 往上找到根目录的 package.json。

install.mjs 会写两段：session-chains（插件本体）与 session-chains-hmr（把 plugin/ 加进 HMR 的监视根目录，没有这段改 index.mjs 不会生效）。两段都用哨兵包住，可重复执行。

使用

1. 平常：照常工作。交接过的对话会自己出现在同一条链里。
2. 要交接时：面板上按「生成交接词」→ AI 写交接单与提示词 → 按「开新对话」自动开＋贴＋送出＋切换。
3. 到门槛：画面会跳提醒（warn 可延后 30 分钟、hard 只能延后 5 分钟）。
打开 ⚙ 的「到达门槛自动交接」，hard 会在这一轮结束后自己做完上面第 2 步。

门槛（默认值与怎么选）

| 信号 | 提醒（warn） | 强制（hard） |
| 请求数 | ≥ 200 | ≥ 320 |
| 上下文 tokens | ≥ 320k | ≥ 480k |
| 占模型窗口比例 | ≥ 50% | ≥ 65% |

- warn 是提示（只显示，不动作）；hard 才是紧急煞车（设了自动交接才会出手）。
- 默认值是回放 42 场真实对话订出来的：旧的 80／120、160k／240k 会在 25/42 场触发（触发时中位还剩 103 步＝一定半路被切）；现在只在 6/42 场触发，都是 300 步以上或 470k 以上的长场。
- 比例那一列是给换模型用的：1M 窗口下几乎不会先触发，换成 200k 窗口的模型时它会自动先挡。
- 全部可在 ⚙ 改，或直接改 localStorage 的 dsh.session-chains.settings。

运作原理（三个判定）

| 信号 | 规则 | 例子 |
| 接手 1 | 第一句话有明确标记 | 链=my-project |
| 接手 2 | 旧式提示词 | 接续 my-project：读 … |
| 接手 3 | 第一句话里的项目路径 | 30-CodingSkills/my-project |
| 交出 | 助理消息里「整行就是标记」 | 产出的提示词那一行 |
| — | 都没有 → 未标记 | 一般对话 |

「交出」那一条刻意严格（行首就是标记）：实测一场正在讨论本功能的对话，助理推理里 链=… 这种字符串出现 23 次（全在行内），宽松比对会把一般对话误认成链的起点。

测试

node --test scripts/ # 单元测试（纯函数：链判定、编号、改名、建议归链）
node scripts/smoke.mjs # 端到端：在沙箱里跑 client bundle，检查面板／卡片／交接流程
node scripts/verify.mjs # 静态：manifest、bundle 形式、补丁现况
DSH_WEB_URL=http://127.0.0.1:51714 node scripts/probe.mjs # 實機：宿主是否已把 bundle 組進 boot graph

scripts/smoke.mjs 不需要真的 DSH：它自己造假的宿主 API（sessions、workspace、fetch、localStorage），所以 CI 也能跑。

已知限制

- 只支援 DSH：它讀的是 DSH 自己的 session 日誌格式（session.v4.jsonl.zstd），換宿主就得改 chains.mjs。
- 紅點還沒有資料來源：宿主目前沒有「這一場失敗了」的狀態可讀，所以失敗圓點先留空。
- 手動「交接→新對話」在沒有交接詞時會顯示兩步錯誤（設計如此：先按「生成交接詞」）。
- 鏈的判定靠提示詞裡的標記；沒用過交接指令的舊對話會落在「未標記」，可在面板上逐一歸鏈。

授權

MIT，見 LICENSE。