前言¶
在 DeepSeek Harness (DSH) 開發中,智能體的行爲安全與正確性高度依賴於“工具面”的配置。開發者在組裝 bundle 時,可能無意中暴露了不應被模型訪問的代碼執行接口或副作用工具。dsh-agent-doctor 旨在解決這一配置審計痛點,通過診斷命令對當前生效的工具表面進行靜態檢查。
插件介紹¶
這是一個輕量級的 DSH 健康與安全診斷插件,由用戶 MkaliezZ 維護。它通過 /doctor 命令檢查接收到的 Agent 的有效模型可見工具表面,並報告邊界配置信號。插件本身不聲稱作爲殺毒軟件、惡意軟件掃描器、沙箱或策略執行邊界。
核心功能¶
插件提供以下檢查項:
1. 工具清單統計:報告模型當前可見的工具數量及具體名稱。
2. 預留接口可見性:檢查保留的 run_code 接口是否對模型可見。
3. 啓發式警告:對名稱特徵明顯帶有副作用傾向的工具發出提示(僅作提示,不攔截)。
4. AgentFuse 檢查(可選):確認 AgentFuse 是否存在。
5. 批准服務信號(可選):檢測批准服務是否可用。
安裝與啓用¶
該插件設計爲 DSH bundle 的形式掛載。在 DSH 配置文件中添加以下片段即可啓用:
- id: dsh-agent-doctor
name: '@mkaliezz/dsh-agent-doctor'
config:
requireAgentFuse: false
典型用法¶
在 DSH 交互界面完成 bundle 組裝後,直接輸入 /doctor 命令即可觸發診斷並查看報告。
適用場景與注意¶
- 適用場景:需要確認 Agent 工具鏈是否包含不應暴露的接口(如代碼執行器),或依賴 AgentFuse 進行混合編排的開發者。
- 注意:
- 本插件以當前 DSH 進程權限運行,不是進程沙箱或策略強制執行邊界。
- 不是殺毒軟件或惡意軟件掃描器。
- 無法通過工具名稱證明工具本身的安全性。
- 無法證明有效配置的不可變性。
- 使用前應檢查源碼與許可證。
結語¶
該插件適合作爲 DSH 環境中的配置審計輔助工具,幫助開發者把控工具面的可見性。插件目錄與源碼倉庫如下: