前言¶
在受限网络里让智能体访问 GitHub,常见结果是请求超时,智能体误判为「网络坏了」,每个会话还要你手工解释代理怎么开。系统代理对 Node 进程里的 fetch 往往不可见;GUI 代理客户端可能没启动,沙箱里的智能体也拉不起来;订阅客户端自带的 url-test 又常按固定间隔测 gstatic.com,和你真正要访问的站点无关,请求失败时也不一定会立刻重测换节点。
下面介绍 dsh-net-proxy(维护者 FIZMIE,分类:联网工具)。它是 DeepSeek Harness(DSH)桌面应用上的自包含出站代理插件:自带 mihomo 核心、一次粘贴 Clash 格式订阅、插件自测延迟并自动选最快节点与故障切换,无需第三方代理客户端,也不改系统代理。
这是什么¶
一句话:给 DSH 进程内的智能体流量(web_fetch、模型调用、git/npm 等子进程)走一条可开关的本地代理链路。
插件不售卖、不提供、也不单独绕过任何限制——你需要自备 Clash 格式订阅链接;没有订阅就没有可用节点。
- 仓库:FIZMIE/dsh-net-proxy
- 社区目录:skillhub.cn 插件页
- 许可证:MIT(见仓库
package.json) - 当前 package 版本:0.1.0;运行环境要求 Node
>=22.6
DSH 生态是「一切皆插件」;社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
资料中明确的能力如下。
- 启动自带代理核心:仓库内捆绑 mihomo 二进制,无需再装其他代理软件;核心与 geodata 已提交在仓库中(若日后需刷新,见仓库
THIRD-PARTY-NOTICES.md)。 - 订阅导入:粘贴 Clash 订阅链接一次;插件对订阅文档只做少量 listener/controller 标量原地改写,不重排 YAML 结构。
- 自测延迟与选路:并发对每个节点测
https://github.com,使用最快节点;节点失效时自动切换;可在 UI 中固定某一节点,或选 Fastest (automatic)。 - 接管 DSH 出站:通过 Node 全局 undici dispatcher(与
@deepseek-ai/dsh-http-proxy同类机制)切换路由,换节点无需重启核心进程。 - 默认关闭、按需开启:启动应用约 4 ms 开销,不拉核心、不下订阅;上次「开」不会自动恢复,需你在设置里再次启用(或通过 AGENTS.md 让智能体在需要时打开)。
README 还记录了在 23 节点订阅上的实测摘要(延迟排序、约 2 s 启用、故障切换后 https://github.com 返回 200、回环地址直连等),可作为行为参考,具体以你的订阅与环境为准。
安装与启用¶
一键交给能跑命令的智能体¶
README 顶部提供一段完整提示词:安装插件、写入 profile 的 package.json 与 cordis.patch.yml、用 tools/ 校验 mihomo 与 geodata、向你索取订阅并验证访问 GitHub。复制该块到 Claude Code、Codex、Cursor 或 DSH 内智能体即可按说明执行。
Install the DSH plugin at https://github.com/FIZMIE/dsh-net-proxy into my DeepSeek Harness.
Read its README, wire it into ~/.dsh/profiles/<profile>/package.json and cordis.patch.yml,
then use the tools in its tools/ directory to fetch the mihomo core and geodata.
Ask me for my Clash subscription link, import it, turn the proxy on, and
verify it works by fetching https://github.com.
(Linux/macOS 上 profile 路径为 ~/.dsh/profiles/<profile>/;Windows 示例见 README 手工步骤中的 $env:USERPROFILE\.dsh\。)
手工安装(Windows 示例,摘自 README)¶
在持久目录克隆仓库(不要放进 profile 的 node_modules),在对应 profile 的 package.json 里 link: 依赖并加入 dsh.profile.bundles,创建 junction 让 loader 解析包名,在 cordis.patch.yml 注册 bundle,再校验并重启 DSH(新 host 插件不能热挂载)。
# 1. Clone somewhere permanent (not into the profile's node_modules)
git clone https://github.com/FIZMIE/dsh-net-proxy.git "$env:USERPROFILE\.dsh\plugins\dsh-net-proxy"
# 4. Check the pieces are in place
node "$env:USERPROFILE\.dsh\plugins\dsh-net-proxy\tools\verify-setup.mjs"
# 5. Restart DeepSeek Harness (a new host plugin cannot be hot-mounted)
步骤 2、3 需在 $DSH_HOME\profiles\<profile>\package.json 与 cordis.patch.yml 中按 README 填写 dependencies、bundles 与 id: dsh-net-proxy;完整字段见 GitHub README。
安装后插件可能向 $DSH_HOME/AGENTS.md 追加一段说明,便于智能体知道如何开代理;若已有该段则不会覆盖。可在 $DSH_HOME/.dsh-net-proxy/config.json 设置 "writeMemory": false 关闭此行为。
典型用法¶
打开 DSH Settings → Network proxy。
- 首次:粘贴订阅链接,点 Update subscription。
- 之后:点 Enable proxy——约两秒内启动核心、排序节点并接管出站流量。
节点表展示各节点测得延迟;点击可固定节点,或选自动最快。Activity log 可查看插件操作记录。
验证是否生效:在代理开启后由智能体或本机请求 https://github.com;README 建议用此 URL 作为连通性探针(与延迟测试目标一致)。
适用场景与注意¶
适合谁:已在用 Clash 格式订阅、希望在 DSH 内让智能体稳定访问 GitHub 等外网资源,且不想依赖系统代理或未运行的 GUI 客户端的开发者。
权限与安全:插件以当前 DSH 进程权限运行,会启动本地 mihomo、处理你的订阅 URL 与节点配置。安装前应阅读源码与 MIT 许可证,并只使用你信任的订阅来源。
网络与配置:订阅下载失败时,插件会尝试通过捆绑核心走备用路径拉取(README「Design notes」);geodata 需完整 bundled 集,否则核心可能无错误挂起或解析失败。本地回环(如 DSH 自身 127.0.0.1:19387)应保持直连,避免代理环路。
平台说明:package.json keywords 含 windows、electron;手工安装示例为 PowerShell。其他系统可参考 profile 路径与 link 依赖的同等做法,并以 node tools/verify-setup.mjs 自检。
结尾¶
dsh-net-proxy 把 mihomo、订阅导入、针对 GitHub 的延迟排序和故障切换收进 DSH 插件里,解决「智能体看不见系统代理、订阅客户端测点不对路」这类集成问题。需要订阅、默认关闭、在设置里一键启用,是资料中强调的使用方式。
- 目录页:https://www.skillhub.cn/plugins/FIZMIE/dsh-net-proxy
- GitHub:https://github.com/FIZMIE/dsh-net-proxy