dsh-plugin 1.4.9 → 1.4.11

package/lib/http/routes.js

@@ -22,7 +22,7 @@ import { loadSettings, saveSettings, resetSettings } from '../services/settings.
 import { appendLog, clearLog, readLog, logFilePath, defaultLogFilePath, customLogFile } from '../services/log.js';
 /**
  * 跨平台宿主重启脚本（以 `node -e` 运行，独立于宿主进程）。
- * 取代原先的 `/bin/sh -c`：Windows 无 /bin/sh，且 lsof/nohup 仅 POSIX 存在。
+ * 不用 `/bin/sh -c`：Windows 无 /bin/sh，且 lsof/nohup 仅 POSIX 存在。
  * 由 `spawn(process.execPath, ['-e', SCRIPT, port], { detached, stdio:'ignore' })` 孵化，
  * 宿主进程被 kill 后仍能完成「停旧 → 等端口释放 → 拉起新 dsh web」。
  */
@@ -137,8 +137,7 @@ function installedRepoOf(profile, name) {
     }
 }
 /** 宿主 dsh CLI 版本：优先直接跑 `dsh --version`（与 pnpm/npm/git 同款同步探测，1500ms 超时兜底，
- *  绝不挂起）—— 原先从 process.argv[1] 向上找 package.json 猜版本在部分宿主加载方式下取不到，
- *  导致 issue 环境快照 DSH: unknown；拿不到再退回入口 package.json 查找（dsh 不在 PATH 时兜底）。 */
+ *  绝不挂起）；拿不到再退回从入口 `process.argv[1]` 向上找 package.json（dsh 不在 PATH 时兜底）。 */
 function hostDshVersion() {
     const viaCli = toolVersion('dsh', ['--version']);
     if (viaCli)
@@ -196,7 +195,7 @@ function hostEnv(profile) {
     };
 }
 /** 安装/卸载 CLI 的子进程环境：透传宿主环境，并按设置注入 HTTP(S) 代理。
- *  npm registry 不再注入 —— 安装完全沿用用户本机 npm 配置（~/.npmrc / 全局配置）。
+ *  不注入 npm registry —— 安装完全沿用用户本机 npm 配置（~/.npmrc / 全局配置）。
  *  代理优先级：设置里的代理 → 系统代理（macOS scutil / Windows 注册表）→ 宿主 env 原有值。
  *  使安装通道与诊断使用相同的代理来源。 */
 function mutationEnv(settings) {
@@ -229,14 +228,24 @@ function sendJson(response, status, value) {
     });
     response.end(JSON.stringify(value));
 }
