- Accueil
- Plugins
- Outils et capacités
- dsh-region
dsh-region
nononononofish/dsh-region
Bascule la source de téléchargement des paquets DSH entre le miroir chinois npmmirror et le registre npm officiel en cas de timeout ou d'échec, avec une interface web pour inspecter et basculer manuellement.
Installer
dsh plugin --profile web add github:nononononofish/dsh-regionREADME
dsh-region
还在为下插件经常卡住或失败而烦恼么?下载本插件即可。全自动在国内镜像和官方源间换路续下,还带面板能手动查看与切换。没啦!
为什么做这个插件? 用 DSH 安装插件时,国外下载源速率很慢,经常卡顿、无法更新,甚至更新到一半就卡住。这个插件就是为解决这个问题而生:默认使用国内镜像为主,最快地下载和更新插件;国内镜像挂掉时自动切换为官方下载源;主源恢复后自动切回。
第三方社区插件,与 DeepSeek 官方无关。
功能特性
- 自动故障切换 —— 每 5 分钟探测主源健康;主源超时(10 秒)或失败时自动切到官方源,主源恢复后自动切回。
- 手动锁定 ——
/region use main|backup锁定任意一个源,/region use auto回到自动模式。 - 原生生效 —— 把当前生效源写入 profile 的
.npmrc,DSH 原生命令(如dsh plugin add ...)也走该源。 - 状态持久化 —— 模式和切换记录存于
~/.dsh/region.json,重启不丢。 - 零运行时依赖 —— 运行期只用 Node 内置模块 + 全局 fetch,无需插件自带任何第三方包(构建期用 react 作 devDependency,由 DSH host 运行时按需提供,不计入发布体积)。
兼容性
| dsh 版本 | 本插件 ≤ 0.2.1 | 本插件 0.3.0+ |
|---|---|---|
| dsh ≤ 0.2.1(旧版) | ✅ 正常 | ✅ 正常 |
| dsh 0.2.1-rc.2 及更新 | ❌ dsh 启动失败 | ✅ 正常 |
dsh 升级后如果突然起不来,先升级本插件。
原因(0.2.1-rc.2 起的宿主变化):
- 宿主不再提供
settingsScope客户端服务,而旧版插件把它写进了顶层inject硬依赖 → 客户端条目永久 pending → 启动校验报web boot: 1 entry did not activate。 - 宿主把右上角「下载日志」按钮挪进了输入框的
+//命令菜单,旧版插件靠这个按钮当挂载锚点 → 找不到锚点后静默放弃,图标不出现。
0.3.0 的处理方式:
settingsScope降级为软依赖(ctx.inject()回调内尝试),宿主没有就跳过设置页卡片,绝不再拖垮启动;- 挂载锚点改为三级回退:工具栏「文件资源管理器」→ 旧「下载日志」→ 右上角固定浮层;
- 定位只用
aria-label等语义标识,不依赖构建生成的哈希类名; .npmrc同时写入desktop与web两个 profile(不同启动方式各用一个),且只增改registry=行,不再整文件覆写,避免抹掉proxy=/_authToken等既有配置。
安装
从源码安装(当前可用)
git clone https://github.com/nononononofish/dsh-region.git
cd dsh-region
npm install # 或 npx tsc(由 src/ 构建 lib/)
dsh plugin --profile web add link:C:\path\to\dsh-region
⚠️
link:后面的路径不能包含空格(DSH 会按空格拆分参数)。
从 npm 安装(已发布,推荐)
已实测通过:DSH 的
plugin add本质是 pnpm 转发器,dsh plugin --profile web add dsh-region会直接从 npm registry 拉取并自动激活为 bundle,无需 git/link。
dsh plugin --profile web add dsh-region
使用方法
Web UI 菜单(推荐)
DSH 重启后,打开任意会话,右上角工具栏「文件资源管理器」按钮(黄色文件夹)左侧会出现源管理菜单:
- 🟢🟡🔴 状态灯实时显示当前源健康(悬停看说明)
- 点击切换:自动切换(auto)/ 国内镜像(main)/ 官方源(backup)
- 每个源后显示最近探测耗时;「立即测速」可实时检测双源
- 当前模式带 ✓ 标记
挂载位置按三级回退,兼容不同 dsh 版本: ① 新版工具栏「文件资源管理器」左侧 → ② 旧版「下载 Log」左侧 → ③ 右上角固定浮层(前两者都不存在时)。
对话框命令
在 DSH 对话框里输入:
| 命令 | 作用 |
|---|---|
/region status | 查看当前模式、生效源、最近探测结果 |
/region probe | 手动测两个源各自的延迟 |
/region use auto | 自动主备模式(默认) |
/region use main | 锁定国内镜像(npmmirror) |
/region use backup | 锁定官方 npm 源 |
默认源配置:
| 角色 | 源地址 |
|---|---|
| 主源(国内镜像) | https://registry.npmmirror.com |
| 备源(官方源) | https://registry.npmjs.org |
工作原理
- auto 模式下,插件用稳定小包
is-number作为探测目标,请求其元数据接口(单次 10 秒超时),探测registry.npmmirror.com,失败则测registry.npmjs.org。 - 生效源写入
<profile>/.npmrc,DSH 原生 pnpm 调用读取的就是它。 - 健康检查每 5 分钟一轮;切换事件记录在
~/.dsh/region.json(保留最近 200 条)。
开发
npm run build # tsc:src/index.ts → lib/index.js + index.d.ts
npm run typecheck # 仅类型检查
npm test # 三套测试:核心逻辑 + 主源故障切换 + HTTP 路由对抗(用临时 DSH_HOME,会真实请求两个源)
维护者备忘
DSH 是快速迭代的宿主。每次宿主大版本更新,都可能同时打断「插件启动」和「客户端挂载」两条链路。 以下是 0.3.0 实际踩过的坑,DSH 升级后按下面的自查顺序逐条过一遍。
四条硬规矩
| # | 规矩 | 违反的后果 |
|---|---|---|
| 1 | client 端顶层 export const inject 只写宿主必然提供的核心服务(如 slots)。可选服务一律用 ctx.inject([...], cb) 回调式软依赖 | 宿主移除该服务 → 条目永久 pending → 启动校验失败 → DSH 整个起不来 |
| 2 | 挂载不要往宿主 DOM 里插元素。用固定定位 + 锚点按钮坐标;锚点按 文件资源管理器 → 右侧边栏 → 更多操作 多级回退,全部缺失才回固定点 | 宿主工具栏不同页面结构完全不同(新建对话页连黄文件夹都没有),且 titleRow 存在溢出容器的大 margin(实测 margin-left:774px 而容器宽仅 1592)——插进去必然错位、重叠或被甩到最左 |
| 3 | 写 <profile> 下任何文件都要遍历所有 profile(desktop 与 web 各用一个) | 硬编码某一个 → 另一半场景静默失效(例如 .npmrc 写到 web,桌面端仍走官方源) |
| 4 | 写 .npmrc 只增改 registry= 一行,绝不整文件覆写 | 把用户的 proxy=、_authToken、scope registry 静默抹掉,不可逆 |
另外:绝不要用构建生成的 CSS Module 哈希类名当选择器(形如 WgQWqa_main),前缀每次构建都可能变;
aria-label 这类语义属性才跨版本稳定。
DSH 升级后自查顺序
- DSH 能起来吗?
起不来先看
%APPDATA%\@deepseek-ai\dsh-desktop\logs\crash-*-web-boot.log。 出现web boot: N entry did not activate+xxx: pending (waiting for service: yyy),就是违反了规矩 1。 - 起来了但图标位置不对、或根本看不见? → 按「本地调试」读真实 DOM,查锚点(规矩 2)。 必须分别在「会话页」和「新建对话页」各验一次 —— 这两页的工具栏内容完全不同, 会话页有黄文件夹组、新建对话页只有「打开右侧边栏」,只验一页会漏。
- 镜像不生效? →
cd ~/.dsh/profiles/<profile> && npm config get registry, 看到的不是镜像就查规矩 3、4。 - 状态灯一直是灰的? → 抓
/dsh-region/status。main/backup为null说明自动探测结果 没写进lastProbe(原实现只有手动「立即测速」才写,0.3.0 已修)。
本地调试(读宿主真实 DOM)
宿主界面元素随时会变,不要猜。用 Chrome DevTools Protocol 直接读渲染进程:
# 1) 先关掉已运行的 DSH —— Electron 有单实例锁,否则调试端口不生效
# 2) 带调试端口启动
"D:\Program Files (x86)\DeepSeek Harness\DeepSeek Harness.exe" --no-sandbox --remote-debugging-port=9222
# 3) 取页面的 webSocketDebuggerUrl
curl http://127.0.0.1:9222/json
# 4) 连上该 ws,发 Runtime.evaluate 执行 JS,例如:
# [...document.querySelectorAll('button')].map(b => b.getAttribute('aria-label'))
0.3.0 就是用这个方法定位到「文件资源管理器」按钮的
aria-label="用 文件资源管理器 打开", 并确认工具栏那一行是个display: contents容器(所以插入子元素能自然参与父级 flex 排布)。
环境坑
- 从 AI 工具 / IDE 的集成终端启动 Electron 会静默失败:父进程若注入了
ELECTRON_RUN_AS_NODE=1, Electron 会退化成纯 Node —— 不开窗口、不写日志、进程秒退。排查前先set ELECTRON_RUN_AS_NODE=再启动。 npm publish需要 2FA:在非交互式环境(CI / 自动化脚本)里会直接EOTP失败, 连授权链接都拿不到,必须在真实终端人工执行 —— CLI 会打印https://www.npmjs.com/auth/cli/<id>, 浏览器授权后自动继续。- npm 自 2026-08 起限制绕过 2FA 的 token,2027-01 起禁止免 2FA 直接发布,发布流程只会越来越严。
开源协议
Plugins associés
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora