前言¶
在 DeepSeek Harness 里做长对话或复杂课题时，常见做法是单线会话里不断追问，或手动开多个 session 对照。前者容易把主线和旁支混在一起；后者切换成本高，来源关系也靠人记。BranchNest 把「项目 + 无限画布 + 独立卡片」接到 DSH 原生会话与存储上，让主线、分支追问和笔记在同一张画布上可见、可拖、可继续。
下面介绍插件定位、能力、安装步骤和日常使用边界。
这是什么¶
BranchNest for DSH（仓库 ForsakenDelusion/dsh-branchnest）由维护者 ForsakenDelusion 发布，分类为 客户端 插件。一句话定位：在 DSH 项目内提供 项目画布 与 非线性会话管理——每个项目一张画布，已有对话以卡片呈现；从回答中选字追问会生成带来源的新对话，主线与分支可各自继续。
插件直接使用 DSH 的会话、模型、权限和存储，不是另起一套聊天后端。交互与视觉参考自开源项目 Rabbithole（MIT），本仓库为独立非官方实现。
核心功能¶
项目画布与对话卡片¶
切换项目即可看到对应画布。画布上展示该项目内的对话卡片、笔记，以及分支之间的连线关系。可拖动卡片和空白区域；底部支持缩放、整理布局、适应全部内容。
从内容分支追问¶
选中模型回答中的文字，或点击卡片底部的 Ask or note：
- Ask：创建独立分支对话，保留选区与来源问答（及必要祖先内容）。
- Note：在当前画布留下一张笔记卡片。
卡片上还提供 Explain、ELI5、Go deeper 等快捷追问入口。
阅读页与笔记编辑¶
点击卡片右上角展开按钮进入阅读页（文档式阅读，右侧可导航分支）。双击 Note 正文可编辑，点击外部自动保存。
新建对话（DSH 原生能力）¶
右上角 ＋ 新建 使用 DSH 原生输入器：支持附件、/ 技能与命令、@ 文件或对话引用，以及模型与权限选择；MCP 使用 DSH 中已配置的工具。
卡片引用¶
从标题栏 ⇢ 拖向另一张卡片，后续 Ask 会带入被引用内容；提交前可排除本次不需要的引用。
数据存放¶
聊天记录保存在 DSH 原生 session 中；画布布局、笔记与来源关系保存在 DSH 的 project_canvas 存储域。同一画布上的独立对话 不会 自动共享完整历史。归档对话前会二次确认；归档保留记录与布局，取消归档可恢复。权限遵循 DSH 设置。
安装与启用¶
README 写明当前已在 macOS · DeepSeek Harness Desktop 0.2.1-rc.3 上验证。插件版本 0.4.4（见 GitHub Release v0.4.4）。
从 Release 下载 dsh-branchnest-0.4.4.tgz，用 Desktop 自带的 dsh CLI 安装：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add ./dsh-branchnest-0.4.4.tgz
安装后 完全退出并重新打开 DSH Desktop，在左侧导航选择 分支探索。安装包含构建产物，使用者无需本地编译。
更新：安装新的 .tgz 并重启 Desktop。卸载：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop remove dsh-branchnest
若从源码构建，需要 Node.js 22.18 或更高；npm ci --legacy-peer-deps、npm run build、npm pack --ignore-scripts 生成 .tgz 后按上述 plugin add 安装。package.json 中 engines.dsh 为 >=0.2.1-rc.3 <0.2.2，安装前请对照本机 DSH 版本。
典型用法¶
完整说明见仓库 docs/usage.md。可按下面顺序上手：
- 打开目标项目，进入 分支探索，在画布上查看已有对话卡片。
- 在某条回答中选中一段文字，发起 Ask，观察新卡片与来源连线；或在卡片底部选 Note 记要点。
- 展开卡片进入阅读页通读；需要并列参考时，用 ⇢ 引用其他卡片后再 Ask。
- 用 ＋ 新建 开主线对话，附件、
@引用与 MCP 与 DSH 其他界面一致。 - 用底部控件缩放或「适应全部」，整理密集分支后再继续探索。
适用场景与注意¶
适合：在同一 DSH 项目里做主题探索、读书笔记式分支、需要看清「从哪句话岔出去」的研发或调研对话。
边界与限制（README 已说明）：
- 未发送的新建草稿可在当前客户端关闭重开、切换项目后继续；刷新、插件重载或退出后不保证 保留草稿。
- 正在生成的回答需 完成后 才能作为分支来源。
- PDF 卡片、跨项目分支、导出 暂未提供。
安全与信任：客户端插件在 DSH 进程权限下运行，会注入侧边栏、会话与工作区等 UI 模块（见 package.json 的 dsh.client.inject）。安装前建议阅读源码与 MIT License，从 GitHub Release 或可信构建获取 .tgz。社区目录页 skillhub.cn 上的 dsh-branchnest 为独立站点条目，与 DeepSeek / 幻方无官方从属关系。
反馈 Issue 时请附上 DSH 版本、插件版本、系统与复现步骤。
结尾¶
BranchNest 把 DSH 原生会话接到项目级无限画布上，用卡片和连线管理主线与分支，适合不想在单线会话里堆满上下文、又希望留在同一项目权限与存储里的用法。
- 目录页：https://www.skillhub.cn/plugins/ForsakenDelusion/dsh-branchnest
- 源码与 Release：https://github.com/ForsakenDelusion/dsh-branchnest
