dsh-plugin 1.6.5 → 1.6.7

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

@@ -8,7 +8,7 @@
  * 输出流式收集到任务上；卸载成功时尝试从运行中 loader 即时停用（见 loader.ts）。
  */
 import { spawn, spawnSync } from 'node:child_process';
-import { resolvePackageEntry } from './package-entry.js';
+import { requiredDistributionFiles, resolveBundlePatchFiles } from './package-entry.js';
 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';
@@ -41,12 +41,30 @@ export function activeTask() {
     for (const item of queue) {
         const task = item.task;
         if (task.status === 'pending') {
-            found.push({ id: task.id, target: show(task), action: task.action, status: 'pending', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES), attempts: task.attempts, installChannel: task.installChannel });
+            found.push({
+                id: task.id,
+                target: show(task),
+                action: task.action,
+                status: 'pending',
+                progress: task.progress,
+                lines: task.lines.slice(0, MAX_TASK_LINES),
+                attempts: task.attempts,
+                installChannel: task.installChannel,
+            });
         }
     }
     tasks.forEach((task) => {
         if (task.status === 'running') {
-            found.unshift({ id: task.id, target: show(task), action: task.action, status: 'running', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES), attempts: task.attempts, installChannel: task.installChannel });
+            found.unshift({
+                id: task.id,
+                target: show(task),
+                action: task.action,
+                status: 'running',
+                progress: task.progress,
+                lines: task.lines.slice(0, MAX_TASK_LINES),
+                attempts: task.attempts,
+                installChannel: task.installChannel,
+            });
         }
     });
     return found;
