前言¶
在 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
