在使用 DeepSeek Harness (DSH) 進行智能體開發時,針對不同模型的特性進行鍼對性調優是常見需求。對於 zhipuai/glm-5.3-flash 這類模型,直接使用通用預設容易出現推理長尾或工具調用空轉等問題。dsh-glm-mode 是爲此類模型設計的專用插件,旨在提供一套開箱即用的預設方案與防護機制。
插件概況¶
這是一個爲 zhipuai/glm-5.3-flash 量身定製的 DSH 編碼 Agent 預設插件。它包含程序化工具調用(PTC)、GLM 專屬自動壓縮以及針對推理死循環和工具空轉的雙重防護。該插件由 hoyyang 維護,採用 MIT 許可證。
核心功能¶
插件主要解決 GLM 系列模型在複雜任務中的穩定性與效率問題:
- PTC 程序化工具調用:將全量工具目錄整合進 Code Mode,模型通過編寫 TypeScript 程序組合多步操作。相比傳統方式,可減少往返輪次和 input token。
- 思考死循環守衛:針對 GLM-5.3-flash 在高推理檔位下可能出現的長推理退化(如單步重複思考數萬 token),在後臺檢測句子級重複。一旦觸發,提前截斷並複用輸出 token 上限鏈路,通過注入“繼續”消息恢復運行。
- 工具空轉守衛:在 PTC 模式下防止模型幻覺頂層工具並連發佔位調用。檢測到連續佔位調用後,通過官方決策通道注入糾偏消息,將模型拉回正軌,而不截斷正常流。
- GLM 專屬自動壓縮:針對 1M 上下文場景,按 75% 閾值 / 22% 保留的比例進行自動壓縮,支持原地摘要無縫續跑。
- 原生多模態:預設聲明支持 text+image 輸入,可直接處理截圖。
安裝與啓用¶
安裝
dsh plugin add dsh-glm-mode
安裝後需重啓 DSH 或進行熱重載。
啓用
在新建會話中:
1. 在預設選擇器中選擇「GLM 模式」。
2. 在模型列表中選擇 zhipuai/glm-5.3-flash。
此時插件會自動生效,守衛在後臺靜默工作,無需任何額外操作。
配置與日誌¶
插件提供了默認配置,位於 cordis.patch.yml。主要配置項包括:
compactEnabled:自動壓縮開關。glmThresholdRatio/glmRetainRatio:GLM 會話壓縮閾值與保留佔比。loopGuardEnabled/spinGuardEnabled:死循環與空轉守衛開關。loopGuardRepeatThreshold:死循環判定閾值(默認 8)。spinGuardStreakThreshold:空轉判定閾值(默認 5)。
守衛觸發記錄位於 ~/.dsh/dsh-glm-mode/guard-events.jsonl,可用於排查異常。
適用場景與注意¶
- 生效範圍:該插件僅對
zhipuai/glm-*路由的模型生效,其他模型無感知。 - 兼容性:可與 Kiro 模式共存,壓縮策略按官方語義確定。
- 權限安全:插件以當前 DSH 進程權限運行,建議在使用前檢查 GitHub 源碼與許可證。
總結¶
dsh-glm-mode 解決了 GLM 系列模型在長推理和複雜工具調用場景下的穩定性與效率問題。通過這套預設,開發者可以更專注於業務邏輯而非底層模型調優。更多細節請參考 GitHub 倉庫。