个人学习小站 SIGNAL DESK 2026
LIVE --:--:-- 反馈
资讯 人工智能 dsh CLI 源码与 npm 包、官方 CLI/代理/插件索引文档、dsh-market README

dsh 插件市场装不上:ETARGET、pnpm 127、装错 profile 怎么修

照着三步教程装 dsh 插件市场,第一条命令就报 ETARGET,第二条报 pnpm 127,装完 Desktop 里又找不到?按 npx、pnpm、profile、入口、代理五道关逐条排查,附 11 条报错原文急救表。

2026年11月21日 18 小时前 作者 站长 约 10 分钟 15 阅读

11 月 19 日掘金那篇《给 Deepseek Harness 装上插件市场》步骤没写错:起服务、dsh plugin --profile web add dshmarket、重启。作者两分钟装完。你把同样三行粘进公司那台 Windows 笔记本,大概率一步一坑:第一条 npx @deepseek-ai/dsh web 就返回 npm error code ETARGET;第二条报 dsh: pnpm was not found;好不容易装上,重启后 Plugins 页里没有 Plugin Market。

三个报错看着无关,其实是同一条链上的五道关:npx 能不能解析到版本、pnpm 在不在 PATH、装进哪个 profile、宿主版本与入口对不对、代理有没有被继承。官方文档每关都写了,但分散在 CLI 参考、网络代理、插件索引三个页面;短视频教程则默认你和作者一样:干净的 Node 24、全局装了 pnpm、只有一套 profile、直连 GitHub。

下面按这五关走一遍。ETARGET 那一关是我在 Node 22.22.2 + npm 10.9.7 上实际复现的,其余命令与报错原文对着 dsh 0.2.2-rc.5 的 CLI 源码逐行核过;版本号截至 11 月 21 日。

组件当前版本发布时间硬要求
dsh(npm 包)0.2.2-rc.511-18 21:17Node ≥ 24.9.0(0.2.2 起才写进 engines)
dshmarket1.74.011-21 01:15宿主 dsh web ≥ 0.1.0-rc.6
官方「发现」索引实验性—不内置索引源,要自己加 URL

第一关:npx 报 ETARGET,不是网络问题

先看现场。在一台 Node 22.22.2(自带 npm 10.9.7)的 Windows 机器上,直接粘官方那条命令:

$ npx @deepseek-ai/dsh web
npm error code ETARGET
npm error notarget No matching version found for @deepseek-ai/dsh@*.

它甚至没开始下载。原因和镜像、代理都无关:npx 把裸包名解析成了 @* 这个版本范围,而 semver 规定 * 不匹配任何预发布版本。这个包从 0.0.1-rc.1 到 0.2.2-rc.5 共 46 个版本,全是 -rc 或 -alpha,一个 stable 都没有,所以 @* 选不出任何东西。

拿 Node 自带 npm 里的 semver 验一下规则本身:

# 用 npm 内置的 semver 模块跑,两行结果
semver.satisfies('0.2.2-rc.5', '*')  →  false
semver.maxSatisfying(['0.2.1-rc.5','0.2.2-rc.5'], '*')  →  null

绕过去只要显式指定 tag 或版本:

# 用 latest 标签,能正常拉起 0.2.2-rc.5
npx @deepseek-ai/dsh@latest web

# 或者钉死版本,团队里最好统一
npx @deepseek-ai/dsh@0.2.2-rc.5 web

我在同一台机器上加 @latest 跑 --version:npm 只打印一段 EBADENGINE 警告(required: node >=24.9.0,current: v22.22.2),CLI 仍然输出版本号。这说明 engines 是软门槛,能打印版本不代表能跑完整会话——0.2.2 起官方把 Node 底线抬到 24.9.0,老机器上别拿「命令能跑」当通过标准。

顺带纠个错:本站在 11 月 13 日写 dsh 桌面端和网页版差在哪时,引的是官方当时的口径「Node ^20.19 或 >=22」。npm 包里的 engines 是 0.2.2-alpha.2 才开始写的,之前 39 个版本根本没这个字段——老教程不算错,只是过期。

第二关:pnpm was not found,dsh 不自带包管理器

CLI 帮助对 dsh plugin 的说明只有一句:把剩余参数转发给 profile 目录里的 pnpm。源码里的处理也很直接——退出码 127 时补一行提示:

dsh: pnpm was not found; install pnpm and make it available on PATH.

也就是说,「装插件」这件事 dsh 只负责把你带到 ~/.dsh/profiles/web/,真正下载、解包、链接依赖的是 pnpm。博主不写这一步,是因为他们机器上早就有。Windows 上没有管理员权限也能装,npm 的全局目录默认就在用户目录下:

npm install -g pnpm
pnpm -v

机器上如果还带 Corepack,corepack enable pnpm 等价。两条都失败,先回去修 node -v,别在插件上找原因。

另有一个少见的坑:dsh plugin 后面跟的参数是原样交给 pnpm 的,顺序错它不会帮你纠正。按官方用法把 --profile 放在 add 前面,排错时能少一个变量。

