前言¶

在 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_research
• verified_json_selection
• verified_json_numeric_extrema
• verified_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