前言¶
在多智能體系統的長期運行中,重複讀取工具結果、提示壓縮導致規則失效、以及昂貴的模型承擔審查任務,是導致 Token 消耗過高且缺乏可觀測性的常見原因。DeepSeek Harness (DSH) 插件生態旨在通過插件化手段解決這些問題。
插件介紹¶
gongyijie85/dsh-agent-frugality 是一個 DSH 插件,用於防禦多智能體系統的讀取臺賬去重、免疫壓縮規則、完成機械門禁和低成本審查 lane。該插件零外部依賴,通過注入機制即可運行。
核心功能¶
插件提供以下核心能力:
1. 讀取臺賬去重:記錄每個智能體的讀取內容哈希值,將重複讀取的浪費可視化。
2. 免疫壓縮規則:將防禦規則置於不可壓縮的提示區,防止上下文壓縮導致規則丟失。
3. 完成機械門禁:強制完成聲明必須通過驗證,防止無效的完成嘗試。
4. 低成本審查 lane:使用低成本模型對工作進行獨立審查,主模型不審查自身。
安裝與依賴¶
安裝命令如下:
dsh plugin add github:gongyijie85/dsh-agent-frugality
運行環境需要滿足:
* Node.js >= 20
* DSH >= 0.1.0-rc.6
典型用法¶
插件通過以下工具和配置項使用:
* 工具:
* frugality_ledger:讀取臺賬,查看各智能體的讀取、重複和字節消耗情況。
* frugality_gate:完成門禁,驗證完成聲明和退出碼。
* frugality_review:低成本審查,在獨立 lane 執行審查。
* 環境變量配置:
* DSH_FRUGALITY_DEDUP:設置爲 1 時,開啓去重功能(默認爲 0)。
* DSH_FRUGALITY_GATE:設置爲 0 時,關閉完成門禁(默認爲 1)。
* DSH_FRUGALITY_GATE_MAX:門禁異議的最大次數(默認爲 2)。
* DSH_FRUGALITY_REVIEW_MODEL:審查模型 ID,設爲 auto 時使用 CHEAP 家族。
* DSH_FRUGALITY_RULES:自定義規則文件(默認爲內置)。
* DSH_FRUGALITY_LEDGER_CAP:讀取緩存表的最大條目數(默認爲 30)。
* DSH_FRUGALITY_WORKDIR:門禁驗證命令的工作目錄(默認爲當前目錄)。
日誌與存儲¶
插件不存儲內容,僅記錄哈希值。
* 日誌文件位於 $DSH_HOME/agent-frugality.log。
* 臺賬文件位於 $DSH_HOME/agent-frugality-ledger.l。
注意事項¶
- 默認行爲:去重功能(DEDUP)默認關閉,完成門禁(GATE)默認開啓。建議先通過
frugality_ledger觀察基準數據,再決定是否開啓去重。 - 權限與安全:插件以當前 DSH 進程的權限運行。安裝前請檢查源碼與許可證(MIT)。
- 生態定位:該插件填補了共享內存、模型路由和任務編排等插件未覆蓋的空白,專注於讀取去重、完成門禁和廉價審查。
總結¶
dsh-agent-frugality 提供了多智能體系統中的可觀測性與成本控制手段。通過讀取臺賬量化浪費,通過機械門禁約束行爲,通過廉價審查降低成本。
- GitHub 倉庫:https://github.com/gongyijie85/dsh-agent-frugality