modsearch

给没有联网能力的模型接上网：Web 搜索、X 搜索与单页读取，免注册、免 API key。

解决什么问题

DeepSeek-V4-Flash 等模型没有（或很弱）的联网能力，查实时信息、抓单页内容都做不了。ModSearch 是一个大幅增强模型联网能力的插件：一条命令装好后，DSH 内置的 web_search 就跑在 modsearch 引擎链上——无需 API key，保留原生引用卡片。默认引擎是 Firecrawl 的无 key 免费档，每月 1,000 免费额度，无需账号与信用卡。

它还把两个 DSH 原本没有的工具带进来：x_search（X / Twitter 搜索）与 read_page（聚焦式单页读取）。配置多个引擎后自动故障切换、先用最快的：某引擎失败或额度耗尽，下一个自动接管，meta.attempts 记录每次尝试，切换从不静默。

核心功能

• 免 key 开箱即用：默认走 Firecrawl Keyless（每月 1,000 免费额度，无注册无卡），所有备用通道也免费
• 多引擎自动故障切换：Firecrawl、Antigravity CLI、Tavily、Exa、Grok (X)、local，best-first，失败自动接管
• 搜索 X（Twitter）：装上 Grok Build 后即可查询 Web 索引覆盖不到的 X 语料
• 单页精读：read_page 对 URL 做聚焦式读取并结构化总结
• 保留原生引用卡片：DSH 内置 web_search 换引擎后引用体验不变
• 一次安装到处可用：同时支持 Claude Code、Codex、Pi、OpenCode

快速上手

一条命令安装（版本号显式命名，便于 pnpm 11 正确解析）：

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

装好即可用，无需任何配置。需要更多免费引擎时，可安装 Antigravity CLI 并登录（curl -fsSL https://antigravity.google/cli/install.sh | bash 后执行 agy），或用一行设置个人额度：modsearch config set tavily.apiKey <key>。密钥存放在 ~/.modsearch/config.json（0600 权限，展示时打码），也可从 TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY 环境变量读取。

适合谁

• 用无联网（或弱联网）模型跑 DSH、需要可靠联网检索的研究与开发用户
• 想要 X 搜索和单页精读、且不想为搜索服务付费配 key 的用户
• 需要多引擎冗余、追求”一个挂了另一个顶上”的稳定检索用户