dsh-network 为 DeepSeek Harness 配齐了一整套网络工具:五个面向模型的工具 (外加一个默认关闭的下载工具)、一个网络设置分区、一个侧边栏网页搜索面板, 以及看起来与应用其余部分并无二致的工具卡片。它接管官方 tool-web 的 web_search / web_fetch, 换成一个常驻的本地回环 Node 进程。同时开箱即用。

需要 dsh 0.1.0.rc2 或更高版本。见 需知事项。

快速安装

dsh plugin --profile web add @naivg/dsh-network

详见 安装。

为什么需要这个插件

DeepSeek Harness 自带 web_search 和 web_fetch, 覆盖了相当一部分场景, 但很快 会撞上这些缺口: 长页面在内联上限处被截断; 指向 .pdf / .docx 的链接把二进制字节 丢给模型;订阅源地址回来一坨 XML, 而不是一份文章列表; 而需要裸 POST、需要把文件落盘 的任务, 根本没有对应工具。模型一旦想要干些特定的活只能使用如curl、wget等外置工具， 或是先写一份tmp_xxx.py脚本(还不一定一遍写对)。

常见的解决办法是安装浏览器自动化插件(如browser-use): 打开页面、抓一份 DOM 快照或 截图、点击、滚动, 再重复一遍。页面只有靠交互才能用时, 选浏览器是对的; 可如果目标只 是读文本, 它就非常浪费 token。每一步都要重新抓一份页面快照, 再花 token 把它读进来, 而 整个循环只能跟着页面渲染的速度走, 于是一篇文章可能烧掉远超其正文很多倍的上下文, 其中大部分还花在导航栏、横幅和标记上。

dsh-network 为补上这个缺口而生。文档与订阅源以解析后的 Markdown 到达, 订阅源逐条渲染; 超过内联上限的正文落进服务端缓存, 模型可以分页读完, 而不是丢掉 尾部。搜索走一条引擎链(默认 Bing → DuckDuckGo → Baidu, 无需密钥), 单次调用可以 锁定某一个引擎, 每条命中都带标题、链接、摘要和日期; 引擎意见不一致时, 答案会直说, 而不是看起来像没有结果。http_request、web_sitemap、web_config 覆盖了官方那两个 工具根本没有的工作, 设置分区与侧边栏面板让整套东西可以手改手用, 而所有请求 ——包括默认关闭的下载工具——都走同一条带护栏的传输链路:逐跳 SSRF 校验、IP 固定、 私有地址段拦截和协议锁。代价仅仅是多一个由插件自身托管的 Node 进程, 并且在你卸载之前, web 插件缝会一直被占用。

你会得到什么

工具	作用
web_search	通过配置的引擎链搜索网络(默认 Bing → DuckDuckGo → Baidu)。返回可引用的来源(标题、链接、摘要、日期)、一段总结、状态标记和不确定提示。engine 参数可以让单次调用指定引擎。
web_fetch	抓取一个 HTTP(S) 地址, 默认返回 Markdown, 也可按需返回原始响应体, 并附带出站链接与告警。PDF、OOXML(docx/pptx/xlsx)、ODF(odt/odp/ods)和 EPUB 响应会被转成 Markdown。订阅源按根元素识别——<rss>、<feed>、<rdf:RDF>——并逐条渲染, 于是 RSS 2.0、RSS 1.0 (RDF) 与 Atom 1.0 读起来是一份条目列表, 而不是一条 ？！惊天大区！？ XML 版(细节)。
http_request	发出底层 HTTP(S) 请求, 方法、请求头和请求体完全可控。
web_sitemap	查询一张包含 178 个权威站点的精选表格——覆盖 arxiv、MDN、包注册表、问答站、政府、新闻、视频……共 23 个分类——可按域名、分类、优先级或自由文本查询定位, 并可选返回可直接粘贴使用的摘要。
web_config	读取 dsh-network 的实时配置;在你打开了安全开关后, 模型可自主应用局部补丁(见设置)。完整行为见配置文档。
web_download	默认关闭。 把二进制文件(图片、压缩包、媒体、字体)存到磁盘并返回路径;走的是与其他工具相同的传输层, 而不是另开一条管道。护栏见安全。

