ModSearch 是专为 DeepSeek Harness（简称 dsh）打造的免费联网搜索插件。只需一条命令安装，就能让 dsh 原生的web_search工具直接跑在免注册、免 API key 的搜索引擎链上——不花一分钱，不用注册任何账号，装完即拥有网页搜索、单页抓取和 X 搜索能力。

为什么 dsh 用户需要这款免费搜索插件

如果你用过 dsh，可能遇到过这种情况：模型回答"我没法访问实时信息"，或者原生的web_search需要配置 DeepSeek 的带 key 搜索 API。

ModSearch 以原生 dsh bundle的形式接入（不是靠提示词触发的 skill），一条命令落地三件事：

• web_search换上免费引擎链：dsh 本就自带原生web_search工具和引用卡片，ModSearch 只替换背后的搜索 provider（searchProvider: modsearch），原生引用卡片全部保留，且完全不需要 API key。
• 新增x_search工具：补齐 dsh 没有接缝的 X（推特）语料，Grok Build 登录后可用，网页顶替的结果会明确标注降级，绝不无声。
• 新增read_page工具：把一个 URL 读成结构化证据（摘要、正文、外链、不确定项），默认走 Firecrawl 云端浏览器，能读 JavaScript 渲染的页面。

免费额度开箱就有：默认引擎是 Firecrawl 的免注册通道，每月 1,000 免费 credits，无需账号、无需绑卡。

一条命令安装 ModSearch 插件（最快步骤）

前提：本机已安装 Node.js（运行环境建议 22.13 以上）并配置好 dsh 的 profile。浏览器界面通常使用webprofile，命令里的--profile web请替换成你实际启动的 profile。

在终端执行：

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.6

安装完成后重启 dsh，让插件生效。

💡 两个细节值得注意：

• 为什么点名精确版本号？pnpm 11 默认通过minimumReleaseAge扣住最近 24 小时内发布的版本，@latest可能静默装到旧版本。精确版本号（与 package.json 同步）可以避开这个问题。
• 再次执行同一条命令就是更新：它会用点名的精确版本替换 profile 中记录的安装请求，所以后续升级直接重跑即可。

验证 ModSearch 插件是否装成功

重启 dsh 后，跑两条命令确认真正解析到的内容：

npx -y @deepseek-ai/dsh plugin --profile web list --depth 0 npx -y @deepseek-ai/dsh --profile web --dump-config

第二条命令的输出中，应同时出现searchProvider: modsearch和名为@liustack/modsearch的插件行。这两处检查不调用模型、不消耗额度。

免注册免费额度：web_search 背后的引擎链是怎么跑的

安装后不做任何设置就能开跑：

多个引擎就绪时自动故障转移：一个通道失败或额度耗尽，自动切换下一个；同一引擎还支持逗号分隔的多 key 轮换。引擎配置统一存放在~/.modsearch/config.json（0600 权限，展示时打码），与 dsh 的其它 profile 和 CLI 共用。

不开终端配置引擎：dsh 网页端的设置卡片

dsh 网页端没有终端，插件自带一张设置卡片：

• dsh 0.1.6-alpha.2 及之后：侧栏点开「插件」，进入@liustack/modsearch页面；
• 更早的版本：「设置 → 插件 → 插件配置」中的「搜索引擎（ModSearch）」卡片。

卡片管三件事：首选引擎（自动或指定某一个）、当前引擎的设置（API 密钥、接口地址）、自动引擎链（每个就绪引擎一个复选框，取消勾选即排除该引擎）。保存后立刻生效，改的就是 CLI 那份~/.modsearch/config.json，不用打开任何终端。

装完后的第一次搜索：实测验证

按 dsh 的标准入口启动（npx -y @deepseek-ai/dsh --profile web），然后用三个小问题依次验证：

1. 网页搜索：搜索当前 Node.js LTS 版本并引用来源。—— 应调用原生web_search卡片，背后就是 ModSearch 引擎链。
2. X 搜索：搜索 X 上 @deepseek_ai 最近的帖子。—— 应显示为x_search。
3. 读单页：读取 https://example.com 并总结页面。—— 应显示为read_page。

下面是 dsh web 里的真实搜索效果：问"今天有哪些重要的 AI 新闻"，18 秒返回三条当日消息，每条都带来源链接。

read_page的实测：问"Node.js 现在哪条版本线还在维护"，工具先后读取官网版本页和发布计划表，59 秒给出带版本状态表和来源的结论。

常见问题与插件更新

• 命令报错或搜索失败：先运行离线体检npx -y @liustack/modsearch@5.10.6 doctor，它会报告哪些引擎就绪、哪些需要fix；更完整的成因和解法见故障排查。
• 提示declares no dsh.bundle：装到了旧版 ModSearch，按正文中的精确版本号重装即可。
• 升级到新版 dsh 后：dsh 仍在开发者预览期，建议每次升级后重跑--dump-config兼容性检查，再重跑add命令刷新插件。
• 卸载：npx -y @deepseek-ai/dsh plugin --profile <name> remove @liustack/modsearch。

相关文档

装完之后不需要记任何命令：正常聊天，提出需要查证的问题或给出一个链接，ModSearch 就会自动选引擎、跑搜索或抓取，答案带着来源回来。