前言¶
在 DSH 裏做智能體任務時,如果模型繼承了 web_search,它可以直接返回答案。但在處理可變事即時,更關鍵的是:允許哪些來源、保留了哪些證據、JSON 選擇是否確定、哪些地方仍未解決。
dsh-plugin-verified-search 面向這類問題:它把智能體繼承的 web_search 替換爲有邊界的工作流,讓來源範圍、保留證據、確定性 JSON 選擇和未解決缺口可見。
這個插件會驗證工作流和結構化來源的後置條件,設計上是 fail closed 或保持顯式 unresolved。它不證明發布者真實,也不保證上游搜索索引是最新的。
這是什麼¶
f0909172434/dsh-plugin-verified-search 是 DeepSeek Harness 的一個插件,定位爲 Verified current-source search workflow for DeepSeek Harness。它由 f0909172434 維護,許可證爲 MIT。
穩定版 v0.1.1 只包含 verified_search,適合一次窄可變事實查詢。它會做結構化來源主機名後置過濾,並讓引用摘錄缺口可見。
實驗快照 0.3.0-experiment.0 額外包含:
verified_researchverified_json_selectionverified_json_numeric_extremaverified_json_projection
實驗快照只用於開發和評估。做可復現測試時,不要用 moving main 替換固定 commit。
核心能力¶
verified_search 的目標不是擴大搜索能力,而是把一個查詢約束到可覈對的範圍。下面這些點會被顯式保留在結果邊界裏:
- 來源範圍:對返回的結構化來源主機名做後置過濾;
- 保留證據:哪些摘錄被保留爲證據;
- 確定性 JSON 選擇:避免只憑文本語義做隱含選擇;
- 未解決缺口:沒有答案摘錄時保持 unresolved,而不是用舊答案或記憶補全。
實驗工具面向更多 JSON 選擇與投影任務,例如 verified_research、verified_json_selection、verified_json_numeric_extrema 和 verified_json_projection。由於它們仍在實驗快照中,生產使用前應先確認版本邊界。
安裝與啓用¶
先確認前置條件:
- DeepSeek Harness
0.1.0-rc.6 - Cordis
4.0.1 - Node.js
22.19.x或24.x - 可通過 Harness credential service 或啓動環境提供
DEEPSEEK_API_KEY - 已有 search-capable preset
平臺方面,CI 覆蓋 Ubuntu 和 Windows;macOS 不在當前 support contract 內。
先安裝穩定版,再 dump config,最後啓動 web:
dsh plugin --profile web add github:f0909172434/dsh-plugin-verified-search#v0.1.1
dsh --profile web --dump-config
dsh web
一條命令寫法:
dsh plugin --profile web add github:f0909172434/dsh-plugin-verified-search#v0.1.1; dsh --profile web --dump-config; dsh web
如果部署已經掛載了 Discussion #344 的 time-context 行,在啓動 Harness 前設置環境變量:
export DSH_VERIFIED_SEARCH_DISABLE_TIME_CONTEXT=1
典型用法¶
向 search-capable agent 提出有邊界、絕對日期的問題。例如:
Find DeepSeek’s current flagship API model as of 2026-08-14. Use only
api-docs.deepseek.com.
對應的 verified_search 參數是:
{
"query": "DeepSeek current flagship API model as of 2026-08-14",
"allowed_domains": ["api-docs.deepseek.com"]
}
這裏的 allowed_domains 是返回結構化來源主機名上的後置條件,不是網絡出口或隱私邊界。
適用場景與注意¶
適合:
- 需要把當前事實查詢限制到指定主機名;
- 需要看到保留證據和 citation-excerpt 缺口;
- 需要在實驗環境中評估 JSON 選擇、數值極值、JSON 行投影等擴展工作流。
不適合或需要警惕:
- 把插件結果當成發佈者真實性的證明;
- 假設上游搜索索引一定最新;
- 把域名過濾當作網絡出口控制或隱私邊界;
- 在生產可復現鏈路中使用 moving
main。
驗證方面,外部獨立驗證缺失。倉庫提供內部確定性測試、CI、package-reproducibility checks 和 maintainer-run conformance evidence。這些不是第三方評審。
安全上,該插件以當前 dsh 進程權限運行。安裝前建議檢查源碼、依賴與 MIT 許可證,並確認 allowed_domains 的後置過濾不會替代你需要的安全邊界。
參考¶
- 社區目錄頁:https://www.skillhub.cn/plugins/f0909172434/dsh-plugin-verified-search
- GitHub:https://github.com/f0909172434/dsh-plugin-verified-search