第三关:装进哪个 profile,决定你在哪能看见它

dsh web 只是 dsh --profile web 的简写。每个 profile 是 $DSH_HOME/profiles/<名字>/ 下一套独立的插件栈,DSH_HOME 默认 ~/.dsh,Windows 上是 C:\Users\你的用户名\.dsh\profiles\。桌面客户端用的是保留名 desktop 的 profile,不是 web。

market 的 README 专门为这件事写了一段:在有 Desktop 的机器上跑 --profile web,命令会报成功,但装进 profiles/web,不是你正在用的 Desktop,所以它永远不会出现在 Desktop 里。反过来直接给 desktop 装,会被源码拦下来:

dsh: Open DeepSeek Harness Desktop once to initialize its profile,
then fully quit it before running dsh plugin --profile desktop.

意思是这个 profile 得由应用自己初始化,而且装之前要完全退出。与其折腾这一步,不如用 GUI:Desktop → Settings → Plugins → 搜 dshmarket → 安装,不用命令行,也不会装错 profile。

三条安装路径分别落到 desktop、web、自定义 profile 的对照图

第四关:入口在 0.2.1 搬过家,宿主太老还会自我禁用

装完重启,Plugins 页里找不到 Plugin Market,先别重装——入口位置改过一次,而且宿主太老时市场会「自己关掉自己」:

宿主版本入口位置备注
0.2.0 及更早Settings → Plugin Market当时唯一入口,Settings 页在 0.2.1 被移除
0.2.1 及以上Plugins → Plugin Market 页签与 Installed 并排,普通 dsh web 也有
低于 0.1.0-rc.6没有市场禁用自身,原因只写在浏览器控制台

「自己关掉自己」是 market README 里明写的:宿主低于 dsh web 0.1.0-rc.6 时,市场会禁用自身,原因只写在浏览器控制台,页面上不显示任何东西。所以入口不出现时,按 F12 看 Console 比翻插件列表快。