超过内联上限(约 20 KB)的 web_fetch / http_request 正文会先返回一段预览加上 一个 cacheId, 模型再用一次调用翻完剩余部分;超长的订阅源预览则永远停在一条完整 条目的末尾, 于是一次 cacheId 调用就能直接翻到第 40 条, 不必重新请求这个地址。见 CLI 与缓存分页。

工具卡片

每个工具都会渲染成第一方风格的 dsh 卡片——一行无边框的展开栏, 下面是结果正文:

web_config 用的也是同一张卡片。读取时收成一行 网络配置 · 读取配置 · N 个引擎; 写入时自动展开, 逐条列出改动的字段以及真正存进去的值——模型要 searchMaxResults: 50 而宿主钳到 20 时, 卡片显示的是那次钳制的结果, 而不是它请求 的数字;被安全开关拒绝的写入显示成「已被拒绝」块, 而不是静默无操作。当前配置本身以分 组形式列在下面(引擎链带密钥标记、超时、保护项、白名单、上限、工具开关、GitHub), 最 底下是原始 JSON。

支持的搜索引擎

引擎 id	凭据
deepseek-official(仅HOST)	DSH 原生配置与账户/凭据服务（可选，可能产生费用）
bing	无
duckduckgo	无
baidu	无
so360	无(按来源 IP 限流)
github	token 可选
searxng	无(自建实例)
brave	需要密钥, 按量计费
mojeek	无 (Altcha 验证) / 需要密钥, 按量计费
tavily	无密钥 (频率限制) / 需要密钥, 按量计费

默认链是 Bing → DuckDuckGo → Baidu, 其余都是可选。更多细节见 搜索引擎。

在 设置 → 网络 → 搜索引擎 → 添加 中选择 DeepSeek (native)，再用上移/下移调整优先级。已有搜索链不会自动改变。原生节点复用官方插件，在独立作用域运行；配置与登录由 DSH 管理，不在本插件中填写密钥。已验证 DSH 0.2.0-rc.2，无需修改宿主或安装第二套 Cordis。原生调用失败时尝试下一节点；正常空结果停止搜索；取消立即终止。原生服务仅能在 DSH 宿主内运行，独立 CLI 会明确报告不可用。见兼容与测试说明。

侧边栏网页搜索

dsh 网页界面会在侧边栏(位于插件与定时任务之后)新增一个网页搜索入口。该面板 走的是与 web_search 工具完全相同的搜索路径, 也受同一个开关控制。

安装

# 从 npm 安装:
dsh plugin --profile web add @naivg/dsh-network

# 或者从 GitHub 安装(安装期间现构建 CLI bundle):
dsh plugin --profile web add github:NaivG/dsh-network --allow-build=@naivg/dsh-network

# 或者从本地检出安装:
dsh plugin --profile web add link:<path-to-this-checkout>
cd <path-to-checkout>      # 仅 link 安装需要
pnpm install
pnpm build

dsh web

之后加载器会替你套用 cordis.patch.yml:web 插件缝的 provider 切换到 dsh-network, 旧的 tool-web 的 web_search / web_fetch 被禁用, 插件条目则带着默认设置插入。

为什么要 --allow-build? CLI bundle(dist/cli.cjs)是在安装期间由包的 prepare 脚本构建的, 而 pnpm 12 默认拦截 git 依赖的构建脚本。如果工具调用报 dsh-network CLI bundle is missing, 见故障排查。

快速开始

1. 执行 dsh web, 然后打开 设置 → 网络。这个插件的一切都在那里配置。
2. 问一个需要联网的问题——“搜索最新的 TypeScript 发布说明并给出来源”。 web_search 卡片会显示各引擎的答案, 来源列在下方。
3. 更喜欢点而不是打字?打开侧边栏的网页搜索, 在那里跑同一个查询。
4. 添加引擎、粘贴 GitHub token, 或者在同一设置分区里调整超时——改动在下一次工具 调用时生效, 无需重启。

全新安装后什么都不用配置:默认链是免密钥的, 而那些会产生费用(或需要你自己的 服务器)的引擎绝不会被悄悄启用。

设置

所有配置都在设置 → 网络里, 并且在下一次工具调用时生效:

