dsh-plugin 1.6.1 → 1.6.3

package/lib/http/routes.js

@@ -26,6 +26,7 @@ import { appendLog, clearLog, readLog, logFilePath, defaultLogFilePath, customLo
  * 不用 `/bin/sh -c`：Windows 无 /bin/sh，且 lsof/nohup 仅 POSIX 存在。
  * 由 `spawn(process.execPath, ['-e', SCRIPT, port], { detached, stdio:'ignore' })` 孵化，
  * 宿主进程被 kill 后仍能完成「停旧 → 等端口释放 → 拉起新 dsh web」。
+ * 端口探测不到监听进程时不再假装重启（记一行日志后退出，见脚本内注释）。
  */
 const HOST_RESTART_SCRIPT = String.raw `const C = require('node:child_process')
 const F = require('node:fs')
@@ -52,7 +53,16 @@ function findPids() {
   return String(out.stdout || '').split(/\s+/).filter(Boolean)
 }
 
-for (const pid of findPids()) {
+const targets = findPids()
+// 一个监听进程都没找到 = 端口探测本身就失败了（netstat 输出格式 / 本地化差异），
+// 旧宿主仍占着端口。此时再拉一个 dsh web 只会在日志里以 EADDRINUSE 静默退出，
+// 用户却看到「重启完成」——不制造这种假象，留一行可诊断的记录后退出。
+if (targets.length === 0) {
+  logLine('restart aborted: no listener found on port ' + port)
+  process.exit(0)
+}
+
+for (const pid of targets) {
   try {
     if (win) C.spawnSync('taskkill', ['/pid', pid, '/t', '/f'])
     else process.kill(Number(pid), 'SIGTERM')
@@ -65,6 +75,14 @@ let tries = 0
   setTimeout(waitForStop, 250)
 })()
 
+function logLine(msg) {
+  try {
+    const dir = P.join(O.homedir(), '.dsh', 'logs')
+    F.mkdirSync(dir, { recursive: true })
+    F.appendFileSync(P.join(dir, 'dsh-web-' + port + '.log'), '[' + new Date().toISOString() + '] ' + msg + '\n')
+  } catch {}
+}
+
 function startHost() {
   const dir = P.join(O.homedir(), '.dsh', 'logs')
   F.mkdirSync(dir, { recursive: true })
@@ -76,6 +94,13 @@ function startHost() {
   })
   child.unref()
 }`;
+/**
+ * 宿主是否由桌面应用壳托管（`ELECTRON_RUN_AS_NODE=1`：壳用 Electron 二进制以 Node 模式跑宿主）。
+ * 桌面端的宿主归应用壳管，插件重启不了它，也不该去 kill —— 详见 /restart 路由。
+ */
+export function isDesktopHost() {
+    return process.env.ELECTRON_RUN_AS_NODE === '1';
+}
 const PROFILE_RE = /^[A-Za-z0-9_-]+$/;
 const BODY_LIMIT_BYTES = 4 * 1024;
 const COMMAND_TIMEOUT_MS = 5 * 60 * 1000;
@@ -1014,6 +1039,8 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                         env: mutationEnv(settings),
                         // 覆盖更新：npm 通道命令显式 @latest（pnpm add 无版本对已存在依赖是幂等的，不加版本不会真更新）
                         updateNpm: mode === 'update',
+                        // 运行中 loader：安装成功后把新插件热挂进 loader，非桌面端 + 纯服务端插件无需重启即生效
+                        loader,
                         // 自定义安装入口渠道（NPM 包 / GitHub 源码 / DSH 命令卡片）：日志/报错据此溯源
                         installChannel,
                     });
@@ -1060,7 +1087,7 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                         // 卸载的 mutation 目标是 npm 包名；待重启行要显示 owner/repo（与安装行一致），非法/缺失时回退包名
                         displayTarget: githubRepoOf(repo) ?? undefined,
                         // 运行中 loader：卸载成功后主动移除条目，立即生效、无需重启
-                        uninstallLoader: loader,
+                        loader,
                         timeoutMs: COMMAND_TIMEOUT_MS,
                         env: mutationEnv(loadSettings(profile)),
                     });
