dsh-lazy-tools:DeepSeek Harness 延遲工具加載插件

大多數編碼 Agent 會把每一個可用工具的 JSON Schema 都塞進提示詞——包括模型最終根本不會用到的工具。dsh-lazy-tools 爲 DeepSeek Harness 提供了 CodeBuddy 風格的延遲工具加載。它是一個 tool_search + defer_execute_tool 覆蓋層,讓工具 schema 在真正需要之前不會進入模型上下文,從而減少 token 消耗、縮小上下文窗口,同時保持工具的可發現性。

功能特性

  • 按需發現:模型通過 tool_search 按需發現工具,激活後即可直接調用。
  • 懶激活:工具默認不進入上下文,只有被請求時才激活。
  • 按名激活:通過 defer_execute_tool 按精確工具名直接激活已知工具。
  • 無侵入:不修改工具註冊表,只對模型可見的工具列表做減法,與任何其他策略天然共存。
  • 靈活配置:支持 CodeBuddy 風格的 Defer(...) / NoDefer(...) 模式及通配符。
  • 自保守衛:tool_search、defer_execute_tool 和 run_code 永不被延遲。
  • 按項目自動調優:插件會按項目統計真實使用情況,把最常用的工具設爲常駐。
  • 全局 + 項目級兩層配置:支持全局默認配置與按項目覆蓋的配置。

安裝

通過命令行安裝該插件:

dsh plugin --profile <profile> add github:studyzy/dsh-lazy-tools

安裝後需要重啓 DeepSeek Harness。bundle 層只在啓動時加載,當前進程不會熱加載。

配置與用法

插件默認爲“裝上即用、零配置”模式:默認延遲長尾工具,同時保留一組常駐編碼核心(read、write、edit、bash、glob、grep、web_search、web_fetch、ask_user_question、skill)。

開啓自動調優後,插件會按項目統計真實使用情況,把每個項目裏最常用的工具設爲常駐、其餘全部延遲。模型通過 tool_search 按需發現它們,激活後即可直接調用。

如果需要自定義規則,可以在 profile 的 cordis.patch.yml 中配置。想徹底關掉延遲加載,只需在配置中寫 defer: [] 即可。

注意事項

  • 本插件不依賴提供商原生的延遲工具協議(如 Anthropic tool_reference 或 OpenAI 的 deferred-tool input items)。
  • 插件不擁有、也不實現任何工具,也不代理執行,僅負責激活。
  • 它適用於任何模型與任何提供商(DeepSeek、OpenAI、Anthropic、Gemini 等)。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