在 DeepSeek Harness (DSH) 的工作流中,智能體經常需要對文件內容、配置文件或遠程資源做出斷言。手動驗證這些斷言既耗時又容易出錯。dsh-plugin-verify 提供了一套基於證據的核查工具,用於檢查聲明、驗證配置並探測網絡狀態。
這是一個工作流插件,由 863683348 維護。它旨在解決智能體無法可靠地核實自身行爲或環境狀態的問題。
核心能力¶
插件提供以下幾種覈查模式:
- 證據檢查:針對工作區文件進行關鍵詞提取,並提供行級引用。結果分爲
verified(已驗證)、partial(部分)或unsupported(未找到證據)。 - 配置驗證:對配置文件進行校驗。支持 JSON 的嚴格解析和 YAML 的結構化煙霧測試(檢查引號、括號、縮進)。
- HTTP URL 檢查:探測 HTTP(S) 資源的可用性,包括狀態碼、重定向目標及延遲。
- NPM 包檢查:檢查 NPM 包是否存在、最新版本、manifest 信息及發佈時間。
- GitHub 倉庫檢查:檢查 GitHub 倉庫是否存在、年齡、是否包含
dsh-plugin主題以及提交計數。 - 批量檢查:支持併發運行多種檢查(聲明、配置、URL、包、倉庫),並輸出包含置信度評分的彙總表格。
使用方法¶
插件提供了一系列命令行工具,以下是一些典型用法:
覈查文件中的聲明
verify claim "the plugin pins zod in dependencies"
verify claim "this repo has 12 commits" scope ./some-dir
驗證配置文件
verify config ./cordis.patch.yml
檢查遠程資源
verify url https://example.com
verify npm dsh-plugin-focus
verify repo 863683348/dsh-plugin-gate
批量執行檢查
verify batch claims:["the plugin pins zod"] urls:["https://example.com"] packages:["dsh-plugin-focus"]
注意事項¶
- 只讀操作:插件不會寫入文件,也不會執行被掃描的內容。
- 聲明檢查是啓發式的:這並非數學證明,而是基於關鍵詞的證據查找。
unsupported狀態表示未找到證據,視爲未確認。 - YAML 檢查侷限:YAML 檢查僅是結構性的煙霧測試,不包含完整的 YAML 解析器邏輯。
- 兼容性:工具模式在插件加載時根據
@deepseek-ai/dsh-toolsvalue-schema DSL 進行驗證。早期版本曾存在 JSON Schema 兼容性問題(如schema.required不被支持),修復後可防止 DSH 進程崩潰。如果受影響的版本導致 DSH 無法啓動,請移除插件或升級。
總結¶
dsh-plugin-verify 適合需要在 DSH 工作流中自動化進行代碼審計、配置校驗和資源探測的場景。作爲只讀工具,它可以在不改變文件系統狀態的前提下,爲智能體提供客觀的檢查結果。
- 倉庫地址:https://github.com/863683348/dsh-plugin-verify
- 插件目錄:https://www.skillhub.cn/plugins/863683348/dsh-plugin-verify