对话分叉 TimRad1/dsh-plugin-branchpoint

Branchpoint

在干净的节点上分叉对话。

Branchpoint 是 DeepSeek Harness（DSH）插件，在聊天头部加一个分叉按钮。点一下，Branchpoint 读取当前分支，提炼关键内容，然后打开新会话，摘要已经放进输入框。

长对话会退化。压缩有帮助，但也会让线索变模糊。Branchpoint 给你一个干净的分支，同时它还记得你走到哪了。

它做什么

- 在 conversation.session.header.actions 里加一个分叉图标，就在分支标题旁边。
- 提示词超出当前窗口时，最多再加载两页更早的会话历史。
- 生成紧凑摘要：
- 目标（最后一条人类提示词）；
- 最新的助手结论；
- 上一个已完成的回合里做了什么；
- 还有什么没完成，包括最新回合尚无回答时的 in progress: <prompt>；
- 重要工具报的错、改动的文件、版本、命令和关键概念。
- 打开新会话，把摘要放进草稿。它不会自动发送，你可以先检查一遍。

摘要示例

🌿 BRANCHPOINT — BRANCH SUMMARY 🎯 Goal: the handoff button does nothing

📌 LATEST CONCLUSION:
Fixed the silent no-op: the digest builder now keeps orphan assistant text and
pages older history before summarizing.

✅ DONE (1):
- silent no-op on empty digest → alert + fallback summary

⏳ OPEN (1):
- in progress: verify the button in a fresh session

📂 STATE:
· changed: lib/client.js
· files: lib/client.js, package.json
· run: npm test

(Summary, not a transcript: intermediate steps are omitted. Continue from this.)

安装

还没上 npm。从最新的 GitHub release 安装预构建的 tarball：

$tgz = "$env:TEMP\branchpoint.tgz"
Invoke-WebRequest "https://github.com/TimRad1/dsh-plugin-branchpoint/releases/latest/download/branchpoint.tgz" -OutFile $tgz
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
plugin --profile desktop add ("file:" + ($tgz -replace '\\', '/'))

或者在 DSH 里打开 Settings → Plugins，安装下载好的 .tgz 压缩包。

完全退出并重启 DSH。桌面配置档在启动时应用插件组合（没有 HMR）。

使用

1. 打开一个已有对话，至少有一轮交流。
2. 点头部的分叉图标。
3. 在新会话的输入框里检查摘要，准备好就发送。

空白会话里按钮是隐藏的：DSH 在会话有历史之前不显示头部操作。

工作原理

- lib/index.js 是最小化的宿主部分（name、空的 apply）。
- lib/client.js：
- inject = ['slots', 'uiWorkspace', 'sessions']；
- 在 conversation.session.header.actions 中注册；
- 读取 ctx.sessions.binding(sessionId).eventSource；
- entriesToTurns 和 entriesToTools 解析消息与工具调用；
- loadOlderHistory 分页加载更早的历史（最多 2 页，7 秒）；
- buildDigest 生成摘要；
- ctx.uiWorkspace.startSession(undefined, { prompt: digest, clearPreviousDraft: true }) 打开新会话。

没有构建步骤：lib/client.js 是现成的 ESM bundle，放在 window.__ModuleLoader__ 信封里。

限制

- 摘要基于 DSH 会话事件日志 构建。推理过程和原始工具输出不做摘要；只使用可见的助手文本、工具错误、变更的文件和命令。
- 摘要的框架文案是英文。引用的结论保持聊天原本的语言，因为它们是逐字提取的。
- 每次点击最多翻两页历史，所以超长会话可能需要再点一次才能到达最初的提示词。
- 如果某个分支既没有助手文本也没有工具结果，Branchpoint 会弹出提示，不会打开空会话。

开发

node --check lib/client.js
npm pack

要加载本地改动，安装新的 .tgz（或 link:<folder>），然后重启 DSH。

许可证

MIT © 2026 TimRad1