dsh-region

dsh plugin --profile web add dsh-region

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 起的宿主变化）：

1. 宿主不再提供 settingsScope 客户端服务，而旧版插件把它写进了顶层 inject 硬依赖 → 客户端条目永久 pending → 启动校验报 web boot: 1 entry did not activate。

2. 宿主把右上角「下载日志」按钮挪进了输入框的 + / / 命令菜单，旧版插件靠这个按钮当挂载锚点 → 找不到锚点后静默放弃，图标不出现。

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 升级后自查顺序

1. 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。

2. 起来了但图标位置不对、或根本看不见？ → 按「本地调试」读真实 DOM，查锚点（规矩 2）。

必须分别在「会话页」和「新建对话页」各验一次 —— 这两页的工具栏内容完全不同，

会话页有黄文件夹组、新建对话页只有「打开右侧边栏」，只验一页会漏。

3. 镜像不生效？ → cd ~/.dsh/profiles/<profile> && npm config get registry，

看到的不是镜像就查规矩 3、4。

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 直接发布，发布流程只会越来越严。

开源协议

[MIT](LICENSE)