dsh-network：为 DeepSeek Harness 打通联网能力的 DSH plugin

它是做什么的？

naivg/dsh-network 是 DeepSeek Harness（DSH）的网络访问插件，让 DSH 能顺畅地访问互联网。它替换了官方 tool-web 的 web_search / web_fetch，改用常驻的本地回环 Node 服务处理请求，并把 PDF、Office、EPUB 等文档解析成 Markdown 交给模型。插件由 NaivG 维护，采用 MIT 协议，用 TypeScript 编写，目前尚未发布到 npm。

核心功能

• 联网搜索：web_search 返回可引用的来源（标题、摘要、日期）、总结、状态标记以及不确定性与警告列表。
• 网页抓取：web_fetch 抓取单个 HTTP(S) 地址并返回 Markdown 或原始内容，同时给出外链与警告；识别 PDF、docx/pptx/xlsx、odt/odp/ods、EPUB 并转成干净 Markdown，避免模型读到二进制乱码。
• 大结果分页：超过约 20 KB 的响应体缓存在服务端，先返回预览与 cacheId，模型再用 cacheId 配合 offset / limit 翻页，无需重新下载。
• 底层请求：http_request 提供完整的方法、请求头与请求体控制，并复用同一套 cacheId 分页。
• 配置读写：web_config 可读取实时配置，或在用户打开「允许修改设置」安全开关后应用局部补丁；密钥类字段在读写路径中都会被过滤。
• 常驻服务架构：宿主在生命周期内只维持一个本地服务子进程，端口通过标准输出上报，配置随每次调用快照下发，改设置无需重启。

怎么使用这个插件？

在 DSH 的 web 配置档中启用后，模型即可直接调用 web_search、web_fetch 与 http_request 完成联网任务，无需额外配置。搜索引擎、超时、SSRF 防护等参数可在 dsh web 界面的「设置 → 网络」中调整；若希望模型能自行修改配置，需要由用户在「设置 → 网络 → 安全」里手动打开「允许修改设置」开关，该开关刻意不对模型暴露，避免误操作锁死写入路径。抓取到超大页面时，按返回的 cacheId 与 offset / limit 继续翻页即可拿到完整内容。

报错怎么排查？

服务子进程启动失败会被记录但不会中断运行，下一次调用会自动重新拉起；若 dsh 主进程意外退出，服务端会通过标准输入结束事件自行关闭，客户端也会先尝试优雅关闭再强制终止。搜索状态返回 degraded 或 unavailable 时，说明当前引擎不可用，可在「设置 → 网络」中调整引擎顺序或更换搜索源后重试。