@1e0zj/dsh-plugin-mall 0.1.12 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,123 +1,172 @@
1
- # dsh-plugin-mall
2
-
3
- **An open plugin marketplace for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh): search every GitHub repo tagged `topic:dsh-plugin`, automatically verify which ones are real dsh plugins, install and update with one click.**
4
-
5
- [中文说明](#中文说明) · [Install](#install) · [Why another marketplace](#why-another-marketplace)
6
-
7
- Two surfaces: a **Settings → Plugins → Marketplace** tab in the dsh web UI, and five agent tools usable from any session.
8
-
9
- ## Why another marketplace?
10
-
11
- Curated lists only show what has been reviewed and merged. This marketplace is open by construction: **any repo tagged `topic:dsh-plugin` is discoverable the moment it is pushed** — no submission, no approval queue. To keep that openness usable:
12
-
13
- - **Automatic verification** — every search result's `package.json` is fetched (jsDelivr/raw dual-source CDN, no API quota) and checked for the official `dsh.bundle` / `dsh.client` manifest. Verified plugins get a green badge; the default "verified only" view filters out ~73% of topic noise (empty repos and unrelated projects riding the tag).
14
- - **Anti-squatting** — an install prefers the npm tarball only when the registry entry's `repository` URL points back to the same GitHub repo; anything else falls back to the explicit `github:` spec.
15
- - **npm-first installs** — registry tarballs are smaller than whole-repo GitHub downloads and come with integrity checks.
16
- - **Update management** — installed plugins are compared against the registry `latest`; one-click update per plugin.
17
- - **Resilience** — rate-limit circuit breaker, GitHub's 1000-result search window handled gracefully, `corepack enable pnpm` self-heal when pnpm is missing, one-click dsh restart (loopback-only, `allowRestart: false` to disable).
18
-
19
- ## Install
20
-
21
- ```powershell
22
- # from npm
23
- dsh plugin --profile web add @1e0zj/dsh-plugin-mall
24
-
25
- # from GitHub
26
- dsh plugin --profile web add github:1e0zj/dsh-plugin-mall
27
-
28
- # local development (symlink; restart dsh after edits)
29
- dsh plugin --profile web add link:C:\path\to\dsh-plugin-mall
30
- ```
31
-
32
- Restart dsh after installing.
33
-
34
- ## Agent tools
35
-
36
- | Tool | What it does |
37
- |---|---|
38
- | `market_search` | Search GitHub repos tagged `topic:dsh-plugin` (star-ranked, keyword filter, server-side `stars:>=1` noise floor) |
39
- | `market_info` | Inspect one repo: stars, license, package.json, whether it declares `dsh.bundle.patch` / `dsh.client` |
40
- | `market_install` | Install a plugin into a profile as a background job (npm-first spec resolution) |
41
- | `market_uninstall` | Remove a plugin: `pnpm remove` + bundle-layer reconcile + client-row cleanup |
42
- | `market_installed` | List a profile's installed plugins and their bundle status |
43
-
44
- ---
45
-
46
- # 中文说明
47
-
48
- **dsh 插件市场** — 搜索 GitHub `dsh-plugin` 话题下的 DeepSeek Harness 插件仓库,自动验证哪些是真 dsh 插件,一键安装与更新。
49
-
50
- 与策展列表不同:**任何打上 `topic:dsh-plugin` 的仓库推送后立即可被发现**——无需投稿、无需审批。为保证开放性可用,做了这些事:
51
-
52
- - **自动验证**:逐仓库拉取 `package.json`(jsDelivr/raw 双源 CDN,不占 API 配额),按官方 `dsh.bundle` / `dsh.client` 声明打徽章;默认"只看已验证"视图过滤约 73% 的话题噪音
53
- - **防抢注**:仅当 npm registry 条目的 `repository` 指回同一 GitHub 仓库时才用 npm 安装,否则回退 `github:`
54
- - **npm 优先安装**:registry tarball 比整仓库下载更小且带完整性校验
55
- - **更新管理**:已装插件与 registry `latest` 比对,逐个一键更新
56
- - **工程韧性**:限流熔断、GitHub 1000 条搜索上限优雅处理、pnpm 缺失时 `corepack` 自愈、一键重启 dsh(仅 loopback,可 `allowRestart: false` 关闭)
57
-
58
- ## 安装
59
-
60
- ```powershell
61
- # 从 npm
62
- dsh plugin --profile web add @1e0zj/dsh-plugin-mall
63
-
64
- # 从 GitHub
65
- dsh plugin --profile web add github:1e0zj/dsh-plugin-mall
66
-
67
- # 本地开发(软链,改代码后重启 dsh 即生效)
68
- dsh plugin --profile web add link:C:\path\to\dsh-plugin-mall
69
- ```
70
-
71
- 装完**重启 dsh**(`dsh web` 进程)后生效。
72
-
73
- > Windows 下用 `link:` 开发本插件时,Node 会从项目的真实路径加载模块,
74
- > 因此项目目录里必须先装一次依赖(`npm install`),裸导入才能解析;
75
- > 通过 npm/GitHub 安装时无此要求(pnpm 会把真实拷贝装进 profile 的 node_modules)。
76
-
77
- ## 工作原理
78
-
79
- - 双面包(dual-face)插件:`dsh.bundle` 半边挂在 **host 平面**(profile bundle 层),
80
- 注册 5 agent 工具(进 global 层,所有会话可见,与 MCP 工具同理);
81
- `dsh.client` 半边是浏览器插件,往设置页插件区注册「插件市场」tab
82
- (`settings.plugins.tab` slot;手写无构建,经 `window.__ModuleLoader__` 加载)。
83
- - 浏览器 服务端走 Connection 服务的独立 RPC 通道 `/market`
84
- (loopback-only,与 `/api` 通道互不干扰);页面发起的安装任务用进程内
85
- tracker 跟踪 —— web host 层没有 job 控制器,`ctx.jobs` 无法在会话外起任务。
86
- - `market_install` 复刻官方 `dsh plugin add` 的流程:在 profile 目录跑
87
- `pnpm add <spec>`,成功后把声明了 `dsh.bundle.patch` 的依赖登记进
88
- `dsh.profile.bundles`(layer 列表),声明了 `dsh.client` 的依赖自动在
89
- profile `cordis.patch.yml` 注册加载行,与官方 reconcile 逻辑一致。
90
- - `market_uninstall` 复刻官方 `dsh plugin remove` 的流程:在 profile 目录跑
91
- `pnpm remove <package>`,成功后从 `dsh.profile.bundles` 剔除该依赖的
92
- bundle 条目,并删掉 `cordis.patch.yml` 里由安装流程注册的客户端加载行
93
- (文本级精准移除,用户手写的行不受影响)。
94
- - 安装源解析:`github:owner/repo` 优先改写为同名 npm 包(仅当 registry
95
- 条目的 repository 指回该仓库,防止抢注),否则用 GitHub 全仓库 spec。
96
- - GitHub 源的插件安装时要跑 prepare 构建脚本,pnpm 默认拦截;本插件检测到
97
- 拦截后会把包名自动合并进 profile 的 `pnpm-workspace.yaml` 的 `allowBuilds`
98
- 并自动重试一次(解析只认合法 npm 包名,写入一律加引号,不会写坏 YAML)。
99
- - 配置(`cordis.patch.yml` 中可改):`defaultProfile`(默认装进哪个 profile,
100
- 默认 `web`)、`apiBase`(GitHub API 地址)、`perPageMax`(搜索单页上限)、
101
- `allowRestart`(是否允许一键重启,默认 `true`)。
102
-
103
- ## 发布
104
-
105
- ```bash
106
- npm publish --access public
107
- # 或在 GitHub 建仓库并打上 topic:dsh-plugin
108
- ```
109
-
110
- ## 开发说明
111
-
112
- - 插件形态:`package.json` `"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }`,
113
- patch 文件把 `dsh-plugin-mall` 这一行 insert 进装配树;**同一行同时是
114
- client 插件行**(`dsh.client` 声明让 client-modules 扫描并服务
115
- `/plugins/<id>/client.js`)。
116
- - **`@deepseek-ai/*` 框架包必须声明为 `peerDependencies`**:装成 dependencies
117
- 会把宿主模块副本 hoist profile,cordis loader 双副本加载、Symbol 身份
118
- 分裂,宿主的工具调度全线崩溃。宿主经 `profiles/node_modules` fallback
119
- 提供框架包。
120
- - node 半边导出具名成员 `{ name, inject, Config, apply }`,**不要** `export default`
121
- (cordis loader 会做 `exports.default ?? exports` 解包,default 会吞掉 inject/Config);
122
- client 半边是 `window.__ModuleLoader__.load({id, factory})`,导出 `{ apply, inject }`。
123
- - 单测 `src/github.js`(无 harness 依赖):`node src/github.js --self-test`。
1
+ # dsh-plugin-mall
2
+
3
+ **An open plugin marketplace for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh): search every GitHub repo tagged `topic:dsh-plugin`, automatically verify which ones are real dsh plugins, install and update with one click.**
4
+
5
+ [中文说明](#中文说明) · [Install](#install) · [Why another marketplace](#why-another-marketplace)
6
+
7
+ Two surfaces: a **Settings → Plugins → Marketplace** tab in the dsh web UI, and five agent tools usable from any session.
8
+
9
+ ## Why another marketplace?
10
+
11
+ Curated lists only show what has been reviewed and merged. This marketplace is open by construction: **any repo tagged `topic:dsh-plugin` is discoverable the moment it is pushed** — no submission, no approval queue. To keep that openness usable:
12
+
13
+ - **Automatic verification** — every search result's `package.json` is fetched (jsDelivr/raw dual-source CDN, no API quota) and checked for the official `dsh.bundle` / `dsh.client` manifest. Verified plugins get a green badge; the default "verified only" view filters out ~73% of topic noise (empty repos and unrelated projects riding the tag).
14
+ - **Anti-squatting** — an install prefers the npm tarball only when the registry entry's `repository` URL points back to the same GitHub repo; anything else falls back to the explicit `github:` spec.
15
+ - **npm-first installs** — registry tarballs are smaller than whole-repo GitHub downloads and come with integrity checks. Lookups follow the registry pnpm actually installs from (profile `.npmrc` → `pnpm config get registry` → npmjs), so a mirror user keeps npm-first instead of silently falling back to whole-repo clones.
16
+ - **Update management** — installed plugins are compared against the registry `latest`; one-click update per plugin.
17
+ - **Resilience** — rate-limit circuit breaker, GitHub's 1000-result search window handled gracefully, `corepack enable pnpm` self-heal when pnpm is missing, one-click dsh restart (loopback-only, `allowRestart: false` to disable).
18
+
19
+ ## Install
20
+
21
+ ```powershell
22
+ # from npm
23
+ dsh plugin --profile web add @1e0zj/dsh-plugin-mall
24
+
25
+ # from GitHub
26
+ dsh plugin --profile web add github:1e0zj/dsh-plugin-mall
27
+
28
+ # local development currently unusable, see the note below
29
+ dsh plugin --profile web add link:C:\path\to\dsh-plugin-mall
30
+ ```
31
+
32
+ Restart dsh after installing.
33
+
34
+ > **`link:` cannot be set up right now**, for reasons upstream of this plugin. Under
35
+ > `link:` Node loads from the project's real path, so bare imports must resolve from
36
+ > the project's own `node_modules` which requires `npm install` inside the project
37
+ > first. That fails: the framework packages' registry dist-tags currently straddle two
38
+ > release trains (`dsh-tools` latest is still `0.0.1-rc.x` while `dsh-app-boot` is on
39
+ > `0.1.0-rc.x`), their peer ranges do not intersect, and npm stops with ERESOLVE.
40
+ > Neither escape hatch helps `--legacy-peer-deps` skips peers so bare imports still
41
+ > will not resolve, and `--force` plants a mixed-train copy of the framework inside the
42
+ > project, which `link:` would then load instead of the host's, causing exactly the
43
+ > duplicate-module crash described under 开发说明. Until those dist-tags line up,
44
+ > develop against a local tarball — `npm pack`, then install the `.tgz` with a `file:`
45
+ > spec (recipe in the 安装 section below). Do not hand-overwrite files under
46
+ > `node_modules`: they are hard-linked into pnpm's global store, and any later
47
+ > `pnpm add/remove` rebuilds the tree and restores them anyway.
48
+
49
+ ## Agent tools
50
+
51
+ | Tool | What it does |
52
+ |---|---|
53
+ | `market_search` | Search GitHub repos tagged `topic:dsh-plugin` (star-ranked, keyword filter, server-side `stars:>=1` noise floor) |
54
+ | `market_info` | Inspect one repo: stars, license, package.json, whether it declares `dsh.bundle.patch` / `dsh.client` |
55
+ | `market_install` | Install a plugin into a profile as a background job (npm-first spec resolution) |
56
+ | `market_uninstall` | Remove a plugin: `pnpm remove` + bundle-layer reconcile + client-row cleanup |
57
+ | `market_installed` | List a profile's installed plugins and their bundle status |
58
+
59
+ ---
60
+
61
+ # 中文说明
62
+
63
+ **dsh 插件市场** — 搜索 GitHub `dsh-plugin` 话题下的 DeepSeek Harness 插件仓库,自动验证哪些是真 dsh 插件,一键安装与更新。
64
+
65
+ 与策展列表不同:**任何打上 `topic:dsh-plugin` 的仓库推送后立即可被发现**——无需投稿、无需审批。为保证开放性可用,做了这些事:
66
+
67
+ - **自动验证**:逐仓库拉取 `package.json`(jsDelivr/raw 双源 CDN,不占 API 配额),按官方 `dsh.bundle` / `dsh.client` 声明打徽章;默认"只看已验证"视图过滤约 73% 的话题噪音
68
+ - **防抢注**:仅当 npm registry 条目的 `repository` 指回同一 GitHub 仓库时才用 npm 安装,否则回退 `github:` 源
69
+ - **npm 优先安装**:registry tarball 比整仓库下载更小且带完整性校验;查询用的 registry 跟随 pnpm 实际安装源(profile `.npmrc` → `pnpm config get registry` → npmjs),换了镜像也不会退化成整仓库克隆
70
+ - **更新管理**:已装插件与 registry `latest` 比对,逐个一键更新
71
+ - **工程韧性**:限流熔断、GitHub 1000 条搜索上限优雅处理、pnpm 缺失时 `corepack` 自愈、一键重启 dsh(仅 loopback,可 `allowRestart: false` 关闭)
72
+
73
+ ## 安装
74
+
75
+ ```powershell
76
+ # 从 npm
77
+ dsh plugin --profile web add @1e0zj/dsh-plugin-mall
78
+
79
+ # GitHub
80
+ dsh plugin --profile web add github:1e0zj/dsh-plugin-mall
81
+
82
+ # 本地开发 —— 目前装不起来,见下方说明
83
+ dsh plugin --profile web add link:C:\path\to\dsh-plugin-mall
84
+ ```
85
+
86
+ 装完**重启 dsh**(`dsh web` 进程)后生效。
87
+
88
+ > **`link:` 目前用不了**,原因在上游、与本插件无关。`link:` 下 Node 从项目的真实
89
+ > 路径加载模块,裸导入只能从项目自己的 `node_modules` 解析,所以得先在项目里
90
+ > `npm install` 一次 —— 而这一步会失败:框架包在 registry 上的 dist-tags 眼下横跨
91
+ > 两条发布线(`dsh-tools` latest 还停在 `0.0.1-rc.x`,`dsh-app-boot` 已经是
92
+ > `0.1.0-rc.x`),二者对 `dsh-invariants` 的 peer 区间无交集(`^0.0.1-rc.x` 只收
93
+ > `0.0.1-rc.x`,`^0.1.0-rc.x` 只收 `0.1.x`),npm 以 ERESOLVE 中止。
94
+ > 两个逃生口都不解决问题:`--legacy-peer-deps` 跳过 peer,裸导入照样解析不了;
95
+ > `--force` 会在项目里装一套**混版本的框架副本**,`link:` 加载的就是那套而不是宿主
96
+ > 那套 —— 正好踩中下面「开发说明」里讲的双副本身份分裂崩溃。
97
+ >
98
+ > 在上游 dist-tags 对齐前,本地开发用**本地 tarball**:
99
+ >
100
+ > ```bash
101
+ > npm pack # 产出 1e0zj-dsh-plugin-mall-<ver>.tgz
102
+ > dsh plugin --profile web remove @1e0zj/dsh-plugin-mall
103
+ > dsh plugin --profile web add file:C:\code\dsh-plugin-mall\1e0zj-dsh-plugin-mall-0.1.13.tgz
104
+ > ```
105
+ >
106
+ > 这样 pnpm 的规范副本本身就是新代码,后续任何 `pnpm add/remove` 重建依赖树都不会
107
+ > 把它换掉;顺带还验证了 `files` 字段没漏文件。改完代码重新 `npm pack` + 重装即可。
108
+ >
109
+ > **不要用直接覆盖 `node_modules` 里文件的办法。** 它有两个坑:
110
+ > 一是 pnpm 装出来的文件是**硬链接**(与全局 store 共享 inode),直接 `cp` 覆盖会
111
+ > 穿透硬链接改掉 store 里的内容且 pnpm 不会察觉,必须先 `rm` 再写;二是**任何一次
112
+ > pnpm 操作都会重建整棵树**,按 lockfile store 把你覆盖的文件还原回去 —— 而通过
113
+ > 本插件装/卸任何插件都会触发 `pnpm add/remove`,也就是说测试市场的安装功能这个动作
114
+ > 本身就会抹掉被测代码。(已加载进内存的模块不受影响,重启后才会退回旧版。)
115
+ >
116
+ > 通过 npm/GitHub 安装则没有上述任何问题:pnpm 把真实拷贝装进 profile 的
117
+ > `node_modules`,框架包由宿主经 `profiles/node_modules` 里指向全局 dsh 的软链提供,
118
+ > 版本天然一致。
119
+ >
120
+ > 另:Windows `file:`/`link:` 的路径**不能含空格**。pnpm 是经 cmd 拉起的,
121
+ > Node 只把参数用空格拼接、不逐参加引号,带空格的路径会被拆成两个参数;
122
+ > 自己加引号也不行(`"` 属于被拦截的 shell 元字符)。市场会直接拒绝并说明原因。
123
+
124
+ ## 工作原理
125
+
126
+ - 双面包(dual-face)插件:`dsh.bundle` 半边挂在 **host 平面**(profile bundle 层),
127
+ 注册 5 个 agent 工具(进 global 层,所有会话可见,与 MCP 工具同理);
128
+ `dsh.client` 半边是浏览器插件,往设置页插件区注册「插件市场」tab
129
+ (`settings.plugins.tab` slot;手写无构建,经 `window.__ModuleLoader__` 加载)。
130
+ - 浏览器 → 服务端走 Connection 服务的独立 RPC 通道 `/market`
131
+ (loopback-only,与 `/api` 通道互不干扰);页面发起的安装任务用进程内
132
+ tracker 跟踪 —— web host 层没有 job 控制器,`ctx.jobs` 无法在会话外起任务。
133
+ - `market_install` 复刻官方 `dsh plugin add` 的流程:在 profile 目录跑
134
+ `pnpm add <spec>`,成功后把声明了 `dsh.bundle.patch` 的依赖登记进
135
+ `dsh.profile.bundles`(layer 列表),声明了 `dsh.client` 的依赖自动在
136
+ profile 的 `cordis.patch.yml` 注册加载行,与官方 reconcile 逻辑一致。
137
+ - `market_uninstall` 复刻官方 `dsh plugin remove` 的流程:在 profile 目录跑
138
+ `pnpm remove <package>`,成功后从 `dsh.profile.bundles` 剔除该依赖的
139
+ bundle 条目,并删掉 `cordis.patch.yml` 里由安装流程注册的客户端加载行
140
+ (文本级精准移除,用户手写的行不受影响)。
141
+ - 安装源解析:`github:owner/repo` 优先改写为同名 npm 包(仅当 registry
142
+ 条目的 repository 指回该仓库,防止抢注),否则用 GitHub 全仓库 spec。
143
+ - GitHub 源的插件安装时要跑 prepare 构建脚本,pnpm 默认拦截;本插件检测到
144
+ 拦截后会把包名自动合并进 profile 的 `pnpm-workspace.yaml` 的 `allowBuilds`
145
+ 并自动重试一次(解析只认合法 npm 包名,写入一律加引号,不会写坏 YAML)。
146
+ - 配置(`cordis.patch.yml` 中可改):`defaultProfile`(默认装进哪个 profile,
147
+ 默认 `web`)、`apiBase`(GitHub API 地址)、`npmRegistry`(npm 查询源,留空
148
+ 则跟随 pnpm 实际安装源)、`rawSources`(验证用的 package.json 源模板列表,
149
+ `{repo}` 会替换成 owner/name,留空用内置的 jsDelivr + raw 双源)、
150
+ `perPageMax`(搜索单页上限)、`allowRestart`(是否允许一键重启,默认 `true`)。
151
+
152
+ ## 发布
153
+
154
+ ```bash
155
+ npm publish --access public
156
+ # 或在 GitHub 建仓库并打上 topic:dsh-plugin
157
+ ```
158
+
159
+ ## 开发说明
160
+
161
+ - 插件形态:`package.json` 里 `"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }`,
162
+ patch 文件把 `dsh-plugin-mall` 这一行 insert 进装配树;**同一行同时是
163
+ client 插件行**(`dsh.client` 声明让 client-modules 扫描并服务
164
+ `/plugins/<id>/client.js`)。
165
+ - **`@deepseek-ai/*` 框架包必须声明为 `peerDependencies`**:装成 dependencies
166
+ 会把宿主模块副本 hoist 进 profile,cordis loader 双副本加载、Symbol 身份
167
+ 分裂,宿主的工具调度全线崩溃。宿主经 `profiles/node_modules` fallback
168
+ 提供框架包。
169
+ - node 半边导出具名成员 `{ name, inject, Config, apply }`,**不要** `export default`
170
+ (cordis loader 会做 `exports.default ?? exports` 解包,default 会吞掉 inject/Config);
171
+ client 半边是 `window.__ModuleLoader__.load({id, factory})`,导出 `{ apply, inject }`。
172
+ - 单测 `src/github.js`(无 harness 依赖):`node src/github.js --self-test`。
package/cordis.patch.yml CHANGED
@@ -9,5 +9,17 @@
9
9
  defaultProfile: web
10
10
  # GitHub REST API base (override for self-hosted mirrors/proxies).
11
11
  apiBase: https://api.github.com
12
+ # npm registry for anti-squatting, update checks and the host-dependency
13
+ # guard. Empty = follow whatever pnpm installs from (the profile's
14
+ # .npmrc, then `pnpm config get registry`, then npmjs), which is what
15
+ # you want on a mirror — set this only to pin a different one.
16
+ npmRegistry: ''
17
+ # package.json sources for plugin verification, tried in order until one
18
+ # answers; `{repo}` is replaced with owner/name. Empty = jsDelivr then
19
+ # raw.githubusercontent.com. Override for a self-hosted reverse proxy.
20
+ rawSources: []
12
21
  # Upper bound for market_search perPage.
13
22
  perPageMax: 30
23
+ # Whether the marketplace tab may restart the dsh process. Set false when
24
+ # something else (systemd, pm2, …) owns the process lifecycle.
25
+ allowRestart: true
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1e0zj/dsh-plugin-mall",
3
- "version": "0.1.12",
3
+ "version": "0.1.13",
4
4
  "description": "dsh 插件市场:搜索 GitHub dsh-plugin 话题下的插件仓库,一键安装到本地 dsh profile(agent 工具 + 设置页插件市场 tab)",
5
5
  "type": "module",
6
6
  "main": "src/index.js",
package/src/github.js CHANGED
@@ -116,25 +116,50 @@ export async function searchPlugins({ query, sort = "stars", perPage = 10, page
116
116
  // points back at that GitHub repo, which doubles as an anti-squatting check
117
117
  // (an unrelated package squatting the name never matches, install falls back
118
118
  // to the explicit github: spec).
119
+ //
120
+ // The registry to query is the CALLER's business (see resolveRegistry in
121
+ // installer.js): it has to be the one pnpm installs from. Querying npmjs while
122
+ // pnpm installs from a mirror fails three ways at once and all of them are
123
+ // silent — anti-squatting never matches (every install degrades to a whole-repo
124
+ // GitHub clone plus a prepare build), `latest` comes back null (the update
125
+ // button disappears), and assertSafeToInstall sees no manifest, so the
126
+ // host-shadow guard stops guarding.
127
+
128
+ export const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
129
+ // `${registry}|${name}` -> {info, at}. Keyed by registry so a config change
130
+ // cannot serve answers from a different registry.
131
+ const npmCache = new Map();
132
+ // Success and failure expire alike. A never-expiring success cache means
133
+ // `hasUpdate` is frozen for the process lifetime: the author publishes, and no
134
+ // amount of "刷新已装" shows it until dsh restarts — self-defeating for a
135
+ // marketplace whose selling point is update management.
136
+ const NPM_CACHE_TTL = 300000;
119
137
 
120
- const NPM_REGISTRY = "https://registry.npmjs.org";
121
- const npmCache = new Map(); // name -> {info, at} — null misses expire after 5 min
138
+ /** Strip trailing slashes so `${base}/${name}` never doubles up. */
139
+ function normalizeRegistry(registry) {
140
+ const value = String(registry ?? "").trim();
141
+ return (value.length > 0 ? value : DEFAULT_NPM_REGISTRY).replace(/\/+$/, "");
142
+ }
122
143
 
123
144
  /**
124
- * Look up a package on the npm registry (abbreviated metadata). Successful
125
- * lookups cache for the process lifetime; "not found / unreachable" (null)
126
- * expires after 5 minutes so a transient registry failure self-heals.
145
+ * Look up a package's `latest` manifest on an npm registry.
146
+ * @param name - the npm package name.
147
+ * @param options - `registry` defaults to npmjs; pass what pnpm installs from.
148
+ * @returns `{latest, repositoryUrl, hostDeps}`, or null when unknown/unreachable.
127
149
  */
128
- export async function npmPackageInfo(name) {
150
+ export async function npmPackageInfo(name, { registry } = {}) {
129
151
  const clean = String(name ?? "").trim();
130
152
  if (clean.length === 0 || !/^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/i.test(clean)) return null;
131
- const cached = npmCache.get(clean);
132
- if (cached !== undefined && (cached.info !== null || Date.now() - cached.at < 300000)) return cached.info;
153
+ const base = normalizeRegistry(registry);
154
+ const key = `${base}|${clean}`;
155
+ const cached = npmCache.get(key);
156
+ if (cached !== undefined && Date.now() - cached.at < NPM_CACHE_TTL) return cached.info;
133
157
  let info = null;
134
158
  try {
135
159
  // 单版本端点返回 latest 的完整 manifest(dependencies + repository 都在)。
136
160
  // abbreviated packument 不含 repository,防抢注比对会永远落空。
137
- const response = await fetch(`${NPM_REGISTRY}/${clean.replace("/", "%2F")}/latest`, {
161
+ // 镜像(npmmirror 等)的同名端点响应格式一致,两个字段都保留。
162
+ const response = await fetch(`${base}/${clean.replace("/", "%2F")}/latest`, {
138
163
  headers: { "User-Agent": "dsh-plugin-mall", Accept: "application/json" },
139
164
  });
140
165
  if (response.ok) {
@@ -152,7 +177,7 @@ export async function npmPackageInfo(name) {
152
177
  } catch {
153
178
  info = null; // registry unreachable — caller falls back
154
179
  }
155
- npmCache.set(clean, { info, at: Date.now() });
180
+ npmCache.set(key, { info, at: Date.now() });
156
181
  return info;
157
182
  }
158
183
 
@@ -161,15 +186,20 @@ export async function npmPackageInfo(name) {
161
186
  * that package exists on npm AND its repository URL points back at the repo
162
187
  * (anti-squatting). Anything else passes through untouched.
163
188
  */
164
- export async function preferNpmSpec({ spec }) {
189
+ export async function preferNpmSpec({ spec, registry, sources }) {
165
190
  const raw = String(spec ?? "");
191
+ // A scoped npm name ("@scope/name", "@scope/name@1.2.3") is shaped exactly
192
+ // like owner/repo and matches the regex below, sending every such install
193
+ // off to verify a repository that cannot exist — two wasted CDN requests and
194
+ // a bogus cache entry. Same guard normalizeSpec already uses.
195
+ if (raw.startsWith("@")) return raw;
166
196
  const githubMatch = /^(?:github:)?([^/\s]+\/[^/\s]+?)(?:\.git)?$/i.exec(raw);
167
197
  if (githubMatch === null) return raw;
168
198
  const repo = githubMatch[1];
169
- const { results } = await verifyPlugins({ repos: [repo] }); // cache hit after first verify
199
+ const { results } = await verifyPlugins({ repos: [repo], sources }); // cache hit after first verify
170
200
  const declaredName = results[repo]?.name;
171
201
  if (typeof declaredName !== "string") return raw;
172
- const info = await npmPackageInfo(declaredName);
202
+ const info = await npmPackageInfo(declaredName, { registry });
173
203
  if (info === null || info.repositoryUrl === undefined) return raw;
174
204
  const pointsBack = new RegExp(`github\\.com[/:]${repo.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(/|\\.git|$)`, "i").test(info.repositoryUrl);
175
205
  return pointsBack ? declaredName : raw;
@@ -197,7 +227,7 @@ function npmNameOf(raw) {
197
227
  return match === null ? null : match[1];
198
228
  }
199
229
 
200
- export async function assertSafeToInstall({ spec }) {
230
+ export async function assertSafeToInstall({ spec, registry, sources }) {
201
231
  const raw = String(spec ?? "");
202
232
  let hostDeps;
203
233
  if (/^(?:file:|link:)/i.test(raw)) {
@@ -211,7 +241,7 @@ export async function assertSafeToInstall({ spec }) {
211
241
  }
212
242
  } else if (/^github:([^/\s]+\/[^/\s]+?)(?:\.git)?(?:#.+)?$/i.test(raw)) {
213
243
  const repo = /^github:([^/\s]+\/[^/\s]+?)(?:\.git)?(?:#.+)?$/i.exec(raw)[1];
214
- const { results } = await verifyPlugins({ repos: [repo] });
244
+ const { results } = await verifyPlugins({ repos: [repo], sources });
215
245
  hostDeps = results[repo]?.hostDeps;
216
246
  } else if (/^https?:\/\//i.test(raw)) {
217
247
  return; // 远程 tarball 下载前无法廉价检查;罕见路径,放行
@@ -222,7 +252,7 @@ export async function assertSafeToInstall({ spec }) {
222
252
  // 无法识别形状的 spec 一律拒绝,而不是静默跳过检查。
223
253
  throw new Error(`cannot analyze install spec ${JSON.stringify(raw)} for host-shadow dependencies — refusing to install`);
224
254
  }
225
- const info = await npmPackageInfo(name);
255
+ const info = await npmPackageInfo(name, { registry });
226
256
  hostDeps = info?.hostDeps;
227
257
  }
228
258
  if (hostDeps !== undefined && hostDeps !== null && hostDeps.length > 0) {
@@ -257,25 +287,52 @@ export function compareVersions(a, b) {
257
287
  // for the process lifetime; a fetch failure caches "unknown" rather than
258
288
  // retrying forever.
259
289
 
260
- const RAW_BASE = "https://raw.githubusercontent.com";
261
- const VERIFY_CONCURRENCY = 8;
290
+ /** Cap on concurrent outbound requests — shared by verification and update checks. */
291
+ export const NETWORK_CONCURRENCY = 8;
262
292
  const verifyCache = new Map();
263
293
 
294
+ /**
295
+ * Run `task` over `items` with at most `limit` workers in flight. The one
296
+ * fan-out primitive for this module's network work, so nothing accidentally
297
+ * bursts every item at once.
298
+ */
299
+ export async function mapLimit(items, limit, task) {
300
+ const list = Array.isArray(items) ? items : [];
301
+ let cursor = 0;
302
+ const worker = async () => {
303
+ while (cursor < list.length) {
304
+ const index = cursor++;
305
+ await task(list[index], index);
306
+ }
307
+ };
308
+ await Promise.all(Array.from({ length: Math.min(limit, list.length) }, worker));
309
+ }
310
+
264
311
  // package.json is fetched from CDNs, not the REST API, so verification never
265
312
  // burns API quota. jsDelivr first (reachable where raw.githubusercontent.com
266
313
  // is blocked), raw as fallback; a 404 only means "no manifest" once EVERY
267
314
  // reachable source 404s (jsDelivr lags new pushes, so one 404 is not final).
268
- const RAW_SOURCES = [
269
- (repo) => `https://cdn.jsdelivr.net/gh/${repo}@HEAD/package.json`,
270
- (repo) => `${RAW_BASE}/${repo}/HEAD/package.json`,
315
+ // URL templates, `{repo}` substituted with owner/name — overridable through
316
+ // the `rawSources` config for self-hosted reverse proxies.
317
+ export const DEFAULT_RAW_SOURCES = [
318
+ "https://cdn.jsdelivr.net/gh/{repo}@HEAD/package.json",
319
+ "https://raw.githubusercontent.com/{repo}/HEAD/package.json",
271
320
  ];
272
321
 
273
- async function fetchRawPackageJson(repo, signal) {
322
+ /** The configured source templates, or the built-in pair. */
323
+ function rawSourcesOf(sources) {
324
+ const list = (Array.isArray(sources) ? sources : [])
325
+ .map((entry) => String(entry ?? "").trim())
326
+ .filter((entry) => entry.length > 0 && entry.includes("{repo}"));
327
+ return list.length > 0 ? list : DEFAULT_RAW_SOURCES;
328
+ }
329
+
330
+ async function fetchRawPackageJson(repo, signal, sources) {
274
331
  let saw404 = false;
275
332
  let lastError;
276
- for (const buildUrl of RAW_SOURCES) {
333
+ for (const template of rawSourcesOf(sources)) {
277
334
  try {
278
- const response = await fetch(buildUrl(repo), {
335
+ const response = await fetch(template.replace("{repo}", repo), {
279
336
  headers: { "User-Agent": "dsh-plugin-mall", Accept: "application/json" },
280
337
  signal,
281
338
  });
@@ -310,36 +367,34 @@ function hostShadowDependencies(pkg) {
310
367
 
311
368
  /**
312
369
  * Verify repositories as real dsh plugins by their package.json declaration.
313
- * @param {{repos: string[], signal?: AbortSignal}} options - "owner/name" list.
370
+ * @param {{repos: string[], signal?: AbortSignal, sources?: string[]}} options - "owner/name" list.
314
371
  * @returns the {results} map: fullName -> {kind: "bundle"|"client"|"plain"|"no-manifest"|"unknown", name?, version?, hostDeps?}.
315
372
  */
316
- export async function verifyPlugins({ repos, signal }) {
373
+ export async function verifyPlugins({ repos, signal, sources }) {
374
+ // A GitHub owner never starts with "@", so rejecting that shape here keeps
375
+ // scoped npm names ("@scope/name") out of repository verification no matter
376
+ // which caller passes them in.
317
377
  const wanted = [...new Set((Array.isArray(repos) ? repos : []).map(String)
318
- .filter((repo) => /^[^/\s]+\/[^/\s]+$/.test(repo) && !repo.includes("..")))];
378
+ .filter((repo) => /^[^@/\s][^/\s]*\/[^/\s]+$/.test(repo) && !repo.includes("..")))];
319
379
  // "unknown"(网络失败)60s 后过期重试;成功结果进程内永久缓存。
320
380
  const pending = wanted.filter((repo) => {
321
381
  const cached = verifyCache.get(repo);
322
382
  if (cached === undefined) return true;
323
383
  return cached.kind === "unknown" && Date.now() - (cached.ts ?? 0) > 60000;
324
384
  });
325
- let cursor = 0;
326
- const worker = async () => {
327
- while (cursor < pending.length) {
328
- const repo = pending[cursor++];
329
- try {
330
- const pkg = await fetchRawPackageJson(repo, signal);
331
- const kind = pkg === undefined ? "no-manifest"
332
- : typeof pkg.dsh?.bundle?.patch === "string" ? "bundle"
333
- : pkg.dsh?.client !== undefined ? "client"
334
- : "plain";
335
- verifyCache.set(repo, { kind, name: pkg?.name, version: pkg?.version, hostDeps: hostShadowDependencies(pkg) });
336
- } catch (error) {
337
- if (error?.name === "AbortError") throw error;
338
- verifyCache.set(repo, { kind: "unknown", ts: Date.now() });
339
- }
385
+ await mapLimit(pending, NETWORK_CONCURRENCY, async (repo) => {
386
+ try {
387
+ const pkg = await fetchRawPackageJson(repo, signal, sources);
388
+ const kind = pkg === undefined ? "no-manifest"
389
+ : typeof pkg.dsh?.bundle?.patch === "string" ? "bundle"
390
+ : pkg.dsh?.client !== undefined ? "client"
391
+ : "plain";
392
+ verifyCache.set(repo, { kind, name: pkg?.name, version: pkg?.version, hostDeps: hostShadowDependencies(pkg) });
393
+ } catch (error) {
394
+ if (error?.name === "AbortError") throw error;
395
+ verifyCache.set(repo, { kind: "unknown", ts: Date.now() });
340
396
  }
341
- };
342
- await Promise.all(Array.from({ length: Math.min(VERIFY_CONCURRENCY, pending.length) }, worker));
397
+ });
343
398
  const results = {};
344
399
  for (const repo of wanted) {
345
400
  const cached = verifyCache.get(repo);
package/src/index.js CHANGED
@@ -19,8 +19,8 @@ import { existsSync, readFileSync } from "node:fs";
19
19
  import { join } from "node:path";
20
20
  import { spawn } from "node:child_process";
21
21
  import { resolveProfileDir } from "@deepseek-ai/dsh-app-boot";
22
- import { repoInfo, searchPlugins, verifyPlugins, preferNpmSpec, npmPackageInfo, compareVersions, assertSafeToInstall } from "./github.js";
23
- import { ensureProfile, listInstalled, normalizeSpec, runInstall, runRemove, createJobTracker, assertSafeSpec } from "./installer.js";
22
+ import { repoInfo, searchPlugins, verifyPlugins, preferNpmSpec, npmPackageInfo, compareVersions, assertSafeToInstall, mapLimit, NETWORK_CONCURRENCY } from "./github.js";
23
+ import { ensureProfile, listInstalled, normalizeSpec, runInstall, runRemove, createJobTracker, assertSafeSpec, resolveRegistry } from "./installer.js";
24
24
 
25
25
  export const name = "@1e0zj/dsh-plugin-mall";
26
26
  export const inject = ["tools", "jobs", "systemPrompt"];
@@ -28,10 +28,23 @@ export const inject = ["tools", "jobs", "systemPrompt"];
28
28
  export const Config = z.object({
29
29
  defaultProfile: z.string().default("web"),
30
30
  apiBase: z.string().default("https://api.github.com"),
31
+ npmRegistry: z.string().default(""),
32
+ rawSources: z.array(z.string()).default([]),
31
33
  perPageMax: z.number().default(30),
32
34
  allowRestart: z.boolean().default(true),
33
35
  });
34
36
 
37
+ /**
38
+ * The registry to query for a profile: an explicit `npmRegistry` config wins,
39
+ * otherwise follow whatever pnpm installs from (profile .npmrc → pnpm config →
40
+ * npmjs). Never npmjs-by-assumption: a mirror user would silently lose
41
+ * anti-squatting, update checks, and the host-shadow guard all at once.
42
+ */
43
+ async function registryFor(profile, npmRegistry) {
44
+ const explicit = String(npmRegistry ?? "").trim();
45
+ return explicit.length > 0 ? explicit.replace(/\/+$/, "") : await resolveRegistry(profile);
46
+ }
47
+
35
48
  /** Clip long strings for compact model-facing output. */
36
49
  function clip(text, max) {
37
50
  const trimmed = String(text ?? "").replace(/\s+/g, " ").trim();
@@ -150,7 +163,7 @@ function rpcFail(error) {
150
163
  * @returns the {ok, value|error} envelope.
151
164
  */
152
165
  async function rpcDispatch(ctx, endpoint, payload, config, token, tracker) {
153
- const { defaultProfile = "web", apiBase = "https://api.github.com", perPageMax = 30, allowRestart = true } = config;
166
+ const { defaultProfile = "web", apiBase = "https://api.github.com", perPageMax = 30, allowRestart = true, npmRegistry = "", rawSources = [] } = config;
154
167
  switch (endpoint) {
155
168
  case "search": {
156
169
  const perPage = Math.min(Math.max(Math.trunc(payload?.perPage ?? 10) || 10, 1), Math.trunc(perPageMax) || 30);
@@ -166,7 +179,7 @@ async function rpcDispatch(ctx, endpoint, payload, config, token, tracker) {
166
179
  return rpcOk(result);
167
180
  }
168
181
  case "verify": {
169
- const result = await verifyPlugins({ repos: payload?.repos });
182
+ const result = await verifyPlugins({ repos: payload?.repos, sources: rawSources });
170
183
  return rpcOk(result);
171
184
  }
172
185
  case "updates": {
@@ -178,14 +191,16 @@ async function rpcDispatch(ctx, endpoint, payload, config, token, tracker) {
178
191
  } catch (error) {
179
192
  return rpcFail(new Error(`invalid profile: ${error.message}`));
180
193
  }
194
+ const registry = await registryFor(profile, npmRegistry);
181
195
  const results = {};
182
- await Promise.all(deps.map(async (dep) => {
196
+ // verifyPlugins worker 池,而不是对所有依赖一次性扇出。
197
+ await mapLimit(deps, NETWORK_CONCURRENCY, async (dep) => {
183
198
  if (dep.kind === "missing") { results[dep.name] = { latest: null }; return; }
184
- const info = await npmPackageInfo(dep.name);
199
+ const info = await npmPackageInfo(dep.name, { registry });
185
200
  results[dep.name] = info === null
186
201
  ? { latest: null }
187
202
  : { latest: info.latest, hasUpdate: compareVersions(info.latest, dep.version) > 0 };
188
- }));
203
+ });
189
204
  return rpcOk(results);
190
205
  }
191
206
  case "info": {
@@ -211,12 +226,14 @@ async function rpcDispatch(ctx, endpoint, payload, config, token, tracker) {
211
226
  return rpcFail(error);
212
227
  }
213
228
  // npm tarball 优先(小而快、带 integrity);registry 条目不同源的包名
214
- // 视为抢注,回退 github: 全仓库 spec
215
- spec = await preferNpmSpec({ spec });
229
+ // 视为抢注,回退 github: 全仓库 spec。查的 registry 必须是 pnpm 实际
230
+ // 安装用的那个,否则镜像用户这里永远比对不上、次次退化成全仓库克隆。
231
+ const registry = await registryFor(profile, npmRegistry);
232
+ spec = await preferNpmSpec({ spec, registry, sources: rawSources });
216
233
  // 宿主依赖硬拦:dependencies 里拖着 @deepseek-ai/* 的包装进 profile
217
234
  // 就是双模块实例 + 全工具调度崩溃(宿主无任何护栏,市场是最后防线)。
218
235
  try {
219
- await assertSafeToInstall({ spec });
236
+ await assertSafeToInstall({ spec, registry, sources: rawSources });
220
237
  } catch (error) {
221
238
  return rpcFail(error);
222
239
  }
@@ -322,7 +339,7 @@ function registerRpcChannel(ctx, config, token) {
322
339
  }
323
340
 
324
341
  export function apply(ctx, config = {}) {
325
- const { defaultProfile = "web", apiBase = "https://api.github.com", perPageMax = 30 } = config;
342
+ const { defaultProfile = "web", apiBase = "https://api.github.com", perPageMax = 30, npmRegistry = "", rawSources = [] } = config;
326
343
  const token = process.env.GITHUB_TOKEN ?? process.env.DSH_MARKET_GITHUB_TOKEN;
327
344
 
328
345
  ctx.systemPrompt.section({
@@ -433,8 +450,9 @@ export function apply(ctx, config = {}) {
433
450
  const profile = String(args.profile ?? defaultProfile).trim();
434
451
  const normalized = normalizeSpec(args.spec);
435
452
  assertSafeSpec(normalized);
436
- const spec = await preferNpmSpec({ spec: normalized });
437
- await assertSafeToInstall({ spec });
453
+ const registry = await registryFor(profile, npmRegistry);
454
+ const spec = await preferNpmSpec({ spec: normalized, registry, sources: rawSources });
455
+ await assertSafeToInstall({ spec, registry, sources: rawSources });
438
456
  let profileDir;
439
457
  try {
440
458
  profileDir = resolveProfileDir(profile);
package/src/installer.js CHANGED
@@ -144,6 +144,91 @@ export function listInstalled(profile) {
144
144
  return { dir, deps };
145
145
  }
146
146
 
147
+ // ── npm registry resolution ─────────────────────────────────────────────────
148
+ //
149
+ // Registry lookups (anti-squatting, update checks, the host-shadow guard) have
150
+ // to hit the same registry pnpm installs from. Hardcoding npmjs while the user
151
+ // is on a mirror breaks all three silently — see the header comment in
152
+ // github.js. Resolution order mirrors pnpm's own: the profile's .npmrc, then
153
+ // `pnpm config get registry` (which folds in the user and global .npmrc
154
+ // chain), then npmjs. Cached per profile for the process lifetime; changing a
155
+ // registry needs a dsh restart anyway, like every other profile setting.
156
+
157
+ const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
158
+ const registryCache = new Map(); // profile -> Promise<string>
159
+
160
+ /** The `registry=` value from a profile-local .npmrc, if it sets one. */
161
+ function registryFromNpmrc(profileDir) {
162
+ const npmrcPath = join(profileDir, ".npmrc");
163
+ if (!existsSync(npmrcPath)) return undefined;
164
+ try {
165
+ for (const line of readFileSync(npmrcPath, "utf8").split("\n")) {
166
+ const match = /^\s*registry\s*=\s*(\S+)\s*$/.exec(line);
167
+ if (match !== null) return match[1];
168
+ }
169
+ } catch {
170
+ /* unreadable .npmrc — fall through to pnpm */
171
+ }
172
+ return undefined;
173
+ }
174
+
175
+ /** `pnpm config get registry`, or undefined if pnpm is missing, slow, or unset. */
176
+ function registryFromPnpm() {
177
+ return new Promise((resolve) => {
178
+ let proc;
179
+ try {
180
+ proc = spawn("pnpm", ["config", "get", "registry"], {
181
+ env: process.env,
182
+ shell: process.platform === "win32",
183
+ stdio: ["ignore", "pipe", "pipe"],
184
+ windowsHide: true,
185
+ });
186
+ } catch {
187
+ resolve(undefined);
188
+ return;
189
+ }
190
+ let out = "";
191
+ // 一次安装不该被一个探测子进程拖住:5s 没结果就当没有,走兜底。
192
+ const timer = setTimeout(() => {
193
+ proc.kill();
194
+ resolve(undefined);
195
+ }, 5000);
196
+ proc.stdout?.on("data", (data) => { out += data.toString(); });
197
+ proc.on("error", () => { clearTimeout(timer); resolve(undefined); });
198
+ proc.on("close", (code) => {
199
+ clearTimeout(timer);
200
+ const value = out.trim();
201
+ // pnpm prints "undefined" for an unset key — only take a real URL.
202
+ resolve(code === 0 && /^https?:\/\//i.test(value) ? value : undefined);
203
+ });
204
+ });
205
+ }
206
+
207
+ /**
208
+ * The registry pnpm installs from for this profile.
209
+ * @param profile - profile name.
210
+ * @returns a promise for the registry base URL, without a trailing slash.
211
+ */
212
+ export function resolveRegistry(profile) {
213
+ const key = String(profile ?? "");
214
+ const cached = registryCache.get(key);
215
+ if (cached !== undefined) return cached;
216
+ const pending = (async () => {
217
+ let dir;
218
+ try {
219
+ dir = resolveProfileDir(key);
220
+ } catch {
221
+ dir = undefined; // invalid profile name — the caller reports it, we just fall back
222
+ }
223
+ const fromNpmrc = dir === undefined ? undefined : registryFromNpmrc(dir);
224
+ if (fromNpmrc !== undefined) return fromNpmrc.replace(/\/+$/, "");
225
+ const fromPnpm = await registryFromPnpm();
226
+ return (fromPnpm ?? DEFAULT_NPM_REGISTRY).replace(/\/+$/, "");
227
+ })();
228
+ registryCache.set(key, pending);
229
+ return pending;
230
+ }
231
+
147
232
  // ── client-plugin row registration ──────────────────────────────────────────
148
233
 
149
234
  /** Profile patch file name (the user's own layer, applied after bundle layers). */
@@ -370,8 +455,16 @@ const UNSAFE_SPEC_RE = /[;&|`$()<>^"!*\n\r]/;
370
455
 
371
456
  /** Reject install/remove specs carrying shell metacharacters. */
372
457
  export function assertSafeSpec(spec) {
373
- if (UNSAFE_SPEC_RE.test(String(spec ?? ""))) {
374
- throw new Error(`spec contains characters that are not allowed in an install spec: ${JSON.stringify(String(spec))}`);
458
+ const value = String(spec ?? "");
459
+ if (UNSAFE_SPEC_RE.test(value)) {
460
+ throw new Error(`spec contains characters that are not allowed in an install spec: ${JSON.stringify(value)}`);
461
+ }
462
+ // Windows 下 pnpm 走 shell,而 Node 只是把参数用空格 join 后交给 cmd,
463
+ // 不逐参加引号——带空格的本地路径会被拆成两个参数,pnpm 报一个和路径
464
+ // 毫无关系的错。用户也没法自己加引号绕过:`"` 就在上面的黑名单里。
465
+ // 与其让它以看不懂的方式失败,不如在这里说清楚。
466
+ if (process.platform === "win32" && /^(?:file:|link:)/i.test(value) && /\s/.test(value)) {
467
+ throw new Error(`local path specs cannot contain spaces on Windows — pnpm is spawned through cmd, which would split the path into two arguments: ${JSON.stringify(value)}`);
375
468
  }
376
469
  }
377
470