前言¶
DeepSeek Harness（DSH）的核心理念是“一切皆插件”，這使得開發者可以靈活地擴展功能。在長會話或複雜工具調用的場景中，輸入 Token 的消耗往往是顯眼的成本項。dsh-token-frugal 插件旨在從源頭壓縮工具輸出，通過分級節省策略和會話記憶匹配，在不影響核心能力的前提下降低輸入 Token 成本。
插件定位¶
- 名稱：dsh-token-frugal
- 作者：xuzihao66
- 許可證：MIT
- 一句話：通過源側工具輸出壓縮、分級節省策略和會話記憶匹配，降低 DeepSeek Harness 長會話的輸入 Token 成本。
核心功能¶
插件在 Harness 的事件流中擴展了五個關鍵點：
-
工具結果壓縮 (
tools/post-execute)
對每個已接受的工具結果在記錄前進行壓縮。處理流程爲：先進行無損的結構感知轉換，再根據預算進行頭部/尾部省略，並標記恢復路徑。 -
代理工具目錄管理 (
agent/created)
利用ctx.tools.restrict()隱藏配置的工具，將其限制在代理的特定上下文中。插件記錄工具移除/添加塊，並將變更內容寫入工作區記憶文檔。 -
工作區記憶匹配 (
agent/inbox/claimed)
在處理新消息時，將其與工作區記憶文檔進行匹配。通過agent.inject()注入最佳片段，觸發agent/inbox/spliced事件，而非重寫歷史記錄。 -
分級節省控制面板 (
conversation.composer.dock)
在對話編輯器下方提供一個控制面板。節省策略分爲三個等級：- 初等：無損，僅清理空白與控制符。
- 中等：摺疊重複行與遞增計數，內容可無損還原。
- 高等：截斷超長結果並改寫，存在信息取捨。
每個等級對應一個開關，且改動立即生效，無需重啓會話。
-
節省統計頁面 (
settings.section)
在設置中提供一個統計頁面，報告實際節省的 Token 和指標。價格估算沿用 Harness 的 4 字符 ≈ 1 Token 啓發式規則。
使用方法¶
啓用插件後，控制面板會顯示在對話框下方，展示已開啓的節省項數量。點擊面板可展開三個等級的分類，通過開關控制具體策略。切換開關會立即應用到當前會話，並持久化保存配置。
查看詳細統計，請前往“設置” -> “省 Token 統計”。該頁面展示當前進程和歷史累計的節省數據，包括被移除的字符數、節省比例以及按工具分類的明細。
技術細節¶
- 持久化存儲：插件的狀態與模式配置保存在
dsh-token-frugal.state.json文件中，位於配置文件旁。 - 價格估算：統計頁面使用與 Harness 相同的啓發式規則（4 字符 ≈ 1 token）進行估算。
- 通信機制：插件通過 HTTP 路由在 Client 和 Host 之間通信。
- 版本更新：當前版本爲 2.2.0。v2.0.5 修復了
source.kind爲空導致顯示異常的問題；v2.0.4 引入了分級面板和統計頁面。
注意事項¶
- 目錄統計：工具目錄的節省數值是按每次請求計算的，而非累計總和。
- 歷史記錄：當未找到配置文件時，歷史累計數據僅保留在內存中。
- 權限範圍：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
dsh-token-frugal 提供了一套完整的工具輸出壓縮與記憶檢索方案。通過可視化的分級控制和實時的統計反饋，它幫助開發者在不犧牲核心功能的前提下，有效控制長會話的 Token 成本。
