zaizaizhao/dsh-branchmark#dsh-branchmark

摘一段，生一枝。

Excerpt-driven session branching and conversation lineage for DeepSeek Harness.

dsh-branchmark 是 BranchMark 的公开安装 Bundle。它为开发过程提供重点知识摘录、可追溯 Session 树和注意力分叉：主 Session 保持当前目标，枝签保存知识锚点，完整分叉沿来源上下文创建子 Session，仅枝签流程用选定知识创建独立 Session，空白分支仅保留会话之间的组织关联。

源码、完整设计与开发文档位于 zaizaizhao/dsh-branchmark。

主要能力

• 在已完成的用户或助手消息中选择文本，将重点知识保存为来源不可改写、备注和多标签可编辑的枝签。
• 会话私有枝签与项目全局枝签严格分开展示，当前 Session 不读取其他 Session 的私有枝签。
• 会话树合并 DSH 完整分叉关系和 BranchMark 的组织关系，以线型区分三种上下文模式；未提问分支在刷新后仍可读取和打开。
• 仅枝签流程从无 DSH parent 的新 Session 开始，只写入选中的摘录与备注；空白分支不携带任何上下文。两者都保存独立的组织父关联。
• 关系视图结合 DSH 完整分叉与 BranchMark 组织关联，从主节点向下显示会话树；点击节点打开会话，全景视图显示完整树枝。
• 主输入框只显示 DSH 原生引用 Chip，用户显式发送时才把枝签正文和保留的备注加入模型上下文。
• 右侧浮动 Dock 提供会话、项目、关系和 Side Chat 视图；项目枝签库支持搜索、多标签、卡片/列表、置顶、排序、多选和回收站。
• Side Chat 只承担临时快问快答，不创建普通 Session、不进入关系树，关闭标签立即销毁。

要求

BranchMark	DeepSeek Harness	Node.js	DSH surface
0.1.2-rc.2	0.1.2-rc.1	^22.19.0 || >=24.0.0	Web profile

DSH 仍处于预发布阶段。上表之外的组合没有经过兼容性验证；升级 DSH 前应在独立 profile 中重新完成安装与 UI smoke test。

本 Bundle 只支持上表中的 DSH 版本。安装说明使用精确版本；两个包的 npm dist-tag 分别维护，不能用标签名称相同代替兼容性核对。

安装

先安装目标 DSH，再把兼容表中的 BranchMark Bundle 加入 Web Profile：

npm install --global @deepseek-ai/dsh@0.1.2-rc.1
dsh plugin --profile web add dsh-branchmark@0.1.2-rc.2
dsh --profile web --dump-config
dsh --profile web

dsh --version 必须输出 0.1.2-rc.1，--dump-config 必须包含 dsh-branchmark 和 branchmark-host。不要把此包安装到 DSH 0.1.1-rc.2；该版本使用精确固定的 BranchMark 0.1.1-rc.2。

卸载：

dsh plugin --profile web remove dsh-branchmark

安装或卸载后需要重启对应 Profile。卸载不会删除 clip_explorer 本地 storage domain，因此已有枝签不会随 package 一起被静默清除。

不要使用 Git URL、GitHub source specifier 或源码目录直接安装。源码仓库不提交 lib/，也不运行 prepare 等安装生命周期脚本；npm 包和仓库内 pnpm run pack:bundle 生成的 tarball 才包含可执行产物。源码构建步骤见 安装教程。

使用

在对话消息内选择连续文本，浮动工具条会提供四个入口。右侧浮签默认位于中线上方，可沿右侧边缘上下拖动；松手不会打开面板，刷新后保留相对位置。单击展开；键盘聚焦后用 ↑/↓、Home/End 移动。保存后可从右侧把手展开 BranchMark Dock：

1. “摘录到会话”保存当前 Session 的私有知识；“摘录到项目”显式提升为当前 Workspace 可复用的项目枝签。
2. “关系”视图显示已知的完整分叉、仅枝签和空白分支；实线、虚线和点线区分上下文模式。点击节点直接打开会话，“继续分支”默认从空白开始。
3. 卡片的“创建新会话”可选择完整分叉、仅携带枝签或空白分支，并填写可选名称；可以创建并打开，或输入新问题后在后台创建并发送。
4. “引用到输入框”只加入可移除的引用 Chip，绝不自动发送。
5. 选中至少两枚枝签后显示批量工具栏；引用按勾选顺序加入 Composer。专用手柄支持指针拖动和 Space/方向键排序，Escape 取消；搜索、标签筛选与回收站禁止排序。回收站是搜索框右侧的独立按钮，删除与排序完成后可撤销。
6. “Ask in side”创建当前 Host 内的临时快问快答标签，由用户输入问题后才发送，关闭后不保留 Session 或 lineage。

配置

Bundle patch 提供以下配置。Profile patch 覆盖该 Loader 条目时会替换整个 config，因此修改任一字段时需要重述全部字段。

字段	默认值	作用
maxExcerptBytes	65536	单条正文 UTF-8 字节上限
maxNoteBytes	16384	单条备注 UTF-8 字节上限
maxTagsPerClip	32	单条枝签标签数上限
maxTagBytes	128	单个标签 UTF-8 字节上限
recentContextMessages	10	Side Chat 至少保留的最近原始消息数
summaryProvider / summaryModel	空	为空时跟随 Side Chat 模型；显式设置时必须成对配置
summaryMaxTokens	2048	来源摘要输出上限
answerMaxTokens	8192	Side Chat 单轮回答输出上限
maxToolRounds	6	单轮最大只读工具迭代数
maxToolOutputChars	24000	单次工具结果进入模型的字符上限
maxReadChars	60000	单文件读取或搜索结果字符上限
maxSearchFiles	300	单次项目文本搜索扫描文件数上限

数据、网络与权限

• 枝签、备注、标签、置顶与集合顺序、回收站状态、衍生关系和使用快照写入 DSH 本地 storageDomain 的 clip_explorer domain。插件不提供云同步，也不向作者控制的服务上传这些数据。
• 保存、搜索和整理枝签不调用模型。Side Chat 或衍生会话发送问题时，用户选中的枝签、启用的备注和恢复出的来源上下文会进入当前 DSH 模型 provider 的请求。
• Side Chat 的项目文件工具只读；读取结果可能进入模型请求。Web 搜索和抓取使用 DSH 部署当前配置的 Web provider。
• Side Chat 只存在于 Host 内存；关闭标签、卸载插件或 Host 退出都会中止并销毁它。普通衍生会话仍由 DSH 持久化。
• 插件不读取或存储 provider 凭据，也不自行增加遥测。

已知限制

• 只支持 DSH Web profile，不向 Headless 或 ACP surface 提供 UI。
• 插件关系树不会改变 DSH 原生侧边栏的会话层级。旧的仅枝签记录若没有组织父标识，不会被推测为某个会话的分支。
• Workspace 和 Session 是当前隔离键；Worktree 不是独立隔离边界。
• 完整分叉与仅枝签需要分别写入 BranchMark 关系记录与 DSH recall 日志，当前没有跨子系统事务。Host 在两次写入之间异常退出可能留下低概率部分提交；插件不提供自动对账修复。
• Side Chat 摘要或回答仍可能因为当前 provider、模型、网络或配额错误而失败；界面会保留错误信息，关闭标签前仍可重试。

支持与安全

普通缺陷和功能建议请提交到 GitHub Issues。安全问题不要公开披露，请遵循 SECURITY.md。提交日志或截图前请移除 API key、凭据文件内容和其他秘密。

BranchMark 使用 MIT License。

社区

LINUX DO — 真诚、友善、团结、专业的技术交流社区。