[社群外掛] dsh-plugin-verified-search：補強 web_search 的時間／來源約束與結構化來源驗證（rc.6）

[f0909172434]

大家好，分享一個針對「最新／目前／截至某日」搜尋情境的 DeepSeek Harness 社群外掛：dsh-plugin-verified-search。

目前版本為 v0.1.1，相容目標是 Harness 0.1.0-rc.6，採 MIT License。

這是獨立維護的社群外掛，不是 DeepSeek 官方修復或官方推薦套件。

它解決什麼問題？

我在 #332 遇到的情況是：要求 Harness 比較「目前最新的旗艦模型」時，搜尋流程可能引用其他公司的舊代模型，最後產生看似完整、實際時間基準不一致的比較。

這不只是搜尋結果偶爾不同，而是目前流程同時存在幾個缺口：

• 出廠 composition 沒有掛載已經存在的 dsh-time-context（#344）；
• web_search 會另外啟動一個獨立的 DeepSeek Messages 搜尋回合，這個回合不會自動繼承外層 agent 的時間與證據要求；
• 原工具只有 query，模型無法指定第一方來源範圍；
• 預設沒有安全的全文 fetch 路徑，缺少 excerpt 時仍容易把標題或 URL 當成已驗證內容。

此外掛不是更換搜尋引擎，而是把這段流程改成可以檢查、可以安全失敗的 verification workflow。

外掛做了什麼？

• 掛載 [Feat] 模型收不到当前时间，web_search 参数停留在训练截止年份 —— 已修复，分支可 cherry-pick #344 使用的 time context，每 60 秒更新一次；
• 對原本具備 web_search 的 agent，以 verified_search 取代舊工具；沒有搜尋能力的 minimal preset 不會被額外擴權；
• 工具參數支援 query 與選用的 allowed_domains；
• 要求可變事實使用絕對日期，先做第一方來源 pass，再另做 unrestricted comparison pass；
• 將 allowed_domains 傳入 DeepSeek 原生 web_search_20250305，並在 prompt 中再次寫明；
• 在本機依 exact hostname／subdomain 過濾回傳的結構化來源，再套用結果數量上限；
• 回報 filteredOut 數量；所有來源都被移除時維持 unresolved，不拿舊版本補表；
• 不採用搜尋服務生成的 prose，只保留結構化來源與 citation excerpt；
• 缺少 excerpt 時降低信心並明確揭露沒有完成全文核驗。

安裝

dsh plugin --profile web add github:f0909172434/dsh-plugin-verified-search#v0.1.1
dsh --profile web --dump-config
dsh web

此外掛提交了已審查的 lib/，沒有 install-time build script；以 Git tag 安裝不需要 allowBuilds。

若你的 composition 已經自行掛載 #344 的 time-context，請在啟動 Harness 前設定：

$env:DSH_VERIFIED_SEARCH_DISABLE_TIME_CONTEXT='1'

回滾：

dsh plugin --profile web remove dsh-plugin-verified-search
dsh web

使用範例

第一方來源核驗：

{
  "query": "DeepSeek current flagship model as of 2026-08-14",
  "allowed_domains": ["deepseek.com"]
}

之後再執行另一個不設 allowlist 的查詢，取得獨立比較來源。若找不到同一日期下的目前版本，prompt policy 會要求保留缺口，而不是拿舊代模型替代。

真實 DeepSeek API 實測

我透過 Harness 0.1.0-rc.6 的真實 headless composition 與真實 DeepSeek Anthropic-compatible Messages endpoint 測試：

{
  "query": "DeepSeek 官方 API 目前可用模型名稱，截至 2026-08-14",
  "allowed_domains": ["api-docs.deepseek.com"]
}

即使搜尋服務收到原生 allowlist，仍回傳了 7 個越界的結構化來源。外掛在本機移除全部 7 個來源，保留 8 個符合 api-docs.deepseek.com 的來源，並回報 filteredOut: 7。

這 8 個來源都沒有 citation excerpt，所以 agent 最後明確回報「目前模型名稱仍 unresolved」，沒有用模型記憶補答案。對這類問題，我認為誠實地沒有答案，比產生時間基準錯誤的完整比較更安全。

驗證狀態

• 45 個單元與 lifecycle tests 全數通過；
• tag CI 4/4 全綠：Ubuntu／Windows × Node 22.19／24；
• 全新 DSH_HOME 的 tag 安裝、composition readback 與 HTTP 200 boot smoke 通過；
• 真實 DeepSeek 搜尋服務呼叫通過；
• Release package SHA-256：80bcf73347222ae20ab70ea4e645d92f71c36b442aa52850b707040a6e961f55。

限制

allowed_domains 保證的是外掛最後回傳之結構化來源 hostname。它不是搜尋服務 candidate pool、內部推理、redirect、網路出口、生成文字或 factual freshness 的安全邊界，也不適合當作隱私或法遵隔離機制。

外掛仍無法證明上游 index 一定收錄最新頁面，也無法把沒有 excerpt 的 URL 變成完整證據。搜尋 query 會成為 Harness durable session data，請勿在 query 中放入 API key、token 或私人資料。

連結與回饋

• Repository：https://github.com/f0909172434/dsh-plugin-verified-search
• Release：https://github.com/f0909172434/dsh-plugin-verified-search/releases/tag/v0.1.1
• 問題分析與核心修補：Discussion #332
• Core patch commit：f0909172434@ce4d045

歡迎協助測試其他 query、Windows／Linux profile 與 provider 回傳形狀。如果遇到 credential leak 或 allowlist bypass，請使用外掛儲存庫已開啟的 private security advisory 回報，不要把 API key、signed URL 或原始 session log 貼到公開 Discussion。