导入代理订阅并监督本地 mihomo 内核(proxy-provider + url-test 组),取回时直连优先、失败自动切代理并按主机记忆路由;对外只有一个 proxy_router 工具(status/start/stop/test/fetch/routes/forget)。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/Lequait/dsh-proxy-router/releases/download/v0.2.1/dsh-proxy-router-0.2.1.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Lequait/dsh-proxy-router
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
给 DSH 的「直连优先、代理兜底」取回能力。 导入一份代理订阅,直连失败的目标自动改走代理,并记住下次直接走对的那条路。
解决的问题:一遍遍重试直连、一遍遍换镜像源。第一次失败就换路,第二次起零试错。
为什么不直接用环境变量代理
DSH 自带的 dsh-http-proxy 只提供一条路:启动时把 HTTP_PROXY/HTTPS_PROXY/ALL_PROXY 装成 undici 全局 dispatcher,命中就全走代理、没配就全直连。
- 没有按主机判断:直连能通的站点也被塞进代理;
- 没有失败重试:第一次连不上就报错;
- 启动后改不了:运行中换不了代理;
- 代理一挂全挂:节点死了连直连站点也访问不了。
本插件补的就是这一层:两条路 + 记忆 + 健康检查。
工作原理
订阅链接 ──► mihomo 内核(本插件监督)──► 本地混合端口 http://127.0.0.1:<mixedPort>
│ proxy-provider:定时重新拉取订阅
│ url-test 组:按真实 204 探测挑最低延迟的健康节点,故障自动切换
▼
smartFetch(本插件)
1. 查路由记忆(按主机,默认 30 分钟 TTL)
2. 直连优先 → 失败则走代理重试
3. 成功即记住该主机该走哪条路
▲
└── 代理没有健康节点时,直连路径不受影响
节点选择与故障切换交给内核(这是 mihomo 的强项),直连/代理的选择留给插件(这是 harness 特有的需求)。传输层是纯 node:http/node:https/node:tls + CONNECT 隧道,零第三方依赖。
安装
dsh plugin --profile <你的profile> add dsh-proxy-router
# 或用 GitHub 源
dsh plugin --profile <你的profile> add github:Lequait/dsh-proxy-router
重启 harness 后,会话里会出现 proxy_router 工具。
你只需要一个订阅地址
其它都不用配。两种给法,任选其一:
① 直接把链接交给 agent(推荐,零配置)
proxy_router { action: "start", subscriptionUrl: "https://你的订阅链接" }
插件会记住它(存在 <DSH_HOME>/cache/proxy-router/subscription.txt),之后 status / test / fetch 都不用再给。
② 写进插件配置(想让内核随 harness 自动启动时用)
上面配置表里的 subscriptionUrl 填一行即可,并可把 autoStart 设为 true。
内核不用你操心
启动时会按顺序找 mihomo:环境变量 DSH_PROXY_CORE → PATH → 常见安装目录 → 正在运行的内核进程 → Windows 注册表卸载项。
你机器上正在跑的 Clash Verge 自带内核(verge-mihomo.exe)就是这样被自动找到的,与安装在哪个盘无关。
都没有时会自动下载 mihomo(GitHub 直连失败会自动换镜像源)到 <DSH_HOME>/cache/proxy-router/bin/。
所以 corePath 和 DSH_PROXY_CORE 都是可选的高级选项,不是必填项。
配置(全部可选)
在 profile 的 cordis.patch.yml 里改 proxy-router 条目的 config:
- id: proxy-router
name: dsh-proxy-router
config:
subscriptionUrl: 'https://你的订阅链接' # 必填,含 token,请自行保管
corePath: '' # 留空自动探测 mihomo / verge-mihomo
autoStart: true # 随 harness 启动内核
mixedPort: 19097
controllerPort: 19098
directTimeoutMs: 8000
proxyTimeoutMs: 12000
healthUrl: 'http://cp.cloudflare.com/generate_204'
| 字段 | 默认 | 说明 |
|---|---|---|
subscriptionUrl |
'' |
订阅链接;支持 Clash YAML 与 base64 节点列表 |
corePath |
自动探测→自动下载 | 通常不用填;要强制指定内核路径时才填(或设 DSH_PROXY_CORE) |
autoStart |
false |
是否随 harness 启动内核 |
mixedPort / controllerPort |
19097 / 19098 | 本地混合端口与控制器端口(避开 Clash Verge 的 7897/9097) |
directTimeoutMs / proxyTimeoutMs |
8000 / 12000 | 两条路的超时预算 |
healthUrl |
cloudflare 204 | 节点健康探测目标 |
工具:proxy_router
| action | 作用 |
|---|---|
status |
内核状态、当前选中节点、健康节点数、路由记忆条数 |
start / stop |
启停本地内核 |
test |
逐节点实测健康度,按延迟排序返回 |
fetch |
按「直连优先 → 代理兜底」取回一个 URL(force: true 忽略记忆重新试) |
routes / forget |
查看 / 清空按主机的路由记忆 |
测试
npm test
test/selftest.mjs 用真实的本地内核与真实传输验证四件事:直连失败 → 代理取回成功;第二次调用直接走对的那条路;直连可达的主机不绕代理;路由记忆持久化。
test/router-real.mjs 用真实订阅启动内核并统计节点健康度:
$env:SUB_URL='https://你的订阅链接'; node test/router-real.mjs
边界与注意
- 订阅里的节点可能全是死的(被封锁或服务器下线)。此时插件如实报告「健康 0 个」,只有直连路径生效——不会因为代理挂了而拖死 agent。
- 订阅 URL 会写进生成的内核配置(
<DSH_HOME>/cache/proxy-router/config.yaml),该文件含凭据,不要同步或提交。 - 本插件运行第三方内核进程(mihomo)。装插件就是跑第三方代码,请只装你信任的来源。
- 本插件目前没有接管内置
web_fetch:它提供的是独立工具与本地代理端口。要让内置抓取也走这套路由,需要额外注册ctx.web抓取提供方。
许可
MIT
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37918
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8650
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5964
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2216
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 2002
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。