前言¶
DeepSeek Harness(dsh)把模型、工具、會話、循環都做成插件,智能體跑起來之後,真正耗時的往往不是某一次 read 或 bash,而是模型在每一次工具調用前重新思考。作者 Electricitysheep 在倉庫 README 裏用一個例子說明這個現象:一條五十步左右的工具鏈,可能有好幾分鐘花在工具與工具之間的思考上,而不是花在工具本身。
2026 年 8 月 13 日前後,DeepSeek 的對話接口把思考強度做成了可調參數 reasoning_effort。官方適配器 @deepseek-ai/dsh-llm-deepseek 把它落到請求配置裏,可選 off / low / high / max,省略時默認 high;並且明確寫了:agent/request 可以在每一步對話替換這個值。換句話說,插件有正規入口去改下一輪思考檔位,而不用改任務提示詞,也不用改 Harness 源碼。
dsh-tool-turbo 做的就是這件事:看最近幾輪工具調用像不像「簡單、確定的讀寫」,簡單就降到 low,活變重再擡回去。任務本身不用改。
這是什麼¶
dsh-tool-turbo 是一個 DeepSeek Harness 主機插件,維護者是 Electricitysheep,倉庫在 Electricitysheep/dsh-tool-turbo。社區目錄把它歸在「工作流與自動化」,主要語言是 TypeScript,當前版本在 package.json 裏是 0.1.0,要求 Node.js 20 及以上。截至 2026-08-18,目錄頁和 GitHub 都顯示 4 顆星。
它解決的問題很具體:長工具鏈裏,簡單步驟也按高檔思考,牆鍾時間會被思考階段拖住。插件接入 dsh 的 agent/request 瀑布流,根據當前步驟最近的 tool/call 記錄,給下一次模型請求注入它認爲合適的 reasoningEffort。目錄頁的概括是:簡單工具鏈用低檔、重活再提檔,對任務本身零改動。
需要先說清楚生態位置。DeepSeek Harness 官方理念是「一切皆插件」,源碼在 deepseek-ai/deepseek-harness。本文用的檢索入口 deepseek-harness-plugin.com 是獨立的社區目錄,站點自己也寫了:與 DeepSeek、幻方沒有官方從屬或贊助關係,不託管插件代碼,條目只指向維護者倉庫。不要把它當成官方應用商店。
工作原理¶
官方 LLM 適配器在每一步都會重新解析請求配置。dsh 的 agent 循環允許插件在 agent/request 裏提出下一輪的 GenerateOptions(插件源碼指向 packages/core/agent-loop/src/agent.ts 的 buildRequest)。dsh-tool-turbo 掛在這個入口上,流程可以分成三步。
1、觀察。從當前會話的 session.events 裏,倒序收集最近的 tool/call 記錄,窗口大小是 8 條,再按時間正序交給決策函數。每條樣本只保留工具名和參數字符長度,不改工具參數本身。
2、決策。純函數 decideEffort 根據最近調用的「簡單工具佔比」和「最重載荷」選出 low / high / max。源碼把「簡單、確定」的工具名做成正則,前綴包括 fs、bash、read、write、grep、glob、edit 以及常見的 ls / cat / mkdir 等;參數字符數達到 800 就不算小載荷。這段邏輯沒有外部依賴,倉庫用 Vitest 單獨測。
3、注入。監聽器先 await next() 拿到下游已經拼好的請求配置,再覆蓋其中的 reasoningEffort,並打一行 [tool-turbo] agent/request: ... 日誌。任務提示、工具列表、會話內容都不動。
同一份插件還掛了 agent/tool,在工具 start / end 之間記牆鍾耗時,寫到 host 日誌。README 路線圖裏,「把耗時呈現在 UI / agent 上下文」還沒做,目前只能在日誌裏看。
決策策略¶
決策表以 README 爲準,並和 src/effort-decision.ts、tests/effort-decision.spec.ts 對過。規則可以記成下面幾條。
| 最近的工具調用 | 決策 |
|---|---|
| 無(全新提示,還沒有工具調用) | 保持用戶選擇的檔位 |
| 至少 75% 是簡單工具、參數較短,且允許降檔 | low |
| 混合工具或重工具,且允許升檔 | high |
| 單次參數達到約 3200 字符(源碼閾值是 800×4),且允許升檔 | max |
| 其他 | 保持用戶選擇的檔位 |
默認配置在 src/index.ts 的 DEFAULT_CONFIG 裏:
enabled:true(插件加載後默認工作)allowDowngrade:true(允許從基線往下降)allowUpgrade:false(默認不升到max,偏保守)baseline:high
README 把這三個開關稱爲規劃中的 settings 命名空間(走 dsh-settings)。路線圖對應項仍是未完成,所以現在不要指望有一塊現成的設置面板;若要改開關,需要看 Cordis 插件配置怎麼傳到 apply(ctx, config),而不是把它寫成已經交付的 UI。
單元測試覆蓋了幾件關鍵行爲:全新提示保持基線;bash / fs_read / fs_write 這類小參數調用會降到 low;關掉 allowDowngrade 後不再降檔;超大載荷只有在 allowUpgrade 打開時才升到 max;web_search、mcp__db 這類混合調用會抬到 high。倉庫聲稱 6/6 測試通過,並且 tsc --noEmit 乾淨。README 還貼過真實 dsh 實例裏的日誌:基線 high、尚無工具調用時保持 high,出現 write 之後變成 low。
源碼註釋裏,作者認爲簡單任務大約九成牆鍾時間花在思考階段,並把 high 降到 low 可能把思考時間縮到原來的幾分之一。這是倉庫作者的判斷,本文沒有獨立複測,當背景說明即可,不要當成已經公佈的基準成績。
安裝與啓用¶
社區目錄頁給出的安裝命令如下,在 DeepSeek Harness 終端裏運行即可:
dsh plugin add github:Electricitysheep/dsh-tool-turbo
dsh CLI 會從 GitHub 解析插件並裝進當前配置。目錄頁同時提醒:如需可復現安裝,請固定 commit 哈希。截至 2026-08-17,倉庫 main 最新提交是 d29e7d9d73032516e37797ea69592ce18e0fe05f(這次提交補上了 dsh.bundle 清單和 cordis.patch.yml,以便走 dsh plugin add)。固定寫法是:
dsh plugin add github:Electricitysheep/dsh-tool-turbo#d29e7d9d73032516e37797ea69592ce18e0fe05f
倉庫自帶的 cordis.patch.yml 會插入 id: dsh-tool-turbo、name: dsh-tool-turbo。README 裏還有一套本地 clone + link: 註冊到 ~/.dsh/profiles/web 的寫法,適合改源碼調試;那份說明裏的插件 id 寫成了 tool-turbo,和倉庫文件不一致,以 cordis.patch.yml 原文爲準。README 也寫了:headless / TUI 等其它 profile 的安裝文檔還在路線圖上,目前示例以 web 爲主。
安裝後按 README 重啓對應 profile,例如:
dsh web
package.json 聲明的 peer 依賴是 @deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-agent 與 @deepseek-ai/dsh-settings 的 ^0.1.0-rc.6。dsh 仍處於開發者預覽,核心插件和 API 會繼續變,裝之前應對一下本機 Harness 版本。
典型用法¶
這個插件沒有單獨的「開始加速」命令。裝上並重啓之後,照常給智能體派活即可。它只在已經出現工具調用的步驟上改下一輪思考檔位;第一條用戶提示、還沒有任何 tool/call 時,會保持你選的基線。
適合拿來觀察的,是那種會連續 read / write / grep / bash 的倉庫任務:改幾個文件、搜一圈符號、再跑一條短命令。按默認策略,這類小參數、高簡單工具佔比的輪次會被降到 low。一旦後面出現 web_search、MCP 類工具,或參數變得很長,決策會停止降檔;若你顯式打開 allowUpgrade,特別重的載荷纔可能升到 max。
要確認它在工作,看 host 日誌裏有沒有類似下面的行(README 提供的真實運行記錄):
[tool-turbo] agent/request: baseline=high calls=[] => reasoningEffort=high
[tool-turbo] agent/request: baseline=high calls=[{"name":"write",…}] => reasoningEffort=low
工具耗時則是另一類日誌,格式是 [tool-turbo] tool <callId> took <ms>ms。
適用場景與注意事項¶
更適合已經在 dsh 裏跑長工具鏈、且大量步驟是讀文件、寫文件、搜索、短命令的人。它不替代模型選擇,也不改工具實現,只是把「這一輪到底要不要高檔思考」從固定配置變成按最近工具調用自動選。
下面幾件事安裝前要心裏有數。
1、插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。目錄頁把這條寫在安裝區,安裝前應自己打開源碼和許可證,而不是隻看簡介。package.json 與 README 聲明許可爲 MIT;GitHub 倉庫元數據目前沒有識別到獨立的 LICENSE 文件,若合規上需要文件級聲明,應向倉庫確認。
2、默認不允許升檔。allowUpgrade 爲 false 時,混合工具不會自動抬到 high(會保持你選的基線),超大載荷也不會自動變成 max。想讓重活主動加思考,需要改配置,不能假定裝上就會全程自適應到 max。
3、「簡單工具」是按名字前綴判斷的。web_search、各類 mcp__... 不在簡單集合裏;參數一長,即便名字看起來像文件工具,也不會按小載荷處理。策略是啓發式,不是對任務難度的精確分類。
4、settings 面板、UI 裏的耗時展示、非 web profile 的安裝說明,README 路線圖裏都還沒勾完。當前能覈實的是:決策核心、瀑布流注入、host 日誌遙測。
5、reasoning_effort 最終還要過官方適配器的校驗。適配器把 off 做成關閉思考,low / high / max 纔會作爲官方的 reasoning_effort 發出去;不支持的值會在髮網前以 UNSUPPORTED_REASONING_EFFORT 失敗。這個插件注入的是後三檔。若部署把思考鎖成 thinking: disabled,再注入 low 也沒有意義。
小結¶
dsh-tool-turbo 把 DeepSeek 已經提供的思考檔位,接到了 dsh 每一步都會走的 agent/request 上:簡單工具鏈降到 low,重活再考慮擡回去,任務提示不用改。它是社區維護的早期插件(0.1.0,星標 4),設置項和界面還沒做完,但安裝命令、決策表和源碼路徑都可以在目錄頁與 GitHub 上對上。
目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-tool-turbo/
GitHub:https://github.com/Electricitysheep/dsh-tool-turbo