代理与镜像下更新 DeepSeek Harness：DSH plugin 的 npm 镜像与内网策略

更新 DeepSeek Harness 失败时，大多数人第一反应是「网络问题」并卡在这一步——但网络问题其实分四层：DNS、代理、源、证书，修法完全不同。 本文按「先分层定位、再选方案（换源 / 走代理 / 内网自建源）、最后处理慢与卡」推进。注意 DSH plugin 走同一套源配置，本体的结论基本可以直接套用。

更新 DeepSeek Harness 卡住时先分清卡在哪一层

一句话结论：用一条手动请求就能把四层分开——拿到响应说明链路通，问题在包与版本；拿不到就逐层往上看。

1. DNS 层：解析不了源域名（表现为「找不到主机」）。试 ping 或 nslookup 该域名；失败说明 DNS 被拦或指向错误。
2. 代理层：能解析但连不上（表现为超时）。检查代理是否必须、变量是否设对、代理本身是否可达。
3. 源层：链路通但包取不到（表现为 404 或「版本不存在」）。换镜像源或查该版本是否已同步。
4. 证书层：报 TLS / 证书链错误。企业网关做 TLS 拦截时常见，需要让工具信任企业根证书，而不是关掉校验（后者有安全代价）。

npm config get registry
npm view @deepseek-ai/dsh version      # 预期：能返回版本号 → 链路与源都通
# 若这里报错，按报错类型对照上面四层定位

方案 A：换 npm 镜像源更新（最常用）

一句话结论：把 registry 指到可达的镜像源，常规升级立刻能走通；唯一代价是同步延迟，影响「刚发布就升级」这一种需求。

1. 写进项目级 .npmrc（避免污染全局）：

# .npmrc
registry=https://你的镜像源地址/

2. 验证并更新：

npm config get registry
npm i -g @deepseek-ai/dsh@0.2.0-rc.2
dsh --version

3. 遇到「版本不存在」时怎么办：先确认镜像上有该版本（npm view @deepseek-ai/dsh versions）；没有就是还没同步，等一会儿或用官方源装这一次。
4. 临时切源两条路：命令行参数指定源，或临时设置环境变量——用完记得恢复，别把临时配置留成常态。

方案 B：走代理更新（有外网但必须经代理）

一句话结论：需要代理就把 HTTP/HTTPS 两个变量都填成同一个可用地址；不需要就彻底取消设置——留空是最常见的坑。

1. 设对代理：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
env | grep -i proxy        # 预期：两个变量都有地址，且没有空值项

2. 清掉多余的空值变量：

unset all_proxy ALL_PROXY 2>/dev/null || true
env | grep -iE '(proxy)='  # 逐项确认没有 "xxx=" 这种空值

3. 为什么留空会坏：空字符串会被当成有效值传给子进程，并可能触发为特定代理场景保留的清理逻辑，结果是子进程静默直连——宿主侧看不出异常，只有子进程拉不到包。
4. 代理与镜像不要同时乱配：同时设代理与私有源时，代理要能到达私有源，否则会出现「本来内网可达却被代理绕出去」的反效果。

方案 C：内网自建源 + 定期同步（企业长期方案）

一句话结论：把「能不能更新」变成「同步任务有没有跑」——用一台出网机器定期把本体与插件清单拉进内网源，内网机器只从那里装。

1. 选一台能访问外网的机器做同步机，负责拉取；内网其余机器只读私有源。
2. 同步内容分三类：本体包、要用的 DSH plugin 包、以及它们的依赖包。
3. 用清单驱动，别临时找包：先在 DSH Plugin Hub 里敲定要用哪些插件，把清单写进同步脚本，一次同步到位。
4. 同步完做一次抽样验证：在内网机器上手动装一个插件确认能装上，比看同步日志可靠。
5. 镜像与代理一起考虑：同步机自己怎么出网（直连 / 镜像 / 代理）要单独记录，出问题时先查它。

DSH plugin 更新慢或卡住的三种网络层定位手段

一句话结论：这一篇只看网络层——慢看源质量，卡看进程停在哪一步；进程残留、磁盘满、缓存锁这些非网络原因不在本篇展开。

1. 看输出的最后一行：停在哪一步（解析版本 / 下载 / 解压）决定是源、代理还是证书的问题。
2. 换源对照：同一条命令换一个有响应的源跑一次——明显变快说明原源质量差。
3. 限时执行，区分「慢」与「卡」：

timeout 600 npm i -g @deepseek-ai/dsh@0.2.0-rc.2
# 预期：超时以非零码退出，便于判断是「一直慢」还是「彻底卡死」

4. 非网络原因统一走另一篇：进程残留、磁盘满、缓存锁、桌面端卡住，见 dsh update 卡死排查。

DSH plugin 排查注意事项

一句话结论：本体能更新、插件不能，九成是「插件包没进你的源」；先补同步，再谈网络。

1. 报 404 的包名是哪一层：本体还是插件——决定你去补源还是补同步清单。
2. 代理变量先排空值，否则后面所有判断都不准。
3. 更新完必须重启服务，dsh web 常驻不会自动换版本。
4. 入口要唯一：全局与 npx 并存时会「更新了却没生效」（见 npx 与全局混装的版本漂移）。
5. 镜像同步延迟要知情：追最新版就临时切官方源，别怀疑安装坏了。
6. 修复状态如实：本文各条基于 npm 官方 registry / .npmrc 机制与官方 CLI 的升级说明；具体源地址、代理地址与你所在网络策略相关，命令参数以 dsh --help 为准。

更新前先在 DSH Plugin Hub 里核对一遍要用的插件与版本，能避免「本体升上去了、插件却没同步」这种半成品状态。

如果只是更新卡住或很慢、并不涉及镜像与代理，可直接看dsh update 卡死排查。

来源：apps/cli/README.md、npm Docs · registry、apps/desktop/README.zh.md。