@noob-stupid/dsh-plugin-console 0.5.50 → 0.5.54

package/lib/server/infra/exec.js

@@ -445,27 +445,23 @@ function execFileWithKillTree(bin, argv, opts = {}, deps = {}) {
  *   仍然照需求注入这三个 env（CI 与非交互确实有用、registry 镜像照旧、fetch_* 是 npm 系标准写法，
  *   对 npm/后续 pnpm 版本仍可能生效），但**不把健壮性只押在 env 上**。
  *
- * ★ 2026-10-14（0.5.50 之后回校，实测更正 0.5.48 此处的判断）：
- *   0.5.48 在这里写的是「pnpm 判交互用它自己的 ci 配置项（opts3.ci，env 形态即 npm_config_ci），
- *   **不是** process.env.CI」。**这句只对了一半，而且是最关键的一半错了**：
- *     · `npm_config_ci=true` 对 pnpm **自己的**配置项是**空操作** —— pnpm 只认 `pnpm_config_*`
- *       前缀（含 argv 的 `--config.*`）。实测：设了它，`pnpm config list --json` 里 `ci` 仍为空，
- *       且 `pnpm install` 面对过时 lock 时**不会**被 frozen 拒绝。⇒ env 这一行是安慰剂。
- *     · 反过来，`CI=true` **确实**点亮 ci 位：pnpm 自己的配置默认值就是 `ci: isCI`
- *       （dist/pnpm.mjs L145865），而 `isCI` 判的是 `env.CI`（L143262）⇒ `opts3.ci` 随之变真。
- *       实测：只设 `CI=true`，`pnpm install` 面对过时 lock **会**被 frozen 拒绝（证伪组：
- *       再加 `--no-frozen-lockfile` 就恢复照常）。这一位在 v0.5.30 就已注入，不是 0.5.48 新增。
- *   ⇒ 真正管用的两位：`CI=true`（env，早就有）与 `--config.ci=true`（argv，只加在 pnpmAddArgs）。
- *     `npm_config_ci=true` 留着无害（对 npm 兼容项仍可能生效），但**别再把它当成非交互的保证**。
- *   ⚠️ 另有一处更重要的更正：0.5.48 说"命中供应链闸 ⇒ pnpm 弹提问 ⇒ 管道永不关闭 ⇒ 永久挂住"，
- *     这条因果链**实测不成立**。pnpm 的 `canPrompt = !inCi && Boolean(process.stdin.isTTY)`
- *     （L194277-278）—— 管道下 `isTTY` 恒为假 ⇒ pnpm **从来**不走 prompt 分支，五种配置
- *     （无 ci / CI=true / npm_config_ci / --config.ci / 两者齐上）实测全部快速失败，无一挂住。
- *     真正读 stdin 等人的是 **corepack 的下载提问**（corepack.cjs L22083：
- *     `if (process.stdin.isTTY && !process.env.CI)` ⇒ `stdin.resume()` + `once(stdin,'data')`）
- *     —— 它的判据恰恰是 `process.env.CI`，也就是 0.5.48 说"不是 pnpm 读的那一位"的那个变量。
- *     所以"无 TTY 挂住"的真凶是 corepack（且需 isTTY 为真才挂），不是 pnpm 的供应链闸。
- *     本段只更正文档，**未改动任何行为代码**（三个 env 与 argv 的注入原样保留）。 */
+ * ★ 2026-10-14（回校 0.5.48 此处的判断，**行为未动、只更正说明**。完整取证与五组实验见
+ *   CHANGELOG「v0.5.51」那节；这里只留结论，因为本文件贴着架构守卫的 600 行硬顶）：
+ *   ① `npm_config_ci=true` 对 pnpm **自己的**配置项是**空操作**（只认 `pnpm_config_*` 前缀，
+ *      含 argv 的 `--config.*`）⇒ 这一行是安慰剂，别再当成非交互的保证。
+ *   ② `CI=true` **确实**点亮 ci 位（pnpm 配置默认值 `ci: isCI`，`isCI` 判 `env.CI`）⇒
+ *      `pnpm install` 面对过时 lock **会**被 frozen 拒绝（加 `--no-frozen-lockfile` 即恢复）。
+ *      这一位 **v0.5.30 就已注入**，不是 0.5.48 新增。
+ *   ③ 「pnpm 弹提问 ⇒ 读 stdin 到 EOF ⇒ 永久挂住」**不成立**：`canPrompt` 需要
+ *      `process.stdin.isTTY`，管道下恒为假 ⇒ pnpm 从不 prompt；五种 ci 配置实测**全部快速失败**。
+ *   ④ 那"挂到 90s / 180s"**是我们自己的超时常量**（`runPnpmAdd` timeout=90000、
+ *      `installTargetDependencies` timeoutMs=180000），与当时观察逐一吻合 ⇒ 是"超过我们的
+ *      超时被杀"，不是"等输入"。**那次为什么慢至今没有证据**（最可能是网络）。
+ *   ⑤ corepack 的下载提问也**默认是关的**（入口 shim `COREPACK_ENABLE_DOWNLOAD_PROMPT ??= '0'`），
+ *      只有显式设成 1 才会问 ⇒ 也不是默认真凶。
+ *   ⇒ 0.5.48 那条「永久挂住」的**根因至今未查明**，能确定的只有"不是 pnpm 的交互提问"。
+ *     `--config.ci=true` 仍保留独立价值：钉死 ci 位 + 让 install 在 lock 过时走 frozen 拒绝
+ *     而非静默改写；`pnpm add` 不受 frozen 影响（实测带/不带此旗结局相同）。 */
 function pnpmEnvOverrides(registry) {
   const overrides = {
     npm_config_fetch_timeout: '60000',
@@ -511,8 +507,11 @@ function pnpmFetchArgs(timeoutMs = 60000, retries = 1) {
  * ★ 2026-10-14（实测更正 0.5.48 的理由陈述，**行为未动**）：0.5.48 写"命中供应链闸 ⇒ 弹提问 ⇒
  *   管道永不关闭 ⇒ 永久挂住"，这条因果链实测**不成立**：pnpm 的
  *   `canPrompt = !inCi && Boolean(process.stdin.isTTY)`，管道下 isTTY 恒假 ⇒ pnpm 从不 prompt，
- *   五种 ci 配置实测全部快速失败（无一挂住）。真正读 stdin 等人的是 **corepack 的下载提问**
- *   （corepack.cjs L22083，判据 `process.stdin.isTTY && !process.env.CI`）。
+ *   五种 ci 配置实测全部快速失败（无一挂住）。
+ *   ⚠️ 本节**不指定真凶**：那"挂到 90s/180s"是我们**自己的超时常量**（`runPnpmAdd` timeout=90000、
+ *   `installTargetDependencies` timeoutMs=180000），与当时观察逐一吻合 ⇒ 是"超过我们的超时被杀"；
+ *   而 corepack 的下载提问**默认是关的**（入口 shim `COREPACK_ENABLE_DOWNLOAD_PROMPT ??= '0'`）。
+ *   **根因至今未查明**（最可能是网络）—— 别再把 corepack（或 pnpm）当成已证实的结论。
  *   所以这一位的真实价值是：**把 ci 位钉死**（与 `CI=true` 同向、但不受 env 被覆盖影响），
  *   并让 install 类命令在 lock 过时走 frozen 拒绝而非静默改写。`pnpm add` 不受 frozen 影响
  *   （实测：带/不带此旗，add 都照常装上并更新 lock）⇒ 不会把安装变成拒绝。

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

@@ -9,20 +9,22 @@
 //   桌面壳/服务进程给的是**永不关闭的 stdin 管道** ⇒ 不抛错、不超时，**永久挂住**
 //   （实测两次分别挂到 90s / 180s 被杀）。
 //
-// ★ 2026-10-14（实测更正上面这段"现场描述"，**本模块行为未动**）：
-//   上述因果链里"pnpm 弹提问 ⇒ 读 stdin 到 EOF ⇒ 挂住"这一段**实测不成立**：
+// ★ 2026-10-14（回校上面这段"现场描述"，**本模块行为未动**）：
+//   上述因果链里"pnpm 弹提问 ⇒ 读 stdin 到 EOF ⇒ 永久挂住"这一段**实测不成立**：
 //     · pnpm 的 canPrompt = `!inCi && Boolean(process.stdin.isTTY)`（L194277-278）；
 //       管道下 isTTY 恒假 ⇒ pnpm **从不**走 prompt 分支，直接 `throw failOnImmature`。
 //     · 实测（pnpm 11.7.0，minimumReleaseAge 设成天文数字 + 管道 stdin）：无 ci 位 / CI=true /
 //       npm_config_ci=true / --config.ci=true / 两者齐上 —— **五种配置全部快速失败，无一挂住**。
-//     · 真正读 stdin 等人的是 **corepack 的下载提问**（corepack.cjs L22083：
-//       `if (process.stdin.isTTY && !process.env.CI) { stderr.write('? Do you want to continue?');
-//        stdin.resume(); await once(stdin,'data') }`）—— 判据恰恰是 `process.env.CI`。
+//     · 那"挂到 90s / 180s"其实是**我们自己的超时常量**：`runPnpmAdd` 默认 timeout=90000、
+//       `link-self-sufficiency#installTargetDependencies` 默认 timeoutMs=180000 —— 与当时观察
+//       逐一吻合 ⇒ 当时是"某次操作超过我们设的超时被我们杀掉"，**不是**"等输入等到天荒地老"。
+//       那次为什么慢**至今没有证据**（最可能是网络）；corepack 的下载提问也**默认是关的**
+//       （入口 shim 第一行 `COREPACK_ENABLE_DOWNLOAD_PROMPT ??= '0'`）。
 //   ⇒ 本模块的定位不变（**识别 + 翻译成可操作错误**，绝不绕过闸门），仍然有价值；
-//     只是"为什么会挂住"要记在 corepack 头上，不是 pnpm 的供应链闸。
-//     顺带更正另两处（详见 infra/exec.js#pnpmEnvOverrides 上方的完整说明）：
+//     只是「为什么会挂住」**至今未查明**，不要再照 0.5.48 那段因果链去找。
+//     另两处一并更正（详见 infra/exec.js#pnpmEnvOverrides 上方的完整说明）：
 //       · `npm_config_ci=true` 对 pnpm 自己的配置项是**空操作**（只认 `pnpm_config_*`）；
-//       · `CI=true` **确实**点亮 ci 位（pnpm 配置默认值 `ci: isCI`，L145865）。
+//       · `CI=true` **确实**点亮 ci 位（pnpm 配置默认值 `ci: isCI`，L145865），且 v0.5.30 就有。
 //
 // 闸门实现（本机 pnpm 11.7.0 `dist/pnpm.mjs`，只读反编译取证）：
 //   L194277  const inCi = opts3.ci ?? isCI

package/lib/server/routes/compat.js

@@ -262,6 +262,14 @@ async function routeCompatStatusGet(req, res, rc) {
     frameworkVersion: current.frameworkVersion,
     fingerprint: { current, previous, changed, reasons, baselineAt },
     rollback: readRollbackRecord(),
+    // ★ 0.5.53 加法：外壳托管时升级/回滚通道会被服务端拒绝（409），面板据此把回滚点标成"不可用"
+    //   并说明原因，而不是显示"可用"却点了必然失败。判据与 upgrade/rollback 路由共用 detectHostShape。
+    host: (() => {
+      try {
+        const shape = detectHostShape()
+        return { hosted: shape.hosted === true, kind: shape.kind, notice: shape.hosted === true ? shape.notice : null }
+      } catch { return { hosted: false, kind: 'standalone', notice: null } }
+    })(),
     // D1 加法字段：自动预检的状态/结论（面板只放一句短句，长文进详情）
     autoPreflight: { ...autoPreflight, scheduled: autoRun !== null, scheduledAt: autoRun === null ? null : Date.now(), timeoutMs: autoRun?.timeoutMs ?? preflightTimeoutMs() },
     // D5 加法字段：自动禁用的开关状态 + **本次一次性提示**（客户端走既有瞬时 note 通道；

package/lib/server/routes/framework.js

@@ -16,7 +16,7 @@ import { fetchJsonUrl } from '../infra/http.js'
 import { sendError, sendJson } from '../infra/httpd.js'
 import { dshHome, entryPkgMeta, findPatchPath, packageNameOf, pluginRoot, profileDirOf, resolvePackageJson } from '../infra/paths.js'
 import { isFrameworkVersionNewer, semverRangeMatchLoose, frameworkUpgradeCandidates } from '../infra/semver.js'
-import { dropStaleUpdateCandidates } from '../domain/update-candidates.js'
+import { dropStaleUpdateCandidates, pickUpdateTarget } from '../domain/update-candidates.js'
 import { fwCheckCache, setFwCheckCache } from '../state.js'
 
 /**
@@ -337,7 +337,7 @@ async function routeCheckUpdate(req, res, rc) {
     } catch {}
     // 兜底（0.5.37）：低于已装版本的候选不是"新版"（真机：镜像 latest=0.1.1-rc.1 < 已装 0.2.0-rc.2）
     ;({ latest, next, beta } = dropStaleUpdateCandidates({ latest, next, beta }, packageName, ctx.baseUrl ?? 'file:///', profileDirOf(ctx)))
-    sendJson(res, 200, { ok: true, packageName, latest, next, beta, depsOutdated, error, source, migrate })
+    sendJson(res, 200, { ok: true, packageName, latest, next, beta, target: pickUpdateTarget({ latest, next, beta }), depsOutdated, error, source, migrate })
     return
 }
 

package/lib/server/routes/index.js

@@ -30,12 +30,14 @@ import { routeEnrich, routeMarketIndex, routeRepo, routeSearch, routeSubpackages
 import { routeAdaptUnlock, routeAdaptUnlockAll, routeCleanResiduals, routeSelfUpdate, routeToggle, routeUninstall } from './plugins.js'
 import { routeSkillRemove, routeSkillToggle, routeSkillsInstalledGet } from './skills.js'
 import { routeGiteeOauthCallbackGet, routeGiteeOauthUrlGet, routeRegistryScan, routeSources, routeSourcesGet } from './sources.js'
-import { routeDetails, routeStateGet } from './state.js'
+import { routeDetails, routeLinksGet, routeStateGet } from './state.js'
 
 const ROUTE_PREFIX = '/plugin-console'
 
 const ROUTES_EARLY = [
   { methods: ['GET'], path: `${ROUTE_PREFIX}/state`, handler: routeStateGet },
+  // link 开发式安装清单（0.5.54 加法）：纯只读，供面板渲染"已挂载 / 自足性 / 垫片 / 持久化"
+  { methods: ['GET'], path: `${ROUTE_PREFIX}/links`, handler: routeLinksGet },
   { methods: ['GET'], path: `${ROUTE_PREFIX}/sources`, handler: routeSourcesGet },
   { methods: ['GET'], path: `${ROUTE_PREFIX}/gitee-oauth-url`, handler: routeGiteeOauthUrlGet },
   { methods: ['GET'], path: `${ROUTE_PREFIX}/gitee-oauth-callback`, handler: routeGiteeOauthCallbackGet },

package/lib/server/routes/state.js

@@ -5,9 +5,12 @@ import { readFileSync, existsSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { detectAdoptablePending, detectCompat, gatingSummary, readCompatGate, readCompatPendingWithVerdicts } from '../domain/compat.js'
 import { compUiUrl, findComponents } from '../domain/components.js'
-import { currentFrameworkVersion, detectFrameworkUpgrade } from '../domain/framework.js'
+import { currentFrameworkVersion, detectFrameworkUpgrade, detectHostShape } from '../domain/framework.js'
 import { peerVetoFor } from '../domain/peer-veto.js'
 import { readExtraBundleRows } from '../domain/install-job.js'
+import { bundleVetoList } from '../domain/bundle-veto.js'
+import { buildLinkInventory } from '../domain/link-inventory.js'
+import { readBundlesSync } from '../domain/persist.js'
 import { failedJobEvidence } from '../domain/install-verify.js'
 import { installJobView, readGithubAuth } from '../domain/install.js'
 import { readPluginDetails } from '../domain/market.js'
@@ -128,7 +131,33 @@ async function routeStateGet(req, res, rc) {
       const selfPkg = JSON.parse(readFileSync(join(pluginRoot(), 'package.json'), 'utf8'))
       selfVersion = typeof selfPkg.version === 'string' ? selfPkg.version : null
     } catch {}
-    sendJson(res, 200, { ok: true, entries, patchPath, compat, installJobs: jobs, recentFailures, pendingRestart, github: { loggedIn: auth.loggedIn, login: auth.login }, patch: { disables: patch.disables, forced: patch.forced, inserts: patch.inserts }, framework, patchHeal: patchHeal === null ? null : { healed: patchHeal.healed ?? [], autoDisabled: patchHeal.autoDisabled ?? [], healedAt: patchHeal.healedAt ?? 0, written: patchHeal.written === true, writeError: patchHeal.writeError ?? null, skippedFrameworkOwned: (patchHeal.skipped ?? []).map((s) => s.id ?? null), uncertain: (patchHeal.uncertain ?? []).map((u) => u.id ?? null) }, gating: gatingSummary(ctx, compatPending, entries, compatVerdicts), compatPending: compatPending === null ? null : { frameworkVersion: compatPending.frameworkVersion ?? null, upgradeFrom: compatPending.upgradeFrom ?? null, pending: (compatPending.pending ?? []).filter((p) => (p.status ?? 'pending') === 'pending').map((p) => ({ rowId: p.rowId, moduleName: p.moduleName, version: p.version ?? null, checkNote: p.checkNote ?? null, check: p.check ?? null, riskyApprovedAt: p.riskyApprovedAt ?? null, adoptable: adoptable.get(p.rowId) ?? null, verdict: compatVerdicts.get(p.rowId) ?? null })), verdictRefresh: pendingState.refresh === null ? null : { version: pendingState.refresh.version ?? null, updated: pendingState.refresh.updated ?? [], unchanged: pendingState.refresh.unchanged ?? [], unresolved: pendingState.refresh.unresolved ?? [], wrote: pendingState.refresh.wrote === true, writeError: pendingState.refresh.writeError ?? null } }, compatGate, rollback: rollbackRec, selfVersion, components: findComponents().map((c) => ({ id: c.id, name: c.name, kind: c.kind ?? 'server', pid: c.pid ?? null, port: c.port ?? null, healthUrl: c.healthUrl ?? null, uiUrl: compUiUrl(c), autoStart: c.autoStart === true })) })
+    // ★ 0.5.53 加法（真机 2026-10-15）：**被框架整层跳过的 bundle**。
+    //   症状：插件装了、在 dsh.profile.bundles 里，但面板上连"未加载"都不显示（用户原话：
+    //   "为啥有的插件我本身是有的，但是没显示呢"）。原因是框架在**装载 bundle 时**就因 peer 不满足
+    //   throw，整个 bundle 层进 skippedBundles，它要插的行根本不存在 —— 而面板 enumerate 的是 loader 行。
+    //   这里复算同一判据（纯只读），把它们如实列出来；绝不改动任何东西。
+    let skippedBundles = { items: [], reliable: true, note: null }
+    try {
+      skippedBundles = bundleVetoList({
+        bundleNames: readBundlesSync(profileDir),
+        profileDir,
+        baseUrl: ctx.baseUrl ?? 'file:///',
+        frameworkVersion: vetoFrameworkVersion,
+      })
+    } catch {}
+    // ★ 0.5.53 加法（真机 2026-10-15）：把「本实例是否由桌面端外壳托管」告诉面板。
+    //   为什么必须下发：一键升级 / 一键回滚这两条通道在**外壳托管时会被服务端拒绝**
+    //   （409 + 「本实例由桌面端外壳托管，请在桌面端内重启/更新」）—— 那是一份历史事故的修补：
+    //   回滚脚本曾按端口 Stop-Process 杀掉 Electron 承载的 host，重新拉起时又找不到 bin.js，
+    //   于是外壳记了一次 crash。拒绝本身是对的，但面板**过去照旧显示一个可点的「回滚到上一版」**，
+    //   点下去必然 409 —— 典型的"按钮存在但永远失败"。这里把同一份事实（detectHostShape）
+    //   下发给面板，让按钮按事实禁用并说明原因，而不是让人撞墙。
+    let host = { hosted: false, kind: 'standalone', notice: null }
+    try {
+      const shape = detectHostShape()
+      host = { hosted: shape.hosted === true, kind: shape.kind, notice: shape.hosted === true ? shape.notice : null }
+    } catch {}
+    sendJson(res, 200, { ok: true, entries, skippedBundles, host, patchPath, compat, installJobs: jobs, recentFailures, pendingRestart, github: { loggedIn: auth.loggedIn, login: auth.login }, patch: { disables: patch.disables, forced: patch.forced, inserts: patch.inserts }, framework, patchHeal: patchHeal === null ? null : { healed: patchHeal.healed ?? [], autoDisabled: patchHeal.autoDisabled ?? [], healedAt: patchHeal.healedAt ?? 0, written: patchHeal.written === true, writeError: patchHeal.writeError ?? null, skippedFrameworkOwned: (patchHeal.skipped ?? []).map((s) => s.id ?? null), uncertain: (patchHeal.uncertain ?? []).map((u) => u.id ?? null) }, gating: gatingSummary(ctx, compatPending, entries, compatVerdicts), compatPending: compatPending === null ? null : { frameworkVersion: compatPending.frameworkVersion ?? null, upgradeFrom: compatPending.upgradeFrom ?? null, pending: (compatPending.pending ?? []).filter((p) => (p.status ?? 'pending') === 'pending').map((p) => ({ rowId: p.rowId, moduleName: p.moduleName, version: p.version ?? null, checkNote: p.checkNote ?? null, check: p.check ?? null, riskyApprovedAt: p.riskyApprovedAt ?? null, adoptable: adoptable.get(p.rowId) ?? null, verdict: compatVerdicts.get(p.rowId) ?? null })), verdictRefresh: pendingState.refresh === null ? null : { version: pendingState.refresh.version ?? null, updated: pendingState.refresh.updated ?? [], unchanged: pendingState.refresh.unchanged ?? [], unresolved: pendingState.refresh.unresolved ?? [], wrote: pendingState.refresh.wrote === true, writeError: pendingState.refresh.writeError ?? null } }, compatGate, rollback: rollbackRec, selfVersion, components: findComponents().map((c) => ({ id: c.id, name: c.name, kind: c.kind ?? 'server', pid: c.pid ?? null, port: c.port ?? null, healthUrl: c.healthUrl ?? null, uiUrl: compUiUrl(c), autoStart: c.autoStart === true })) })
     return
 }
 
@@ -159,4 +188,28 @@ async function routeDetails(req, res, rc) {
     return
 }
 
-export { routeStateGet, routeDetails }
+/**
+ * GET /links —— **link 开发式安装清单**（0.5.54 加法，纯只读）。
+ *
+ * 用户 2026-10-15 的原话：「这主要是对标他们本地开发插件 link 挂载钉住」。
+ * 过去面板上 link 钉住的插件与普通插件长得一模一样：看不出指向哪、目标还在不在、
+ * 依赖/peer 齐不齐、改完代码加载的是哪一份。本路由把它们聚合成一份清单，让"看见"先成立。
+ *
+ * 判据全部复用既有唯一真源（domain/link-inventory.js → planLinkSelfSufficiency / persistReport /
+ * listSelfSufficiencyRecords），**不新增任何写盘、不 spawn、不联网**。
+ */
+async function routeLinksGet(req, res, rc) {
+  const ctx = rc.ctx
+  let payload = { ok: true, items: [], count: 0, readyCount: 0, error: null }
+  try {
+    const patchPath = findPatchPath(ctx)
+    const profileDir = dirname(patchPath)
+    payload = { ok: true, ...buildLinkInventory({ profileDir, patchPath, entries: listEntries(ctx) }), error: null }
+  } catch (error) {
+    // 体检失败要如实说，不能假装"没有 link 依赖"
+    payload = { ok: false, items: [], count: 0, readyCount: 0, error: error instanceof Error ? error.message : String(error) }
+  }
+  sendJson(res, 200, payload)
+}
+
+export { routeStateGet, routeDetails, routeLinksGet }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.50",
+  "version": "0.5.54",
   "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",
@@ -51,8 +51,7 @@
     "cordis.patch.yml",
     "SECURITY.md",
     "icon.svg",
-    "scripts/safe-boot.mjs",
-    "scripts/fw-preflight.mjs"
+    "scripts"
   ],
   "license": "MIT",
   "scripts": {

package/scripts/apply-framework-patch.cjs

@@ -0,0 +1,134 @@
+/**
+ * 框架层补丁：dsh-app-boot 的 cordis.patch.yml 解析容错（议题 #5）。
+ *
+ * 问题：cordis.patch.yml 若含顶格 `[]` 占位符 + 后续条目（两个 YAML 根节点），
+ * DSH 启动时 parsePatchList 解析崩溃（"end of the stream or a document separator is expected"）。
+ *
+ * 修复：parsePatchList 解析失败时，自动移除顶格空数组占位行（视为 no-op）后重试。
+ *
+ * 用法：node scripts/apply-framework-patch.cjs
+ * 说明：DSH 升级（npx 重新拉取）后框架文件会被覆盖，重新运行本脚本即可。
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const os = require('node:os')
+
+/** npm 缓存下的 npx 缓存目录候选（**不写死盘符/用户名**）。
+ *  npm 的 cache 位置是用户配置（把 cache 指到别的盘很常见）→ 按 npm 自己的来源读：
+ *  环境变量 npm_config_cache / NPM_CONFIG_CACHE + 用户级 ~/.npmrc 的 `cache=`。
+ *  （原实现第一条写死开发机上的缓存绝对路径：某个盘符下的 node_cache\_npx。） */
+function npmNpxCacheRoots() {
+  const roots = []
+  const push = (value) => {
+    if (typeof value !== 'string') return
+    const dir = value.trim().replace(/^["']|["']$/g, '').replace(/^~(?=[\\/]|$)/, os.homedir())
+    if (dir !== '') roots.push(path.join(dir, '_npx'))
+  }
+  for (const key of ['npm_config_cache', 'NPM_CONFIG_CACHE']) push(process.env[key])
+  try {
+    for (const line of fs.readFileSync(path.join(os.homedir(), '.npmrc'), 'utf8').split(/\r?\n/)) {
+      const hit = /^\s*cache\s*=\s*(.*?)\s*$/i.exec(line)
+      if (hit) push(hit[1])
+    }
+  } catch {}
+  return roots
+}
+
+// 定位 @deepseek-ai/dsh-app-boot（与 @deepseek-ai/dsh 同级）
+function locateAppBoot() {
+  try {
+    const dshPkg = require.resolve('@deepseek-ai/dsh/package.json')
+    const aiDir = path.dirname(dshPkg) // .../node_modules/@deepseek-ai
+    const candidate = path.join(aiDir, 'dsh-app-boot', 'lib', 'index.js')
+    if (fs.existsSync(candidate)) return candidate
+  } catch {}
+  const cacheRoots = [
+    process.env.NODE_CACHE || '',
+    ...npmNpxCacheRoots(),
+    path.join(os.homedir(), '.npm', '_npx'),
+    process.env.LOCALAPPDATA ? path.join(process.env.LOCALAPPDATA, 'node_cache', '_npx') : '',
+  ].filter(Boolean)
+  for (const root of cacheRoots) {
+    if (!fs.existsSync(root)) continue
+    let entries = []
+    try { entries = fs.readdirSync(root, { withFileTypes: true }) } catch { continue }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue
+      const candidate = path.join(root, entry.name, 'node_modules', '@deepseek-ai', 'dsh-app-boot', 'lib', 'index.js')
+      if (fs.existsSync(candidate)) return candidate
+    }
+  }
+  return null
+}
+
+const MARKER = 'tryDropEmptyArrayPlaceholder'
+const OLD = `function parsePatchList(binName, file, content, label) {
+	let parsed;
+	try {
+		parsed = yaml.load(content, { schema: userPatchesSchema });
+	} catch (error) {
+		throw new Error(\`${'${binName}'}: failed to parse ${'${label}'} ${'${file}'}: ${'${String(error)}'}\`);
+	}`
+const NEW = `function parsePatchList(binName, file, content, label) {
+	let parsed;
+	try {
+		parsed = yaml.load(content, { schema: userPatchesSchema });
+	} catch (error) {
+		// 容错（issue #5）：文件可能是「[] 空数组占位符 + 后续条目」两个根节点，
+		// YAML 解析必然失败。移除顶层空数组占位行（视为 no-op）后重试。
+		const retried = tryDropEmptyArrayPlaceholder(content);
+		if (retried !== null) {
+			try {
+				parsed = yaml.load(retried, { schema: userPatchesSchema });
+			} catch {
+				throw new Error(\`${'${binName}'}: failed to parse ${'${label}'} ${'${file}'}: ${'${String(error)}'}\`);
+			}
+		} else {
+			throw new Error(\`${'${binName}'}: failed to parse ${'${label}'} ${'${file}'}: ${'${String(error)}'}\`);
+		}
+	}`
+
+const HELPER = `
+/**
+ * 容错辅助（issue #5）：若文件含顶格空数组占位行（\`[]\` / \`[ ]\`，可带行尾注释），
+ * 视为 no-op 全部移除；无此模式返回 null。
+ */
+function tryDropEmptyArrayPlaceholder(content) {
+	const lines = String(content).split("\\n");
+	const kept = [];
+	let dropped = false;
+	for (const line of lines) {
+		if (/^\\[\\s*\\]\\s*(?:#.*)?$/u.test(line)) {
+			dropped = true;
+			continue;
+		}
+		kept.push(line);
+	}
+	if (!dropped) return null;
+	return kept.join("\\n");
+}
+`
+
+function main() {
+  const target = locateAppBoot()
+  if (!target) {
+    console.error('未找到 @deepseek-ai/dsh-app-boot/lib/index.js，请确认 DSH 已安装（或手动指定路径）')
+    process.exit(1)
+  }
+  const source = fs.readFileSync(target, 'utf8')
+  if (source.includes(MARKER)) {
+    console.log('已打过补丁，跳过：' + target)
+    return
+  }
+  if (!source.includes('function parsePatchList')) {
+    console.error('未找到 parsePatchList（框架版本可能已变更），跳过。' + target)
+    process.exit(1)
+  }
+  fs.copyFileSync(target, target + '.bak-issue5')
+  const next = source.replace(OLD, NEW) + HELPER
+  fs.writeFileSync(target, next, 'utf8')
+  console.log('补丁已应用：' + target)
+  console.log('备份：' + target + '.bak-issue5')
+}
+
+main()

package/scripts/apply-npm-names.cjs

@@ -0,0 +1,36 @@
+/**
+ * 给已提交的 marketplace/index.json 就地补 npmName（批次 C-⑪）。
+ *
+ * 为什么单独有这个脚本：build-index.cjs 需要 gh CLI + 网络（本机 github 不可达时跑不了），
+ * 而"补 npmName"这件事**完全离线** —— 映射来自 marketplace/npm-name-hints.json（人工核对）。
+ * 用法：
+ *   node scripts/apply-npm-names.cjs                     # 就地更新 marketplace/index.json
+ *   node scripts/apply-npm-names.cjs --dry-run           # 只报告会改哪几条
+ *   node scripts/apply-npm-names.cjs --file=<index.json> # 指定索引文件
+ * 幂等：已经带 npmName 的条目内容不变；映射里没有的仓库保持原样（老索引兼容）。
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const { readNpmNameHints, withNpmNames } = require('./build-index.cjs')
+
+const args = process.argv.slice(2)
+const dryRun = args.includes('--dry-run')
+const fileArg = args.find((a) => a.startsWith('--file='))
+const hintsArg = args.find((a) => a.startsWith('--hints='))
+const indexFile = fileArg ? fileArg.split('=')[1] : path.join(__dirname, '..', 'marketplace', 'index.json')
+const hints = readNpmNameHints(hintsArg ? hintsArg.split('=')[1] : undefined)
+
+const raw = JSON.parse(fs.readFileSync(indexFile, 'utf8'))
+const before = Array.isArray(raw.items) ? raw.items : []
+const after = withNpmNames(before, hints)
+const changed = after.filter((it, i) => typeof it.npmName === 'string' && before[i]?.npmName !== it.npmName)
+
+console.log(`映射条目 ${Object.keys(hints).length} 条；索引 ${before.length} 条命中 ${changed.length} 条`)
+for (const it of changed) console.log(`  ${it.fullName} → ${it.npmName}`)
+
+if (dryRun) {
+  console.log('（dry-run：未写入）')
+  process.exit(0)
+}
+fs.writeFileSync(indexFile, JSON.stringify({ ...raw, items: after }, null, 2) + '\n', 'utf8')
+console.log(`已写入 ${indexFile}`)

package/scripts/build-index.cjs

@@ -0,0 +1,190 @@
+/**
+ * 构建静态插件/技能索引：嗅探 GitHub topic 仓库 → marketplace/index.json。
+ *
+ * 插件模式（默认）：topic:dsh-plugin，按 star 排序，限制 --limit（默认 500）
+ * 技能模式：--skills，合并 topic:agent-skills + topic:claude-skills + topic:dsh-skill，
+ *   写入 index.json 的 skills 段（保留已有 items 段），限制 --limit（默认 300）
+ *
+ * 数据拉取（本机沙箱禁止 node spawn gh 时的推荐方式）：
+ *   gh api --paginate "search/repositories?q=topic:dsh-plugin&sort=stars&order=desc&per_page=100" > raw.json
+ *   node scripts/build-index.cjs --input raw.json [--limit 500]
+ * 无 --input 时尝试直接用 gh CLI 拉取（GitHub Actions 中预装 gh 且已认证）。
+ *
+ * 产物：marketplace/index.json（提交到仓库，经 jsDelivr CDN 分发，终端零 GitHub API 调用）
+ */
+const { execFile } = require('node:child_process')
+const { promisify } = require('node:util')
+const fs = require('node:fs')
+const path = require('node:path')
+
+const execFileAsync = promisify(execFile)
+
+const SKILL_TOPICS = ['agent-skills', 'claude-skills', 'dsh-skill']
+
+// gh api search 单对象响应，--paginate 拼接后不是合法 JSON，改手动分页循环
+async function ghSearchRepos(query, limit) {
+  const all = []
+  let page = 1
+  const perPage = Math.min(100, limit)
+  while (all.length < limit) {
+    const { stdout } = await execFileAsync('gh', [
+      'api',
+      'search/repositories',
+      '--method', 'GET',
+      '-f', 'q=' + query,
+      '-f', 'sort=stars',
+      '-f', 'order=desc',
+      '-f', `per_page=${perPage}`,
+      '-f', `page=${page}`,
+      '--jq', '.items',
+    ], {
+      timeout: 120000,
+      windowsHide: true,
+      maxBuffer: 64 * 1024 * 1024,
+    })
+    const batch = JSON.parse(stdout)
+    if (!Array.isArray(batch) || batch.length === 0) break
+    all.push(...batch)
+    page += 1
+  }
+  return all
+}
+
+function normalizeRepo(item) {
+  const fullName = String(item.full_name ?? '').trim()
+  if (!fullName) return null
+  return {
+    fullName,
+    description: item.description ?? '',
+    htmlUrl: item.html_url ?? `https://github.com/${fullName}`,
+    stars: item.stargazers_count ?? 0,
+    updatedAt: item.updated_at ?? '',
+    defaultBranch: item.default_branch ?? 'main',
+    topics: Array.isArray(item.topics) ? item.topics : [],
+  }
+}
+
+function readExisting(file) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'))
+  } catch {
+    return {}
+  }
+}
+
+/**
+ * 仓库 → npm 包名（批次 C-⑪）：市场索引的 npmName 字段。
+ * 为什么需要：有些仓库的根包没有发布到 npm（private），真正该装的产物是某个子包/聚合包
+ * （真机：zhu1090093659/dsh-web → @linxin666/dsh-web-all，5.97 MB，而仓库本体 429 MB、
+ * git 协议 0 B/s）。把这个映射写进索引后，hub 侧可以**直接按包名走 registry 安装**，
+ * 省掉"先探测根 package.json、再展开子包"的一整轮（本机 github 不可达时那条路根本走不通）。
+ * 只收录**能确定**的（人工核对过的映射文件）；不能确定就省略 —— 老索引没有这个字段，
+ * hub 侧行为与改动前完全一致。
+ */
+function readNpmNameHints(explicitFile) {
+  const file = explicitFile ?? path.join(__dirname, '..', 'marketplace', 'npm-name-hints.json')
+  try {
+    const raw = JSON.parse(fs.readFileSync(file, 'utf8'))
+    const hints = raw && typeof raw.hints === 'object' && raw.hints !== null ? raw.hints : {}
+    const out = {}
+    for (const [repo, npmName] of Object.entries(hints)) {
+      if (typeof repo !== 'string' || repo.trim() === '') continue
+      if (typeof npmName !== 'string' || !/^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/u.test(npmName.trim())) continue
+      out[repo.trim().toLowerCase()] = npmName.trim()
+    }
+    return out
+  } catch {
+    return {}
+  }
+}
+
+/** 给归一化后的条目补 npmName（能确定时）。纯函数，便于单测。 */
+function withNpmNames(items, hints) {
+  return items.map((item) => {
+    const hit = hints[String(item.fullName).toLowerCase()]
+    return hit === undefined ? item : { ...item, npmName: hit }
+  })
+}
+
+async function main() {
+  const skillsMode = process.argv.includes('--skills')
+  const limitArg = process.argv.find((a) => a.startsWith('--limit='))
+  const limit = limitArg ? Number(limitArg.split('=')[1]) || (skillsMode ? 300 : 500) : (skillsMode ? 300 : 500)
+  const inputArg = process.argv.find((a) => a.startsWith('--input='))
+  const inputFile = inputArg ? inputArg.split('=')[1] : null
+
+  const dir = path.join(__dirname, '..', 'marketplace')
+  fs.mkdirSync(dir, { recursive: true })
+  const file = path.join(dir, 'index.json')
+
+  let items = []
+  if (skillsMode) {
+    console.log(`拉取技能 topic 仓库（${SKILL_TOPICS.join(' + ')}，gh CLI，自动分页）…`)
+    try {
+      const raw = inputFile ? JSON.parse(fs.readFileSync(inputFile, 'utf8')) : null
+      if (raw) {
+        items = Array.isArray(raw) ? raw : (raw.items ?? [])
+      } else {
+        for (const topic of SKILL_TOPICS) {
+          const batch = await ghSearchRepos(`topic:${topic} in:name,description,topics`, limit)
+          items.push(...batch)
+        }
+      }
+    } catch (error) {
+      console.error('技能搜索失败：' + error.message)
+      process.exit(1)
+    }
+  } else if (inputFile) {
+    // 外部已拉取的数据文件（gh api --paginate 输出：JSON 数组）
+    console.log(`读取数据文件 ${inputFile}…`)
+    const raw = JSON.parse(fs.readFileSync(inputFile, 'utf8'))
+    items = Array.isArray(raw) ? raw : (raw.items ?? [])
+  } else {
+    console.log('拉取 dsh-plugin topic 仓库（gh CLI，自动分页）…')
+    try {
+      items = await ghSearchRepos('topic:dsh-plugin in:name,description,topics', limit)
+    } catch (error) {
+      console.error('搜索失败：' + error.message)
+      process.exit(1)
+    }
+  }
+
+  const seen = new Set()
+  const normalized = []
+  for (const item of items) {
+    const norm = normalizeRepo(item)
+    if (!norm || seen.has(norm.fullName)) continue
+    seen.add(norm.fullName)
+    if (skillsMode) {
+      norm.skillTopics = SKILL_TOPICS.filter((t) => norm.topics.includes(t))
+    }
+    normalized.push(norm)
+    if (normalized.length >= limit) break
+  }
+
+  const existing = readExisting(file)
+  // 批次 C-⑪：给能确定的条目补 npmName（--hints=<file> 可覆盖映射文件）
+  const hintsArg = process.argv.find((a) => a.startsWith('--hints='))
+  const hints = readNpmNameHints(hintsArg ? hintsArg.split('=')[1] : undefined)
+  const named = withNpmNames(normalized, hints)
+  const out = {
+    generatedAt: new Date().toISOString(),
+    count: existing.count ?? 0,
+    items: existing.items ?? [],
+    skills: existing.skills ?? [],
+  }
+  if (skillsMode) {
+    out.skills = named
+    out.skillCount = named.length
+  } else {
+    out.items = named
+    out.count = named.length
+  }
+  fs.writeFileSync(file, JSON.stringify(out, null, 2) + '\n', 'utf8')
+  const hinted = named.filter((it) => typeof it.npmName === 'string').length
+  console.log(`已更新 ${file}：${skillsMode ? '技能 ' + named.length : '插件 ' + named.length}（限制 ${limit}${hinted > 0 ? `；其中 ${hinted} 条带 npmName` : ''}）`)
+}
+
+if (require.main === module) main().catch((error) => { console.error(error); process.exit(1) })
+
+module.exports = { normalizeRepo, readNpmNameHints, withNpmNames }