-/** POST mutations are only accepted from the local web server origin. */
-function isSameOrigin(request) {
+/** POST mutations are only accepted from the local web server origin or the desktop host page.
+ *  Exported for tests (tests/routes.test.ts) — the origin check is the whole CSRF defence. */
+export function isSameOrigin(request) {
     const origin = request.headers.origin;
-    const host = request.headers.host;
-    if (origin === undefined || host === undefined)
+    if (origin === undefined)
         return false;
     try {
         const url = new URL(origin);
+        // 桌面端（Electron 宿主）的页面跑在宿主自定义协议下，origin 形如 `dsh-app://app`。
+        // 客户端一律用相对路径请求，宿主把 `/dsh-plugin-hub/*` 转发给本地 http server 时
+        // Origin 头原样保留，与 Host（如 localhost:3081）不等，因此必须显式放行该协议，
+        // 否则桌面端全部 POST 都会被判成 untrusted origin。该协议只有宿主自身能产生，
+        // 外部网页无法把 Origin 伪造成 `dsh-app://…`，放行不扩大 CSRF 面。
+        if (url.protocol === 'dsh-app:')
+            return true;
+        const host = request.headers.host;
+        if (host === undefined)
+            return false;
         const localHostnames = new Set(['localhost', '127.0.0.1', '[::1]']);
         return url.host === host && localHostnames.has(url.hostname);
     }
@@ -638,7 +647,7 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
             handler: async (request, response) => {
                 if (!requireMethod(request, response, 'GET'))
                     return;
-                // 目录/统计数据服务端代理：浏览器不再直连 dsh-plugin.org，改经此路由
+                // 目录/统计数据服务端代理：浏览器不直连 dsh-plugin.org，统一经此路由
                 // 转发（curl 子进程注入代理 env），与 npm / git 安装通道走同一代理口径，
                 // 「npm / git / 目录数据请求统一走该代理」的设置文案因此真实生效。
                 const url = new URL(request.url ?? '/', 'http://localhost');
@@ -696,7 +705,7 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
             handler: async (request, response) => {
                 if (!requireTrustedPost(request, response))
                     return;
-                // 任务自动入队：即使已有插件操作在跑也接受请求（FIFO 串行执行），不再 409 拒绝
+                // 任务自动入队：即使已有插件操作在跑也接受请求（FIFO 串行执行），不做 409 拒绝
                 try {
                     const body = await readJsonBody(request);
                     // mode: 'update' = 已安装目标的覆盖更新（放行 add，pnpm 对已存在依赖原位覆盖重装）。
@@ -835,20 +844,37 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                     // 页 —— 404 表示「目标不存在」而非网络不通，不该被当成网络故障拦截。
                     // 仅新安装预检（更新是已信任目标的覆盖重装，跳过）；不通直接 400 拦下并打
                     // [network] 标记，客户端据此提示「你的网络不通」，而不是把网络失败当成
-                    // 插件侧问题引导去作者仓库提 Issue（issue #10：git fetch 超时被误报为插件问题）。
+                    // 插件侧问题引导去作者仓库提 Issue。
                     // 代理口径与诊断一致：设置里的代理 → 系统代理 → 环境变量 → 直连。
                     if (already === null) {
                         const effectiveProxy = settings.proxy !== ''
                             ? settings.proxy
                             : (systemProxy() ?? process.env.HTTPS_PROXY ?? process.env.https_proxy ?? '');
                         const isGitChannel = repoTarget !== null && target === repoTarget;
-                        const probeTarget = isGitChannel
-                            ? 'https://github.com/'
-                            : `${(settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org')}/`;
-                        const net = await probeUrl(probeTarget, effectiveProxy, 6000);
+                        const npmProbeTarget = `${(settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org')}/`;
+                        // git 通道的探针换成克隆握手本身：git ls-remote 走的就是 pnpm 克隆前的同一套
+                        // https 传输。curl 打 github.com 主页会被按协议/端口区分的防火墙与 TLS 复检
+                        // 拦截（能 git 克隆、打不开网页），把可装的仓库误判成 [network] 而中止
+                        // （见 issue #71）。握手失败时再用 curl 复核一次主页连通性：只有两者都不通
+                        // 才判「网络不通」；仅握手失败（仓库不存在、私有仓库、需要凭据）放行，
+                        // 交给后续预检与真实安装给出准确原因。
+                        const gitProbeTarget = repoTarget === null ? null : repoTarget.replace(/^git\+/, '');
+                        let net;
+                        if (gitProbeTarget !== null) {
+                            net = await gitLsRemote(gitProbeTarget, effectiveProxy, 6000);
+                            if (!net.ok) {
+                                const reachable = await probeUrl('https://github.com/', effectiveProxy, 6000);
+                                if (reachable.ok)
+                                    net = reachable;
+                            }
+                        }
+                        else {
+                            net = await probeUrl(npmProbeTarget, effectiveProxy, 6000);
+                        }
+                        const probeTarget = gitProbeTarget ?? npmProbeTarget;
                         if (!net.ok) {
                             // 错误消息按客户端界面语言提示：中文界面给中文、英文界面给英文，
-                            // 不再写死英文（用户一眼看懂是网络问题，而不是插件问题）
+                            // 让用户一眼看懂是网络问题而非插件问题
                             const channelName = isGitChannel
                                 ? (lang === 'zh' ? 'GitHub' : 'github.com')
                                 : (lang === 'zh' ? 'npm 源' : 'the npm registry');
@@ -875,9 +901,9 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                             return;
                         }
                         // 包名冲突检测（仅 git 通道）：git 目标包内声明的 name 若与 profile 已装依赖同名，
-                        // pnpm 会以该 name 做依赖键撞车，抛出的 CLI 报错晦涩难懂（issue #25：sandbase-harness
-                        // 声明 managed-agents，但该包名在 registry 上被另一仓库占用，npm 反查搜不到 → git 直装
-                        // 撞已装同名依赖）。到这里已装依赖要么来源不同仓库、要么 spec 是版本号解析不出仓库身份。
+                        // pnpm 会以该 name 做依赖键撞车，抛出的 CLI 报错晦涩难懂 —— 且该包名在 registry 上
+                        // 可能被别的仓库占用，npm 反查搜不到，git 直装就会撞上已装的同名依赖。
+                        // 到这里已装依赖要么来源不同仓库、要么 spec 是版本号解析不出仓库身份。
                         // 读 node_modules 里已装包的真实 repository 区分两种情况：
                         //  - 指向同一仓库 → 是「同仓库残留」（spec 丢了仓库身份），就地转 update 覆盖重装（幂等）；
                         //  - 指向别的仓库 / 读不到 → 跨仓库包名冲突，入队前转成明确 409，指导用户先卸载或改装。

package/lib/services/install/npm-check.js

@@ -5,10 +5,9 @@
  *
  * 本机 npm 环境检测：判断一次安装失败是否源于「本机 npm 版本过低」。
  *
- * 背景：pnpm 在 git 源插件的 prepare 阶段会调 npm 装依赖，npm arborist 在解 peer 依赖时
- * 有已知内部崩溃 —— `Cannot read properties of null (reading 'edgesOut')`（build-ideal-tree.js
- * 的 #loadPeerSet），官方标记 Cannot Reproduce（npm/cli#8261、#9787），npm 11.6.0 起不再复现。
- * 该报错会被 pnpm 包进 ERR_PNPM_PREPARE_PACKAGE 输出，若按插件打包问题引导提 Issue 就误导了用户。
+ * 背景：pnpm 在 git 源插件的 prepare 阶段会调 npm 装依赖，npm arborist 在解 peer 依赖时有
+ * 已知内部崩溃 —— `Cannot read properties of null (reading 'edgesOut')`。这是 npm 自身缺陷，
+ * 该报错会被 pnpm 包进 ERR_PNPM_PREPARE_PACKAGE 输出，不能按插件打包问题引导用户提 Issue。
  *
  * 这里的 `npmTooLowMarker` 是纯函数（输出文本 + 环境 → 标记行或 null），不触碰任务/队列，
  * 由调用方（task-queue.ts）负责把标记追加到任务输出；spawn 读 npm 版本是唯一副作用，独立可测。
@@ -16,7 +15,7 @@
 import { spawnSync } from 'node:child_process';
 /** npm arborist 内部崩溃特征：`Cannot read properties of null (reading 'edgesOut')`。 */
 export const NPM_CRASH_EDGES_OUT_RE = /Cannot read properties of null \(reading 'edgesOut'\)|edgesOut/i;
-/** 该缺陷在 npm 11.6.0 起不再复现；低于此版本遇到 edgesOut 崩溃即判「本机 npm 版本过低」。 */
+/** 低于该版本（该缺陷在 npm 11.6.0 修复）遇到 edgesOut 崩溃即判「本机 npm 版本过低」。 */
 export const NPM_MIN_VERSION = [11, 6, 0];
 /** 读本机 npm 版本（major.minor.patch）；npm 不在 PATH 或执行失败/超时时返回 null（不妄下结论）。 */
 export function npmVersionOf(env) {

package/lib/services/install/task-queue.js

@@ -9,7 +9,7 @@
  */
 import { spawn, spawnSync } from 'node:child_process';
 import { resolvePackageEntry } from './package-entry.js';
-import { readFileSync, statSync } from 'node:fs';
+import { existsSync, readFileSync, statSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { CAPTURE_LIMIT_BYTES, MAX_TASKS, MAX_TASK_LINES } from './install-types.js';
 import { npmTooLowMarker } from './npm-check.js';
@@ -112,19 +112,55 @@ function pushLine(task, line) {
         task.progress = Math.max(task.progress, 6 + Math.min(79, task.lines.length * 2));
     }
 }
-function cliInvocation() {
+function cliInvocation(profile) {
     const entry = process.argv[1];
-    if (entry !== undefined && /[\\/](?:bin\.(?:js|ts)|dsh)$/.test(entry)) {
-        const absoluteEntry = resolve(entry);
-        return {
-            file: process.execPath,
-            prefixArgs: [...process.execArgv, absoluteEntry],
-            cwd: dirname(absoluteEntry),
-            useShell: false,
-        };
+    if (entry !== undefined) {
+        // 打包桌面端（Electron）：宿主入口在 app.asar 内，机器上根本没有 `dsh` 可执行文件
+        //（Windows 那条 dsh.cmd shim 只存在于宿主进程自己的 PATH 里），直接回退 PATH 必然
+        // 报 [dsh-missing]（见 issue #71）。这里改用应用自己的 CLI 引导脚本调起同一份打包
+        // CLI：Electron 可执行文件 + --expose-internals + desktop-cli.js，与内置终端、
+        // 官方插件页安装完全同一条路径 —— desktop profile 由应用独占管理的授权也在其中。
+        const bootstrap = desktopCliBootstrap(entry);
+        if (bootstrap !== null) {
+            return {
+                file: process.execPath,
+                prefixArgs: ['--expose-internals', bootstrap],
+                // 工作目录用 profile 目录（真实存在的目录）：asar 内的路径不能作为 spawn 的 cwd
+                cwd: profileDirectory(profile),
+                useShell: false,
+                // Electron 可执行文件只有带这个变量才按 Node 运行引导脚本
+                env: { ELECTRON_RUN_AS_NODE: '1' },
+            };
+        }
+        if (/[\\/](?:bin\.(?:js|ts)|dsh)$/.test(entry)) {
+            const absoluteEntry = resolve(entry);
+            return {
+                file: process.execPath,
+                prefixArgs: [...process.execArgv, absoluteEntry],
+                cwd: dirname(absoluteEntry),
+                useShell: false,
+            };
+        }
     }
     return { file: 'dsh', prefixArgs: [], cwd: process.cwd(), useShell: process.platform === 'win32' };
 }
+/**
+ * 打包桌面端宿主的 CLI 引导脚本路径（`<asar 根>/lib/desktop-cli.js`，即应用内
+ * pnpm 服务的 dshBootstrapPath）。宿主入口落在 app.asar 内时按 asar 根反推候选路径，
+ * 命中存在的那个才采用；布局不认识（官方改版）时返回 null，调用方回退原逻辑。
+ * 导出供单测覆盖路径推导。
+ */
+export function desktopCliBootstrap(entry) {
+    const marker = /[\\/]app\.asar(?=[\\/]|$)/i.exec(entry);
+    if (marker === null)
+        return null;
+    const root = entry.slice(0, marker.index + marker[0].length);
+    for (const candidate of [join(root, 'lib', 'desktop-cli.js'), join(root, 'dsh', 'lib', 'desktop-cli.js')]) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
 /**
  * dsh 命令存在性探测：which/where 找 PATH 里的 dsh。
  * Windows shell 模式命令缺失时 cmd 只输出 GBK 乱码「不是内部或外部命令」（UTF-8 解码后
@@ -286,7 +322,7 @@ function spawnMutation(options) {
     const isGlobalNpm = (globalNpm ?? []).length > 0;
     const invocation = isGlobalNpm
         ? { file: 'npm', prefixArgs: [], cwd: process.cwd(), useShell: process.platform === 'win32' }
-        : cliInvocation();
+        : cliInvocation(profile);
     // 更新已安装的 npm 包：显式指定 @latest。pnpm add <pkg>（无版本）对已存在依赖
     // （尤其精确 spec 如 "1.3.0"）是幂等的 —— 输出 "Already up to date" 且不改 package.json，
     // 导致「更新成功」但实际仍停留在旧版本；git 地址与全局安装不受此影响。
@@ -334,7 +370,9 @@ function spawnMutation(options) {
             }
             child = spawn(invocation.file, attemptArgs, {
                 cwd: invocation.cwd,
-                env,
+                // invocation.env 是「必须叠加」的变量（打包桌面端的 ELECTRON_RUN_AS_NODE）：
+                // 没有它时保持 env 原样透传，有它时必须基于完整环境叠加，否则子进程会丢掉 PATH。
+                env: invocation.env === undefined ? env : { ...(env ?? process.env), ...invocation.env },
                 shell: invocation.useShell,
                 // detached 使子进程成为独立进程组组长：取消时能整组清理（见 stopChild），
                 // 且宿主进程崩溃后安装任务不会被连带误杀
@@ -444,7 +482,7 @@ function spawnMutation(options) {
     });
     return (async () => {
         let result = await spawnOnce(args);
-        // npm 11 的 arborist peer-set bug（`Cannot read properties of null (reading 'children')`，npm/cli#9911）：
+        // npm 11 的 arborist peer-set bug（`Cannot read properties of null (reading 'children')`）：
         // 某些包的 peerDependencies 用「双段 prerelease 范围」（如 dsh-tui@0.9.0 的 `^0.1.0-rc.6 || ^0.1.1-rc.1`，
         // 26 个必需 peer 全是这种形状）会让 `npm install -g` 在解析阶段直接崩溃 —— 退出码 1、什么都没装，
         // 与是不是从我们界面发起无关（终端里同样复现）。首次失败后自动带 `--legacy-peer-deps` 重试一次：

package/lib/services/probe.js

@@ -19,7 +19,7 @@ const probeFail = () => ({ ok: false, ms: null, status: null });
  * 代理受限或吊销服务不可达时整个握手直接失败（CRYPT_E_NO_REVOCATION_CHECK），
  * 表现为 `curl: (35) schannel: next InitializeSecurityContext failed` —— 而 Node/npm/
  * 浏览器各有自己的 TLS 实现，照常可用，用户只会看到「插件市场打不开」。
- * --ssl-revoke-best-effort（curl ≥ 7.70）把吊销检查降级为尽力而为，握手不再被它拦死；
+ * --ssl-revoke-best-effort（curl ≥ 7.70）把吊销检查降级为尽力而为，避免它拦死握手；
  * 其它平台后端（SecureTransport / OpenSSL）没有这个强制行为，不加参数。
  * 运行时读 process.platform（而非模块级常量），便于测试覆盖两条分支。
  */
@@ -30,6 +30,8 @@ export function curlTlsArgs() {
 export function curlRevokeFlagUnsupported(code, stderr) {
     return code === 2 && /ssl-revoke-best-effort/i.test(stderr) && /unknown|unrecognized/i.test(stderr);
 }
+/** 彻底关闭证书吊销检查的兜底参数（curl ≥ 7.19），比降级参数覆盖更老的 Windows curl。 */
+const NO_REVOKE_ARG = '--ssl-no-revoke';
 /** stderr 是否指向 Schannel 取不到证书吊销信息（据此归因为环境 TLS 问题，而非网络不通）。 */
 export function tlsRevocationBlocked(stderr) {
     return /CRYPT_E_NO_REVOCATION_CHECK|CRYPT_E_REVOCATION_OFFLINE|0x80092012/i.test(stderr);
@@ -77,7 +79,7 @@ function macSystemProxy() {
  * `http=host:port;https=host:port`（按协议分别配置）。
  * 字符类必须同时排除 `/` 与 `=`：只排除 `=` 时，带 scheme 的值会让「主机名」吞掉 `//`，
  * 拼出 `http:////127.0.0.1:10793` 这种立刻失败的非法地址 —— 代理本来是通的，却把诊断、
- * 目录拉取、npm/git 预检全判成「不可达」（dsh-plugin-hub#66）。
+ * 目录拉取、npm/git 预检全判成「不可达」。
  */
 export function parseWinProxyServer(stdout) {
     const m = /([^:\s=/]+):(\d+)/.exec(stdout);
@@ -135,13 +137,24 @@ function runCurl(args, env, timeoutMs) {
     });
 }
 /** 带 TLS 兜底的 curl 调用：先按平台参数跑（Windows 带吊销检查降级），
- *  若本机 curl 不认这个参数（curl < 7.70）则去掉参数重跑一次，保证老版本不因此直接失败。 */
+ *  若本机 curl 不认这个参数（curl < 7.70）则去掉参数重跑一次，保证老版本不因此直接失败；
+ *  降级后仍被吊销检查拦死（CRYPT_E_NO_REVOCATION_CHECK）时，再用 --ssl-no-revoke
+ *  彻底关掉吊销检查跑一次 —— 该参数 curl ≥ 7.19 即存在，覆盖面比降级参数更广，
+ *  否则「能上网但取不到 CRL」的 Windows 机器会把所有通道误报成不可达（见 issue #71）。
+ *  吊销检查只影响本次探测自身的信任判断，不改变系统 TLS 配置。 */
 async function curlWithTlsFallback(args, env, timeoutMs) {
     const tlsArgs = curlTlsArgs();
-    const first = await runCurl([...tlsArgs, ...args], env, timeoutMs);
-    if (tlsArgs.length === 0 || !curlRevokeFlagUnsupported(first.code, first.stderr))
-        return first;
-    return runCurl(args, env, timeoutMs);
+    let run = await runCurl([...tlsArgs, ...args], env, timeoutMs);
+    if (tlsArgs.length > 0 && curlRevokeFlagUnsupported(run.code, run.stderr)) {
+        run = await runCurl(args, env, timeoutMs);
+    }
+    if (tlsArgs.length > 0 && tlsRevocationBlocked(run.stderr)) {
+        const retry = await runCurl([NO_REVOKE_ARG, ...args], env, timeoutMs);
+        // 只在兜底本身跑起来（非「不认识该参数」）时采用其结果，否则保留原始失败线索
+        if (retry.code !== null && !curlRevokeFlagUnsupported(retry.code, retry.stderr))
+            run = retry;
+    }
+    return run;
 }
 /**
  * curl 子进程探测：spawn curl -s -w '%{http_code}' 并注入代理 env。

package/lib/services/profile/profile.js

@@ -20,7 +20,7 @@ export function readProfileArg(fallback = 'web') {
  *  - Electron 桌面宿主：不传 `--profile`，而是把 profile 目录作为位置参数传入
  *    （`… <dshRoot> <home>\profiles\desktop …`）。
  * 桌面端只认 `--profile` 会永远落回 fallback，把路由/日志/安装全挂到错误的 profile 上
- * （日志写进 profiles/web/hub.log、市场必然「插件数据加载失败」，dsh-plugin-hub#65）。
+ * （日志写进 profiles/web/hub.log、市场必然「插件数据加载失败」）。
  * 位置参数按「父目录名为 profiles」精确识别 profile 目录，避免误取其它位置参数。
  */
 export function profileFromArgv(argv, fallback = 'web') {

package/lib/types/http/routes.d.ts

@@ -11,6 +11,9 @@ export interface WebServerService {
 }
 /** Read non-official dependencies installed into one profile. */
 export declare function readInstalled(profile: string): Record<string, string>;
+/** POST mutations are only accepted from the local web server origin or the desktop host page.
+ *  Exported for tests (tests/routes.test.ts) — the origin check is the whole CSRF defence. */
+export declare function isSameOrigin(request: IncomingMessage): boolean;
 /**
  * Register the Plugin Hub API on the host web server and return a disposer.
  * @param webServer - DSH web server service.

package/lib/types/services/install/install-types.d.ts

@@ -46,6 +46,8 @@ export interface Invocation {
     prefixArgs: string[];
     cwd: string;
     useShell: boolean;
+    /** 必须叠加到子进程环境上的变量（打包桌面端要带 ELECTRON_RUN_AS_NODE） */
+    env?: NodeJS.ProcessEnv;
 }
 /** 排队中的变更任务及其启动参数。 */
 export interface QueueItem {

package/lib/types/services/install/npm-check.d.ts

@@ -1,6 +1,6 @@
 /** npm arborist 内部崩溃特征：`Cannot read properties of null (reading 'edgesOut')`。 */
 export declare const NPM_CRASH_EDGES_OUT_RE: RegExp;
-/** 该缺陷在 npm 11.6.0 起不再复现；低于此版本遇到 edgesOut 崩溃即判「本机 npm 版本过低」。 */
+/** 低于该版本（该缺陷在 npm 11.6.0 修复）遇到 edgesOut 崩溃即判「本机 npm 版本过低」。 */
 export declare const NPM_MIN_VERSION: number[];
 /** 读本机 npm 版本（major.minor.patch）；npm 不在 PATH 或执行失败/超时时返回 null（不妄下结论）。 */
 export declare function npmVersionOf(env: NodeJS.ProcessEnv | undefined): [number, number, number] | null;

package/lib/types/services/install/task-queue.d.ts

@@ -33,6 +33,13 @@ export declare function hasQueuedTarget(target: string): boolean;
  * Returns false when the task is unknown or already finished.
  */
 export declare function cancelTask(id: number): boolean;
+/**
+ * 打包桌面端宿主的 CLI 引导脚本路径（`<asar 根>/lib/desktop-cli.js`，即应用内
+ * pnpm 服务的 dshBootstrapPath）。宿主入口落在 app.asar 内时按 asar 根反推候选路径，
+ * 命中存在的那个才采用；布局不认识（官方改版）时返回 null，调用方回退原逻辑。
+ * 导出供单测覆盖路径推导。
+ */
+export declare function desktopCliBootstrap(entry: string): string | null;
 /**
  * Enqueue a plugin mutation and return its task. Tasks run strictly serially:
  * the queue worker starts the next one only after the previous finishes.

package/lib/types/services/probe.d.ts

@@ -18,7 +18,7 @@ export type ProbeFailReason = 'tlsRevocation';
  * 代理受限或吊销服务不可达时整个握手直接失败（CRYPT_E_NO_REVOCATION_CHECK），
  * 表现为 `curl: (35) schannel: next InitializeSecurityContext failed` —— 而 Node/npm/
  * 浏览器各有自己的 TLS 实现，照常可用，用户只会看到「插件市场打不开」。
- * --ssl-revoke-best-effort（curl ≥ 7.70）把吊销检查降级为尽力而为，握手不再被它拦死；
+ * --ssl-revoke-best-effort（curl ≥ 7.70）把吊销检查降级为尽力而为，避免它拦死握手；
  * 其它平台后端（SecureTransport / OpenSSL）没有这个强制行为，不加参数。
  * 运行时读 process.platform（而非模块级常量），便于测试覆盖两条分支。
  */
@@ -33,7 +33,7 @@ export declare function tlsRevocationBlocked(stderr: string): boolean;
  * `http=host:port;https=host:port`（按协议分别配置）。
  * 字符类必须同时排除 `/` 与 `=`：只排除 `=` 时，带 scheme 的值会让「主机名」吞掉 `//`，
  * 拼出 `http:////127.0.0.1:10793` 这种立刻失败的非法地址 —— 代理本来是通的，却把诊断、
- * 目录拉取、npm/git 预检全判成「不可达」（dsh-plugin-hub#66）。
+ * 目录拉取、npm/git 预检全判成「不可达」。
  */
 export declare function parseWinProxyServer(stdout: string): string | null;
 /**

package/lib/types/services/profile/profile.d.ts

@@ -6,7 +6,7 @@ export declare function readProfileArg(fallback?: string): string;
  *  - Electron 桌面宿主：不传 `--profile`，而是把 profile 目录作为位置参数传入
  *    （`… <dshRoot> <home>\profiles\desktop …`）。
  * 桌面端只认 `--profile` 会永远落回 fallback，把路由/日志/安装全挂到错误的 profile 上
- * （日志写进 profiles/web/hub.log、市场必然「插件数据加载失败」，dsh-plugin-hub#65）。
+ * （日志写进 profiles/web/hub.log、市场必然「插件数据加载失败」）。
  * 位置参数按「父目录名为 profiles」精确识别 profile 目录，避免误取其它位置参数。
  */
 export declare function profileFromArgv(argv: readonly string[], fallback?: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.4.9",
+  "version": "1.4.11",
   "description": "A community plugin marketplace for DeepSeek Harness, built to the official plugin spec — browse, search and install 10000+ human-curated community plugins without leaving the app. · DeepSeek Harness 社区插件市场（遵循官方开发规范）：10000+ 人工精选社区插件，每日更新。",
   "type": "module",
   "main": "lib/index.js",

package/src/client/components/PluginHubSection.tsx

@@ -456,7 +456,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
               // 命令行安装：与应用商店同一套确认/进度/结果弹窗 —— 输入 npm 包名 / GitHub 地址 /
               // dsh plugin 命令即装（custom 源，受安全设置三开关控制）。点安装先弹确认窗，
               // 确认后走队列安装（实时进度 + 成功结果视图）；目标已安装 → 弹窗转「更新」覆盖重装，
-              // 不再撞「already installed」报错（第一次安装没有反馈才导致用户重复点击）。
+              // 不会撞「already installed」报错。
               // 安全信任开关关掉对应通道 → 卡片禁用并提示去设置打开（onOpenSettings 跳到设置页）。
               enableNpm: hubSettings.enableNpmInstall,
               enableGit: hubSettings.enableGitInstall,

package/src/client/components/catalog/PluginCard.tsx

@@ -50,8 +50,8 @@ export function PluginCard({ plugin: p, copied, installedName, installedVersion,
           ? h('span', { className: styles.verified }, t('verified'))
           : null,
       ),
-      // 描述始终显示：站点英文数据缺翻译时 description 回退成中文也照常展示，
-      // 描述是了解插件的第一入口，比隐藏更实用（不再为求语言一致而砍内容）。
+      // 描述始终显示：站点英文数据缺翻译时 description 回退成中文也照常展示 ——
+      // 描述是了解插件的第一入口，语言不一致也不该省略。
       p.description ? h('p', { className: styles.desc }, p.description) : null,
       (p.topics?.length ?? 0) > 0
         ? h('div', { className: styles.topics },

package/src/client/components/modals/NotificationsModal.tsx

@@ -225,8 +225,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       className: styles.failCopy,
                       onClick: () => onCopy(r.message),
                     }, t('failCopy')),
-                    // 成功通知：时间戳并入本行右侧，与图标/文字垂直居中 ——
-                    // 不再单独占底部一行，卡片只有一行内容，图标文字整体居中不顶头
+                    // 成功通知：时间戳在行右侧，与图标/文字垂直居中，卡片保持单行内容
                     r.ok
                       ? h('span', {
                         className: styles.noticeTime,
@@ -288,12 +287,12 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     }
                     if (kind === 'pnpmWorkspace') {
                       // pnpm 拒绝把依赖装到 workspace 根目录（ERR_PNPM_ADDING_TO_ROOT）：宿主在 profile
-                      // 目录调 pnpm add 未声明在根操作，任何插件都会失败，不是插件问题 ——
-                      // 给 .npmrc 豁免指引，不引导提 Issue（dsh-plugin-hub#40）
+                      // 目录调 pnpm add 未声明在根操作，任何插件都会失败 ——
+                      // 给 .npmrc 豁免指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failPnpmWorkspaceHint'))
                     }
                     if (kind === 'pnpmStore') {
-                      // pnpm 存在但 store 大版本不匹配（ERR_PNPM_UNEXPECTED_STORE）：profile 目录旧依赖是
+                      // pnpm 存在但 store 大版本不匹配（ERR_PNPM_UNEXPECTED_STORE）：profile 目录的依赖是
                       // 另一大版本 pnpm 装的，当前 pnpm 不认，任何插件装进该 profile 都会失败 ——
                       // 给清理重建指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failPnpmStoreHint'))
@@ -305,17 +304,17 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     }
                     if (kind === 'pnpmUnusedPatch') {
                       // profile 里留着指向旧版本 dsh-plugin 的补丁声明（ERR_PNPM_UNUSED_PATCH）：pnpm
-                      // 发现补丁没被用上就中止安装，任何插件都装不进来 —— 不引导提 Issue（#48）
+                      // 发现补丁没被用上就中止安装，任何插件都装不进来 —— 不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failPnpmUnusedPatchHint'))
                     }
                     if (kind === 'fileLocked') {
                       // profile 里的文件被其他进程占用（Windows os error 32）：通常是宿主或杀毒软件
-                      // 持有句柄 —— 给出完全退出宿主的指引，不引导提 Issue（#47）
+                      // 持有句柄 —— 给出完全退出宿主的指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failFileLockedHint'))
                     }
                     if (kind === 'accessDenied') {
                       // profile 里的文件被系统拒绝写入（Windows os error 5「拒绝访问」/ EPERM / EACCES）：
-                      // 占用、只读属性、目录 ACL 或杀软拦截 —— 给退出宿主 + 检查权限的指引，不引导提 Issue（#50）
+                      // 占用、只读属性、目录 ACL 或杀软拦截 —— 给退出宿主 + 检查权限的指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failAccessDeniedHint'))
                     }
                     if (kind === 'fsUnavailable') {
@@ -323,6 +322,11 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       // 空间不足、盘只读、句柄耗尽，任何插件都装不进来 —— 按子场景给指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failFsUnavailableHint'))
                     }
+                    if (kind === 'originRejected') {
+                      // 请求来源没通过本地 hub 服务的校验（服务端 403 untrusted origin）：请求根本没进
+                      // 安装流程，与插件无关 —— 引导从本机地址重新打开市场，不引导提 Issue
+                      return h('div', { className: styles.failPrepareHint }, t('failOriginRejectedHint'))
+                    }
                     if (kind === 'network') {
                       // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
                       // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
@@ -331,7 +335,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         // 「无法访问 …」醒目行：精准告诉用户具体哪个地址连不上（消息里取不到地址就跳过这行）
                         (() => { const target = unreachableTargetOf(r.message); return target ? h('div', { className: styles.failNetworkTarget }, t('failNetworkTarget', { url: target })) : null })(),
                         // registry 被指向内网/自定义源（tarball 从非官方源下载失败）：直接给出换源指引，
-                        // 否则用户外网是通的会困惑「为什么连不上」（dsh-plugin-hub#32）
+                        // 否则用户外网是通的会困惑「为什么连不上」
                         (() => { const host = registryHostOf(r.message); return host ? h('div', { className: styles.failPrepareHint }, t('failNetworkRegistryHint', { host })) : null })(),
                         h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
                         onRunDiagnostics ? h('button', {

package/src/client/components/modals/modals.tsx

@@ -406,10 +406,10 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               : failureKind === 'pnpmWorkspace'
               // pnpm 拒绝把依赖装到 workspace 根目录（ERR_PNPM_ADDING_TO_ROOT）：宿主在 profile 目录
               // 调 pnpm add 时未声明在根操作，任何插件都会失败，不是插件问题 ——
-              // 给 .npmrc 豁免指引，不引导提 Issue（dsh-plugin-hub#40）
+              // 给 .npmrc 豁免指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failPnpmWorkspaceHint'))
               : failureKind === 'pnpmStore'
-              // pnpm 存在但 store 大版本不匹配（ERR_PNPM_UNEXPECTED_STORE）：profile 目录旧依赖是
+              // pnpm 存在但 store 大版本不匹配（ERR_PNPM_UNEXPECTED_STORE）：profile 目录的依赖是
               // 另一大版本 pnpm 装的，当前 pnpm 不认，任何插件装进该 profile 都会失败 ——
               // 给清理重建指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failPnpmStoreHint'))
@@ -419,20 +419,24 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               ? h('div', { className: styles.failPrepareHint }, t('failPnpmPolicyHint'))
               : failureKind === 'pnpmUnusedPatch'
               // profile 里留着指向旧版本 dsh-plugin 的补丁声明（ERR_PNPM_UNUSED_PATCH）：pnpm 发现
-              // 补丁没被用上就中止整次安装，任何插件都装不进来 —— 给删除条目的指引，不引导提 Issue（#48）
+              // 补丁没被用上就中止整次安装，任何插件都装不进来 —— 给删除条目的指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failPnpmUnusedPatchHint'))
               : failureKind === 'fileLocked'
               // profile 里的文件被其他进程占用（Windows os error 32）：pnpm 无法替换被占用的文件，
-              // 通常是宿主或杀毒软件持有句柄 —— 给退出宿主的指引，不引导提 Issue（#47）
+              // 通常是宿主或杀毒软件持有句柄 —— 给退出宿主的指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failFileLockedHint'))
               : failureKind === 'accessDenied'
               // profile 里的文件被系统拒绝写入（Windows os error 5「拒绝访问」/ EPERM / EACCES）：
-              // 占用、只读属性、目录 ACL 或杀软拦截 —— 同样给退出宿主/检查权限的指引，不引导提 Issue（#50）
+              // 占用、只读属性、目录 ACL 或杀软拦截 —— 同样给退出宿主/检查权限的指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failAccessDeniedHint'))
               : failureKind === 'fsUnavailable'
               // 本机磁盘写不进去（ENOSPC / EROFS / EMFILE 及 Windows os error 112、19）：
               // 空间不足、盘只读、句柄耗尽，任何插件都装不进来 —— 按子场景给指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failFsUnavailableHint'))
+              : failureKind === 'originRejected'
+              // 请求来源没通过本地 hub 服务的校验（服务端 403 untrusted origin）：请求根本没进
+              // 安装流程，与插件无关 —— 引导从本机地址重新打开市场，不引导提 Issue
+              ? h('div', { className: styles.failPrepareHint }, t('failOriginRejectedHint'))
               : failureKind === 'network'
               // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
               // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
@@ -441,7 +445,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                 // 「无法访问 …」醒目行：精准告诉用户具体哪个地址连不上（消息里取不到地址就跳过这行）
                 (() => { const target = unreachableTargetOf(message); return target ? h('div', { className: styles.failNetworkTarget }, t('failNetworkTarget', { url: target })) : null })(),
                 // registry 被指向内网/自定义源（tarball 从非官方源下载失败）：直接给出换源指引，
-                // 否则用户外网是通的会困惑「为什么连不上」（dsh-plugin-hub#32）
+                // 否则用户外网是通的会困惑「为什么连不上」
                 (() => { const host = registryHostOf(message); return host ? h('div', { className: styles.failPrepareHint }, t('failNetworkRegistryHint', { host })) : null })(),
                 h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
                 onRunDiagnostics ? h('button', {

package/src/client/data/catalog.ts

@@ -11,7 +11,7 @@ import type { HubPlugin, LocaleId } from '../types.ts'
 import { normalize } from '../logic/normalize.ts'
 
 // 目录/统计数据经服务端 /catalog 代理路由获取（curl 子进程注入设置里的代理），
-// 与 npm / git 安装通道同一代理口径 —— 浏览器不再直连 api.dsh-plugin.org。
+// 与 npm / git 安装通道同一代理口径 —— 浏览器不直连 api.dsh-plugin.org。
 const PROXY_BASE = '/dsh-plugin-hub/catalog'
 const PLUGINS_URL = (lang: LocaleId) => `${PROXY_BASE}?lang=${lang}`
 const STATS_URL = `${PROXY_BASE}?stats=1`

package/src/client/hooks/useCatalog.ts

@@ -100,7 +100,7 @@ export function useCatalog(lang: LocaleId) {
     setHubPlugin(null)
     setStats(null)
     setFailed(false)
-    // 目录数据直拉：hub 自身版本由独立 Worker 版本控制中心管理，不再依赖主站版本号接口。
+    // 此处只拉目录与统计；hub 自身版本由独立 Worker 版本控制中心提供（见 fetchHubUpdate）。
     const load = () => Promise.all([fetchCatalog(lang, controller.signal), fetchStats(controller.signal)])
     load()
       .then(([list, stats]) => {
@@ -160,7 +160,7 @@ export function useCatalog(lang: LocaleId) {
   useEffect(() => { refreshInstalled() }, [])
 
   // Hub 自身版本检查走独立 Worker（版本控制中心）：发新版后写一次 Worker KV，
-  // 所有已装用户立即看到「可更新」+ Markdown 变更记录，不再依赖主站目录数据管道。
+  // 所有已装用户立即看到「可更新」+ Markdown 变更记录，不经过主站目录数据管道。
   // 失败静默降级为 null（徽标不出现，不影响目录本身加载）。
   useEffect(() => {
     let cancelled = false

package/src/client/locales.ts

@@ -317,6 +317,9 @@ export const zh = {
   failNetworkTarget: '无法访问 {url} —— 你的网络连接不通',
   // 「去系统诊断」直达按钮：网络不通提示下方的品牌实底按钮，跳到设置 → 系统诊断跑连通性检测
   failNetworkRunDiag: '去系统诊断检测网络',
+  // 请求来源没通过本地 hub 服务校验（服务端 403 untrusted origin）：请求根本没进安装流程，
+  // 与插件无关 —— 引导从本机地址重新打开市场，不引导提 Issue
+  failOriginRejectedHint: '这次安装请求没有通过插件市场的来源校验，被本地服务直接拒绝，所以安装根本没有开始 —— 与插件本身无关。通常是因为市场页面不是从本机地址打开的（比如用了局域网 IP），或宿主页面的来源未被识别。请从本机的插件市场地址（localhost）重新打开页面后重试；桌面端用户重启一次宿主即可。',
   failDshMissingHint: '系统找不到 dsh 命令（dsh 未加入系统 PATH），无法调用安装器执行安装。请确认 DeepSeek Harness 已正确安装、dsh 已加入 PATH（或重新安装），然后重试。这不是插件本身的问题。',
   failGitMissingHint: '系统找不到 git 命令（Git 未安装或未加入系统 PATH），无法从 GitHub 源安装插件。请先安装 Git（如 git-scm.com/downloads）或把 git 加入 PATH，重启 DSH 后重试。这不是插件本身的问题。',
   failPnpmMissingHint: '安装器找到了 dsh，但系统里没有 pnpm 命令（dsh 用它来管理 profile 插件）。请先安装 pnpm（如 npm install -g pnpm），确认 pnpm 已加入 PATH 后重试。这不是插件本身的问题。',
@@ -687,6 +690,10 @@ export const en = {
   failNetworkTarget: 'Cannot reach {url} — your network connection is down',
   // Diagnostics shortcut button under the network-down hint: jumps to Settings → System Diagnostics
   failNetworkRunDiag: 'Run a network diagnostic',
+  // The request origin did not pass the local hub service check (403 untrusted origin): the request
+  // never reached the install flow — nothing to do with the plugin, so point at the local address
+  // and do not offer an issue link
+  failOriginRejectedHint: 'This install request did not pass the marketplace origin check and was rejected by the local service, so the install never started — this is not about the plugin itself. It usually means the marketplace page was not opened from a local address (for example a LAN IP), or the host page origin was not recognized. Reopen the marketplace from localhost and retry; on the desktop app, restart the host once.',
   failDshMissingHint: 'The dsh command could not be found (it is not on the system PATH), so the installer could not run. Please make sure DeepSeek Harness is installed correctly and dsh is on your PATH (or reinstall it), then retry. This is not a problem with the plugin itself.',
   failGitMissingHint: 'The git command could not be found (Git is not installed or not on the system PATH), so GitHub-source plugins cannot be installed. Please install Git (e.g. from git-scm.com/downloads) or add git to your PATH, restart DSH, then retry. This is not a problem with the plugin itself.',
   failPnpmMissingHint: 'The installer found dsh, but pnpm is missing on this machine (dsh uses it to manage profile plugins). Please install pnpm first (e.g. npm install -g pnpm), make sure it is on your PATH, then retry. This is not a problem with the plugin itself.',