@@ -1133,6 +1160,15 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
             handler: (request, response) => {
                 if (!requireTrustedPost(request, response))
                     return;
+                // 桌面端：宿主由应用壳托管，插件重启不了它。Windows 上 `taskkill /T` 会把发起
+                // 重启的助手一起结束（助手是宿主的子进程），壳再把这次外部 kill 判成宿主崩溃
+                // 弹「应用无法启动或已意外停止」；退一步说，脱离壳拉起的 `dsh web` 也服务不了
+                // 桌面 UI（缺壳注入的 desktop:boot）。故不 kill、不拉新宿主，由客户端改提示
+                // 用户从菜单/托盘退出后重新打开。
+                if (isDesktopHost()) {
+                    sendJson(response, 200, { ok: false, desktop: true });
+                    return;
+                }
                 // 当前宿主监听端口来自请求 Host 头（localhost:7923），解析失败回退 7923
                 const host = request.headers.host ?? '';
                 const portMatch = host.match(/:(\d+)$/);

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

@@ -14,7 +14,7 @@ import { dirname, join, resolve } from 'node:path';
 import { CAPTURE_LIMIT_BYTES, MAX_TASKS, MAX_TASK_LINES } from './install-types.js';
 import { npmTooLowMarker } from './npm-check.js';
 import { cleanLine, estimateProgress } from '../profile/progress.js';
-import { removeLoadedEntry } from '../loader.js';
+import { hasClientUi, isDshPlugin, mountLoadedEntry, removeLoadedEntry } from '../loader.js';
 import { addPendingRestart, clearPendingRestart } from '../profile/pending-restart.js';
 import { addAllowBuildsKey, githubRepoOf, parseAllowBuildsKey, profileDirectory } from '../profile/profile.js';
 import { appendLog } from '../log.js';
@@ -230,7 +230,10 @@ function channelLabel(channel) {
  * Progress is visible through `getTask(id)` / `activeTask()` until done.
  */
 export function startPluginMutation(options) {
-    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, installChannel: options.installChannel };
+    // 卸载入队时先快照「该包是否带客户端 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 };
     nextTaskId = nextTaskId >= Number.MAX_SAFE_INTEGER ? 1 : nextTaskId + 1;
     tasks.set(task.id, task);
     if (tasks.size > MAX_TASKS) {
@@ -326,7 +329,7 @@ function pumpQueue() {
  * Never rejects; failures surface through the result / task state.
  */
 function spawnMutation(options) {
-    const { action, profile, target, timeoutMs = 5 * 60 * 1000, env, task, displayTarget, uninstallLoader, globalNpm, updateNpm } = options;
+    const { action, profile, target, timeoutMs = 5 * 60 * 1000, env, task, displayTarget, loader, globalNpm, updateNpm } = options;
     // 全局 npm 安装：直接 spawn 本机 npm（`npm install -g <pkgs>`），不是 dsh plugin 命令
     const isGlobalNpm = (globalNpm ?? []).length > 0;
     const invocation = isGlobalNpm
@@ -518,21 +521,35 @@ function spawnMutation(options) {
                         // 全局 npm 安装：装的是本机 CLI 工具（如 dsh-tui），不进任何 profile，无需宿主重启
                         task.needsRestart = false;
                     }
-                    else if (action === 'remove' && uninstallLoader) {
-                        // 卸载成功 → 主动从运行中 loader 停用该包条目；
-                        // 仅当宿主从未加载过它（磁盘已干净）才判「无需重启」；
-                        // 只要曾在 loader 中存活（停用过 live entry）就仍要求重启——
-                        // 带 UI 的插件（侧边栏面板等宿主启动时渲染的槽位）disable 后不会
-                        // 主动消失，重启才能立即摘除面板
-                        const removed = await removeLoadedEntry(uninstallLoader, target);
-                        task.needsRestart = !removed;
-                        if (removed)
-                            clearPendingRestart(displayTarget ?? target);
-                        else
+                    else if (action === 'remove' && loader) {
+                        // 卸载成功 → 主动从运行中 loader 停用该包条目：
+                        //  - 停用成功：服务端即时卸载；带客户端 UI 的插件面板要页面刷新才摘除（无需重启宿主）
+                        //  - 停用失败 / 超时：回退「待重启」兜底清理（刷新解决不了，登记常驻提醒）
+                        const removal = await removeLoadedEntry(loader, target);
+                        task.needsRestart = !removal.ok;
+                        task.needsReload = removal.ok && removal.live && task.hadClientUi === true;
+                        if (task.needsRestart)
                             addPendingRestart(displayTarget ?? target, 'uninstall');
+                        else
+                            clearPendingRestart(displayTarget ?? target);
+                    }
+                    else if (action !== 'remove' && !isUpdate && loader) {
+                        // 安装成功 → 尝试把新插件热挂进运行中 loader，让插件无需重启宿主即生效。
+                        // 挂上了：服务端即时生效；带客户端 UI 的插件还需页面重新加载（宿主按请求现场
+                        //   拼装 __DSH_BOOT__ 注入清单，网页端与桌面端一致，刷新即可）。
+                        // 挂不上 / 非 dsh 插件 / 无法定位包名：回退「待重启」提醒（保证不静默失效）。
+                        const { name } = verifyInstalledEntry(profile, target);
+                        if (name !== null && isDshPlugin(profile, name) && await mountLoadedEntry(loader, name)) {
+                            task.needsReload = hasClientUi(profile, name);
+                            task.needsRestart = false;
+                        }
+                        else {
+                            task.needsRestart = true;
+                            addPendingRestart(displayTarget ?? target, 'install');
+                        }
                     }
                     else {
-                        // 安装/更新成功（或卸载但无 loader 引用）→ 登记待重启：
+                        // 更新（ESM 缓存下热挂取不到新代码）/ 无 loader 的安装或卸载 → 登记待重启：
                         // 插件要宿主重启才会挂载/卸载干净，重启前一直提醒；展示目标用 displayTarget（owner/repo）
                         task.needsRestart = true;
                         addPendingRestart(displayTarget ?? target, action === 'remove' ? 'uninstall' : 'install');

package/lib/services/loader.js

@@ -3,8 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * 运行中 loader 的读取与停用：卸载成功后对匹配条目做 live-disable，
- * 使卸载立即生效（刷新页面不再加载已卸载的 client bundle，也无需重启）。
+ * 运行中 loader 的读取、停用与热挂载：卸载成功后对匹配条目做 live-disable、
+ * 安装成功后把新插件条目热挂进运行中的 loader，让两类操作都尽量立即生效
+ * （刷新页面即可，无需重启宿主）。
  */
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -77,15 +78,16 @@ function nameMatches(entryName, target) {
  * `loader.entries()`（含嵌套子树），对每个匹配条目
  * `entry.update({ disabled: true })` 做 live-disable —— fiber 被 dispose，
  * client-modules 对账后不再把它写进 `__DSH_BOOT__`，页面刷新即恢复。
- * 返回 true = 无需重启（仅当宿主从未加载过它：磁盘已干净）；
- * 其余一律 false = 需要重启：要么 disable 失败需「待重启清理」兜底，
- * 要么 disable 成功但该插件曾在 loader 中存活——带 UI 的插件（侧边栏面板等
- * 宿主启动时渲染的槽位）disable 后不会主动摘除，不重启面板一直残留。
+ * 返回 `{ ok, live }`：
+ *  - `{ ok: true, live: false }`：宿主从未加载过它（磁盘已干净），无需刷新/重启；
+ *  - `{ ok: true, live: true }`：曾在 loader 中存活且已 live-disable —— 服务端即时卸载；
+ *    带客户端 UI 的插件面板要页面刷新才摘除（由调用方按 `hadClientUi` 决定 needsReload）；
+ *  - `{ ok: false, live: true }`：disable 失败 / 超时，需宿主重启兜底清理。
  * 宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
  */
 export async function removeLoadedEntry(loader, name) {
     if (name === 'dsh-plugin' || name.startsWith('@deepseek-ai/'))
-        return false;
+        return { ok: false, live: true };
     // 5s 超时兜底：fiber dispose 卡住时不能让卸载任务（乃至整个队列）被拖死
     const removal = (async () => {
         const entries = dumpLoaderEntries(loader);
@@ -106,32 +108,77 @@ export async function removeLoadedEntry(loader, name) {
                 catch (error) {
                     console.log(`[hub-uninstall] disable ${name} attempt ${attempt + 1} failed: ${error instanceof Error ? error.message : String(error)}`);
                     if (attempt === 2)
-                        return false;
+                        return { ok: false, live: true };
                     await new Promise((resolvePromise) => setTimeout(resolvePromise, 200));
                 }
             }
         }
         if (!found) {
-            // 运行中 loader 无该条目：宿主从未加载过它（装完未重启），磁盘已干净，无需重启
+            // 运行中 loader 无该条目：宿主从未加载过它（装完未重启），磁盘已干净，无需刷新/重启
             console.log(`[hub-uninstall] no live entry for ${name}; nothing to disable`);
-            return true;
+            return { ok: true, live: false };
         }
         // 找到并停用了 live entry：逻辑层已卸载（刷新页面不再加载其 client bundle），
-        // 但带 UI 的插件（侧边栏面板等）是宿主启动时渲染的槽位，disable 不会主动摘除，
-        // 不重启面板会一直残留 → 返回「需要重启」，弹窗给出「立即重启」，面板立即消失
-        console.log(`[hub-uninstall] disabled live entry for ${name}; UI may persist until restart`);
-        return false;
+        // 带 UI 的插件面板由调用方按 hadClientUi 决定是否需要刷新摘除
+        console.log(`[hub-uninstall] disabled live entry for ${name}`);
+        return { ok: true, live: true };
     })();
     const result = await Promise.race([
         removal.catch((error) => {
             console.log(`[hub-uninstall] disable failed: ${error instanceof Error ? error.message : String(error)}`);
-            return false;
+            return { ok: false, live: true };
         }),
-        new Promise((resolve) => setTimeout(() => resolve(false), 5_000)),
+        new Promise((resolve) => setTimeout(() => resolve({ ok: false, live: true }), 5_000)),
     ]);
-    console.log(`[hub-uninstall] disable ${name} -> ${result ? 'ok/clean' : 'timed out or failed'}`);
+    console.log(`[hub-uninstall] disable ${name} -> ${result.ok ? (result.live ? 'disabled live entry' : 'nothing live') : 'timed out or failed'}`);
     return result;
 }
+/**
+ * 安装成功后把新插件热挂进运行中 loader（等价 profile bundle patch 的
+ * `- insert: - name: <pkg>` 行），让插件无需重启宿主即可生效。
+ * 做法：在 Loader 根组新建条目并启动 —— Loader.write() 为空实现，不写盘；
+ * 重启后由 profile 的 bundles 清单重新挂载，不会重复。
+ * `Entry._init` 的 import 失败只 `logger.error` 后 return（不抛），条目会建出来但
+ * fiber 为空 / 条目可能被标记 disabled —— 必须用 `loader.resolve(id)` 校验真的起来了。
+ * 返回 true = 已在运行中（本次新建或此前已加载）。
+ */
+export async function mountLoadedEntry(loader, name) {
+    if (isEntryLoaded(loader, name))
+        return true;
+    const mounting = (async () => {
+        const id = await loader.create({ name });
+        const entry = loader.resolve(id);
+        if (entry?.fiber !== undefined && entry?.fiber !== null && !entry.options?.disabled) {
+            console.log(`[hub-install] hot mounted ${name} (entry ${id})`);
+            return true;
+        }
+        console.log(`[hub-install] hot mount ${name}: entry ${id} created but not running (import failed?)`);
+        return false;
+    })();
+    // 10s 超时兜底：import 卡住时不能让装完收尾（乃至整个队列）被拖死
+    return Promise.race([
+        mounting.catch((error) => {
+            console.log(`[hub-install] hot mount ${name} failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }),
+        new Promise((resolve) => setTimeout(() => resolve(false), 10_000)),
+    ]);
+}
+/**
+ * 已安装包是否带客户端 UI（package.json 的 `dsh.client` 声明）：client-modules 据它把
+ * 客户端 bundle 注入宿主页面。带 UI 的插件热挂载后需要页面重新加载才会渲染，
+ * 网页端与桌面端一致 —— `__DSH_BOOT__` 注入清单由宿主服务端按请求现场拼装，
+ * 壳不缓存，所以桌面端刷新页面同样能拿到新清单，无需重开 App。
+ */
+export function hasClientUi(profile, name) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(profileDirectory(profile), 'node_modules', name, 'package.json'), 'utf8'));
+        return pkg.dsh?.client !== undefined && pkg.dsh?.client !== null;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * 判断某已安装包是否是真正的 dsh 插件（宿主会加载 / 值得提示「待重启」）：
  *  1) 包名已写进 profile 的 `dsh.profile.bundles`（宿主启动时按清单加载）；
@@ -143,10 +190,9 @@ export function isDshPlugin(profile, name) {
     // 1) profile 级 bundles 清单：包名在清单里 → 宿主启动会加载它
     try {
         const profilePkg = JSON.parse(readFileSync(join(profileDirectory(profile), 'package.json'), 'utf8'));
-        if (Array.isArray(profilePkg.dsh?.profile?.bundles)) {
-            if (profilePkg.dsh.profile.bundles.includes(name))
-                return true;
-        }
+        const bundles = profilePkg.dsh?.profile?.bundles;
+        if (Array.isArray(bundles) && bundles.includes(name))
+            return true;
     }
     catch { /* profile 读取失败按无 bundles 处理 */ }
     // 2) 包内声明：dsh 字段（bundle patch / profile 配置）或 dsh 关键字

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

@@ -1,5 +1,10 @@
 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 路由。
+ */
+export declare function isDesktopHost(): boolean;
 export interface WebRoute {
     kind: 'exact';
     path: string;

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

@@ -37,8 +37,15 @@ export interface InstallTask {
     progress: number;
     /** Newest output lines first (consumer shows the tail). */
     lines: string[];
-    /** 完成后是否仍需宿主重启才生效：卸载时 loader 已即时移除 → false；否则 true（弹窗据此给重启选项） */
+    /** 完成后是否仍需宿主重启才生效：仅「热挂载失败 / 非 dsh 插件 / 更新（ESM 缓存取不到新代码）/
+     *  无 loader」等刷新解决不了的兜底场景为 true（弹窗给「立即重启」）；其余一律 false。 */
     needsRestart: boolean;
+    /** 完成后是否只需刷新页面即生效（插件已热挂进运行中 loader，仅剩客户端 UI 待页面重新加载，
+     *  网页端与桌面端一致）：true 时关闭结果弹窗即自动刷新页面，不给手动刷新按钮。 */
+    needsReload?: boolean;
+    /** 卸载入队时该包是否带客户端 UI（`dsh.client`）：卸载后包已从磁盘删除，只能入队前快照，
+     *  卸载成功且曾存活时据此决定是否需要刷新页面摘除插件面板。 */
+    hadClientUi?: boolean;
 }
 /** 子进程启动参数（复用宿主 dsh 入口，或回退到 PATH 上的 `dsh`）。 */
 export interface Invocation {

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

@@ -55,8 +55,9 @@ export declare function startPluginMutation(options: {
     globalNpm?: string[];
     /** 待重启行的展示目标（owner/repo）：卸载时用于把 npm 包名映射回仓库名 */
     displayTarget?: string;
-    /** 运行中 loader：卸载成功后主动移除条目、立即生效（缺失时卸载仍需重启清理） */
-    uninstallLoader?: LoaderHandle;
+    /** 运行中 loader：安装成功后热挂新条目、卸载成功后停用旧条目，两类操作都尽量立即生效
+     *  （缺失时安装/卸载仍需重启） */
+    loader?: LoaderHandle;
     /** 入队前已尝试的安装方式（npm registry 反查等）：失败提 Issue 时如实展示；实际执行的命令由 spawn 时追加 */
     attempts?: string[];
     /** 更新已安装的 npm 包（mode=update）：命令显式带 @latest，让 pnpm 真正解析最新版本 */
@@ -93,8 +94,8 @@ export declare function runPluginMutation(options: {
     task?: InstallTask;
     /** 待重启行的展示目标（owner/repo）：卸载时用于把 npm 包名映射回仓库名 */
     displayTarget?: string;
-    /** 运行中 loader：卸载成功后主动移除条目、立即生效（缺失时卸载仍需重启清理） */
-    uninstallLoader?: LoaderHandle;
+    /** 运行中 loader：安装成功后热挂新条目、卸载成功后停用旧条目（缺失时仍需重启） */
+    loader?: LoaderHandle;
     /** 全局 npm 安装（官方 `npm install -g <pkgs>`）：非空时执行全局安装，不进任何 profile、无需宿主重启 */
     globalNpm?: string[];
 }): Promise<InstallResult>;

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

@@ -1,6 +1,6 @@
 /**
- * 运行中 loader 的最小接口：卸载成功后即时移除条目用。
- * 对应官方 `ctx.loader`（cordis-plugin-loader 的 Loader 服务）的读取面与移除面。
+ * 运行中 loader 的最小接口：卸载即时停用 / 安装即时热挂载用。
+ * 对应官方 `ctx.loader`（cordis-plugin-loader 的 Loader 服务）的读取、新建与移除面。
  * 移除方式：对匹配条目 live-disable（`entry.update({ disabled: true })`），
  * 而不是 `loader.remove(id)` —— disable 走 Entry.update 的 disabled 分支，不触发
  * tree.write()（不会把运行态条目烘焙回 cordis.yml），也不依赖嵌套子树的 id 解析。
@@ -21,6 +21,23 @@ export interface LoaderHandle {
     }>;
     /** 停止并移除一个条目（官方 Loader API：resolve → EntryGroup.remove → tree.write）。 */
     remove(id: string): Promise<void>;
+    /** 在运行中 loader 里新建一个条目并启动它。等价于 profile bundle patch 的
+     *  `- insert: - name: <pkg>` 行；Loader.write() 为空实现，不会写盘（重启后由
+     *  profile 的 bundles 清单重新挂载，不会重复挂载）。返回新条目的 id。 */
+    create(options: {
+        id?: string;
+        name: string;
+    }): Promise<string>;
+    /** 按 id 解析条目：热挂载后确认 fiber 真的起来了（import 失败时条目在、但 fiber 为空）。 */
+    resolve(id: string): {
+        id: string;
+        options?: {
+            name?: string;
+            disabled?: boolean | null;
+        };
+        fiber?: unknown;
+        subgroup?: unknown;
+    };
 }
 /** 运行中 loader 的全部条目（id + options.name），诊断用。 */
 export declare function dumpLoaderEntries(loader: LoaderHandle | undefined): Array<{
@@ -38,13 +55,34 @@ export declare function isEntryLoaded(loader: LoaderHandle | undefined, name: st
  * `loader.entries()`（含嵌套子树），对每个匹配条目
  * `entry.update({ disabled: true })` 做 live-disable —— fiber 被 dispose，
  * client-modules 对账后不再把它写进 `__DSH_BOOT__`，页面刷新即恢复。
- * 返回 true = 无需重启（仅当宿主从未加载过它：磁盘已干净）；
- * 其余一律 false = 需要重启：要么 disable 失败需「待重启清理」兜底，
- * 要么 disable 成功但该插件曾在 loader 中存活——带 UI 的插件（侧边栏面板等
- * 宿主启动时渲染的槽位）disable 后不会主动摘除，不重启面板一直残留。
+ * 返回 `{ ok, live }`：
+ *  - `{ ok: true, live: false }`：宿主从未加载过它（磁盘已干净），无需刷新/重启；
+ *  - `{ ok: true, live: true }`：曾在 loader 中存活且已 live-disable —— 服务端即时卸载；
+ *    带客户端 UI 的插件面板要页面刷新才摘除（由调用方按 `hadClientUi` 决定 needsReload）；
+ *  - `{ ok: false, live: true }`：disable 失败 / 超时，需宿主重启兜底清理。
  * 宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
  */
-export declare function removeLoadedEntry(loader: LoaderHandle, name: string): Promise<boolean>;
+export declare function removeLoadedEntry(loader: LoaderHandle, name: string): Promise<{
+    ok: boolean;
+    live: boolean;
+}>;
+/**
+ * 安装成功后把新插件热挂进运行中 loader（等价 profile bundle patch 的
+ * `- insert: - name: <pkg>` 行），让插件无需重启宿主即可生效。
+ * 做法：在 Loader 根组新建条目并启动 —— Loader.write() 为空实现，不写盘；
+ * 重启后由 profile 的 bundles 清单重新挂载，不会重复。
+ * `Entry._init` 的 import 失败只 `logger.error` 后 return（不抛），条目会建出来但
+ * fiber 为空 / 条目可能被标记 disabled —— 必须用 `loader.resolve(id)` 校验真的起来了。
+ * 返回 true = 已在运行中（本次新建或此前已加载）。
+ */
+export declare function mountLoadedEntry(loader: LoaderHandle, name: string): Promise<boolean>;
+/**
+ * 已安装包是否带客户端 UI（package.json 的 `dsh.client` 声明）：client-modules 据它把
+ * 客户端 bundle 注入宿主页面。带 UI 的插件热挂载后需要页面重新加载才会渲染，
+ * 网页端与桌面端一致 —— `__DSH_BOOT__` 注入清单由宿主服务端按请求现场拼装，
+ * 壳不缓存，所以桌面端刷新页面同样能拿到新清单，无需重开 App。
+ */
+export declare function hasClientUi(profile: string, name: string): boolean;
 /**
  * 判断某已安装包是否是真正的 dsh 插件（宿主会加载 / 值得提示「待重启」）：
  *  1) 包名已写进 profile 的 `dsh.profile.bundles`（宿主启动时按清单加载）；

package/package.json

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

@@ -103,10 +103,15 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   /** 安装/卸载完成后的结果视图：停留弹窗内，点「完成」关闭 */
   const [installDone, setInstallDone] = useState(false)
   const [uninstallDone, setUninstallDone] = useState(false)
-  /** 结果视图是否给「立即重启」：服务端任务终态带出（卸载时 loader 已即时移除 → false 只给「完成」；
-   *  true 时通知中心待重启条目同步常驻，直到用户点「立即重启」真正重启后才消失） */
-  const [installNeedsRestart, setInstallNeedsRestart] = useState(true)
-  const [uninstallNeedsRestart, setUninstallNeedsRestart] = useState(true)
+  /** 结果视图是否给「立即重启」：服务端任务终态带出。仅刷新解决不了的兜底场景
+   *  （热挂载失败 / 非 dsh 插件 / 更新）为 true；其余（热挂载成功、卸载已即时停用）为 false，
+   *  结果视图只给「完成」，关闭时自动刷新页面生效 */
+  const [installNeedsRestart, setInstallNeedsRestart] = useState(false)
+  const [uninstallNeedsRestart, setUninstallNeedsRestart] = useState(false)
+  /** 结果视图是否显示「关闭后自动刷新」说明：插件已热挂进运行中 loader（安装）、或卸载后
+   *  插件面板仍残留在当前页面（卸载）。关闭弹窗即整页刷新，不给手动刷新按钮。 */
+  const [installNeedsReload, setInstallNeedsReload] = useState(false)
+  const [uninstallNeedsReload, setUninstallNeedsReload] = useState(false)
   /** 结果视图「立即重启」：请求宿主重启后进入等待，服务回来后整页刷新 */
   const [restarting, setRestarting] = useState(false)
   /** 操作失败完整信息 + 所属插件仓库 + 失败类型（决定弹窗标题「安装失败/卸载失败」）+ 实际执行的安装命令 + 尝试过的安装方式（issue 预填用） */
@@ -129,23 +134,39 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   // 挂载与每次切换视图时比对全局 CSS 清单，把缺失的样式补注入回去 —— 用户无需再手动点击恢复。
   useEffect(() => { ensurePluginCss() }, [view])
 
+  /** 后台任务（弹窗已关）完成且只需刷新页面即生效时，等结果 Toast 读完再整页刷新：
+   *  新插件（或卸载后残留）的客户端资源要重新加载页面才会生效，无需重启宿主。 */
+  const scheduleAutoReload = () => {
+    window.setTimeout(() => window.location.reload(), 1600)
+  }
+
   const queue = useTaskQueue({
     t,
     // 界面语言带给服务端：网络预检等错误消息按用户语言提示（中文界面给中文，英文界面给英文）
     langKey,
     refreshInstalled: catalog.refreshInstalled,
-    onInstallDone: (viaModal, repo, needsRestart, update) => {
+    onInstallDone: (viaModal, repo, needsRestart, update, needsReload) => {
+      const reload = needsReload === true
       setInstallNeedsRestart(needsRestart)
+      setInstallNeedsReload(reload)
       if (viaModal) setInstallDone(true)
-      else setToast({ id: Date.now(), kind: 'done' })
+      // 弹窗外的后台安装：给结果 toast；需要页面重载时（热挂载的客户端 UI）读完后自动刷新
+      else setToast({
+        id: Date.now(),
+        kind: reload ? 'installedReload' : needsRestart ? 'done' : 'installedLive',
+      })
+      if (!viaModal && reload) scheduleAutoReload()
       // 安装成功也写入通知记录：通知中心里成功与失败都能看到。
       // action 区分「安装成功」与「更新成功」（更新 = 覆盖重装，同一执行通道）
       setNotifications(addSuccess({ kind: 'install', action: update ? 'update' : 'install', repo: repo ?? '' }))
     },
-    onUninstallDone: (viaModal, repo, needsRestart) => {
+    onUninstallDone: (viaModal, repo, needsRestart, needsReload) => {
+      const reload = needsReload === true
       setUninstallNeedsRestart(needsRestart)
+      setUninstallNeedsReload(reload)
       if (viaModal) setUninstallDone(true)
       else setToast({ id: Date.now(), kind: 'removed' })
+      if (!viaModal && reload) scheduleAutoReload()
       setNotifications(addSuccess({ kind: 'uninstall', repo: repo ?? '' }))
     },
     onError: (message, repo, kind, command, attempts, update) => {
@@ -311,16 +332,27 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     if (!ok) setToast({ id: Date.now(), kind: 'revealFail' })
   }
 
-  /** 「立即重启」：POST 同源 /restart，宿主进程自杀重启；随后轮询服务恢复后整页刷新。 */
+  /** 「立即重启」：POST 同源 /restart，宿主进程自杀重启；随后轮询服务恢复后整页刷新。
+   *  只在刷新解决不了的兜底场景（热挂载失败 / 非 dsh 插件 / 更新）出现。
+   *  桌面端宿主归应用壳管（服务端回 `desktop: true` 且不重启）：不轮询，改提示退出重开。 */
   const requestRestart = async () => {
     if (restarting) return
     setRestarting(true)
+    let desktop = false
     try {
       // 响应可能在宿主进程被 kill 前返回，也可能直接断连 —— 两种都属正常
-      await fetch('/dsh-plugin-hub/restart', { method: 'POST' })
+      const res = await fetch('/dsh-plugin-hub/restart', { method: 'POST' })
+      const data = await res.json() as { desktop?: boolean }
+      desktop = data.desktop === true
     } catch {
       /* 服务已终止，无需处理 */
     }
+    if (desktop) {
+      // 宿主不会重启，轮询等不到新服务：直接给出正确口径
+      setRestarting(false)
+      setToast({ id: Date.now(), kind: 'restartDesktop' })
+      return
+    }
     // 轮询同源端点，服务恢复后整页 reload（让新挂载的 bundle 完全初始化）
     let attempts = 0
     const poll = async () => {
@@ -618,7 +650,13 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       cliOnly: confirmPlugin.install?.webInstallable === false,
       submitting: queue.submitting,
       needsRestart: installNeedsRestart,
-      onClose: () => setConfirmPlugin(null),
+      needsReload: installNeedsReload,
+      // 结果弹窗关闭即生效：安装热挂载的插件要页面重载才渲染客户端 UI → 自动刷新，无需用户点按钮
+      onClose: () => {
+        const reload = installDone && installNeedsReload
+        setConfirmPlugin(null)
+        if (reload) window.location.reload()
+      },
       onCopy: () => copyCommand(confirmPlugin),
       onInstall: () => queue.installNow(confirmPlugin, confirmIsUpdate ? { update: true } : undefined),
       // 重启：结果视图「立即重启」也会中断进行中的任务 → 先弹重启确认弹窗
@@ -638,10 +676,13 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       cliOnly: false,
       submitting: queue.submitting,
       needsRestart: installNeedsRestart,
+      needsReload: installNeedsReload,
       onClose: () => {
+        const reload = installDone && installNeedsReload
         setInstallDone(false)
         setConfirmCustomTarget(null)
         setConfirmCustomChannel(null)
+        if (reload) window.location.reload()
       },
       onCopy: () => {
         doCopy(`pnpm add ${confirmCustomTarget}`)
@@ -669,10 +710,13 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       cliOnly: false,
       submitting: queue.submitting,
       needsRestart: installNeedsRestart,
+      needsReload: installNeedsReload,
       onClose: () => {
+        const reload = installDone && installNeedsReload
         setInstallDone(false)
         setConfirmGlobalNpm(null)
         setConfirmCustomChannel(null)
+        if (reload) window.location.reload()
       },
       onCopy: () => {
         doCopy(`npm install -g ${confirmGlobalNpm.pkgs.join(' ')}`)
@@ -692,10 +736,14 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       restarting,
       submitting: queue.submitting,
       needsRestart: uninstallNeedsRestart,
+      needsReload: uninstallNeedsReload,
+      // 卸载后插件面板要页面重载才摘除（带 UI 的插件）→ 关闭结果弹窗即自动刷新
       onClose: () => {
+        const reload = uninstallDone && uninstallNeedsReload
         setUninstallDone(false)
         setUninstallPlugin(null)
         setUninstallItem(null)
+        if (reload) window.location.reload()
       },
       onCancel: () => {
         setUninstallPlugin(null)
@@ -753,7 +801,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       onRunDiagnostics: openDiagnostics,
       onClose: () => setErrorMsg(null),
     }),
-    // 待重启确认弹窗：已安装列表行内「重启」按钮点击后弹出，稍后重启 / 立即重启
+    // 待重启确认弹窗：已安装列表行内「重启」按钮点击后弹出（兜底场景），单个「立即重启」，关闭即视为稍后
     showRestartConfirm && h(RestartConfirmModal, {
       t,
       restarting,

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

@@ -122,11 +122,8 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     h('span', { className: styles.pendingRowStatus },
                       p.kind === 'uninstall' ? t('restartPendingHintUninstall') : t('restartPendingHint')),
                     h('span', { className: styles.pendingRowActions },
-                      h('button', {
-                        className: styles.restartLater,
-                        disabled: restarting,
-                        onClick: onClose,
-                      }, t('restartLater')),
+                      // 兜底项：刷新解决不了（热挂载失败 / 非 dsh 插件 / 更新）才登记待重启；
+                      // 关闭本弹窗即视为「稍后」，只在真正需要时给单个「立即重启」
                       h('button', {
                         className: styles.restartNow,
                         disabled: restarting,