@noob-stupid/dsh-plugin-console 0.5.47 → 0.5.48

package/lib/server/domain/landed-repo.js

@@ -0,0 +1,47 @@
+// L1 · domain —— 已落地仓库复用（批次 C-⑩ 2026-09-27 加法；0.5.48 从 repoland.js 抽出）
+//
+// 为什么单开一个模块：repoland.js 贴着 tests/test-architecture-guard.mjs 的 **单文件 ≤ 600 行**硬顶，
+// 而"判断某个仓库本机是否已经落地、能不能直接复用"是自洽的一块只读逻辑（0.5.48 改错时新增了判据，
+// 抽出来是**搬移 + 那一条判据**，导出名与行为在 repoland.js 侧保持不变）。
+//
+// 为什么要有这条复用：用户在「仓库落地」里已经把仓库拉到本地（reposDir，默认 ~/.dsh/repos），
+// 安装/套装装配时再去网上拉一遍纯属浪费 —— 本机直连不通时甚至是"白等一场空"。
+//
+// ★ 2026-10-13（0.5.48）改错：判据从"**仓库根**必须有 package.json"改为
+//   「根有清单 **或** 目标子目录有清单」。
+//   为什么原来那条对**子目录插件结构性失效**：像 DeepSeek-Bot 这类仓库，根目录**故意**没有
+//   package.json（真正的插件在 `<repo>/<subdir>/`）。旧判据要求根有清单 ⇒ 这类仓库**永远 hit:false**
+//   ⇒ 明明本地已经落地，还是去网上重拉一遍 —— 恰好把"已落地优先 ⇒ 零网络"这条特性，
+//   对它最该服务的场景（用户特地为子目录插件落的仓库）废掉了。
+//   `subdir` 由调用方按本次安装目标传入（形如 `web-search` 或 `packages/web-search`）；
+//   不传 ⇒ 只认根清单 ⇒ **行为与旧版逐项相同**（不改变既有调用点的语义、不制造新的命中面）。
+
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+/** 已落地仓库复用（纯判断，只读）。返回 `{ hit, path, subdir? }`；deps 只为单测注入。 */
+function findLandedRepoImpl(repo, deps = {}) {
+  const exists = deps.exists ?? existsSync
+  const list = deps.listLanded
+  const full = String(repo ?? '').trim().replace(/\.git$/u, '')
+  if (full === '' || !full.includes('/')) return { hit: false, path: null }
+  const subdir = typeof deps.subdir === 'string' && deps.subdir.trim() !== ''
+    ? deps.subdir.trim().replace(/^[./\\]+/u, '').replace(/\\/gu, '/')
+    : null
+  let landed = []
+  try { landed = list() ?? [] } catch { landed = [] }
+  const match = landed.find((r) => String(r.repo).toLowerCase() === full.toLowerCase())
+  if (match === undefined) return { hit: false, path: null }
+  try {
+    if (exists(join(match.path, 'package.json'))) return { hit: true, path: match.path }
+    // 根没有清单：只有调用方明确给了子目录时才继续看子目录（否则不扩大命中面）
+    if (subdir !== null && exists(join(match.path, ...subdir.split('/'), 'package.json'))) {
+      return { hit: true, path: match.path, subdir }
+    }
+    return { hit: false, path: match.path }
+  } catch {
+    return { hit: false, path: match.path }
+  }
+}
+
+export { findLandedRepoImpl }

package/lib/server/domain/repoland.js

@@ -9,6 +9,7 @@ import { gitCloneCandidates } from './sources.js'
 import { archiveRepo } from './archive-source.js'
 import { execFileAsync, gitEnv, killProcessTree } from '../infra/exec.js'
 import { copyTree, disposeDir, disposeNote } from '../infra/fsx.js'
+import { findLandedRepoImpl } from './landed-repo.js'
 import { dshHome, repoLandConfFile } from '../infra/paths.js'
 
 /** 仓库落地根目录（可配置，默认 ~/.dsh/repos）。 */
