前言¶
在 DeepSeek Harness（DSH）里做需要实时信息的任务时，模型往往只能依赖训练数据或你手动粘贴的网页内容。若要为智能体接上联网检索，常见做法是单独申请各搜索引擎或聚合服务的 API key，再写一层调用与结果合并逻辑，部署和维护成本都不低。
下面介绍社区插件 dsh-tool-websearch（维护者 leolee9086，分类：联网工具）。它在 DSH 内提供多引擎并发搜索、结果去重与评分，以及浏览器侧结果卡与进度展示，搜索实现无需自备 API key。
这是什么¶
dsh-tool-websearch 是独立的 DSH 多引擎搜索插件：通过 Host 工具 web_search_meta、web_search_status、web_search_proxy 与浏览器搜索结果卡，直接调用 DuckDuckGo、Bing、Google、百度、搜狗等约 200 个搜索引擎（完整清单由 web_search_status 报出）。并发执行、结果去重聚合，并按引擎权重与时效性评分。搜索逻辑移植自 s-code，构建期打包为 lib/search.bundle.mjs，运行时零 npm 依赖，仅通过 Cordis 服务契约与 DSH 交互。
- 目录页：skillhub.cn/plugins/leolee9086/dsh-tool-websearch
- 源码：github.com/leolee9086/dsh-tool-websearch
- 许可证：MIT
- 当前包版本（资料）：0.1.1
核心功能¶
Host 工具¶
模型侧可调用三个工具：
- web_search_meta：发起元搜索，可指定查询词与引擎列表。
- web_search_status：查看可用引擎、权重、超时、速率限制、缓存与各引擎健康状态。
- web_search_proxy：查看或切换本地代理（例如探测
127.0.0.1:7890等）。
浏览器侧¶
搜索结果在浏览器中以结果卡展示，各引擎进度显示在同一张卡片上；代理开关位于会话输入区左侧。
HTTP 接口（Web 环境）¶
GET /api/dsh-websearch/progress?sessionId=…&callId=…：读取某次调用的运行进度（需sessionId与callId，不提供列表查询；沿用 DSH 登录与 Host/Origin 检查）。/api/dsh-websearch/proxy：查看或切换代理。
运行中的结果卡约每 500ms 轮询进度接口；最终检索文本仍通过工具返回值写入会话，历史结果卡读取该结果。进度仅保存在插件实例内存中，进程重启或插件卸载后不恢复。
安装与启用¶
环境要求：Node.js 22.19.0 或更高、pnpm，以及兼容的 DeepSeek Harness Web 环境。
方式一：在 Web profile 中按 git 依赖安装¶
在 DSH Web profile 目录（默认 ~/.dsh/profiles/web，Windows 通常为 %USERPROFILE%\.dsh\profiles\web）执行官方命令（带标签，避免版本随分支漂移）：
pnpm add "github:leolee9086/dsh-tool-websearch#v0.1.1"
构建产物 lib/（含 search.bundle.mjs）已随仓库提交，装完即可用，无需额外构建。
在该 profile 的 cordis.patch.yml 中注册插件。若已有 insert 列表，只追加一项，勿重复注册：
- insert:
- id: dsh-tool-websearch
name: dsh-tool-websearch
包内自带 cordis.patch.yml，也可作为 bundle 挂载：
- name: dsh-tool-websearch
方式二：放入插件目录¶
将整个目录放进 $DSH_HOME/plugins/。开发时同样可放该路径后重启 dsh。
完成配置后重载插件或重启 DSH，并刷新浏览器页面。
典型用法¶
在对话中让模型调用工具，示例（来自 README）：
web_search_meta(query="rust async runtime 对比", engines=["duckduckgo","bing","baidu"])
web_search_status() # 可用引擎、权重、超时、速率限制、缓存与健康状态
web_search_proxy() # 查看/切换本地代理（探测 127.0.0.1:7890 等本地代理）
先用 web_search_status 确认当前网络下哪些引擎可用；境外引擎在部分环境下需代理，可用 web_search_proxy 处理。
适用场景与注意¶
适合谁：在 DSH Web 环境中开发或运行智能体、需要免 API key 的多源网页检索，并希望在浏览器里看到分引擎进度与聚合结果卡的开发者。
运行权限：插件以当前 DSH 进程权限发起对外 HTTP 请求。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认行为符合你的安全与合规要求。
已知边界（README 摘要）：
- 结果卡依赖 DSH 会话快照与结果卡结构，DSH 大版本升级时插件可能需要跟进；DSH 插件接口仍处预发布阶段。
- 进度为临时展示状态，不写入会话投影；重启或卸载后历史调用无进度回放。
- 部分引擎在特定网络下不可用；以
web_search_status健康状态为准。 - 界面文案目前为简体中文。
社区插件目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本包是其中一项联网工具实现。
结尾¶
dsh-tool-websearch 把约 200 个搜索引擎的并发检索、去重与评分收进 DSH 的三个 Host 工具与 Web 结果卡，安装命令与 Cordis 配置以 README 为准。需要细节、测试说明与 HTTP 行为时，请直接查阅仓库文档。
