dsh-region
为 DeepSeek Harness（DSH）开发的下载源主备切换插件：国内镜像为主、官方源为备、故障自动切换。 已发布到 npm。
为什么做这个插件？ 用 DSH 安装插件时，国外下载源速率很慢，经常卡顿、无法更新，甚至更新到一半就卡住。这个插件就是为解决这个问题而生：默认使用国内镜像为主，最快地下载和更新插件；国内镜像挂掉时自动切换为官方下载源；主源恢复后自动切回。
第三方社区插件，与 DeepSeek 官方无关。
功能特性
- 自动故障切换 —— 每 5 分钟探测主源健康；主源超时（10 秒）或失败时自动切到官方源，主源恢复后自动切回。
- 手动锁定 ——
/region use main|backup锁定任意一个源，/region use auto回到自动模式。 - 原生生效 —— 把当前生效源写入 profile 的
.npmrc，DSH 原生命令（如dsh plugin add ...）也走该源。 - 状态持久化 —— 模式和切换记录存于
~/.dsh/region.json，重启不丢。 - 零运行时依赖 —— 只用 Node 内置模块 + 全局 fetch。
安装
从源码安装（当前可用）
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 重启后，打开任意会话，右上角「下载 Log」按钮左侧会出现源管理菜单：
- 🟢🟡🔴 状态灯实时显示当前源健康（悬停看说明）
- 点击切换：自动切换（auto）/ 国内镜像（main）/ 官方源（backup）
- 每个源后显示最近探测耗时；「立即测速」可实时检测双源
- 当前模式带 ✓ 标记
对话框命令
在 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（保留最近 50 条）。
开发
npm run build # tsc：src/index.ts → lib/index.js + index.d.ts
npm run typecheck # 仅类型检查
npm test # 冒烟测试 + 故障切换测试（用临时 DSH_HOME，会真实请求两个源）