@@ -174,27 +175,11 @@ function waitChildExit(child, timeoutMs, pollMs = 60) {
  * 效果：一个"只连不传"的源从"每个源白等 60/180 秒"变成"≈20 秒判死 → 立刻换下一个源"。 */
 const GIT_STALL_ARGS = ['-c', 'http.lowSpeedLimit=1', '-c', 'http.lowSpeedTime=20']
 
-/** 已落地仓库复用（批次 C-⑩，2026-09-27 加法）：克隆前先看 `<reposDir>/<owner>/<repo>`。
- * 为什么：用户在「仓库落地」里已经把仓库拉到本地（reposDir，默认 ~/.dsh/repos），
- * 安装/套装装配时再去网上拉一遍纯属浪费——本机直连不通时甚至是"白等一场空"。
- * 命中条件：目录存在、看起来是仓库（有 .git 或 .gitmodules）、且**含 package.json**
- * （没有 package.json 的多半是半成品/技能仓库，交给正常通道更稳）。
- * 返回 `{ hit, path }`；deps 只为单测注入。 */
+/** 已落地仓库复用：判据与实现见 `domain/landed-repo.js`（2026-10-13 抽出 —— 本文件贴着
+ * tests/test-architecture-guard.mjs 的"单文件 ≤ 600 行"硬顶；只搬移，导出名与行为一字未变）。
+ * 这里保留同名包装，既有调用点与单测不用改。 */
 function findLandedRepo(repo, deps = {}) {
-  const exists = deps.exists ?? existsSync
-  const list = deps.listLanded ?? listLandedRepos
-  const full = String(repo ?? '').trim().replace(/\.git$/u, '')
-  if (full === '' || !full.includes('/')) return { hit: false, path: null }
-  let landed = []
-  try { landed = list() ?? [] } catch { landed = [] }
-  const match = landed.find((r) => String(r.repo).toLowerCase() === full.toLowerCase())
-  if (match === undefined) return { hit: false, path: null }
-  try {
-    if (!exists(join(match.path, 'package.json'))) return { hit: false, path: match.path }
-  } catch {
-    return { hit: false, path: match.path }
-  }
-  return { hit: true, path: match.path }
+  return findLandedRepoImpl(repo, { ...deps, listLanded: deps.listLanded ?? listLandedRepos })
 }
 
 /** git 克隆的默认首轮超时（2026-09-27 下调 180 秒 → 60 秒）。

package/lib/server/domain/subdir-install.js

@@ -114,13 +114,20 @@ async function verifySubdirManifest({ repo, branch, dir, readManifest }) {
 }
 
 /** 取子目录源码：先复用**已落地**仓库（零网络），否则稀疏取源码只拉这一个目录。
- * 返回 `{ ok, dir, reused, notes }` / `{ ok:false, notes, error }`。clone 可注入（单测零进程/零网络）。 */
+ * 返回 `{ ok, dir, reused, notes }` / `{ ok:false, notes, error }`。clone 可注入（单测零进程/零网络）。
+ *
+ * ★ 2026-10-13（0.5.48）接线改错：把本次目标子目录 `dir` **显式传给 findLandedRepo**。
+ *   原来这里调 `findLanded(repo)` 不传子目录，而 findLandedRepo 的旧判据要求**仓库根**有
+ *   package.json ⇒ 像 DeepSeek-Bot 这种"根目录故意没有清单、插件在子目录"的仓库**永远不命中**
+ *   ⇒ 本地明明已经落地，还是往下走去网上取源码 —— 正是"已落地优先 ⇒ 零网络"对子目录插件的结构性失效。
+ *   （下面那段"再看 candidate/package.json"的兜底是从**未命中**里救回来的补丁；判据修好后
+ *   正常路径在 findLandedRepo 内就命中，这段兜底保留作为行为不变的安全网。） */
 async function acquireSubdirSource({ repo, dir, source = 'github', deps = {} }) {
   const notes = []
   const findLanded = typeof deps.findLandedRepo === 'function' ? deps.findLandedRepo : findLandedRepo
   let landed = { hit: false, path: null }
   try {
-    landed = findLanded(repo) ?? landed
+    landed = findLanded(repo, { subdir: dir }) ?? landed
   } catch {
     landed = { hit: false, path: null }
   }

package/lib/server/infra/cmd-line.js

@@ -0,0 +1,63 @@
+// L0 · infra —— cmd.exe 命令行拼装（0.5.48 从 exec.js 抽出：本文件贴着
+// tests/test-architecture-guard.mjs 的"单文件 ≤ 600 行"硬顶；**只搬移，不改逻辑**）。
+//
+// 为什么 Windows 上要这么绕（2026-09-27 改错，桌面端实例"所有 pnpm 操作都跑不了"的两处根因之一）：
+//   旧代码是 `['corepack','pnpm',...args].map((a) => JSON.stringify(a)).join(' ')` —— JSON.stringify
+//   加的是**真引号**，而这一整串又是作为一个 argv 元素交给 Node 的 spawn；Windows 上 Node/libuv 按
+//   MSVCRT 规则把参数里的 `"` 转义成 `\"`，cmd 实际收到 `\"corepack\" \"pnpm\"`
+//   → `'\"corepack\"' 不是内部或外部命令`。
+//   本机对着一个只回显参数的 .cmd 实测三种形态：
+//     · `"a" "b"`   + 默认转义            → 收到 `\"a\" \"b\"` → 失败（旧缺陷）
+//     · `"a" "b"`   + windowsVerbatimArguments → `/s` 会把首尾两个引号一起剥掉 → 也失败
+//     · `""a" "b""` + windowsVerbatimArguments → 正确解析成两个参数 ✓
+//   所以本模块产出的是"**内层**命令字符串"（形如 `corepack pnpm add x`，**永不含 `\"`**），
+//   最外层那对引号由 cmdShellArgv 负责加。
+//
+// 已知边界（如实记，不假装覆盖）：`%VAR%` 与开启延迟展开时的 `!VAR!` 是 cmd 自己的展开，
+//   **任何引号/`^` 都挡不住**；我们生成的 argv（包名、registry、布尔选项、绝对路径）不含这两个字符，
+//   真出现时该通道会失败并如实报错（不会静默跑成别的命令）。
+//
+// 分层：L0 · infra（不得 import domain/routes/index —— tests/test-architecture-guard.mjs 断言②）。
+
+/** cmd.exe 的元字符：`^` 是 cmd 自己的转义符（**引号内照样生效** —— 本机实测 `"a^b"` 到程序手里变成 `ab`），
+ *  `& | < > ( )` 在引号内**仍然是 cmd 的操作符**（实测 `"a&b"` 会在 `&` 处断开，把 `b` 当命令执行）。
+ *  所以段内这些字符必须逐个加 `^` 转义。 */
+const CMD_META_RE = /[\^&|<>()]/gu
+
+/** 把一串命令段拼成**一条 cmd.exe 命令字符串**（纯函数，导出给单测）。
+ *  2026-09-28 改错（真机：`cmd-corepack` 一条都跑不动 → pnpm-runners / suite-fallback /
+ *  install-smoke 三套红，报 `cmd-corepack :: status=1 out=""`）：
+ *    `corepack` 在 Windows 上常是 **cmd 批处理 shim**（`<node 安装目录>\corepack.cmd` →
+ *    `node …\corepack\dist\corepack.js %*`）。对批处理，cmd **不会剥掉参数外层的引号**，
+ *    引号会随 `%*` 一路进到 node 的 argv —— 于是 corepack 收到的是 `"pnpm"` / `"--version"`
+ *    （带引号当成了包管理器名）→ 直接崩：status=1、stdout 空。真 cmd.exe 实测：
+ *      · `""corepack" "pnpm" "--version""` → status=1、stdout=""（旧形态，坏）
+ *      · `"corepack pnpm --version"`      → status=0、stdout="11.21.0"（按需引号，好）
+ *    所以**只为含空白的段加引号**；其余裸串 + `^` 转义 cmd 元字符。
+ *  只有「干净 token」（无空白、无 cmd 元字符）能去引号：含 `& | < > ( ) ^` 的段，实测
+ *  **裸串 + `^` 转义会失效**（真机 ⑥：裸的 `a^&b` 被 cmd 当分隔符断开，收到 `[a`），
+ *  必须沿用「引号 + 段内 ^」的既有形态。 */
+function cmdCommandLine(parts) {
+  return parts
+    .map((part) => String(part))
+    .map((text) => {
+      const clean = !/[\s]/u.test(text) && !/[\^&|<>()]/u.test(text)
+      if (clean) return text
+      return `"${text.replace(CMD_META_RE, (ch) => `^${ch}`)}"`
+    })
+    .join(' ')
+}
+
+/** corepack 形态的命令字符串（纯函数，导出给单测断言"不含 `\"` 转义"）。 */
+function cmdCorepackCommand(args) {
+  return cmdCommandLine(['corepack', 'pnpm', ...args])
+}
+
+/** 交给 cmd.exe 的完整 argv（`/d /s /c` + **整条再包一层引号**的内层命令字符串）。
+ *  必须与 `verbatim: true`（windowsVerbatimArguments）配套：Node 不再做任何引号转义，
+ *  cmd 的 `/s` 剥掉最外层那一对，剩下的正好是我们要的命令行。 */
+function cmdShellArgv(commandLine) {
+  return ['/d', '/s', '/c', `"${commandLine}"`]
+}
+
+export { CMD_META_RE, cmdCommandLine, cmdCorepackCommand, cmdShellArgv }

package/lib/server/infra/exec.js

@@ -7,6 +7,9 @@ import { existsSync, readFileSync, readdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { homedir } from 'node:os'
 import { selectPnpmRunners } from './pnpm-runner-pick.js'
+import { releaseAgeGateHit, releaseAgeBlockedSpecs, releaseAgeGateError } from './pnpm-release-gate.js'
+import { RUNTIME_PNPM_BIN_RE, RUNTIME_BIN_RE, desktopRuntimeCandidates, dshRuntimeCandidates } from './pnpm-runtime-discovery.js'
+import { CMD_META_RE, cmdCommandLine, cmdCorepackCommand, cmdShellArgv } from './cmd-line.js'
 
 /** git 可执行名（跨平台）。事故（2026-09-20，另一位用户：Android + proot Ubuntu）：
  * 「仓库落地」硬编码 `git.exe` → 非 Windows 环境 spawn git.exe ENOENT，克隆必然失败。 */
@@ -14,70 +17,6 @@ function gitBin() {
   return process.platform === 'win32' ? 'git.exe' : 'git'
 }
 
-/** PATH 条目是不是桌面端运行时的 `<…>\runtime\pnpm\bin` / `<…>\runtime\bin`（两种分隔符都认）。 */
-const RUNTIME_PNPM_BIN_RE = /[\\/]runtime[\\/]pnpm[\\/]bin[\\/]?$/u
-const RUNTIME_BIN_RE = /[\\/]runtime[\\/]bin[\\/]?$/u
-
-/** cmd.exe 的元字符：`^` 是 cmd 自己的转义符（**引号内照样生效** —— 本机实测 `"a^b"` 到程序手里变成 `ab`），
- *  `& | < > ( )` 在引号内**仍然是 cmd 的操作符**（实测 `"a&b"` 会在 `&` 处断开，把 `b` 当命令执行）。
- *  所以段内这些字符必须逐个加 `^` 转义。 */
-const CMD_META_RE = /[\^&|<>()]/gu
-
-/** 把一串命令段拼成**一条 cmd.exe 命令字符串**（纯函数，导出给单测）。
- *
- * 2026-09-27 改错（桌面端实例"所有 pnpm 操作都跑不了"的两处根因之一）：
- *   旧代码是 `['corepack','pnpm',...args].map((a) => JSON.stringify(a)).join(' ')` —— JSON.stringify 加的是
- *   **真引号**，而这一整串又是作为一个 argv 元素交给 Node 的 spawn；Windows 上 Node/libuv 按 MSVCRT 规则
- *   把参数里的 `"` 转义成 `\"`，cmd 实际收到 `\"corepack\" \"pnpm\"` → `'\"corepack\"' 不是内部或外部命令`。
- *   本机对着一个只回显参数的 .cmd 实测三种形态：
- *     · `"a" "b"`   + 默认转义 → 收到 `\"a\" \"b\"` → 失败（旧缺陷）
- *     · `"a" "b"`   + windowsVerbatimArguments → `/s` 会把首尾两个引号一起剥掉 → 也失败
- *     · `""a" "b""` + windowsVerbatimArguments → 正确解析成两个参数 ✓（含空格 / `&` / `|` / `>` 的参数
- *       在段内加 `^` 转义后也原样到达）
- *   所以本函数产出的是"**内层**命令字符串"（形如 `corepack pnpm add x`，**永不含 `\"`**；只有含空白的段才带引号 —— 2026-09-28 改错，见函数内注释），
- *   最外层那对引号由 cmdShellArgv 负责加。
- * 已知边界（如实记，不假装覆盖）：`%VAR%` 与开启延迟展开时的 `!VAR!` 是 cmd 自己的展开，
- *   **任何引号/`^` 都挡不住**；我们生成的 argv（包名、registry、布尔选项、绝对路径）不含这两个字符，
- *   真出现时该通道会失败并如实报错（不会静默跑成别的命令）。 */
-function cmdCommandLine(parts) {
-  return parts
-    .map((part) => String(part))
-    .map((text) => {
-      // 2026-09-28 改错（真机：`cmd-corepack` 一条都跑不动 → pnpm-runners / suite-fallback /
-      // install-smoke 三套红，报 `cmd-corepack :: status=1 out=""`）：
-      //   `corepack` 在 Windows 上常是 **cmd 批处理 shim**（`<node 安装目录>\corepack.cmd` →
-      //   `node …\corepack\dist\corepack.js %*`）。对批处理，cmd **不会剥掉参数外层的引号**，
-      //   引号会随 `%*` 一路进到 node 的 argv —— 于是 corepack 收到的是 `"pnpm"` / `"--version"`
-      //   （带引号当成了包管理器名）→ 直接崩：status=1、stdout 空。
-      //   真 cmd.exe + windowsVerbatimArguments 实测（同一台机）：
-      //     · `""corepack" "pnpm" "--version""` → status=1、stdout=""（现行形态，坏）
-      //     · `"corepack pnpm --version"`      → status=0、stdout="11.21.0"（按需引号，好）
-      //   所以**只为含空白的段加引号**；其余裸串 + `^` 转义 cmd 元字符（裸串里 `^` 是标准且可靠的转义）。
-      //   含空白的段仍走「引号 + 段内 ^ 转义」，与既有行为一致，不改语义。
-      // 已知边界（如实记）：段内含 `"` 时无法在 cmd 里安全表达 —— 我们生成的 argv（包名/registry/布尔
-      //   选项/绝对路径）不含裸引号；真出现时该通道会失败并如实报错，不会静默跑成别的命令。
-      // 「干净 token」（无空白、无 cmd 元字符）→ 裸串。**只有这种情况**能去引号：
-      //   含空白的段必须带引号；含 `& | < > ( ) ^` 的段，实测**裸串 + `^` 转义会失效**
-      //   （真机 ⑥：裸的 `a^&b` 被 cmd 当分隔符断开，收到 `[a`），必须沿用「引号 + 段内 ^」的既有形态。
-      const clean = !/[\s]/u.test(text) && !/[\^&|<>()]/u.test(text)
-      if (clean) return text
-      return `"${text.replace(CMD_META_RE, (ch) => `^${ch}`)}"`
-    })
-    .join(' ')
-}
-
-/** corepack 形态的命令字符串（纯函数，导出给单测断言"不含 `\"` 转义"）。 */
-function cmdCorepackCommand(args) {
-  return cmdCommandLine(['corepack', 'pnpm', ...args])
-}
-
-/** 交给 cmd.exe 的完整 argv（`/d /s /c` + **整条再包一层引号**的内层命令字符串）。
- *  必须与 `verbatim: true`（windowsVerbatimArguments）配套：Node 不再做任何引号转义，
- *  cmd 的 `/s` 剥掉最外层那一对，剩下的正好是我们要的命令行。 */
-function cmdShellArgv(commandLine) {
-  return ['/d', '/s', '/c', `"${commandLine}"`]
-}
-
 /** pnpm 执行方式定位（跨平台，纯函数便于单测 → 按优先级返回列表，逐个尝试）。
  * 事故（2026-09-20，同一位用户，node v24 + Linux）：只按 Windows 布局找 corepack.js
  * （`<node bin>/node_modules/corepack/dist/corepack.js`），而 Linux 的 npm 全局布局在
@@ -98,7 +37,7 @@ function cmdShellArgv(commandLine) {
  *      作为**新候选插在 node-corepack 之后、cmd-corepack 之前**：既有候选与顺序一个都没动。
  * 兜底语义保持不变：只有"执行方式本身不可用"（ENOENT / Cannot find module）才换下一个，
  * 真正的失败立即抛出（见 runPnpmWithFallback）。
- * 全部候选都走注入的 `exists`；`env/resourcesPath/delimiter/nodeBin` 四个注入点只为离线单测，
+ * 全部候选都走注入的 `exists`；`env/resourcesPath/delimiter/nodeBin/home` 五个注入点只为离线单测，
  * 生产调用方一个字都不用改（默认值就是当前进程的事实）。 */
 function resolvePnpmRunners({
   platform = process.platform,
@@ -109,6 +48,7 @@ function resolvePnpmRunners({
   resourcesPath = process.resourcesPath,
   delimiter = platform === 'win32' ? ';' : ':',
   nodeBin = 'node',
+  home = homedir(),
 } = {}) {
   const binDir = dirname(execPath)
   const corepackCandidates = [
@@ -127,29 +67,26 @@ function resolvePnpmRunners({
     }
   }
 
-  // ── 新候选 ①/③：桌面端（Electron）自带运行时 ──────────────────────────────────
-  // ① Electron 的 `process.resourcesPath`（桌面端 = `<安装目录>\resources`）；
-  // ③ 环境线索：PATH 条目里的 `<…>\runtime\pnpm\bin` 与 `<…>\runtime\bin`（桌面端 host 就是把
-  //    `resources\runtime\bin` 拼进 profile 的 PATH 的，其同级就是 `runtime\pnpm\bin\pnpm.mjs`）。
+  // ── 候选发现：桌面端自带运行时 与 DSH 运行时装（细节见 infra/pnpm-runtime-discovery.js）────
   const desktopNode = typeof env?.DSH_DESKTOP_NODE_EXECUTABLE === 'string' && env.DSH_DESKTOP_NODE_EXECUTABLE !== ''
     ? env.DSH_DESKTOP_NODE_EXECUTABLE
     : execPath
-  const runtimeMjs = []
-  if (typeof resourcesPath === 'string' && resourcesPath !== '') runtimeMjs.push(join(resourcesPath, 'runtime', 'pnpm', 'bin', 'pnpm.mjs'))
   const pathValue = typeof env?.PATH === 'string' && env.PATH !== '' ? env.PATH : (typeof env?.Path === 'string' ? env.Path : '')
   const pathDirs = String(pathValue).split(delimiter).map((d) => d.trim()).filter((d) => d !== '')
-  for (const dir of pathDirs) {
-    if (RUNTIME_PNPM_BIN_RE.test(dir)) runtimeMjs.push(join(dir, 'pnpm.mjs'))
-    else if (RUNTIME_BIN_RE.test(dir)) runtimeMjs.push(join(dirname(dir), 'pnpm', 'bin', 'pnpm.mjs'))
+
+  // ① DSH 运行时装那份（**普通 node 进程也找得到** ⇒ 缺陷②的正解；见模块头注释）
+  for (const js of dshRuntimeCandidates({ env, home })) {
+    if (!exists(js)) continue
+    // 用普通 **node** 跑，**不带** ELECTRON_RUN_AS_NODE（那不是 Electron 二进制，带了反而污染语义）
+    add({ kind: 'runtime-pnpm-mjs', note: `${nodeBin} ${js} pnpm`, run: (args) => ({ bin: nodeBin, argv: [js, ...args] }) })
   }
-  for (const js of runtimeMjs) {
+  // ② 桌面端（Electron）自带运行时那份。ELECTRON_RUN_AS_NODE 必须显式带上：不带它，
+  //    Electron 二进制会当 **GUI 应用**启动 —— 等于弹一个新窗口，退出码还可能是 0（"假成功"更糟）。
+  for (const js of desktopRuntimeCandidates({ resourcesPath, pathDirs, delimiter })) {
     if (!exists(js)) continue
     add({
       kind: 'desktop-pnpm-mjs',
       note: `${desktopNode} --expose-internals ${js} pnpm`,
-      // 照抄桌面端 host 的形态（command=execPath，args=['--expose-internals', <pnpm.mjs>]）。
-      // ELECTRON_RUN_AS_NODE 必须显式带上：不带它，Electron 二进制会当 **GUI 应用**启动 ——
-      // 等于弹一个新窗口，而且退出码可能是 0（"假成功"，比失败更糟）。
       run: (args) => ({ bin: desktopNode, argv: ['--expose-internals', js, ...args], env: { ELECTRON_RUN_AS_NODE: '1' } }),
     })
   }
@@ -506,12 +443,19 @@ function execFileWithKillTree(bin, argv, opts = {}, deps = {}) {
  *   所以不是 env 前缀的问题，是这两个键不在 pnpm 的 env 白名单里）；
  *   真正生效的是 `pnpm add --fetch-timeout / --fetch-retries` 两个 CLI 选项（见 pnpmFetchArgs）。
  *   仍然照需求注入这三个 env（CI 与非交互确实有用、registry 镜像照旧、fetch_* 是 npm 系标准写法，
- *   对 npm/后续 pnpm 版本仍可能生效），但**不把健壮性只押在 env 上**。 */
+ *   对 npm/后续 pnpm 版本仍可能生效），但**不把健壮性只押在 env 上**。
+ *
+ * ★ 2026-10-13（0.5.48，实测"装 ds-bot 时无 TTY 永久挂住"）：补 `npm_config_ci=true` ——
+ *   pnpm 判"能不能弹交互"用的是**它自己的 ci 配置项**（`opts3.ci`，env 形态即 `npm_config_ci`），
+ *   **不是** `process.env.CI`；只给 `CI=true` 时 `canPrompt` 可能仍为真 ⇒ 弹提问 ⇒ 读 stdin 到 EOF
+ *   ⇒ 桌面壳的管道永不关闭 ⇒ 永久挂住。取证与完整链条见 infra/pnpm-release-gate.js 头注释。 */
 function pnpmEnvOverrides(registry) {
   const overrides = {
     npm_config_fetch_timeout: '60000',
     npm_config_fetch_retries: '1',
     CI: 'true',
+    // pnpm 自己的 ci 位（非交互的权威开关）；`CI=true` 单独不够，理由见上。
+    npm_config_ci: 'true',
   }
   if (typeof registry === 'string' && registry !== '') overrides.COREPACK_NPM_REGISTRY = registry
   return overrides
@@ -542,11 +486,17 @@ function pnpmFetchArgs(timeoutMs = 60000, retries = 1) {
 
 /** pnpm add 的完整参数（纯函数，单测覆盖）。registry 只在是**非空字符串**时才拼 ——
  * 旧代码无条件拼 `--registry ${registry}`，`git:` 规格那条路传的是 undefined，命令行长成
- * `--registry undefined`（今天恰好还能装，但那是"垃圾参数被忽略"，不是设计）。 */
+ * `--registry undefined`（今天恰好还能装，但那是"垃圾参数被忽略"，不是设计）。
+ *
+ * ★ 2026-10-13（0.5.48）：追加 `--config.ci=true` —— pnpm **官方支持的非交互开关**
+ * （`--config.<key>=<value>` 是 pnpm 设任意配置项的通用语法，**不是**绕过闸门的手段）。
+ * 理由与取证见 infra/pnpm-release-gate.js 头注释：命中供应链闸门时它会弹提问等人回答，
+ * 而无 TTY 的子进程 stdin 是永不关闭的管道 ⇒ **永久挂住**；钉死 ci 位 ⇒ 改成快速如实失败。 */
 function pnpmAddArgs(spec, registry, { fetchFlags = true, fetchTimeoutMs = 60000, fetchRetries = 1 } = {}) {
   const args = ['add', spec]
   if (typeof registry === 'string' && registry !== '') args.push('--registry', registry)
   if (fetchFlags) args.push(...pnpmFetchArgs(fetchTimeoutMs, fetchRetries))
+  args.push('--config.ci=true')
   return args
 }
 
@@ -563,11 +513,18 @@ function unknownPnpmOption(message) {
 
 /** 跑一次 `pnpm add`（本控制台所有安装通道的唯一入口）—— 2026-09-26 新增。
  * 相对旧的 `runPnpmWithFallback(['add', spec, '--registry', registry], { execOpts })`，只加三样：
- *   ① env 走 buildPnpmEnv（追加 fetch 超时/重试 + CI=true；registry 镜像与禁交互照旧）；
+ *   ① env 走 buildPnpmEnv（追加 fetch 超时/重试 + CI/ci=true；registry 镜像与禁交互照旧）；
  *   ② 参数走 pnpmAddArgs（追加 `--fetch-timeout/--fetch-retries`：实测 pnpm 11 不读同名 env，只认这两个选项）；
  *   ③ 遇到 `Unknown options` 就去掉加固选项重试一次 —— 加固不允许变成"装不上"。
  * 失败语义不变：真实失败照旧抛出（含 pnpm 原始 stderr），成功不返回值。
- * `deps.run` 只是单测注入口（默认 runPnpmWithFallback），生产调用方不传。 */
+ * `deps.run` 只是单测注入口（默认 runPnpmWithFallback），生产调用方不传。
+ *
+ * ★ 2026-10-13（0.5.48，两个真缺陷一起修）：
+ *   · **供应链闸命中 ⇒ 快速如实失败**（判据/错误文案见 infra/pnpm-release-gate.js）：闸门命中即
+ *     翻译成带解法的错误立刻抛，**不重试、更不绕过**（不忽略锁文件校验、不强制装）。
+ *   · **显式传 profileDir**：以前只靠 `execOpts.cwd` 兜出 profileDir（**隐式**耦合）⇒ 一旦调用方
+ *     换了 cwd 形态，就会落回 corepack 那版 pnpm（本机 11.21.0）而不是 profile 声明的那版（11.7.0）
+ *     ⇒ 版本错配 ⇒ Windows 上 EPERM。现在两处调用都显式传，判据不依赖 cwd 这个副作用。 */
 async function runPnpmAdd({ profileDir, spec, registry, timeout = 90000, signal = null, deps = {} } = {}) {
   const run = typeof deps.run === 'function' ? deps.run : runPnpmWithFallback
   const execOpts = (ms) => ({
@@ -578,11 +535,20 @@ async function runPnpmAdd({ profileDir, spec, registry, timeout = 90000, signal
     env: buildPnpmEnv(registry),
     ...(signal ? { signal } : {}),
   })
+  // profileDir 显式下传（不再依赖 execOpts.cwd 的隐式兜底）：见上面 ★ 第二条。
+  const runOpts = (ms) => ({ execOpts: execOpts(ms), profileDir })
   try {
-    await run(pnpmAddArgs(spec, registry), { execOpts: execOpts(timeout) })
+    await run(pnpmAddArgs(spec, registry), runOpts(timeout))
   } catch (error) {
+    // 闸门命中：立刻抛出带解法的错误 —— 不重试（重试也是同样的结局，只会白白多挂一轮）。
+    if (releaseAgeGateHit(error?.message)) throw releaseAgeGateError({ spec, profileDir, message: error.message })
     if (!unknownPnpmOption(error?.message)) throw error
-    await run(pnpmAddArgs(spec, registry, { fetchFlags: false }), { execOpts: execOpts(timeout) })
+    try {
+      await run(pnpmAddArgs(spec, registry, { fetchFlags: false }), runOpts(timeout))
+    } catch (retryError) {
+      if (releaseAgeGateHit(retryError?.message)) throw releaseAgeGateError({ spec, profileDir, message: retryError.message })
+      throw retryError
+    }
   }
 }
 
@@ -595,4 +561,4 @@ const GH_BIN_CANDIDATES = [
   join(homedir(), 'scoop', 'shims', 'gh.exe'),
 ]
 
-export { GH_BIN_CANDIDATES, gitEnv, gitBin, processAlive, execFileAsync, resolvePnpmRunners, pnpmRunnersFor, runPnpmWithFallback, killProcessTree, posixDescendants, execFileWithKillTree, KILL_WAIT_MS, KILL_WAIT_POLL_MS, GIT_LOW_SPEED_ENV, pnpmEnvOverrides, buildPnpmEnv, pnpmFetchArgs, pnpmAddArgs, unknownPnpmOption, runPnpmAdd, cmdCommandLine, cmdCorepackCommand, cmdShellArgv }
+export { GH_BIN_CANDIDATES, gitEnv, gitBin, processAlive, execFileAsync, resolvePnpmRunners, pnpmRunnersFor, runPnpmWithFallback, killProcessTree, posixDescendants, execFileWithKillTree, KILL_WAIT_MS, KILL_WAIT_POLL_MS, GIT_LOW_SPEED_ENV, pnpmEnvOverrides, buildPnpmEnv, pnpmFetchArgs, pnpmAddArgs, unknownPnpmOption, runPnpmAdd, releaseAgeGateHit, releaseAgeBlockedSpecs, releaseAgeGateError, cmdCommandLine, cmdCorepackCommand, cmdShellArgv }

package/lib/server/infra/paths.js

@@ -52,9 +52,65 @@ function baseDirOf(baseUrl) {
  * require.resolve('pkg/package.json') 对声明了 exports 且不含 './package.json' 的包会抛错
  * （2026-09-04 教训：@openviking/dsh-memory-plugin 因此被 heal 误判模块缺失并自动禁用）——
  * fallback 直接查 node_modules 物理路径。
+ *
+ * ★ 2026-10-13（0.5.48）改错：**对 exports 子路径的假阳性**。
+ *   现场：装 ds-bot 时 `verifyInstalledEntry` 拿 `ds-bot/web-search` 来核实，旧代码把引用名拼成
+ *   `ds-bot/web-search/package.json` ⇒ ds-bot 的 exports 里没有这个子路径 ⇒
+ *   `ERR_PACKAGE_PATH_NOT_EXPORTED` ⇒ 退物理路径 `node_modules/ds-bot/web-search/package.json`
+ *   ⇒ **也不存在**（包的清单在 `node_modules/ds-bot/package.json`，不在子目录里）⇒ 返回 null
+ *   ⇒ 误报"缺模块会崩/会被自动禁用"。
+ *   但按**真实解析语义**这个引用是好的：本机实测 `require.resolve('ds-bot/web-search')` **成功**
+ *   （`包/子路径` 是生态既有约定，官方 patch 里也有这种 entry），`import.meta.resolve` 同理，
+ *   模块也能真 `import()`。
+ *   ⇒ 现在先用**真实解析语义**解析「引用名本身」（不再拿字符串拼 `/package.json`），
+ *     成功后从解析结果**向上找最近的 package.json** 作为该包的清单。
+ *   ⇒ 负控不变：真不存在的子路径，三条路都失败 ⇒ 仍然返回 null（**绝不放松成"一律放行"**）。
  */
+function nearestPackageJson(fromPath) {
+  try {
+    let dir = dirname(fromPath)
+    for (let depth = 0; depth < 40; depth += 1) {
+      const candidate = join(dir, 'package.json')
+      if (existsSync(candidate)) return candidate
+      const parent = dirname(dir)
+      if (parent === dir) break
+      dir = parent
+    }
+  } catch {}
+  return null
+}
+
+/** 该引用是不是"包 + 子路径"形态（`pkg/sub`、`@scope/pkg/sub`）。
+ * 判据与 packageNameOf 同源：剥掉包名后还剩东西 ⇒ 是子路径引用。 */
+function isSubpathRef(refName) {
+  if (typeof refName !== 'string' || refName === '') return false
+  return refName !== packageNameOf(refName)
+}
+
+/** 用真实解析语义解析「包/子路径」引用的清单路径：先解析引用本身，再向上找最近的清单。 */
+function resolveViaRealSemantics(refName, base) {
+  if (typeof base !== 'string' || base === '') return null
+  try {
+    const entry = createRequire(join(base, 'package.json')).resolve(refName)
+    return nearestPackageJson(entry)
+  } catch {
+    return null
+  }
+}
+
 function resolvePackageJson(pkgName, baseDir, fallbackBase) {
   const name = packageNameOf(pkgName)
+  // ① 真实解析语义（认 exports 子路径）—— 优先，且**不**拼 `/package.json`
+  const real = resolveViaRealSemantics(pkgName, baseDir)
+  if (real !== null) return real
+  // ★ 子路径引用（`包/子路径`）到此为止：**不许**再退到"按包名找清单"的那两条 fallback。
+  //   为什么：那两条是按**包名**（packageNameOf 剥掉子路径后的 name）找 `node_modules/<包名>/package.json`，
+  //   对不存在的子路径也会命中**包根**那份清单 ⇒ 把一个坏引用判成好的
+  //   —— 正是"校验被放松成一律放行"，任务红线明令不许。
+  //   （本机实测：`@scope/tool/nope` 在 @scope/tool 存在时会从 fallback 拿到包根清单。）
+  //   而真实解析语义对这一类已经给出权威答案：能解析就是好，不能解析就是坏 ⇒ 直接返回 null。
+  if (isSubpathRef(pkgName)) return null
+  // ② 既有两条（顺序与行为不变）：`<name>/package.json` 解析 → node_modules 物理路径
   try {
     return createRequire(join(baseDir, 'package.json')).resolve(`${name}/package.json`)
   } catch {}
@@ -65,6 +121,8 @@ function resolvePackageJson(pkgName, baseDir, fallbackBase) {
   // 官方 @deepseek-ai/* 恰好可见、第三方插件全部解析失败 → 详情/版本/仓库全空。
   // 回退到 profile 目录（fallbackBase）再试一次。
   if (typeof fallbackBase === 'string' && fallbackBase !== '' && fallbackBase !== baseDir) {
+    const realFallback = resolveViaRealSemantics(pkgName, fallbackBase)
+    if (realFallback !== null) return realFallback
     try {
       return createRequire(join(fallbackBase, 'package.json')).resolve(`${name}/package.json`)
     } catch {}

package/lib/server/infra/pnpm-release-gate.js

@@ -0,0 +1,74 @@
+// L0 · infra —— pnpm 供应链闸门（minimumReleaseAge）的**判据与错误翻译**（0.5.48 加法）
+//
+// 为什么单开一个模块：这两个函数的归属是自洽的（"把 pnpm 的闸门原文翻译成用户能照着做的错误"），
+// 而 infra/exec.js 贴着 tests/test-architecture-guard.mjs 的 **单文件 ≤ 600 行**硬顶（0.5.48 实测
+// 723 行被棘轮拦下）⇒ 抽出来是**只搬移与新增**，exec.js 只留调用点。
+//
+// 现场（用户实测，装 ds-bot 时撞出来）：
+//   pnpm 的 minimumReleaseAge 闸门拦下了太新的版本，而它在**可交互**时会弹提问等人回答；
+//   桌面壳/服务进程给的是**永不关闭的 stdin 管道** ⇒ 不抛错、不超时，**永久挂住**
+//   （实测两次分别挂到 90s / 180s 被杀）。
+//
+// 闸门实现（本机 pnpm 11.7.0 `dist/pnpm.mjs`，只读反编译取证）：
+//   L194277  const inCi = opts3.ci ?? isCI
+//   L194278  const canPrompt = !inCi && Boolean(process.stdin.isTTY)
+//   L194305  if (canPrompt) { await promptForApproval(immature) }
+//   L194307  else { throw failOnImmature(immature) }   ← 我们要走的分支
+//   L194330    confirmed = await dist_default5({ message, default: false })  ← prompt 库读 stdin 到 EOF
+//   L63849   MINIMUM_RELEASE_AGE_VIOLATION_CODE = 'MINIMUM_RELEASE_AGE_VIOLATION'
+//
+// ★ 红线：本模块只做"识别 + 翻译成可操作错误"，**绝不**提供任何绕过闸门的手段
+//   （不使用忽略锁文件校验 / 强制安装一类开关）。闸门该拦还是拦，只是把"等人回答"换成"立刻报错并给解法"。
+//
+// 分层：L0 · infra（不得 import domain/routes/index —— tests/test-architecture-guard.mjs 断言②）。
+
+/** 命中 pnpm 供应链闸门的**判据**（纯函数，单测覆盖）。
+ * 两代真实文案都要认（照 exec.js#unknownPnpmOption 的教训：缺一条就等于"闸门命中被当成普通失败"，
+ * 用户拿不到"怎么加白名单"的解法）：
+ *   · pnpm 11.7.0 的违规码 `MINIMUM_RELEASE_AGE_VIOLATION` / `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`；
+ *   · 严格模式不可交互时 pnpm 抛 `NO_MATURE_MATCHING_VERSION`（同文件 194308 的 failOnImmature）；
+ *   · 用户在提问处拒绝时是 `MINIMUM_RELEASE_AGE_DENIED`（同文件 194340）。 */
+function releaseAgeGateHit(message) {
+  const text = String(message ?? '')
+  return /MINIMUM_RELEASE_AGE_VIOLATION|MINIMUM_RELEASE_AGE_DENIED|NO_MATURE_MATCHING_VERSION|ERR_PNPM_MINIMUM_RELEASE_AGE/iu.test(text)
+}
+
+/** 从 pnpm 原始输出里抠出"被闸门拦下的 `包@版本`"清单（尽力而为，抠不到就返回 []）。
+ * 两种真实排版：`  <name>@<version> <reason>`（failOnImmature）与裸 `<name>@<version>`。 */
+function releaseAgeBlockedSpecs(message) {
+  const found = new Set()
+  for (const line of String(message ?? '').split(/\r?\n/u)) {
+    const m = line.match(/(@?[A-Za-z0-9][\w.@/-]*?)@(\d+\.\d+\.\d+(?:-[\w.]+)?)/u)
+    if (m) found.add(`${m[1]}@${m[2]}`)
+  }
+  return [...found]
+}
+
+/** 把"命中供应链闸门"翻译成**用户能照着做**的错误（纯函数，单测覆盖）。
+ * 需求红线：**必须快速如实失败并给出解法**。所以这里只说三件事：
+ *   ① 哪个包被拦下 ② 命中哪条闸 ③ 怎么加白名单。 */
+function releaseAgeGateError({ spec, profileDir, message } = {}) {
+  const blocked = releaseAgeBlockedSpecs(message)
+  const who = blocked.length > 0 ? blocked.join('、') : String(spec ?? '（未能从 pnpm 输出解析出包名）')
+  const lines = [
+    `pnpm 供应链闸门（minimumReleaseAge）拦下了 ${who}：该版本发布时间还没满 pnpm 配置的最短"冷静期"。`,
+    '这不是网络故障。闸门是安全特性，本控制台**不会绕过它**（既不忽略锁文件校验，也不强制装），',
+    '所以这里选择**立刻如实失败**，并把解法交给你：',
+    '解法（任选其一）：',
+    `  ① 加白名单：在 profile 的 pnpm-workspace.yaml 里把该版本追加进 minimumReleaseAgeExclude，例如`,
+    `     minimumReleaseAgeExclude:\n       - '${blocked[0] ?? '<包名>@<版本>'}'`,
+    '     ★ 该清单是**逐版本**匹配的（pnpm 只认 `包名@精确版本`，不支持范围）⇒ 每发一个新版本都要加一行。',
+    '  ② 等：过了冷静期后重试同一操作即可，无需改配置。',
+    '  ③ 调低/关闭该策略：不推荐，等于放弃这道供应链保护。',
+  ]
+  if (typeof profileDir === 'string' && profileDir !== '') lines.push(`目标 profile：${profileDir}`)
+  const error = new Error(lines.join('\n'))
+  error.name = 'PnpmSupplyChainGateError'
+  error.code = 'DSH_PNPM_RELEASE_AGE_GATE'
+  error.gate = 'minimumReleaseAge'
+  error.blocked = blocked
+  error.pnpmMessage = String(message ?? '')
+  return error
+}
+
+export { releaseAgeGateHit, releaseAgeBlockedSpecs, releaseAgeGateError }

package/lib/server/infra/pnpm-runtime-discovery.js

@@ -0,0 +1,64 @@
+// L0 · infra —— 「本机自带那份 pnpm 在哪」的候选发现（0.5.48 加法；从 exec.js 抽出）
+//
+// 为什么单开一个模块：exec.js 贴着 tests/test-architecture-guard.mjs 的 **单文件 ≤ 600 行**硬顶，
+// 而"从桌面端运行时 / DSH 运行时装 / PATH 里找出那份 pnpm"是自洽的一块只读探测逻辑。
+//
+// 两类被发现的 pnpm（形态不同，**绝不能混**）：
+//   · `desktop-pnpm-mjs`：桌面端（Electron）自带运行时那份。用 **Electron 二进制**跑，
+//     必须显式带 `ELECTRON_RUN_AS_NODE=1` —— 不带它，Electron 会当 **GUI 应用**启动
+//     （等于弹一个新窗口，而且退出码可能是 0，"假成功"比失败更糟）。
+//   · `runtime-pnpm-mjs`：DSH **运行时装**那份（0.5.48 新增）。用普通 **node** 跑，**不带**那个 env。
+//
+// ★ 为什么必须有 `runtime-pnpm-mjs`（这条就是缺陷②的正解）：
+//   原来只有两条线索能找到本机那份 pnpm —— ① Electron 的 `process.resourcesPath`；
+//   ② PATH 里的 `<…>\runtime\pnpm\bin` / `<…>\runtime\bin`。**两条都只在桌面端宿主成立**。
+//   而控制台的安装动作跑在**普通 node 服务进程**里 ⇒ 两条都没有 ⇒ 落到候选表最前面的
+//   `node-corepack` ⇒ 跑 corepack 自己解析出的那版（本机实测 11.21.0），
+//   而 profile 的 node_modules 是**声明的那版**建的（`.modules.yaml` 写着 pnpm@11.7.0）
+//   ⇒ 版本错配 ⇒ Windows 上 rename 覆盖已存在目录 ⇒ ERR_PNPM_EPERM。
+//   本机实据（两份都在，且都是 profile 声明的那版 11.7.0）：
+//     · ~/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/pnpm
+//     · <桌面端安装目录>/resources/runtime/pnpm
+//
+// 全部探测只走注入的 `exists`（生产默认值 = 进程事实）；本模块**不 spawn 任何东西**。
+//
+// 分层：L0 · infra（不得 import domain/routes/index —— tests/test-architecture-guard.mjs 断言②）。
+
+import { dirname, join } from 'node:path'
+import { homedir } from 'node:os'
+
+/** PATH 条目里的 `<…>\runtime\pnpm\bin` 形态（桌面端 host 就是把它拼进 profile 的 PATH 的）。 */
+const RUNTIME_PNPM_BIN_RE = /[\\/]runtime[\\/]pnpm[\\/]bin[\\/]?$/u
+/** PATH 条目里的 `<…>\runtime\bin` 形态（其同级就是 `runtime\pnpm\bin\pnpm.mjs`）。 */
+const RUNTIME_BIN_RE = /[\\/]runtime[\\/]bin[\\/]?$/u
+
+/** 桌面端（Electron）自带运行时的 pnpm 入口候选（resourcesPath + PATH 两条线索）。 */
+function desktopRuntimeCandidates({ resourcesPath, pathDirs, delimiter }) {
+  const out = []
+  if (typeof resourcesPath === 'string' && resourcesPath !== '') {
+    out.push(join(resourcesPath, 'runtime', 'pnpm', 'bin', 'pnpm.mjs'))
+  }
+  void delimiter
+  for (const dir of pathDirs) {
+    if (RUNTIME_PNPM_BIN_RE.test(dir)) out.push(join(dir, 'pnpm.mjs'))
+    else if (RUNTIME_BIN_RE.test(dir)) out.push(join(dirname(dir), 'pnpm', 'bin', 'pnpm.mjs'))
+  }
+  return out
+}
+
+/** DSH 运行时装那份 pnpm 的入口候选（**普通 node 进程也找得到**，0.5.48 新增）。
+ * 位置：`<dshHome>/dsh-runtimes/<runtime>/dependencies/pnpm/bin/pnpm.mjs`。
+ * `env.DSH_PNPM_HINT` 是显式注入点（单测用，也允许用户指定）。 */
+function dshRuntimeCandidates({ env, home = homedir() }) {
+  const dshHomeDir = typeof env?.DSH_HOME === 'string' && env.DSH_HOME !== ''
+    ? env.DSH_HOME
+    : join(home, '.dsh')
+  const out = []
+  if (typeof env?.DSH_PNPM_HINT === 'string' && env.DSH_PNPM_HINT !== '') out.push(env.DSH_PNPM_HINT)
+  for (const rt of ['dsh-primary-runtime', 'dsh-runtime']) {
+    out.push(join(dshHomeDir, 'dsh-runtimes', rt, 'dependencies', 'pnpm', 'bin', 'pnpm.mjs'))
+  }
+  return out
+}
+
+export { RUNTIME_PNPM_BIN_RE, RUNTIME_BIN_RE, desktopRuntimeCandidates, dshRuntimeCandidates }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.47",
+  "version": "0.5.48",
   "description": "DSH 框架升级安全与插件升级门控：一键升级、失败自动回滚、升级后回滚上版、旧插件不适配自动禁用；内置多源插件市场为发现层，插件源全部可自定义，可指向公司内网私有源 / 私有索引 / 本地 Git 仓库，纯内网离线可用 | Framework upgrade safety & plugin version gating for DSH, with a customizable multi-source plugin market: point every source at internal mirrors or a local file:// repo for intranet-only, offline installs.",
   "repository": {
     "type": "git",