前言¶
在 DeepSeek Harness(DSH)裏跑長任務時,主 Agent 的思考鏈路與最終交付往往在同一會話裏完成,事後很難用另一套視角做一致性覈對。常見做法是人工回看日誌,或在提示詞裏要求自我複覈,但前者費時,後者仍受同一模型上下文約束。下面介紹社區插件 dsh-think-guard:用單獨配置的模型旁觀主 Agent 的執行與回覆,並可按需介入建議、審批與交付複查。維護方爲 Stars-ETO,作者在倉庫中署名爲 Wesley.T;SkillHub 分類爲 admin-security,倉庫當前約 1 star(以目錄頁與 GitHub 爲準)。
這是什麼¶
dsh-think-guard 是 DSH 的獨立監察插件,不是獨立可執行程序。它在 DSH 進程內掛載,使用「監察模型」檢查主 Agent 的推理過程與最終輸出;支持對工作區內文檔、圖片做只讀審閱,並在配置允許時對工具調用(含權限相關操作)做審批策略。許可證爲 MIT,當前發行版本在 package.json 中爲 0.2.1,實現面向 DSH 0.2.2-rc.1 接口,其他 DSH 版本需自行驗證。
核心功能¶
觀察與建議¶
- 觀察模式:只記錄監察側結論,不向主會話注入內容。
- 建議模式:在認爲有依據時,可將建議加入主會話;建議被取出不代表主 Agent 已採納。
審批¶
可按策略交給系統、用戶審批、自動審批或完全自主審覈,並配合常規/高頻檔位篩選。只有被 DSH 鉤子捕獲且命中規則的操作會進入審查流程;插件不能代替沙箱,也無法保證覆蓋所有操作。
輸出後複查¶
在主 Agent 準備結束當前輪時,可檢查最終回覆(問答、方案、項目交付等)。可選自動迭代,並設有次數上限。
獨立監察聊天¶
會話標題欄打開「思考監督」後,可使用獨立於主會話的監察聊天:可選擇或粘貼圖片,發送後圖片會出現在聊天記錄中;針對圖片繼續追問時會再次提供給模型(可能產生額外費用)。普通監察聊天不會自動寫入主會話;明確要求轉交時,插件會嘗試注入並報告狀態。
文件檢查¶
按需只讀工作區內的文本、PDF、DOCX、PPTX、XLSX 和圖片;工作區外路徑及指向工作區外的鏈接會被拒絕。圖片檢查依賴所選模型與服務商是否支持圖像輸入。
常規與細緻檢查¶
細緻模式提高預算並對較長文檔分段檢查,會增加調用次數與費用;與審批頻率相互獨立。
安裝與啓用¶
從 npm 安裝時,將 desktop 換成你實際使用的 DSH profile:
dsh plugin --profile desktop add dsh-think-guard
從 GitHub 源碼安裝(README 註明此方式尚待在乾淨 DSH 環境中驗證):
dsh plugin --profile desktop add github:Stars-ETO/dsh-think-guard
安裝後按 DSH 提示重新加載插件或重啓,在會話標題欄打開「思考監督」。本地開發測試需要 Node.js 20.19 或更高,可在插件目錄執行:
npm test
測試使用合成輸入與模擬模型,不代表已驗證所有 DSH 版本或真實模型服務。若通過本地目錄鏈接安裝,README 提到可在 desktop profile 使用 pnpm add "link:<插件目錄絕對路徑>",並將 dsh-think-guard 加入 profile 的 bundle 配置,具體以對應 DSH 版本文檔爲準。
典型用法¶
1、在目標會話開啓監督,選擇監察模型,以及觀察或建議模式。
2、在監察聊天中可通過輸入路徑,請求檢查工作區內的文件(受只讀與工作區邊界限制)。
3、按需配置審批檔位與輸出後複查、自動迭代次數;若啓用完全自主審覈,需理解其對單次沙箱提權請求的處理方式(見下文限制)。
圖片單次最多 3 張,每張不超過 4 MB;不支持圖像輸入的模型會提示未檢查圖片,並可能繼續處理已提取的文字。
適用場景與注意¶
適合誰:希望在 DSH 內爲 Agent 任務增加第二視角、對交付物做文檔/圖片抽查、或對部分工具調用走審批流程的開發者與團隊。監察數據與主會話片段會發往你所選模型服務商並可能計費,適用前請閱讀倉庫「隱私與數據」一節。
運行權限:插件隨當前 DSH 進程權限運行;安裝前應檢查源碼與 MIT 及內置第三方組件(如 vendor/pdfjs/ 等)的許可證聲明。
檢查侷限:文檔提取與模型輸入有大小、頁數、內容及超時限制;細緻模式分段摘要可能遺漏細節。PDF 提取文字及部分嵌入位圖,並非完整頁面渲染;Office 原生圖表、版面與部分媒體可能未被檢查。未提供或未讀到的內容不能視爲已檢查。
自主審覈:完全自主審覈可能接管能與當前工具調用準確關聯的單次沙箱提權請求;單次完整權限允許該次調用訪問整個主機。模型判斷可能出錯,其他系統或插件的拒絕仍然有效。
本地數據:監察聊天與要求按會話保存在 DSH_HOME/think-guard/memory(默認 ~/.dsh/think-guard/memory),可能含敏感信息;公開倉庫與發行包不應包含該目錄。清空界面記錄不等同於撤銷已執行的操作。
結尾¶
dsh-think-guard 把「獨立監察模型」收進 DSH 插件形態:觀察與建議、審批、交付複查、工作區文件與圖片審閱可在同一監督界面配置。社區目錄與源碼入口如下,版本與安裝細節以倉庫 README 爲準。
- SkillHub 目錄:Stars-ETO/dsh-think-guard
- GitHub:https://github.com/Stars-ETO/dsh-think-guard