Desktop 用户还要多查一层:桌面端可能自带一个比 npm 更老的 dsh(README 引的是 issue #139)。dsh --version 看的是 PATH 里的 CLI,不一定是 Desktop 内置那个;两者对不上时,入口位置和兼容性判断都会跟着错。

官方「发现」页为什么是空的

0.2.1+ 的 Plugins 页里有个实验性的「自定义插件索引」,打开后出现「发现」标签页。它不是应用商店:DSH 不内置任何索引源,得自己点「添加索引源」填一个 JSON 地址,而且索引源按 profile 各自独立。只装一两个插件、又不想引入 pnpm 的人,这条路更轻;想要截图、分类、一键更新,才需要 dshmarket 这种完整市场(13,082 star,目录里 12,000+ 个插件)。

第五关:浏览器能开 3080,插件却拉不动

症状很统一:市场页能打开,插件列表一直转圈,点安装就超时。这不是插件坏了,是「系统代理」这四个字误导人。官方代理文档明确说:不存在一套所有软件都遵循的系统代理,实际有三套互不相干的机制。

机制谁会遵循DSH 是否读
操作系统代理设置Safari、多数 macOS 原生应用、Chrome / Edge不读
HTTP_PROXY / HTTPS_PROXY / ALL_PROXYcurl、git、npm、pip 以及 DSH读,仅在启动时读一次
TUN 模式(虚拟网卡)所有程序,对应用透明等效于透明代理

Clash 这类软件的「系统代理」开关只写第一套,浏览器读得到,命令行工具永远看不到;DSH 不读操作系统的代理设置。要它走代理,只能给环境变量,或者开 TUN 模式。

还有四个官方点名的限制,踩一个就够折腾半天:

  • 不支持 SOCKS。socks5:// 的值会在启动时被报出来然后跳过,对应协议转直连;要填代理软件的 HTTP 端口(Clash 的 mixed 端口通常同时支持 HTTP)。
  • NO_PROXY 不认 CIDR。把系统绕过列表里的 10.0.0.0/8 抄进去没有任何效果,得写主机名或域名后缀。
  • 企业代理做 TLS 拦截时要给证书。代理通了仍报证书错误,启动前用 NODE_EXTRA_CA_CERTS 指向公司 CA 的 pem;Node 只在进程启动时读一次。
  • 项目里的 .env 不能设代理。DSH 宁可拒绝启动,也不让一个 git clone 下来的仓库决定流量去向;要写就写进 ~/.dsh/.env。
# %USERPROFILE%\.dsh\.env
HTTPS_PROXY=http://127.0.0.1:7890
HTTP_PROXY=http://127.0.0.1:7890
NO_PROXY=internal.corp.example,.corp.example
NODE_EXTRA_CA_CERTS=C:\certs\corporate-ca.pem

改完必须重启 dsh 进程。验证方式官方也给了一条:让 agent 抓个页面,同时看代理软件的连接日志;没请求就先确认变量真进了 dsh 的环境(PowerShell:Get-ChildItem Env: | Where-Object Name -match proxy)。

只有 GitHub 慢、代理本身没问题时,市场还有一层回退:中国区优先从 npm 镜像读插件目录,refs、README、头像各有独立回退顺序;全挂了可在 Settings → Plugins → Plugin configuration → GitHub acceleration 填固定的 https 前缀,或用环境变量 DSHM_GITHUB_PROXY。目录取不到时,DSHM_REGISTRY_URL 可指向任意同格式的 plugins.json 镜像。

dsh 插件安装五道关卡的失败症状对照图

按顺序装一遍:五个步骤与三个验证点

顺序别跳:版本 → pnpm → 代理 → 安装 → 入口。没有桌面客户端的机器(Linux、Intel Mac)只能走 CLI,这条链一步都省不了。

  1. 看 Node。node -v 要 ≥ 24.9.0;不够就装用户级的 fnm 或 nvm-windows,别动系统 Node。
  2. 看 pnpm。pnpm -v 有输出就跳过,没有就 npm install -g pnpm。
  3. 把代理写进 dsh 自己的环境。%USERPROFILE%\.dsh\.env,写完重启进程。
  4. 装市场。Desktop 走 Settings → Plugins 搜 dshmarket;纯 CLI 用下面的命令,装完重启。
  5. 对入口。0.2.1+ 看 Plugins → Plugin Market,0.2.0 及更早看 Settings → Plugin Market。
# 纯 CLI:装进 web profile
dsh plugin --profile web add dshmarket

# 预构建包,跳过 GitHub 源码构建(约 1 MB,最稳)
dsh plugin --profile web add https://github.com/dsh-market/dsh-market/releases/download/v1.74.0/dshmarket-1.74.0.tgz

# 重启,让插件树重建
npx @deepseek-ai/dsh@latest web

三个验证点:终端能打开 3080、Plugins 页出现 Plugin Market 页签、市场里能搜到插件并看到「安装」按钮。三个都过,再去调模型和工作区。

常见翻车报错与急救清单

下面这张表按你看到的报错原文查。最麻烦的是中间几行——命令返回 0、页面什么都不提示,最容易被误判成插件 bug。判断顺序永远是先看 profile,再看宿主版本,最后才怀疑网络。

症状原文 / 特征处置
第一条命令就停npm error code ETARGET … @deepseek-ai/dsh@*改用 @latest 或钉版本;或把 Node 升到 24.9+
装插件直接退出dsh: pnpm was not found…(退出码 127)npm install -g pnpm;或改用 Desktop 的 GUI 安装
Desktop 里没有 Market命令返回 0,无任何报错装进了 web profile;改用 Settings → Plugins 安装
给 desktop 装被拦Open DeepSeek Harness Desktop once to initialize…先启动一次 Desktop 并完全退出;或直接用 GUI
入口找不到Plugins 页没有 Plugin Market先查宿主版本与入口位置;F12 看控制台禁用原因
市场能开、列表空一直转圈、安装超时代理没进 dsh 环境;写 ~/.dsh/.env 或开 TUN;必要时配 DSHM_REGISTRY_URL
证书类报错SELF_SIGNED_CERT_IN_CHAIN / UNABLE_TO_VERIFY_LEAF_SIGNATURE启动前设 NODE_EXTRA_CA_CERTS 指向企业 CA,再重启
git 源插件装到一半失败提示 allowBuilds 与 pnpm-workspace.yaml把 pnpm 打印的 key 加进该 profile 的 pnpm-workspace.yaml,重跑
安装被拒提示 allow-version … --accept-risk能换版本就换;强装必须显式接受风险,官方明说可能损坏数据
装完 dsh 起不来一个插件加载失败,整个进程停用市场 Recovery 页取消勾选;命令行兜底 dsh rescue --from-default-profile web
远程/反代点安装 403非同源或缺 trusted host启动加 --trusted-host;安装端只收同源 POST,重启只认本机 loopback

什么情况别装这个市场

  • 公司禁装第三方代码。市场里的 12,000+ 插件都是第三方;它做的只是把来源限定在 curated 列表、构建脚本默认拦截(pnpm ≥10)、终端类插件提前标红,不等于安全审计。
  • 共用或生产机器。市场的备份会把 profile 配置一起导出,里面含 API Key 等凭据;一键重启只接受本机 loopback 请求,反代或远程访问时这个按钮本来就不该能用。
  • 只装一两个插件。官方「自定义插件索引」够用,代价是实验性、要自己维护索引地址。
  • 完全不想碰 Node 和 pnpm。用 Desktop 客户端,装插件全程在 GUI 里完成。

还有一个前提值得说清:dsh 官方把它标为 developer preview,明确写了会有破坏性变更。插件生态很热闹,但版本组合每天都在动;本文的数字都标了日期,过一周请以 npm view @deepseek-ai/dsh version 和 release 页为准。

你卡在哪一关?把 dsh --version、用的 profile 名(web 还是 desktop)和报错原文贴评论区,我按这五关帮你定位——尤其是那些「命令返回 0 但就是看不见」的,八成在第三关。

登录后可点赞、收藏与反馈。

继续阅读 NEXT

更多 →