@@ -117,7 +135,7 @@ function cliInvocation(profile) {
     if (entry !== undefined) {
         // 打包桌面端（Electron）：宿主入口在 app.asar 内，机器上根本没有 `dsh` 可执行文件
         //（Windows 那条 dsh.cmd shim 只存在于宿主进程自己的 PATH 里），直接回退 PATH 必然
-        // 报 [dsh-missing]（见 issue #71）。这里改用应用自己的 CLI 引导脚本调起同一份打包
+        // 报 [dsh-missing]。这里改用应用自己的 CLI 引导脚本调起同一份打包
         // CLI：Electron 可执行文件 + --expose-internals + desktop-cli.js，与内置终端、
         // 官方插件页安装完全同一条路径 —— desktop profile 由应用独占管理的授权也在其中。
         const bootstrap = desktopCliBootstrap(entry);
@@ -172,9 +190,8 @@ export function desktopCliBootstrap(entry) {
 }
 /**
  * dsh 命令存在性探测：which/where 找 PATH 里的 dsh。
- * Windows shell 模式命令缺失时 cmd 只输出 GBK 乱码「不是内部或外部命令」（UTF-8 解码后
- * 无法匹配），POSIX 非 shell 模式才会抛 spawn dsh ENOENT —— 两种形态都不可靠，统一在
- * spawn 前用 which/where 探测，命令不存在则直接失败并打 ASCII 标记 [dsh-missing]（乱码免疫）。
+ * 命令缺失时各平台报错形态不同（Windows shell 只回 GBK 乱码、POSIX 才抛 spawn ENOENT），
+ * 统一在 spawn 前用 which/where 探测，命令不存在则直接失败并打 ASCII 标记 [dsh-missing]（乱码免疫）。
  * 探测自身异常（which/where 不可用等）不拦截安装，交给装后校验兜底。
  */
 function dshOnPath(env) {
@@ -233,7 +250,22 @@ export function startPluginMutation(options) {
     // 卸载入队时先快照「该包是否带客户端 UI」：卸载完成后包已从磁盘删除，读不到 package.json，
     // 只能在此刻取；卸载成功且曾存活时据此决定是否要刷新页面摘除插件面板
     const hadClientUi = options.action === 'remove' ? hasClientUi(options.profile, options.target) : undefined;
-    const task = { id: nextTaskId, target: options.target, displayTarget: options.displayTarget, globalNpm: options.globalNpm, action: options.action, status: 'pending', timedOut: false, exitCode: null, progress: 0, lines: [], attempts: options.attempts ?? [], needsRestart: false, hadClientUi, installChannel: options.installChannel };
+    const task = {
+        id: nextTaskId,
+        target: options.target,
+        displayTarget: options.displayTarget,
+        globalNpm: options.globalNpm,
+        action: options.action,
+        status: 'pending',
+        timedOut: false,
+        exitCode: null,
+        progress: 0,
+        lines: [],
+        attempts: options.attempts ?? [],
+        needsRestart: false,
+        hadClientUi,
+        installChannel: options.installChannel,
+    };
     nextTaskId = nextTaskId >= Number.MAX_SAFE_INTEGER ? 1 : nextTaskId + 1;
     tasks.set(task.id, task);
     if (tasks.size > MAX_TASKS) {
@@ -367,8 +399,8 @@ function spawnMutation(options) {
         let child;
         try {
             // 独立 CLI 场景（file: 'dsh'，宿主加载器走 node bin 不经过这里）：先探测 dsh 是否在 PATH。
-            // 命令不存在时 Windows shell 模式只回传 GBK 乱码、POSIX 才抛 spawn dsh ENOENT —— 统一前置
-            // 拦截并打 ASCII 标记 [dsh-missing]，前端据此精准提示「dsh 未加入 PATH」而不是笼统的插件失败。
+            // 命令缺失时各平台报错形态不同（GBK 乱码 / spawn ENOENT），统一前置拦截并打 ASCII 标记
+            // [dsh-missing]，前端据此精准提示「dsh 未加入 PATH」而不是笼统的插件失败。
             if (invocation.file === 'dsh' && !dshOnPath(env)) {
                 const detail = '[dsh-missing] the dsh CLI was not found on this machine (DeepSeek Harness not installed, or dsh not on the PATH)';
                 if (task) {
@@ -494,12 +526,9 @@ function spawnMutation(options) {
     });
     return (async () => {
         let result = await spawnOnce(args);
-        // 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` 重试一次：
-        // 跳过 peer 自动解析即可绕过该 bug（peer 通常由同装的 @deepseek-ai/dsh 依赖树天然提供）。
-        // 二次尝试仍失败则保留其错误信息，不掩盖真正的原因。
+        // npm 11 的 arborist peer-set bug（`Cannot read properties of null (reading 'children')`）
+        // 会让 `npm install -g` 在解析阶段直接崩溃。首次失败后自动带 `--legacy-peer-deps` 重试一次：
+        // 跳过 peer 自动解析即可绕过该 bug；二次尝试仍失败则保留其错误信息，不掩盖真正的原因。
         if (isGlobalNpm && result.exitCode !== 0 && !result.timedOut && task?.status !== 'cancelled') {
             const retryArgs = ['install', '-g', '--legacy-peer-deps', ...(globalNpm ?? [])];
             const retryExecuted = `npm install -g --legacy-peer-deps ${(globalNpm ?? []).join(' ')}`;
@@ -562,10 +591,12 @@ function spawnMutation(options) {
     })();
 }
 /**
- * 安装后校验已装包的入口文件（package.json 的 main / exports["."].default）是否真实存在。
- * git: 分发常不提交构建产物（lib/ 等），pnpm 装完没有报错，但宿主重启加载插件树时会
- * ERR_MODULE_NOT_FOUND 直接崩溃、网页打不开 —— 这里在登记「待重启」前就把这类残缺包拦下。
- * 返回 { name, missing }：name 为空表示无法定位目标包（跳过校验）；missing 为缺失的入口路径。
+ * 安装后校验已装包里 package.json 声明的文件（main / exports["."].default 与
+ * dsh.bundle.patch）是否真实存在。git: 分发常不提交构建产物（lib/ 等），pnpm 装完没有
+ * 报错，但宿主重启加载插件树时会 ERR_MODULE_NOT_FOUND 直接崩溃、网页打不开 —— 这里在
+ * 登记「待重启」前就把这类残缺包拦下。没有声明过的文件不在这里追究：没声明入口的
+ * bundle 包（只挂技能）本来就不需要入口，宿主读的是它的 package.json 与声明的补丁。
+ * 返回 { name, missing }：name 为空表示无法定位目标包（跳过校验）；missing 为缺失文件的路径。
  */
 export function verifyInstalledEntry(profile, target) {
     let profilePkg = null;
@@ -584,20 +615,33 @@ export function verifyInstalledEntry(profile, target) {
     if (!name)
         return { name: null, missing: null };
     const pkgDir = join(profileDirectory(profile), 'node_modules', name);
-    let entry = null;
+    let required = [];
     try {
         const meta = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf8'));
-        entry = resolvePackageEntry(meta);
+        // 补丁按本包名 mount 自己时入口也是必须的，所以先读已装包里的补丁（读不到就当没有）。
+        const patchTexts = resolveBundlePatchFiles(meta).flatMap((file) => {
+            try {
+                return [readFileSync(join(pkgDir, file), 'utf8')];
+            }
+            catch {
+                return [];
+            }
+        });
+        required = requiredDistributionFiles(meta, patchTexts);
     }
     catch {
         return { name, missing: null };
     }
-    try {
-        return { name, missing: statSync(join(pkgDir, entry)).isFile() ? null : entry };
-    }
-    catch {
-        return { name, missing: entry };
+    for (const file of required) {
+        try {
+            if (!statSync(join(pkgDir, file)).isFile())
+                return { name, missing: file };
+        }
+        catch {
+            return { name, missing: file };
+        }
     }
+    return { name, missing: null };
 }
 /** 从 pnpm `Ignored build scripts:` 提示行解析被拦截的构建脚本 key（name@version，逗号分隔）。 */
 function ignoredBuildKeys(output) {
@@ -611,7 +655,7 @@ function ignoredBuildKeys(output) {
 }
 /** npm arborist edgesOut 崩溃 + 本机 npm 版本过低 → 把 [npm-too-low] 标记追加到任务输出，
  *  前端据此展示「本机 npm 版本过低」的准确原因 —— 避免该报错被外层 ERR_PNPM_PREPARE_PACKAGE
- *  误判成插件打包/分发问题、误导用户提 Issue。检测逻辑在独立的 npm-check.ts（本机 npm 环境职责）。 */
+ *  误判成插件打包/分发问题。检测逻辑在独立的 npm-check.ts（本机 npm 环境职责）。 */
 function annotateNpmTooLow(result, options) {
     if (options.action === 'remove' || result.exitCode === 0 || result.timedOut)
         return result;
@@ -673,21 +717,21 @@ export async function runPluginMutation(options) {
             }
         }
     }
-    // pnpm 安装本身成功，但目标包入口文件缺失（git 分发缺构建产物）→ 判为失败：
+    // pnpm 安装本身成功，但目标包声明分发的文件缺失（git 分发缺构建产物 / 缺声明的补丁）→ 判为失败：
     // 撤销刚登记的待重启，避免用户重启时宿主加载残缺包直接崩溃。
     // 全局 npm 安装不进 profile（profile deps 里没有这些包），跳过入口校验
     if (options.action !== 'remove' && result.exitCode === 0 && !result.timedOut && (options.globalNpm ?? []).length === 0) {
         const verified = verifyInstalledEntry(options.profile, options.target);
         if (verified.name !== null && verified.missing !== null) {
             clearPendingRestart(options.displayTarget ?? options.target);
-            const detail = `[packaging] ${verified.name}: entry file missing: ${verified.missing} (git distribution lacks build output — install the npm version or report to the author)`;
+            const detail = `[packaging] ${verified.name}: declared file missing: ${verified.missing} (git distribution lacks build output — install the npm version or report to the author)`;
             if (options.task && options.task.status !== 'cancelled') {
                 options.task.status = 'failed';
                 options.task.exitCode = null;
                 options.task.progress = 0;
                 pushLine(options.task, detail);
             }
-            return { exitCode: 1, timedOut: false, error: `entry file missing: ${verified.missing}`, stdout: result.stdout, stderr: `${result.stderr}\n${detail}` };
+            return { exitCode: 1, timedOut: false, error: `declared file missing: ${verified.missing}`, stdout: result.stdout, stderr: `${result.stderr}\n${detail}` };
         }
     }
     // npm arborist edgesOut 崩溃 + 本机 npm 版本过低 → 追加 [npm-too-low] 标记，前端据此给准确原因

package/lib/services/probe.js

@@ -140,7 +140,7 @@ function runCurl(args, env, timeoutMs) {
  *  若本机 curl 不认这个参数（curl < 7.70）则去掉参数重跑一次，保证老版本不因此直接失败；
  *  降级后仍被吊销检查拦死（CRYPT_E_NO_REVOCATION_CHECK）时，再用 --ssl-no-revoke
  *  彻底关掉吊销检查跑一次 —— 该参数 curl ≥ 7.19 即存在，覆盖面比降级参数更广，
- *  否则「能上网但取不到 CRL」的 Windows 机器会把所有通道误报成不可达（见 issue #71）。
+ *  否则「能上网但取不到 CRL」的 Windows 机器会把所有通道误报成不可达。
  *  吊销检查只影响本次探测自身的信任判断，不改变系统 TLS 配置。 */
 async function curlWithTlsFallback(args, env, timeoutMs) {
     const tlsArgs = curlTlsArgs();

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

@@ -0,0 +1,10 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function profileDirectory(profile: string): string;
+/** Read non-official dependencies installed into one profile. */
+export declare function readInstalled(profile: string): Record<string, string>;
+/** 读已装依赖实际落在磁盘上的仓库身份（`owner/repo`）：解析 node_modules/<name>/package.json
+ *  的 repository 字段。已装 spec 可能是纯版本号（丢了仓库身份），但真实包元数据仍指向来源仓库，
+ *  据此可区分「同名依赖其实是同一仓库的残留（应转 update）」还是「跨仓库包名冲突（应报错）」。
+ *  读不到 / 解析不出返回 null（交给调用方按冲突处理）。 */
+export declare function installedRepoOf(profile: string, name: string): string | null;
+export declare function registerCatalogRoutes(webServer: WebServerService, profile: string): WebRoute[];

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

@@ -0,0 +1,4 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+/** 宿主环境快照：提交 bug 时随 issue 附上，便于作者复现（前端 /env 端点返回）。 */
+export declare function hostEnv(profile: string): Record<string, string | null>;
+export declare function registerDiagnosticsRoutes(webServer: WebServerService, profile: string): WebRoute[];

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

@@ -0,0 +1,11 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Install/uninstall routes: validate the target and spawn the official dsh CLI
+ * (see services/install/install.ts), reporting the captured result back.
+ */
+import { type LoaderHandle } from '../services/install/install.ts';
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerInstallRoutes(webServer: WebServerService, profile: string, loader: LoaderHandle | undefined): WebRoute[];

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

@@ -0,0 +1,2 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerLogsRoutes(webServer: WebServerService, profile: string): WebRoute[];

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

@@ -1,24 +1,15 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { readProfileArg, type LoaderHandle } from '../services/install/install.ts';
 /**
- * 宿主是否由桌面应用壳托管（`ELECTRON_RUN_AS_NODE=1`：壳用 Electron 二进制以 Node 模式跑宿主）。
- * 桌面端的宿主归应用壳管，插件重启不了它，也不该去 kill —— 详见 /restart 路由。
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Local HTTP routes exposing real installs to the in-app Plugin Hub UI.
+ * The client fetches the same-origin `/dsh-plugin-hub/*` endpoints; the
+ * install handler validates the target, then spawns the official dsh CLI
+ * (see services/install/install.ts) and reports the captured result back.
  */
-export declare function isDesktopHost(): boolean;
-export interface WebRoute {
-    kind: 'exact';
-    path: string;
-    handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
-}
-/** The subset of the host web-server service this plugin touches. */
-export interface WebServerService {
-    register(route: WebRoute): () => void;
-}
-/** 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;
+import { type LoaderHandle } from '../services/install/install.ts';
+import { type WebServerService } from './shared.ts';
 /**
  * Register the Plugin Hub API on the host web server and return a disposer.
  * @param webServer - DSH web server service.
@@ -28,4 +19,8 @@ export declare function isSameOrigin(request: IncomingMessage): boolean;
  */
 export declare function mountPluginHubRoutes(webServer: WebServerService, profile: string, loader?: LoaderHandle): () => void;
 /** Profile resolution shared with the client route docs. */
-export { readProfileArg };
+export { readProfileArg } from '../services/install/install.ts';
+/** Re-exported so the host entry (index.ts) keeps importing it from this module. */
+export type { WebServerService } from './shared.ts';
+/** Re-exported so tests/routes.test.ts keeps importing these from this module. */
+export { isDesktopHost, isSameOrigin } from './shared.ts';

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

@@ -0,0 +1,2 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerSettingsRoutes(webServer: WebServerService, profile: string): WebRoute[];

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

@@ -0,0 +1,44 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Shared HTTP utilities: route/service types, request validation helpers and
+ * the same-origin check guarding every POST mutation. Imported by the other
+ * route modules in this directory.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * 跨平台宿主重启脚本（以 `node -e` 运行，独立于宿主进程）。
+ * 不用 `/bin/sh -c`：Windows 无 /bin/sh，且 lsof/nohup 仅 POSIX 存在。
+ * 由 `spawn(process.execPath, ['-e', SCRIPT, port], { detached, stdio:'ignore' })` 孵化，
+ * 宿主进程被 kill 后仍能完成「停旧 → 等端口释放 → 拉起新 dsh web」。
+ * 端口探测不到监听进程时不再假装重启（记一行日志后退出，见脚本内注释）。
+ */
+export declare const HOST_RESTART_SCRIPT: string;
+/**
+ * 宿主是否由桌面应用壳托管（`ELECTRON_RUN_AS_NODE=1`：壳用 Electron 二进制以 Node 模式跑宿主）。
+ * 桌面端的宿主归应用壳管，插件重启不了它，也不该去 kill —— 详见 /restart 路由。
+ */
+export declare function isDesktopHost(): boolean;
+export interface WebRoute {
+    kind: 'exact';
+    path: string;
+    handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
+}
+/** The subset of the host web-server service this plugin touches. */
+export interface WebServerService {
+    register(route: WebRoute): () => void;
+}
+export declare const PROFILE_RE: RegExp;
+export declare const COMMAND_TIMEOUT_MS: number;
+/** 目录/统计数据代理的本地缓存时长：1 小时内重复打开插件市场直接读盘，
+ *  不重复走 curl 拉远程 —— 重启宿主后首次打开同样秒开（缓存跨重启存活）。 */
+export declare const CATALOG_CACHE_TTL_MS: number;
+export declare function sendJson(response: ServerResponse, status: number, value: unknown): void;
+/** 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;
+export declare function requireMethod(request: IncomingMessage, response: ServerResponse, method: 'GET' | 'POST'): boolean;
+export declare function requireTrustedPost(request: IncomingMessage, response: ServerResponse): boolean;
+export declare function readJsonBody(request: IncomingMessage): Promise<unknown>;

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

@@ -0,0 +1,3 @@
+import { type LoaderHandle } from '../services/install/install.ts';
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerTaskRoutes(webServer: WebServerService, profile: string, loader: LoaderHandle | undefined): WebRoute[];

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

@@ -18,5 +18,5 @@ export type { InstallResult, InstallTask, Invocation, PendingRestart, QueueItem
 export type { LoaderHandle } from '../loader.ts';
 export { addPendingRestart, clearPendingRestart, listPendingRestarts } from '../profile/pending-restart.ts';
 export { dumpLoaderEntries, removeLoadedEntry } from '../loader.ts';
-export { addAllowBuildsKey, githubRefOf, githubRepoOf, githubTarget, globalNpmPackagesOf, installTargetOf, parseAllowBuildsKey, readProfileArg, validPackageName } from '../profile/profile.ts';
+export { addAllowBuildsKey, githubRefOf, githubRepoOf, githubTarget, globalNpmPackagesOf, installTargetOf, parseAllowBuildsKey, readProfileArg, validPackageName, } from '../profile/profile.ts';
 export { activeTask, cancelTask, getTask, hasQueuedTarget, hasRunningTask, runPluginMutation, startPluginMutation } from './task-queue.ts';

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

@@ -1,21 +1,53 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * 包入口解析：从 package.json 的 exports["."] / main 推出用于校验的入口文件。
- * git 通道（tar 预检）与 npm 通道（装后 statSync 校验）共用，保证两条通道
- * 对同一个包判定一致。
+ * 分发文件解析：从 package.json 推出装完后必须真实存在的文件 —— 作者声明的入口
+ * （exports["."] / main）与 bundle 声明的补丁（dsh.bundle.patch）。git 通道（tar 预检）
+ * 与 npm 通道（装后 statSync 校验）共用，保证两条通道对同一个包判定一致。
+ *
+ * 这里不替作者补一个 index.js：宿主加载一个 bundle 读的是它的 package.json 和它声明的
+ * 补丁文件（官方 bundleManifest 的注释即「Read bundle metadata without loading its
+ * JavaScript」），从不 import 包本身。凭空要求一个作者没声明的入口，只会把完整的
+ * 技能包判成分发残缺，并把一条假缺陷推到作者仓库（见 QingYunA/answer-me-with-html#209）。
+ *
+ * 例外是补丁自己 mount 了本包：dsh 的《打包与安装插件》里组合包的常规写法就是
+ * `- insert: - name: <本包名>`，宿主随后按包名 import 本包，入口那时必须存在。
+ * 所以只有补丁真的写了自己的包名，才把这个入口算进分发要求。
  */
+/** 解析所需的 manifest 字段；其余字段不读。 */
+export interface PackageManifest {
+    name?: unknown;
+    main?: unknown;
+    exports?: unknown;
+    dsh?: unknown;
+}
 /**
- * 解析包的入口文件（相对包根，不带 `./` 前缀）。
+ * 解析作者声明的入口文件（相对包根，不带 `./` 前缀）。manifest 未声明入口时返回 null：
+ * 没有声明就没有可缺失的入口，是否可 import 交给真实安装与宿主加载去暴露。
  *
  * Node 的 exports 规范要求字符串 target 以 `./` 开头（如 `"./lib/index.js"`），
  * 而 tar 成员名与磁盘路径都不带该前缀，因此统一剥掉；条件对象
  * （`{ "import": ..., "require": ... }`）按 default → import → require 取第一
- * 个字符串值。无 exports 时回退 main，再回退 index.js。
+ * 个字符串值。无 exports 时回退 main；两者都没有则没有入口。
  */
-export declare function resolvePackageEntry(meta: {
-    main?: unknown;
-    exports?: unknown;
-}): string;
+export declare function resolvePackageEntry(meta: PackageManifest): string | null;
+/**
+ * 解析 `dsh.bundle.patch` 声明的补丁文件（相对包根，不带 `./` 前缀）。
+ * 形状不合规范（既不是字符串也不是字符串数组）在这里不判定：那是 dsh 启动时
+ * bundlePatchFiles 的报错职责，预检只负责「声明了就要在包里存在」。
+ */
+export declare function resolveBundlePatchFiles(meta: PackageManifest): string[];
+/** 分发里必须存在的全部文件：作者声明的入口，加上 bundle 声明的补丁，入口在前。
+ *  manifest 没声明入口时才看补丁：补丁按本包名 mount 自己（下面 mountsItself），
+ *  宿主就会 import 本包，Node 的旧式解析落到 index.js —— 那个入口同样必须有。 */
+export declare function requiredDistributionFiles(meta: PackageManifest, patchTexts?: string[]): string[];
+/**
+ * 补丁文本里插件行的 `name:` 值（DSH 补丁按行书写：`- name: <pkg>` / `  name: <pkg>`）。
+ * 刻意不做 YAML 解析：只认这一种行形状，认不出来就不判定 —— 漏判只是少一条要求，
+ * 误判会拦下能装的包，两边的代价不对称。
+ */
+export declare function patchRowNamesOf(text: string): string[];
+/** 补丁是否把本包自己 mount 进树（dsh 文档里组合包的常规写法），是则宿主会 import 本包。 */
+export declare function mountsItself(meta: PackageManifest, patchTexts: string[]): boolean;

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

@@ -1,4 +1,5 @@
-/** 预检结果：ok=false 表示分发改入口文件缺失，missing 为该文件在包内的相对路径；
+/** 预检结果：ok=false 表示分发改 package.json 声明的文件（入口或 bundle 补丁），
+ *  missing 为该文件在包内的相对路径；
  *  name 为 git 分发包 package.json 声明的包名（非 git 目标/无法确定时为 null），
  *  供安装路由做「包名冲突」检测 —— 同名包名已被其他来源占用时，pnpm 装前必然撞车，
  *  需要把晦涩的 CLI 报错转成明确的拦截。 */
@@ -13,3 +14,10 @@ export declare function preflightTarget(target: string): Promise<PreflightResult
  * single archive root; nested monorepo package manifests are intentionally
  * ignored. Exported for a small parser regression test. */
 export declare function rootPackageEntryOfTarList(listing: string): string | null;
+/**
+ * 清单里第一个缺失的必需文件（成员名带包根前缀，由调用方拼好），全部都在则为 null。
+ * 清单不可读（tar 缺失/解压失败）时按第一个必需文件缺失处理：与逐文件查询时
+ * 「查不到就是缺」的判定一致，宁可拦下一次可疑安装，也不放一个空包过去。
+ * Exported for a small parser regression test.
+ */
+export declare function missingDistributionFileOfTarList(listing: string | null, required: string[]): string | null;

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

@@ -67,10 +67,12 @@ export declare function startPluginMutation(options: {
     installChannel?: 'npm' | 'git' | 'dsh';
 }): InstallTask;
 /**
- * 安装后校验已装包的入口文件（package.json 的 main / exports["."].default）是否真实存在。
- * git: 分发常不提交构建产物（lib/ 等），pnpm 装完没有报错，但宿主重启加载插件树时会
- * ERR_MODULE_NOT_FOUND 直接崩溃、网页打不开 —— 这里在登记「待重启」前就把这类残缺包拦下。
- * 返回 { name, missing }：name 为空表示无法定位目标包（跳过校验）；missing 为缺失的入口路径。
+ * 安装后校验已装包里 package.json 声明的文件（main / exports["."].default 与
+ * dsh.bundle.patch）是否真实存在。git: 分发常不提交构建产物（lib/ 等），pnpm 装完没有
+ * 报错，但宿主重启加载插件树时会 ERR_MODULE_NOT_FOUND 直接崩溃、网页打不开 —— 这里在
+ * 登记「待重启」前就把这类残缺包拦下。没有声明过的文件不在这里追究：没声明入口的
+ * bundle 包（只挂技能）本来就不需要入口，宿主读的是它的 package.json 与声明的补丁。
+ * 返回 { name, missing }：name 为空表示无法定位目标包（跳过校验）；missing 为缺失文件的路径。
  */
 export declare function verifyInstalledEntry(profile: string, target: string): {
     name: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.6.5",
+  "version": "1.6.7",
   "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

@@ -460,6 +460,9 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
             // 支持系统文件管理器定位的平台（macOS / Linux）上，行内「打开详情」替换为
             // 打开安装目录按钮（行点击本身即打开详情弹窗）；Windows 不支持则按钮不显示
             platform: env?.platform ?? '',
+            // 待重启列表（owner/repo）：用于区分「待重启」与「已重启仍加载失败」，
+            // 后者不再无限显示「重启」，改为「未激活」灰点
+            pendingRestarts: queue.pendingRestarts.map((p) => p.target),
             // 行点击 / 详情按钮：打开已安装详情弹窗（完整元数据 + 运行时信息）
             onOpenDetail: (item) => setDetailItem(item),
             onReveal: (item) => { void revealFolder(item) },

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

@@ -20,7 +20,7 @@ import type { EnvInfo, Translate } from '../../types.ts'
 import type { NotificationRecord } from '../../logic/failures.ts'
 import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
 import type { PendingRestart, QueueTask } from '../../hooks/useTaskQueue.ts'
-import { pluginIssueUrl, pluginSiteUrl } from '../../logic/urls.ts'
+import { pluginIssueUrl, pluginSiteUrl, hubIssueUrl } from '../../logic/urls.ts'
 import { CloseIcon } from '../ui/icons.tsx'
 import { ConfirmDialog } from './ConfirmDialog.tsx'
 
@@ -263,13 +263,13 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         t(v ? 'failNpmTooLowV' : 'failNpmTooLow', v ? { v } : undefined))
                     }
                     if (kind === 'dshMissing') {
-                      // 找不到 dsh 命令（Win「不是内部或外部命令」/ POSIX「command not found」/ spawn ENOENT）：
-                      // 本机 DeepSeek Harness 未正确安装或 dsh 不在 PATH，不是插件问题 —— 直接给环境修复指引，不引导提 Issue
+                      // 找不到 dsh 命令：本机 DeepSeek Harness 未正确安装或 dsh 不在 PATH，
+                      // 不是插件问题 —— 直接给环境修复指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failDshMissingHint'))
                     }
                     if (kind === 'gitMissing') {
-                      // 找不到 git 命令（Win「'git' is not recognized」/ POSIX「git: command not found」/ spawn ENOENT）：
-                      // 本机 Git 未安装或不在 PATH，不是插件问题 —— 直接给环境修复指引，不引导提 Issue
+                      // 找不到 git 命令：本机 Git 未安装或不在 PATH，不是插件问题 ——
+                      // 直接给环境修复指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failGitMissingHint'))
                     }
                     if (kind === 'pnpmMissing') {
@@ -314,13 +314,25 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         h('div', { className: styles.failPrepareHint }, t('failPnpmMissingDepHint')),
                       ])
                     }
+                    if (kind === 'registryVersionStale') {
+                      // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
+                      // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源；
+                      // 也可能只是版本号写错。与插件作者无关 —— 给对齐源 / 显式走官方源 / 离线包指引，不引导提 Issue
+                      return h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
+                    }
+                    if (kind === 'pnpmLinkedDirMissing') {
+                      // profile 里留着指向不存在目录的本地依赖（ERR_PNPM_LINKED_PKG_DIR_NOT_FOUND）：
+                      // 常见于 link:/本地路径装过开发中的插件、之后目录被删；与本次要装的插件无关
+                      // —— 给删除悬空条目的指引，不引导提 Issue
+                      return h('div', { className: styles.failPrepareHint }, t('failPnpmLinkedDirMissingHint'))
+                    }
                     if (kind === 'fileLocked') {
                       // profile 里的文件被其他进程占用（Windows os error 32）：通常是宿主或杀毒软件
                       // 持有句柄 —— 给出完全退出宿主的指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failFileLockedHint'))
                     }
                     if (kind === 'accessDenied') {
-                      // profile 里的文件被系统拒绝写入（Windows os error 5「拒绝访问」/ EPERM / EACCES）：
+                      // profile 里的文件被系统拒绝写入（os error 5 / EPERM / EACCES）：
                       // 占用、只读属性、目录 ACL 或杀软拦截 —— 给退出宿主 + 检查权限的指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failAccessDeniedHint'))
                     }
@@ -351,13 +363,11 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         }, t('failNetworkRunDiag')) : null,
                       ])
                     }
-                    if (kind === 'pluginPrepare' || kind === 'pnpmIgnoredBuild') {
+                    if (kind === 'pluginPrepare') {
                       // [packaging]（预检/装后校验拦截：git 分发缺产物）与
-                      // prepare 构建脚本实际执行失败 / 原生依赖构建被 pnpm 拦截：都是插件打包分发问题 —— 先说明原因，按钮在下方提交
+                      // prepare 构建脚本实际执行失败：唯一确有证据的插件打包分发问题 —— 引导到插件仓库提 Issue
                       return h('div', null, [
-                        h('div', { className: styles.failPrepareHint }, kind === 'pnpmIgnoredBuild'
-                          ? t('failIgnoredBuild')
-                          : /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
+                        h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
                         r.repo && shownRepo ? h('a', {
                           className: styles.failBigIssue,
                           href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
@@ -367,13 +377,19 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         }, t('failIssueBig')) : null,
                       ])
                     }
-                    return r.repo && shownRepo ? h('a', {
-                      className: styles.failBigIssue,
-                      href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
-                      target: '_blank',
-                      rel: 'noopener noreferrer',
-                      title: t('failIssueHint'),
-                    }, t('failIssueBig')) : null
+                    // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
+                    return h('div', null, [
+                      kind === 'pnpmIgnoredBuild'
+                        ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
+                        : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint')),
+                      h('a', {
+                        className: styles.failBigIssue,
+                        href: hubIssueUrl(shownRepo || r.repo, r.message, env, r.command, r.attempts),
+                        target: '_blank',
+                        rel: 'noopener noreferrer',
+                        title: t('failHubIssueHint'),
+                      }, t('failHubIssueBig')),
+                    ])
                   })(),
                 ),
               ),