前言¶
DeepSeek Harness（DSH）裏 compaction 閾值、緩存策略、模型側重試與工具調用開銷，並沒有一套放之四海皆準的配置：長會話和短問答不同，500k 窗口與 1M 窗口模型的「甜點」也不一樣。手工翻日誌、對照 preset 改 cordis.patch.yml，既費時間，也很難按模塊把「現狀—要不要改—改成什麼」說清楚。
下面介紹社區插件 dsh-tuner（維護者 doctorllll，分類：工作流）。它只讀取本機 profile 下的會話數據，在本地計算建議，默認不改你的配置；需要時可在 compaction 策略上 一鍵 把按模型的閾值寫入當前 agent preset。
這是什麼¶
dsh-tuner 面向已在用 DSH 桌面端或 dsh web 的開發者：基於你自己的 session，按模塊回答三個問題——現在怎樣、要不要動、動成什麼樣。面板 UI 爲中文；無 UI 時可用 /tuner 斜槓命令輸出與面板相同的文本報告。
當前 release 爲 v0.5.2（MIT 許可證）。在 DSH 0.2.2-rc.1 上已驗證（桌面 desktop profile 與 dsh web）。
核心功能¶
概覽頁一屏展示各模塊；點擊卡片可看結論、數據表、重放拆解與術語說明，並跟隨應用明暗主題。
| 模塊 | 回答的問題 | 產出 |
|---|---|---|
| Compaction policy | 各模型應在什麼比例觸發 compact？會不會剛壓完又立刻再壓（「跑步機」）？ | 一鍵寫入活動 agent preset 的 compaction-basic.modelPolicies |
| Compaction health | 真實 compact 的失敗與原因、耗時；按當時生效的閾值評判，區分已修復問題與當前問題 | 配置片段建議 |
| Cache | 緩存命中率與請求間隔；保活是否值得做 | 結論 |
| Model side | 按模型看重試原因、推理力度、生成速度；高力度下是否 idle 超時集中 | 建議（力度在模型選擇器裏改） |
| Tools | 各工具調用次數、失敗原因、輸出體積；hook 開銷 | 可複製的 AGENTS.md 句式 |
默認行爲與寫入範圍（來自官方說明）：
- 默認只讀：通過 DSH 的 session 查詢服務讀本會話，本地計算；不調用模型、不上傳、不走外網。
- 僅在點擊「應用」時寫入：改 profile 的
cordis.patch.yml中默認 agent preset 的一行compaction-basic；寫回校驗，失敗則回滾；preset 上你的其它修改保留。 - 不改：模型選擇、reasoning effort、AGENTS.md、hook 配置——這些僅給建議和可複製文案。
- 啓動時：若 preset 覆蓋裏含有當前 DSH 已不再自帶的行（升級後常見），會在新默認上重建覆蓋，保留你改過的行，面板會提示被丟棄或新增的行。
安裝與啓用¶
安裝前請注意：插件在 當前 dsh 進程的權限 下運行，安裝前應自行查看 GitHub 倉庫 源碼與 MIT 許可證。
通用命令（將 <profile> 換成你的 profile，例如 desktop）：
dsh plugin --profile <profile> add github:doctorllll/dsh-tuner#v0.5.2
桌面應用在 macOS 上僅接受應用內自帶的 CLI；PATH 上的 dsh 會提示由 Electron 應用獨佔管理。可先退出應用，執行：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:doctorllll/dsh-tuner#v0.5.2
再重新打開應用。在 dsh web 中安裝後需刷新頁面。側欄會出現 「調優 v0.5」（Tuner）入口。
卸載：
dsh plugin --profile <profile> remove dsh-tuner
已寫入 preset 的閾值不會隨卸載自動恢復；若需默認值，先在面板點 「恢復 preset 默認」 再卸載。
典型用法¶
- 在側欄打開 「調優」，選擇統計窗口（最近 7 / 14 / 30 天）。
- 看概覽配色：橙色表示值得調整，藍色表示數據尚不足，綠色表示現狀可接受。
- 打開 Compaction policy 卡片，查看各模型的 replay 表；若認同建議，點 「應用按模型建議」。
- 寫入的配置 僅對新會話生效；已打開的會話需執行
/compact或重新打開。 - 隨時可在面板 恢復 preset 默認。
無界面時，執行 /tuner 可得到與面板一致的文本報告。
適用場景與注意¶
適合誰：長期用同一 DSH profile、會話形態多樣（長任務 vs 快問），希望用本機真實用量校準 compaction 閾值，並順帶審視 cache、模型側與工具側指標的人。
侷限（README 原文要點）：
- Replay 爲估算而非重跑；摘要質量變化未建模；壓檔後的 floor 取實測中位數，異常大的 turn 可能偏高。
- 不含 subagent 會話；含 fork（共享歷史只計一次）；少於 3 次 request 的會話跳過。
- Preset 覆蓋在 DSH 語義下是完整配置：上游僅改既有行的默認值時，覆蓋不會自動跟隨。
- 不提供 cache 保活實現，只判斷「是否值得裝」這類插件。
建議如何算出來、preset 覆蓋爲何會重建，見倉庫內 docs/DESIGN.zh.md（中文）。
結尾¶
dsh-tuner 把「按真實 session、分模塊、本地算建議」和 compaction 閾值的一鍵落盤放在一起，減少猜配置的成本；其它模塊仍以只讀建議與可複製文案爲主。DSH 生態理念是「一切皆插件」，社區目錄由獨立站點維護，與 DeepSeek / 幻方無官方從屬關係。
- 目錄頁：https://www.skillhub.cn/plugins/doctorllll/dsh-tuner
- GitHub：https://github.com/doctorllll/dsh-tuner
- 問題反饋：https://github.com/doctorllll/dsh-tuner/issues
