一、 悬案:为什么我的 DeepSeek API 被频繁扣费?
2026-11-10 更新:本文发布后,社区出现了成熟的免费搜索插件 dsh-free-search,本机已实测可用,现在首推方案是直接装插件(见第四节)。文末的自建 MCP 方案保留,作为不依赖第三方插件时的进阶备选。
最近在使用 DSH 进行项目开发时,我们在后台监控到了极其异常的 API 调用波形:
- 高频消耗:在昨天下午和今天上午,累计产生了近数百次官方 API 请求;
- 高度重合:消耗的时间窗口与开发者本地活跃敲代码、执行 Agent 任务的时间 100% 严密对齐;
- 极度异常的缓存命中率:在 DeepSeek 开发者后台,这些调用的 Prompt Cache 命中率竟不足 10%!这意味着绝大多数调用都在以全额原价计费。
起初我们怀疑是:
- 模型路由名称配置混淆?(比如某些反代渠道带有
deepseek/前缀导致误匹配到官方渠道) - 或者是 API Key 泄露?
但在全量解包分析了 DSH 的本地底层会话日志(多帧 Zstandard 压缩格式)后,排查结果令人大吃一惊:所有常规对话、子代理对话走官方渠道的次数居然是 0 次!
那么,扣费到底从何而来?
二、 破案:揭开内置 web_search 的“Token 刺客”面目
翻阅 DSH 源码中负责网络检索的包 @deepseek-ai/dsh-web-search-deepseek,我们在其核心逻辑中找到了真相:
| |
痛点根因:
- 它不是专用搜索引擎,而是一次完整的 LLM 推理(Model Turn):
- 很多开发者以为内置的
web_search是像 Google Custom Search 或 Bing API 那样按“次”计费(比如几厘钱查一次); - 但 DSH 默认捆绑的搜索机制,是启动一个
deepseek-v4-flash大模型,让模型调用服务端工具抓取网页,再把抓到的海量网页内容塞回给模型阅读并输出摘要。
- 很多开发者以为内置的
- 为什么缓存命中率不足 10%?
- 官方模型的上下文缓存(Cache Hit)要求有较长且相同的历史前缀(Prefix Cache);
- 但这个搜索插件每次发出的请求都是冷启动的独立单句(
Perform a web search for the query: [全新关键词]),没有任何历史上下文复用; - 结果就是:抓回来的网页 Token 全额按原价计费,每次检索都在狠狠燃烧你的官方账户余额!
- 静默调用,账本不可见:
- 该插件使用的是私有 HTTP Client 直接读取环境中的
DEEPSEEK_API_KEY,绕过了 DSH 的通用模型计费拦截层,在常规的聊天 Token 统计中根本看不到它。
- 该插件使用的是私有 HTTP Client 直接读取环境中的
三、 国内网络环境的第二重困境
既然官方的搜索机制既费钱又隐蔽,那换成社区主流的搜索方案可行吗?
- Brave Search MCP:DSH 官方推荐,但我们在国内网络环境下实测
api.search.brave.com,直接 10000ms 超时中断,没有全局科学上网几乎不可用; - DuckDuckGo / Google:国内直连同样被阻断;
- 第三方商业搜索 API(如 SerpApi、Tavily):需要绑定海外信用卡、申请 API Key,且存在每月的免费调用限额。
核心诉求:我们能不能做一个国内免代理直连、无需任何 API Key、零额外费用、永不扣大模型 Token 的纯净搜索服务?
2026-11-10 更新:现在有两个答案——
- (推荐)安装社区插件
dsh-free-search:多引擎免费搜索 + 自动回退,开箱即用; - (进阶备选)自建国内直连 MCP:完全自主可控,即下文的实战方案。
四、 首推方案:dsh-free-search 免费多引擎搜索插件
dsh-free-search(维护者 DDDMUC,MIT)实现了官方 WebSearchProvider 接口并注册进 ctx.web seam,让 web_search / advanced_search 等工具直接用上多引擎免费搜索,无需 API Key 即可开箱(默认 Bing,中文市场 zh-CN)。
引擎清单与实测(本机 2026-11-10 实测结果)
| id | 引擎 | 费用 | 本机实测 |
|---|---|---|---|
bing | Bing | 免费 | ✅ OK(国内直连可用) |
anysearch | AnySearch AI | 免费 | ✅ OK |
keenable | Keenable | 免费 | ✅ OK |
firecrawl | Firecrawl | 免费 | ✅ OK |
parallel | Parallel | 免费 | ✅ OK |
exa | Exa | 免费/配 key 提额 | ✅ OK |
ddg / ddg-lite | DuckDuckGo | 免费 | ⚠️ 国内直连不稳(需代理) |
searxng | SearXNG | 免费 | ⚠️ 公共实例国内不稳,可自建实例 |
tavily | Tavily | 免费 keyless | ⚠️ 有每日限额(当日实测已达上限) |
perplexity / deepseek-official 等 | 付费 | 需各自 API Key | — |
任一引擎失败(缺 key、401、限流、网络错误)时,插件按统一回退链自动尝试下一个引擎,搜索不会直接中断。
提供的工具
web_search:标准搜索(自动走回退链);advanced_search:带timeRange时间过滤(day/week/month/year、3d、绝对日期等);platform_search:定向搜 GitHub / V2EX / B站 / Reddit / HN / Stack Overflow / Wikipedia / npm 等平台;web_fetch:抓取网页正文(注意无 SSRF 防护);free_search_test:一键测试所有引擎可用性(本文表格即来自它的实测输出)。
安装与配置
| |
配置写入 ~/.dsh/settings.yaml:
| |
网页端在 设置 → 插件 → Free Search 卡片切换引擎/填 key/一键测试;聊天框输入 /free-search-engine 可弹出快捷切换。
和官方付费搜索的关系
装了它之后,默认 web_search 就不再依赖官方付费链路,但第五节「第一步:彻底封印内置大模型搜索」的止血步骤依然建议保留(双保险,杜绝任何插件残留的隐性扣费)。
五、 进阶备选:彻底改造实战(自建直连 MCP,两步实现免代理检索)
第一步:彻底封印内置大模型搜索(止血)
在 DSH 的全局补丁配置文件 $DSH_HOME/cordis.patch.yml 中,将内置搜索插件显式禁用:
| |
注:DSH 具备 patchReload: live 特性,保存后热重载机制会立即卸载该插件,不用重启服务,彻底切断扣费源头。
第二步:纯原生 Node.js 实现国内直连双引擎 MCP
为了避免 Windows 权限沙盒下的 npm 缓存锁定问题(EPERM: operation not permitted),我们不引入任何外部第三方 npm 依赖,仅使用 Node.js 原生的 https 和 readline 模块,编写一个极度轻量、毫秒级响应的标准 MCP 服务端。
它整合了微软必应中国(cn.bing.com,实测延迟 300ms)与百度搜索(www.baidu.com,实测延迟 170ms),具备自动双引擎故障回退。
新建文件 $DSH_HOME/scripts/mcp-cn-search.js:
| |
第三步:在 DSH 中挂载该 MCP
编辑 $DSH_HOME/cordis.patch.yml,在 insert 列表中加入该服务:
| |
注意:在 YAML 中传递动态路径参数时,使用标准的缩进多行列表(如上所示),避免由于行内方括号解析导致语法报错。
六、 实操效果检验
配置完成后,在终端中使用命令校验 DSH 组合层:
| |
你可以看到 mcp-cn-search 已正常装载,而 web-search-deepseek 已明确处于 disabled: true 状态。
在日常与 Agent 对话时:
- Agent 获得专属工具:
mcp__cn-search__cn_web_search和mcp__cn-search__cn_fetch_url; - 输入搜索请求,平均 200ms 内即刻返回结构化网页列表(含标题、原文链接和摘要);
- Token 消耗归零,从此彻底告别月底 API 账单的“意外惊喜”!
七、 总结与结语
2026-11-10 收尾更新:如果现在重新来解决「又贵又连不上」的问题,路径已经很清晰——
- 日常使用:直接装
dsh-free-search插件,Bing 等免费引擎开箱即用,多引擎自动回退,本机实测可用引擎包括 bing / anysearch / keenable / exa / firecrawl / parallel;- 彻底止血:仍然建议在补丁配置中禁用
web-search-deepseek,防止官方付费链路被静默调用;- 自主可控:需要定制抓取逻辑、私有部署或不想依赖第三方插件时,再走文中的自建 MCP 方案。
AI Agent 框架目前百花齐放,但在底层实现上,不同的搜索与检索机制往往存在着成本与网络陷阱。DeepSeek Harness 原生的设计初衷是让模型借助服务端大模型去理解网页,但在实际工程与国内网络环境下,往往会演变成“既花钱又连不上海外引擎”的双重尴尬。
通过禁用官方高消耗搜索 + 免费搜索插件(或本地原生直连 MCP),我们在保证开发体验顺畅的同时,兼顾了极致的成本控制与直连稳定性。希望这篇实战记录能为同样在折腾 DSH 的开发者们提供清晰的排查思路与落地参考!