• 搜索引擎——实时引擎链(默认 Bing → DuckDuckGo → Baidu), 每个引擎有一个 编辑对话框, 可以配置 endpoint、API Key 和自定义 key=value 选项。 见搜索引擎。
• 工具开关——webSearchTool、webFetchTool、httpRequestTool、 webSitemapTool, 以及 默认关闭的 downloadTool(它是唯一会往磁盘写东西 的工具, 而且模型自己既读不到也改不了这个开关, 和 allowConfigEdit 同样处理)。 关掉其中一个, 对应工具就会立刻失败, 侧边栏搜索路由也会返回 403;重启 dsh 会 彻底注销被禁用的工具。
• 安全——安全一节里那些防护的开关, 旁边就是允许模型修改设置, 它决定 web_config 能否写入。
• 超时、User-Agent、结果上限、重定向预算、允许的 HTTP 方法以及主机允许列表, 都在 同一个分区里。

设置持久化到 ~/.dsh/dsh-network.json;删掉该文件即可重置。密钥(GitHub token、 引擎 API key)也会存在那里——浏览器只会显示“是否已配置密钥”, 绝不会显示密钥本身。 包含回环路由在内的完整字段参考见配置文档。

安全

• 所有流量都走 undici。插件绝不会外呼 curl.exe、nslookup.exe 或任何其他外部 可执行文件。
• 逐跳重定向 SSRF 校验、IP 固定、私有/保留地址段拦截默认开启;在你设置之前, 允许 列表为空(不受限)。
• 传输层会拒绝真正的二进制内容(图片、音频、视频、字体、压缩包、通用 octet-stream)。只有一份固定白名单中的文档 MIME 类型会被解析成 Markdown。唯一的 例外是 web_download——而且它走的是同一个传输层, 不是另开一条管道。
• 回环服务只绑定 127.0.0.1, 并且对请求体做了大小限制。
• web_config 的 set 动作由一个开关把守, 该开关模型既读不到也写不了, 因此一次 坏补丁不可能把模型锁死在它自己的写入通道之外。
• web_download 另外三道闸:文件名无法逃出目标目录(分隔符、..、Windows 保留 设备名全部中和, 落盘前再校验一次解析后的路径);可执行后缀(.exe/.ps1/ .sh/.js/.bat……)直接拒绝, 声明名和嗅探名都要过这一关;超过字节上限是 失败而不是截断, 而且写入是原子的(.part → rename), 所以磁盘上存在的文件 一定是完整的。

需知事项

我们正式支持 dsh 0.1.0.rc2 及更高版本。这是因为从该版本开始，API 已变得更加稳定。

但有一个例外：原生 deepseek 搜索 API 函数使用 API （包含 DEEPSEEK_PROVIDER_ID、 命名空间、Config 和 apply），该函数已通过 DSH 0.0.1.rc3 及更高版本进行了手 动验证，因此本插件可能与较旧的 DSH 版本兼容。但我们不声明支持 0.1.0.rc2 之前的任何版本。

故障排查

• npx @naivg/dsh-network doctor 会打印解析后的配置——引擎链、超时、哪些 API key 已配置——且不会访问任何外部服务。离线可用, 是排查的第一站。
• dsh-network CLI bundle is missing——CLI 构建被跳过了, 这只会发生在 git 或 link 安装上(发布到 npm 的 tarball 自带 dist/)。GitHub 安装请用 --allow-build=@naivg/dsh-network 重新安装, link 安装则在检出目录里执行 pnpm install && pnpm build。见 开发文档。
• 某个带密钥的引擎提示"无凭据"——在该引擎的编辑对话框里粘贴密钥并保存; 只有真正存下密钥后, 行上的徽标才会变绿。凭据规则见 搜索引擎。
• SearXNG 返回 403——在你实例的 settings.yml 里为 search.formats 启用 json。见搜索引擎。
• 侧边栏搜索面板不见了——它只有在插件存在且网页搜索开关打开时才会挂载。
• 想全部重置? 删除 ~/.dsh/dsh-network.json(路径可由 DSH_NETWORK_CONFIG_FILE 覆盖)并重启 dsh。

文档

以下文档目前仅提供英文版。

• 搜索引擎——引擎链、按调用锁定, 以及每个引擎的凭据 与选项。
• CLI 与缓存分页——独立 CLI、结果信封格式, 以及缓存如何分页。
• 配置——全部字段、全部环境变量、回环路由。
• 架构——进程模型、传输层、引擎注册表、浏览器端实现。
• 开发——构建、测试、代码结构。

致谢

• Deepseek Harness——插件设计、实现与参考资料。
• Deepseek——社交预览图中的 deepseek 参考形象。

许可证

MIT。见 LICENSE。