前言¶

DeepSeek Harness 的插件生态允许开发者扩展功能。在使用非官方 DeepSeek API（例如 GLM 或网关）时，默认的内置 web_search 工具常因鉴权配置问题返回 401 错误，导致无法完成联网检索。dsh-plugin-search 插件专门针对这一场景，提供了一套无需复杂配置的解决方案。

插件定位¶

dsh-plugin-search 是一个为 DeepSeek Harness 设计的联网工具插件，由用户 shinjiyu 维护。其核心定位是在不依赖官方 DeepSeek API 的环境下，通过零配置的方式接管 web_search 工具，绕过鉴权限制，实现正常的网页搜索。

核心功能¶

• 零配置启动：安装后无需额外配置即可运行。
• 接管内置工具：自动关闭官方的 web-search-deepseek 机制，避免冲突。
• 保持兼容性：工具名称保持为 web_search，与现有工作流无缝衔接。
• 支持无 Key 模式：默认支持 Tavily 的 keyless 模式，无需 API Key 即可使用。
• 修复鉴权错误：正确配置后，将返回搜索结果链接，而非 401 错误。

安装与启用¶

1. 执行以下命令安装插件：

dsh plugin --profile web add github:shinjiyu/dsh-plugin-search

2. 安装完成后，重启 dsh web 进程。

注意：旧会话的工具表在重启后不会自动更新，新会话将自动使用新插件。

典型用法¶

1. 环境变量配置：

   • 如果拥有 Tavily 账号，请设置环境变量 TAVILY_API_KEY。
   • 如果没有账号，保持不设置该变量，插件将使用 keyless 模式。

2. 模型与 Key 设置：

   • 确保主模型使用的是非官方 DeepSeek API（如 GLM 或网关）。
   • 不要设置 DEEPSEEK_API_KEY。

3. 功能验证：

   • 在对话中询问关于 DeepSeek Harness Discussions 的最新内容。
   • 若插件生效，web_search 将返回搜索结果链接，而非 401 错误。

注意事项¶

• 不要修改系统文件：请勿修改 runtime/ 目录或官方的 web-search-deepseek 插件文件。
• 定位限制：请勿将其宣传为搜索引擎全家桶。
• 社区状态：对应的微信群二维码已于 2026-08-22 过期。
• 会话更新：旧会话的工具表不会在重启后自动更新，需开启新会话。

结尾¶

dsh-plugin-search 解决了在使用第三方 API 时 web_search 被鉴权限制的痛点。项目基于 MIT 许可证开源，源码托管在 GitHub，供需要集成第三方 DeepSeek 服务的开发者参考。

• 项目主页：https://github.com/shinjiyu/dsh-plugin-search