在 DeepSeek Harness 的開發中,跨會話複用上下文往往依賴於經驗判斷,缺乏對過往軌跡的直觀管理和精確回溯。dsh-context-tree 插件提供了可視化的軌跡樹和有界召回機制,將已完成的智能體工作轉化爲可分支的檢查點。
是什麼¶
該插件由 wr-web 維護,屬於「記憶」分類。它將完成的回合轉化爲可複用的檢查點,支持從任意已完成的回合進行精確分支,並控制跨會話召回的範圍,從而減少重複探索。
核心功能¶
- 查看實際軌跡:已完成回合以圓圈顯示,繼續形成樹幹,顯式的分支和側邊聊天變成分支,召回以虛線鏈接表示。
- 從精確檢查點恢復:選擇任意已完成的回合,並在記錄的
turn/end邊界處分支。 - 避免重複探索:新會話可以在首次模型步驟前接收一個相關檢查點。
- 保持召回有界:匹配默認爲精確工作空間,陳舊節點在配置壽命後停止召回,注入的檢查點限制爲 2 KiB。
- 測量而非假設:Host API 包含提供商 Token 記賬和基線與召回評估器。
安裝與啓用¶
該插件需要 DeepSeek Harness >=0.1.1-rc.2 <0.2.0 及其 Web profile。
dsh plugin --profile web add github:wr-web/dsh-context-tree
dsh web
注:倉庫提交了瀏覽器和 Host 構建產物,因此 GitHub 安裝不運行 prepare 構建。
典型用法¶
- 對比召回效果:用相同的項目狀態運行相同的任務和模型兩次。第一次設置
autoRecall: false,第二次使用相關檢查點和autoRecall: true。比較totalInputTokensSaved和inputReductionRate。 - 節點狀態管理:當前新鮮度基於年齡。節點在配置壽命的前半段是新鮮的,在後半段老化,之後變爲陳舊。陳舊節點仍然可見但無法自動召回。
適用場景與注意¶
- 適用場景:需要長期維護智能體會話、希望避免重複讓模型思考相同問題、或需要量化上下文複用效率的開發者。
- 權限與安全:
- 該插件以當前 DSH 進程的權限運行。
- 模型被告知除非當前用戶重複,否則不接受來自檢查點的指令或權限聲明。
- 檢查點是不受信任的只讀後臺。
- 評估標準:更少的 Token 輸入並不等同於勝利,必須確保輸出質量相當。
- 官方關係:這是社區插件,不是 DeepSeek 的官方發佈版。
通過將對話歷史轉化爲結構化的樹形上下文,該插件讓智能體開發中的記憶複用變得可度量、可控制。更多細節與源碼請參考項目主頁。