ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness alpha 渠道装不上报 ETARGET:缺叶子包怎么排查

故障排查发布于 2026-11-03作者: DeepSeek Plugin 插件市场
DeepSeek HarnessETARGETalpha 渠道npm 安装失败dist-tag叶子包
执行 npm i -g @deepseek-ai/dsh@alpha 报 ETARGET,alpha 渠道整体不可用。缺的是 0.2.2-alpha.3 精确 pin 了从未发布的叶子包,不是你的 npm 配置。本文给三步判据、发布流水线视角,以及从发现到补发的完整时间线。

DeepSeek Harness(DSH)的 alpha 渠道曾经整条不可安装:npm i -g @deepseek-ai/dsh@alpha 与 npx @deepseek-ai/dsh@alpha 都在依赖解析阶段报 ETARGET,提示 No matching version found for @deepseek-ai/dsh-tool-pwsh-persistent@0.2.2-alpha.3。 这不是你的 npm 缓存、也不是 npmrc 配置问题——npm i --dry-run 同样复现,因为它连写盘都没开始就已经失败。缺的是一个从未发布的叶子包,而主包把它写成了精确版本 pin,一个缺口就让整条渠道对所有用户不可用(#11984)。

三步判据:先用三条命令定位缺的是哪个包

关键判据是:ETARGET 出现在解析期、报错里点名了具体包与具体版本,且换 latest 立刻正常。 三步顺序照做:

  1. 看渠道标签当前指向哪个版本。
bash
npm view @deepseek-ai/dsh dist-tags
#   { alpha: '0.2.2-alpha.3', latest: '0.2.1-rc.5', next: '0.2.1-rc.5' }

预期:alpha 指向一个具体版本号。这一步的作用是确定「要装的是哪个版本」,避免把「标签指向错误」和「版本缺包」混为一谈。

  1. 用 --dry-run 把失败限制在解析阶段。
bash
npm i --dry-run @deepseek-ai/dsh@0.2.2-alpha.3
#   npm error notarget No matching version found for
#   @deepseek-ai/dsh-tool-pwsh-persistent@0.2.2-alpha.3

预期:同样的 ETARGET,且没有产生任何安装动作。--dry-run 的价值在于证明失败发生在「解析」而不是「下载/写盘」,从而排除网络中断、磁盘权限这类解释。

  1. 直接查那个被点名的叶子包。
bash
npm view @deepseek-ai/dsh-tool-pwsh-persistent versions --json
npm view @deepseek-ai/dsh-tool-pwsh-persistent dist-tags

预期:versions 列表里没有 0.2.2-alpha.3,且它的 alpha 标签还停在 0.2.2-alpha.2(该版本发布于 2026-10-27T19:03:34Z)。到这一步,「缺的是哪一个、缺多久了」就都有答案。

补充一组对照数据:0.2.2-alpha.3 声明 90 个依赖,无法解析 1 个;0.2.2-alpha.2 声明 91 个,无法解析 0 个;0.2.1-rc.5 声明 86 个,无法解析 0 个。这不是整批没发,而是恰好缺一个(#11984)。

为什么一个叶子包能让整条渠道装不上

一句话结论:精确 pin 把「一个包缺失」放大成「整棵树不可解析」,而 npm 的解析是全有或全无。 机制分三层:

  1. 主包声明了精确版本。 @deepseek-ai/dsh@0.2.2-alpha.3 把兄弟包写成 0.2.2-alpha.3 这种完整版本号,没有用 ^ / ~ 范围。
  2. npm 要求每个精确依赖都有对应版本。 只要有一个查不到,解析整体失败,不会「跳过这个包继续装」。
  3. 失败点在最外层。 依赖树里任何一层缺版本,报错都会回到你执行的这条 npm i 上,于是看起来像「DSH 装不上」,实际是某个内部包没发。

这也解释了为什么用户侧没有自救空间:ETARGET 是解析期错误,装到一半再修补的路不存在,只能等补发或换版本。

这次事件的完整时间线

一句话结论:这个缺口是「事后补发」修好的,从发现问题到恢复约 29 分钟。 按 UTC 时间:

  1. 07:48:26Z:@deepseek-ai/dsh@0.2.2-alpha.3 落库,alpha 标签随之指向它。
  2. 08:10Z 前后:报告者核对 registry,确认 dsh-tool-pwsh-persistent 的最新版本仍是 0.2.2-alpha.2,versions 里没有 alpha.3。
  3. 08:44Z:另一名社区成员直连 registry 逐个查询(不经本机缓存)独立复核,结论一致:alpha 渠道对所有人不可安装,唯一缺口就是那个叶子包;其余 88 个精确 pin 全部存在,8 个范围声明也都有满足的版本。
  4. 09:03:15Z:补发落库。dsh-tool-pwsh-persistent 的 dist-tags 变为 alpha: '0.2.2-alpha.3',alpha 渠道恢复。
  5. 补发后真机验证(不是 dry-run):
bash
npm install @deepseek-ai/dsh@alpha
#   added 652 packages in 3m
#   EXIT=0

预期:安装成功,node_modules/@deepseek-ai/dsh 与 node_modules/@deepseek-ai/dsh-tool-pwsh-persistent 都指向 0.2.2-alpha.3,90 个依赖重新逐个比对缺失 0 个。

时间线里有个值得记住的细节:发布脚本是严格串行、按依赖拓扑、遇错即抛的(scripts/release/publish.ts 的 publishRelease),主包必然排在叶子包之后发布,而主包确实落了库。也就是说发布流程并没有「中途抛错停下」,更像是这个包没有进入本次的打包/上传集合。这一点只能从仓外推断,但足以说明「流程成功」不等于「每个成员都上了 registry」。

一处常见误判:依赖数 91 降到 90 不等于只发了一半

一句话结论:dsh-cua-bundle 从声明里消失是 tag 树的真实差异,不是漏发信号;把它当证据会得出错误结论。 讨论里原文曾把它列为「发布波次只发了一半」的辅助证据,随后被独立复核纠正:

  1. 用 tag 树对比确认差异来源。 对两个 tag 的 apps/cli/package.json 做 diff,能看到 "@deepseek-ai/dsh-cua-bundle": "workspace:*" 这一行被删除。
  2. 理解这个包的性质。 cua-bundle 是 dsh.bundle.platforms: ['darwin'] 的可选 bundle,引入它的提交不在 alpha.3 的祖先里,所以该 tag 本来就没声明它。
  3. 确认关键包在两个 tag 里都照常声明。 pwsh-persistent 在 alpha.2 与 alpha.3 的 tag 里都存在,所以「唯一缺口」的主结论不受影响。
  4. 修正结论:判断缺包只能用「逐个依赖与 registry 比对」,不要用依赖总数差、也不要看某个可选 bundle 是否出现。

同一条讨论里还有一处与故障无关的输出容易干扰判断:npm error config prefix cannot be changed from project config: ~/.npmrc 属于本地 npmrc 配置问题,与 ETARGET 没有关系。

发布侧该怎么补门禁:别等用户撞上 ETARGET

一句话结论:真正的缺口在发布流水线——现有验证只装本地 tarball,验不出「本地有、registry 上没有」。 讨论里建议加一道发布后断言:

  1. npm publish 之后逐个查询本 family 的每个成员(npm view <name>@<version> version)。预期:每个成员都有响应;任何一个无响应就中止,不移动 dist-tag。
  2. 或者把「每个精确依赖都能在 registry 解析」做成发布前门禁。 对目标版本的 dependencies 逐个 npm view,全部命中才允许打标签。
  3. 考虑把同家族兄弟包改成 ~ / ^ 范围声明。 这样部分发布的波次会解析到最近的已发布版本,而不是让整条安装失败。讨论里明确指出,这已经是连续第三次「精确 pin 未发布兄弟包」打挂渠道。
  4. 现有 release:verify-packed-install 保留但不够。 它只从本地 tarball 装一棵树,验证的是「本地包互相能装」,验证不了 registry 的可见性。

这类事故不是孤例:0.1.5-rc.* 的 dsh-client-ui-sidebar-documentpreview@0.1.5-rc.3、0.2.0-rc.2 的 dsh-client-ui-settings-account、0.1.0-rc.6 的 dsh-compaction-basic 都属同一类——主包先上、叶子包没跟上(#11984)。

用户侧现在该怎么做

一句话结论:先确认补发是否已完成;没完成就换 latest 或上一个 alpha,完成了就直接装 alpha。 步骤:

  1. 先查两个标签,判断缺口是否还在:npm view @deepseek-ai/dsh dist-tags 与 npm view @deepseek-ai/dsh-tool-pwsh-persistent dist-tags。预期:后者 alpha 已指向 0.2.2-alpha.3 时,缺口已补,可直接安装。
  2. 补发完成时直接装 alpha:npm i -g @deepseek-ai/dsh@alpha。
  3. 缺口还在时先装上一个 alpha 版本(91 个依赖全部可解析):npm i -g @deepseek-ai/dsh@0.2.2-alpha.2。
  4. 或者走稳定线:npm i -g @deepseek-ai/dsh@latest(0.2.1-rc.5,86 个依赖全部可解析)。
  5. 不要靠清缓存、换 registry 镜像、重装 Node 去「修」ETARGET。 这些动作都改变不了解析结果。
  6. 装完确认实际版本:npm ls -g @deepseek-ai/dsh @deepseek-ai/dsh-tool-pwsh-persistent。预期:两个包版本一致,都是 0.2.2-alpha.3。

别忽略「版本装上了但跑不起来」这条后继问题:0.2.2-alpha.3 能装之后,alpha 线仍有 Agent 预设加载失败等其他问题,排查见 DeepSeek Harness Agent 预设全部加载失败。

排查注意事项

ETARGET 这类错误的排查原则是:先分清「解析期失败」与「写盘后失败」,再看报错点名的包。 六条要点:

  1. ETARGET / notarget = registry 没有这个版本,不是网络、不是权限、不是缓存。
  2. --dry-run 是最快的分流器:dry-run 也失败说明与本地环境无关。
  3. 看报错点名的包名与版本号,不要只看「DSH 装不上」这个外层描述。
  4. 逐个依赖比对 registry,不要用依赖总数差、可选 bundle 的有无当作证据。
  5. dist-tag 移动不代表依赖齐全,标签只是别名,没有校验语义。
  6. 修复状态要写清楚:本例已在 2026-11-03T09:03:15Z 补发修复,真机安装验证通过。

来源:Discussion #11984。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

npm i -g @deepseek-ai/dsh@alpha 报 ETARGET,是本地 npm 缓存坏了吗?

DeepSeek Harness 报 ETARGET 不是本地缓存问题。ETARGET 出现在依赖解析阶段,说明 registry 上确实缺少这个版本,与本地缓存、npmrc 配置无关。用 npm i --dry-run 同样会复现,因为它连写盘都不用做就已经在解析期失败。

为什么一个叶子包没发布,就让整条 DeepSeek Harness alpha 渠道都装不上?

因为 DeepSeek Harness 主包把同家族的兄弟包写成了精确版本 pin,npm 解析时必须让每一个精确依赖都找到对应版本,任一缺失就整体中止。0.2.2-alpha.3 声明了 90 个依赖,其中 89 个都能解析,只有 dsh-tool-pwsh-persistent@0.2.2-alpha.3 不存在,结果整条 alpha dist-tag 不可用。

DeepSeek Harness 的 0.2.2-alpha.3 现在还能安装吗?这个 ETARGET 问题修好了没有?

DeepSeek Harness 的这个 ETARGET 问题已经修复。社区成员在讨论中确认 dsh-tool-pwsh-persistent@0.2.2-alpha.3 已于 2026-11-03T09:03:15Z 补发,alpha dist-tag 重新指向 0.2.2-alpha.3,90 个依赖全部可解析。真机执行 npm install @deepseek-ai/dsh@alpha 成功,added 652 packages,耗时约 3 分钟。

看到依赖数从 91 掉到 90、dsh-cua-bundle 不在声明里,能判断这次发布只发了一半吗?

DeepSeek Harness 这边不能这么判断。这个差异来自 git tag 树本身:dsh-cua-bundle 是只在 darwin 平台声明的可选 bundle,在 dsh-v0.2.2-alpha.3 的 tag 里本来就没被声明,与发布是否完整无关。判断缺包要看逐个依赖与 registry 比对的结果,不要用依赖总数差当信号。

相关术语

ETARGET
ETARGET 是 npm 在依赖解析阶段抛出的错误码,表示某个被请求的包版本在 registry 上找不到匹配项,通常写作 No matching version found for <package>@<version>。它发生在写盘之前,因此不会在本地留下半截安装结果。— https://github.com/deepseek-ai/deepseek-harness/discussions/11984
dist-tag
dist-tag 是 npm 给包版本打的别名标签,如 latest、next、alpha,安装时用 @alpha 这样的写法就按标签解析到具体版本。标签本身不会校验目标版本的所有依赖是否可解析,因此标签可以指向一个装不上的版本。— https://github.com/deepseek-ai/deepseek-harness/discussions/11984
精确 pin
精确 pin 是指依赖声明里写死完整版本号(如 0.2.2-alpha.3),而不是用 ^ 或 ~ 这样的范围。精确 pin 的代价是兄弟包任一漏发都会让整棵依赖树解析失败,范围声明则可能退到最近的已发布版本。— https://github.com/deepseek-ai/deepseek-harness/discussions/11984

来源