ygc-dsh-plugin-autoupdate 0.9.1 → 0.9.4

package/README.md

@@ -45,18 +45,63 @@
 `ctx.get('desktopActions')`），插件直接调它。桌面 shell 自己 `app.relaunch()` 并无确认退出，
 把这次退出当作**预期内**的退出，因此**不会弹「启动失败」恢复框、不写 crash report**。
 
-### 通道二：进程树之外的助手（兜底）
+### 通道二：进程树之外的助手（实际生效的那条）
 
 拿不到官方通道时才走这条。插件不自杀——它把重启助手**送到调用树之外**，由助手负责：
 
 1. 等 `restartDelaySeconds`（默认 0 秒）
-2. **等旧 Electron main 自己退出**（默认最多 15 秒，`exitWaitMs` 可调）——它自己退了就一步强制动作都不做
-3. 仍没退出，先 `taskkill /PID <main>`（**不带 `/F`**，等于发 WM_CLOSE，走 `app.quit()` 正常收尾）；
-   仍不领情才 `/T /F`
+2. **按可执行文件路径**枚举所有同程序进程（main / host / renderer / gpu 都在内），排除助手自己
+3. 给 250ms 让正在写盘的日志收尾，然后 **`taskkill /PID <n…> /F` 一次性批量结束**
 4. 用 `process.execPath` 重新拉起，Windows 上带 `--updated`（窗口会自己置前台）
 5. 删掉跨进程锁，下一次重启才能正常排期
 
-全程写 `~/.dsh/storages/plugin-autoupdate/restart.log`。
+全程写 `~/.dsh/storages/plugin-autoupdate/restart.log`。**端到端实测 ≤ 5 秒**
+（`test/restart-speed.e2e.mjs`，三份同程序进程一次清掉）。
+
+### 0.9.2 修的「点重启完全没反应」（最直接的那条）
+
+用户原话：**「purge 是弹出来重启客户端，我点一下就立刻重启了；你这边我点了完全没反应。」**
+
+对照 dsh-purge 的实现找到了两个原因：
+
+**原因一：助手顶着应用的名字，被别人的映像名清场打死。**
+
+`process.execPath` 在宿主里是 `C:\DeepSeekHarness\DeepSeek Harness.exe`，
+所以 0.9.x 的助手**也叫 `DeepSeek Harness.exe`**。dsh-purge 的 helper 正是按
+`DeepSeek Harness.exe` 枚举后逐个结束的（只排除它自己）——我的助手在那张名单里。
+12:03 那次重启的现场就是证据：
+
+```
+我的日志：  [helper] start; ... self=21860
+            ← 之后再无任何一行（没有「等待期内未退出」，没有 relaunched）
+purge 日志： relaunched via execPath      ← 34 秒后，DSH 是 purge 拉回来的
+```
+
+现在助手由安装包自带的
+`resources\runtime\primary-runtime\dependencies\node\bin\node.exe` 跑，
+映像是 `node.exe`：任何按 `DeepSeek Harness.exe` 的清场都碰不到它，
+也不再需要 `ELECTRON_RUN_AS_NODE` 那个开关（只在拿不到 node.exe 的退路上用）。
+
+**原因二：流程里有最长 31 秒的沉默，其中一步还会弹模态框。**
+
+| 步骤 | 旧行为 | 为什么致命 |
+|---|---|---|
+| 等旧 main 退出 | 15 秒 | 用户点完什么都看不到 |
+| 「礼貌退出」 | 8 秒 | `taskkill` 不带 `/F` = 发 WM_CLOSE → 桌面 `before-quit` 会 `preventDefault()` 并弹原生「退出 DeepSeek Harness？当前正在运行的任务将会中断」，**不点就永远不退** |
+| 强杀 | 8 秒 | 到这一步用户早已认定「没反应」 |
+
+purge 的助手是直接 terminate，所以「点一下立刻重启」。0.9.2 对齐它：
+不做 WM_CLOSE、批量 `/F`、固定等待合计 ≤ 500ms。
+
+**顺带修的两个隐患：**
+
+- **按路径枚举必须加闸门。** 纯 node 环境里 `process.execPath` 是 `node.exe`，
+  若照旧按路径扫会把机器上所有 node 进程杀光（实测一次带走 4 个，包括测试进程和
+  bash 作业运行器）。`canEnumerateByPath()` 只允许「应用自己的 exe」走路径模式，
+  node 一律退回显式 pid 名单。
+- **新实例的 stderr 必须落盘。** 原来 `stdio: 'ignore'` 让 `Cannot find module …`
+  这类错误彻底消失 —— 日志里只有 `relaunched`，实际上新实例根本没起来。
+  现在写到同目录的 `relaunch-stderr.log`。
 
 ### 0.9.0 修的两条「重启之后 DSH 就没了」（实测复现 + 回归测试）
 
@@ -67,12 +112,12 @@
 日志停在「兜底结束旧宿主 pid=…」，`relaunched` 永远不出现。
 实测确认：`taskkill /T` 连 detached 子进程一起杀。
 
-现在两条路把助手送走：
+现在把助手送走：
 
 | 通道 | 父进程 | 说明 |
 |---|---|---|
 | **WMI** `Win32_Process.Create`（首选） | `WmiPrvSE.exe` | 压根不在调用树里，`/T` 走不到 |
-| **两跳孤儿**（WMI 不可用时） | 已退出的第一跳 | 第一跳拉起第二跳后立刻 `exit(0)`，`/T` 顺树找不到它 |
+| **detached spawn**（WMI 不可用时） | 调用方 | 兜底；助手映像是 `node.exe`，不会与 `DeepSeek Harness.exe` 混淆 |
 
 **故障二：结束的是宿主（Host），不是 Electron main。**
 
@@ -115,10 +160,13 @@ Electron 的 main / gpu-process / renderer / utility，以及以 `ELECTRON_RUN_A
 - 把自己的 renderer 一起打死 → `Desktop renderer exited: launch-failed` 崩溃日志
 - 用户看到的是 **DSH 无预警消失、随后自动重开**，完全不像「更新完成后的正常重启」
 
-0.8.0 起助手只认两个明确的 pid：**自己**（`process.pid`，永不动）与
-**调用方登记的旧宿主**（`mainPid`）。这条边界由 `test/restart-safety.test.mjs`
+0.8.0 起到现在，助手从不按映像名做事：它按**可执行文件路径**枚举、
+排除自己、一次批量 `/F`。这条边界由 `test/restart-safety.test.mjs`
 以源码契约钉死（`tasklist` 不得出现 `IMAGENAME`、`taskkill` 必须带 `/PID` 且不得带 `/IM`）。
 
+0.9.2 额外把「按路径枚举」本身也加了闸门：只有目标是**应用自己的 exe** 时才允许，
+`node.exe` 一律退回显式 pid 名单 —— 否则在纯 node 环境里会把机器上所有 node 进程扫掉。
+
 「只在没有会话正在跑的时候重启」默认开着：判定依据是最近 90 秒内有没有会话事件。
 有会话时重启会被推迟，等空闲了再执行。**手动卸载与手动重启不受这条约束。**
 
@@ -345,7 +393,7 @@ $node = "C:\DeepSeekHarness\resources\runtime\primary-runtime\dependencies\node\
 & $node "C:\DSH-Work\plugin-autoupdate\pkg\test\all.mjs"
 ```
 
-十六个套件：
+二十二个套件（含 6 个 e2e）：
 
 | 套件 | 覆盖 |
 |---|---|
@@ -358,12 +406,16 @@ $node = "C:\DeepSeekHarness\resources\runtime\primary-runtime\dependencies\node\
 | `machine.test.mjs` | 本机标识：继承会话同步的 machineId、固定后不漂移、改名不换特征值、卸载会话同步后旧值仍有效、写边界（别人的格 / `../` 逃逸 / 前缀相近） |
 | `share.test.mjs` | 特征文件夹：清单分类（registry 只写名 / 本地打副本 / 宿主自带不写）、tgz 结构、同步幂等与副本复用、他人清单合并去重、安装路径选择、特征名防上跳 |
 | `schedule.test.mjs` | 定时排期：更新与共享同步各自独立开关 |
-| `restart-safety.test.mjs` | **重启安全契约**（源码级）：不得按映像名杀进程、必须排除自身、必须先等再兜底、助手须由 WMI/两跳送出进程树、须先礼后兵、须有冷却与锁、launcher 须设 `ELECTRON_RUN_AS_NODE` |
+| `system-plugins.test.mjs` | **系统插件显示契约**（源码级）：宿主清单是版本第二来源、版本回落顺序、宿主多出的名字也补进来、`installation` 不进检查、面板单独成组且不给策略/更新/刷新 |
+| `system-plugins.behavior.test.mjs` | **系统插件显示行为**（真执行 + 假宿主）：版本真的从宿主补出来、缺失 `pluginManager` / 抛错 / 脏数据三种降级都不让 `/state` 失败 |
+| `restart-safety.test.mjs` | **重启安全契约**（源码级）：不得按映像名杀、必须排除自身、枚举→批量结束→拉起的顺序固定、助手须由 WMI 送出进程树、直接 `/F` 不做 WM_CLOSE、有冷却与锁、助手解释器须优先用自带 node.exe |
+| `restart-interpreter.test.mjs` | **助手解释器与安全闸门**：`canEnumerateByPath()` 拒绝 node.exe/node、payload 带闸门结果与显式 pid、固定等待 ≤ 1 秒、不再每轮重新枚举、批量 taskkill |
 | `pidtree.test.mjs` | **进程树解析**（合成进程表）：Host 爬到 main、renderer 爬到同一个 main、起点缺失/父进程缺失/链过深时的边界、只在 Electron 里才爬 |
-| `restart-helper-behavior.test.mjs` | **助手行为**（真子进程）：旧 main 自退时零强制动作、不退出时先请求正常退出再强杀、只针对登记的那个 pid、payload 读后即删 |
+| `restart-helper-behavior.test.mjs` | **助手行为**（真子进程）：by-pid 只结束登记的那个、空名单零动作且 <4 秒、by-path 一次收掉多份同程序进程、源码无软退出 |
 | `restart-relaunch.e2e.mjs` | **重启链路**（真进程树）：助手父进程不是调用方、整树 `taskkill /T /F` 之后助手仍活着并完成 `relaunched` |
+| `restart-speed.e2e.mjs` | **即时重启**（独立 exe 副本）：三份同程序进程一次清掉 → 拉起新实例 → 全流程 ≤ 12 秒（实测约 4~5 秒），并断言助手不在自己的击杀名单里 |
 | `restart-env.e2e.mjs` | **环境传递**：`DSH_PROFILE` / `DSH_HOME` / `PATH` 传到新实例、白名单外的变量不落盘、新实例不带 `ELECTRON_RUN_AS_NODE` |
-| `restart-electron-env.e2e.mjs` | **Electron 助手模式**（真 Electron exe）：launcher 能真的让 Electron 以 Node 模式跑脚本 |
+| `restart-electron-env.e2e.mjs` | **退路通道**（真 Electron exe）：拿不到 node.exe 时，Electron + `ELECTRON_RUN_AS_NODE` 仍能跑助手 |
 | `restart-electron-env.negative.mjs` | **负向对照**：故意不带 `ELECTRON_RUN_AS_NODE` 时脚本不执行，证明上一条断言不是空的 |
 | `uninstall.test.mjs` | **卸载契约**：未确认不出手、`installation`/不可移除的拒绝、拒绝卸自己与管理器、走 `removeBundle`、失败写 `uninstall-failed`、成功后请求重启；外加前端按钮 / 二次确认 / `canUninstall` 契约 |
 | `client-smoke.test.mjs` | 在 Node 里用假 `document` / React 求值 `client.js`，验证插槽注册、locale 注册、面板首渲染 |
@@ -376,10 +428,77 @@ $env:ELECTRON_RUN_AS_NODE = '1'
 & "C:\DeepSeekHarness\DeepSeek Harness.exe" "C:\DSH-Work\plugin-autoupdate\pkg\test\_live-pidtree.mjs"
 ```
 
+## 系统插件（随 DSH 安装提供的那些）
+
+面板里的「随 DSH 安装提供（N）」那一组，包括 `@deepseek-ai/dsh-base`、`dsh-web-app`、
+`dsh-experimental-*` 等。它们的包在**安装目录**（`resources/app/dsh/node_modules`），
+`profile/node_modules` 里没有 —— 所以：
+
+| 数据 | 从哪来 |
+|---|---|
+| 名字 | profile 的 `dsh.profile.bundles`（`profileBundleNames()`） |
+| **版本** | **宿主** `pluginManager.listBundles()` 的 `version` |
+| 归属 | 同一接口的 `availability === 'installation'` |
+| 可卸载性 | 同一接口的 `removable`（这些恒为 false） |
+
+> **0.9.3 修的「Dsh 系统插件不在自动更新插件里显示」**：它们其实**一直**在列表里，
+> 只是 `version` 读成了 `null`（只查 profile 的 node_modules），面板渲染成「未装」，
+> 看着就像没列出来。现在 `listPlugins(host)` 把宿主清单当第二来源合并，
+> 版本回落顺序是「profile 里实际装的 → 宿主报的 → null」。
+>
+> 顺带对齐了这些插件的语义：状态写「随安装」而不是「已是最新」（没联网比过就别说这话）；
+> 不给策略下拉、不给「立即更新」、不给「刷新」—— 它们的版本跟桌面端走，
+> 查 registry 只会白打网络。检查阶段也显式跳过 `availability=installation`。
+
+宿主清单按 **10 秒 TTL** 缓存在 `hostBundlesCache`，由 `GET /state` 等入口惰性刷新。
+不在 `apply` 阶段拉：那时别的插件可能还没注册完，`pluginManager` 未必在。
+`pluginManager` 缺失、`listBundles()` 抛错、或返回脏数据（`null` / 数字 name）都只降级，
+不会让 `/state` 失败 —— 这条由 `system-plugins.behavior.test.mjs` 逐个场景验证。
+
+### 五种来源，各自怎么显示（0.9.4 明确了分类）
+
+宿主清单的 `availability` 决定分组，`spec` 决定来源类型。两者**都**要看，
+只按其中一个分就会混组：
+
+| 来源 | 判据 | 面板位置 | 状态文案 | 能自动更新 | 能卸载 |
+|---|---|---|---|---|---|
+| 随 DSH 安装 | `availability=installation` | 「随 DSH 安装提供（N）」 | 随安装 | 否 | 否 |
+| **宿主知道但没装** | `availability=missing` | 「可选、本机未安装（N）」 | **未安装** | 否 | 否（无需） |
+| npm registry | `kind=registry` | 「已装插件（N）」 | 可更新 / 已是最新 | 是 | 宿主说 removable 才行 |
+| git 来源 | `kind=git` | 同上 | 比 commit | 是 | 同上 |
+| **直链 tar 包** | `kind=local` + `spec` 是 `https://` | 「本地路径 / 直链来源」 | **直链·手动更新** | 否 | 同上 |
+
+> **0.9.4 修的两处归类错误**（用户报「有两个插件应该是 dsh 系统插件，没有正确归类」）：
+> `@deepseek-ai/dsh-subagent-claude-code` 与 `-codex` 在宿主清单里是
+> `availability: 'missing'`（宿主提供入口、包不在磁盘上），但旧代码
+> `managed = availability !== 'installation'` 把它们划进了「已装」组，
+> 同时 `kind` 又被算成 `installation`，于是显示成「随安装 + 未装」的矛盾行。
+> 现在 `missing` 单列一组，状态写「未安装」，并且 `installed: false` 一并透出。
+>
+> 顺带把 `dsh-purge-community` 这类**直链 release tar** 标成「直链·手动更新」：
+> 它的 `spec` 是 `https://github.com/.../releases/latest/download/xxx.tgz`，
+> 没有版本号可比、也没有 ref 可追，说「已是最新」是假的。
+
+### 可卸载性：不要再自己算一遍
+
+`listPlugins()` 直接把宿主的 `removable` / `readOnlyReason` 带在每行上
+（`canUninstall` / `uninstallReadOnlyReason`），`snapshot()` 只做归一，不另起炉灶。
+
+> **0.9.4 修的连带缺陷**：`snapshot()` 原来读 `deps._removableCache`，
+> 而那个字段**从来没有被赋值**（全仓库只有一处读、零处写），
+> 于是每个插件都显示「宿主未提供插件清单，无法卸载」——
+> 连宿主明说 `removable: true` 的 `dsh-purge-community` 都点不动卸载。
+> 另外 `refreshHostBundles()` 里字段名写成了 `removability`，与宿主的 `removable`
+> 对不上，等于又丢了一层。两处一起修，`system-plugins.behavior.test.mjs`
+> 用「宿主 removable=true 必须 canUninstall=true」把它钉死。
+
+
 ## 边界
 
 - 只**更新**已装插件，不安装新插件；**卸载仅限 profile 自装且宿主判定 removable 的包**（见「卸载插件」）
 - 只在 `registry` 来源上工作；`local` / `git` / `installation` 来源只显示、不处理
+- **系统插件（`availability=installation`）只显示、不检查、不更新、不卸载**：
+  版本跟桌面端走，`registry` 上的同名包与它无关
 - 更新失败只记历史，不自动回滚（避免把用户自己手改的清单吞掉）；要回滚用 `/restore`
 - DSH 关闭期间不检查（进程内定时器的固有限制）；重开后会立刻按上游发布时间重新判定
 - 共享只**同步清单与副本**，不自动安装别人的插件；安装必须人工点选

package/client.js

@@ -180,10 +180,17 @@ function makePanel(React) {
     }
 
     const plugins = Array.isArray(snap.plugins) ? snap.plugins : [];
-    const registryPlugins = plugins.filter((p) => p.kind === 'registry');
+    // 三类要分清，不能混：
+    //   1. 随 DSH 安装提供（availability=installation）—— 版本跟桌面端走
+    //   2. 知道但没装（availability=missing）—— 宿主清单里有条目，包并不在机器上
+    //   3. 本 profile 装的 —— 真正参与自动更新的那一批
+    const systemPlugins = plugins.filter((p) => p.availability === 'installation');
+    const missingPlugins = plugins.filter((p) => p.availability === 'missing');
+    const managed = plugins.filter((p) => p.availability !== 'installation' && p.availability !== 'missing');
+    const registryPlugins = managed.filter((p) => p.kind === 'registry');
     // git 与 registry 一样参与自动更新，只是比的是 commit 而不是版本号
-    const gitPlugins = plugins.filter((p) => p.kind === 'git');
-    const otherPlugins = plugins.filter((p) => p.kind !== 'registry' && p.kind !== 'git');
+    const gitPlugins = managed.filter((p) => p.kind === 'git');
+    const otherPlugins = managed.filter((p) => p.kind !== 'registry' && p.kind !== 'git');
     const available = plugins.filter((p) => p.updateAvailable);
     const ready = available.filter((p) => !p.waitMs);
 
@@ -326,18 +333,31 @@ function makePanel(React) {
 
     const pluginRow = (plugin) => {
       const isGit = plugin.kind === 'git';
+      // 三种特殊行，各自的状态文案必须诚实：
+      //   system  —— 随 DSH 安装，版本跟桌面端走
+      //   missing —— 宿主知道但没装，不是「已是最新」
+      //   link    —— 直链 tar 包（如 GitHub release），没有版本号可比
+      const isSystem = plugin.availability === 'installation';
+      const isMissing = plugin.availability === 'missing';
+      const isLink = plugin.kind === 'local' && typeof plugin.spec === 'string' && /^https?:\/\//i.test(plugin.spec);
       const tone = plugin.updateAvailable
         ? plugin.waitMs
           ? 'pau-tag-warn'
           : 'pau-tag-ok'
         : 'pau-tag';
-      const stateText = plugin.updateAvailable
-        ? plugin.waitMs
-          ? `待等 ${plugin.waitText}`
-          : '可更新'
-        : plugin.latestError
-          ? '查询失败'
-          : '已是最新';
+      const stateText = isMissing
+        ? '未安装'
+        : isSystem
+          ? '随安装'
+          : isLink
+            ? '直链·手动更新'
+            : plugin.updateAvailable
+              ? plugin.waitMs
+                ? `待等 ${plugin.waitText}`
+                : '可更新'
+              : plugin.latestError
+                ? '查询失败'
+                : '已是最新';
       // git 来源没有版本号可比：当前版本只认 commit，「最新」也只写短 sha
       const currentCommit = plugin.git && plugin.git.commit ? String(plugin.git.commit).slice(0, 10) : '';
       const showLatest = isGit
@@ -379,22 +399,31 @@ function makePanel(React) {
                   ? h('div', { className: 'pau-row-d' }, plugin.description.slice(0, 160))
                   : null,
         ),
-        h(
-          'select',
-          {
-            className: 'pau-select',
-            value: plugin.hasOverride ? plugin.policy : 'inherit',
-            onChange: (e) => {
-              const value = e.target.value;
-              if (value === 'inherit') setPolicy(plugin.name, 'inherit');
-              else setPolicy(plugin.name, value, plugin.delayHours);
-            },
-          },
-          h('option', { value: 'inherit' }, '跟随默认'),
-          h('option', { value: 'immediate' }, '立即更新'),
-          h('option', { value: 'delayed' }, '延迟更新'),
-        ),
-        plugin.policy === 'delayed'
+        // 系统插件 / 未安装 / 直链来源的策略与「立即更新」都是假的：
+        // 一个版本跟桌面端走，一个根本没装，一个没有版本号可比。
+        // 与其让用户点了报错，不如把控件换成一句实话。
+        isMissing
+          ? h('span', { className: 'pau-row-d' }, '宿主清单里有、但本机没装')
+          : isSystem
+            ? h('span', { className: 'pau-row-d' }, '随桌面端更新')
+            : isLink
+              ? h('span', { className: 'pau-row-d' }, '直链包，无法按版本号自动更新')
+              : h(
+              'select',
+              {
+                className: 'pau-select',
+                value: plugin.hasOverride ? plugin.policy : 'inherit',
+                onChange: (e) => {
+                  const value = e.target.value;
+                  if (value === 'inherit') setPolicy(plugin.name, 'inherit');
+                  else setPolicy(plugin.name, value, plugin.delayHours);
+                },
+              },
+              h('option', { value: 'inherit' }, '跟随默认'),
+              h('option', { value: 'immediate' }, '立即更新'),
+              h('option', { value: 'delayed' }, '延迟更新'),
+            ),
+        !isSystem && !isMissing && !isLink && plugin.policy === 'delayed'
           ? h('input', {
               className: 'pau-input pau-input-num',
               type: 'number',
@@ -406,27 +435,29 @@ function makePanel(React) {
                 setPolicy(plugin.name, 'delayed', Number(e.target.value)),
             })
           : null,
-        plugin.policy === 'delayed' ? h('span', { className: 'pau-row-d' }, '小时') : null,
-        h(
-          'button',
-          {
-            className: 'pau-btn pau-btn-sm',
-            disabled: !!busy || !plugin.updateAvailable,
-            title: isGit ? '安装远端最新提交' : '安装最新版本',
-            onClick: () =>
-              run(`update:${plugin.name}`, async () => {
-                const body = isGit
-                  ? { name: plugin.name, commit: plugin.latestCommit || '' }
-                  : { name: plugin.name, version: plugin.latest };
-                const next = await call('/update', body);
-                if (next.restart) setNote(next.restart.message || '已安排重启');
-                else if (next.result && next.result.ok === false) setNote(next.result.message || '未执行');
-                else setNote(`${plugin.name} 已更新`);
-                return next;
-              }),
-          },
-          busy === `update:${plugin.name}` ? '更新中…' : '立即更新',
-        ),
+        !isSystem && !isMissing && !isLink && plugin.policy === 'delayed' ? h('span', { className: 'pau-row-d' }, '小时') : null,
+        isSystem || isMissing || isLink
+          ? null
+          : h(
+              'button',
+              {
+                className: 'pau-btn pau-btn-sm',
+                disabled: !!busy || !plugin.updateAvailable,
+                title: isGit ? '安装远端最新提交' : '安装最新版本',
+                onClick: () =>
+                  run(`update:${plugin.name}`, async () => {
+                    const body = isGit
+                      ? { name: plugin.name, commit: plugin.latestCommit || '' }
+                      : { name: plugin.name, version: plugin.latest };
+                    const next = await call('/update', body);
+                    if (next.restart) setNote(next.restart.message || '已安排重启');
+                    else if (next.result && next.result.ok === false) setNote(next.result.message || '未执行');
+                    else setNote(`${plugin.name} 已更新`);
+                    return next;
+                  }),
+              },
+              busy === `update:${plugin.name}` ? '更新中…' : '立即更新',
+            ),
         canMigrate
           ? h(
               'button',
@@ -448,16 +479,18 @@ function makePanel(React) {
               busy === `migrate:${plugin.name}` ? '切换中…' : '切换到 npm',
             )
           : null,
-        h(
-          'button',
-          {
-            className: 'pau-btn pau-btn-sm',
-            disabled: !!busy,
-            title: '只查这一个插件',
-            onClick: () =>
-              run(`query:${plugin.name}`, async () => {
-                const one = await call('/query', { name: plugin.name });
-                setNote(
+        isSystem || isMissing || isLink
+          ? null
+          : h(
+              'button',
+              {
+                className: 'pau-btn pau-btn-sm',
+                disabled: !!busy,
+                title: '只查这一个插件',
+                onClick: () =>
+                  run(`query:${plugin.name}`, async () => {
+                    const one = await call('/query', { name: plugin.name });
+                    setNote(
                   one.error
                     ? `查询失败：${one.error}`
                     : one.updateAvailable
@@ -468,7 +501,7 @@ function makePanel(React) {
               }),
           },
           '刷新',
-        ),
+            ),
         h(
           'button',
           {
@@ -517,7 +550,13 @@ function makePanel(React) {
       h(
         'div',
         { className: 'pau-card-h' },
-        h('h3', { className: 'pau-card-t' }, `已装插件（${registryPlugins.length + gitPlugins.length}）`),
+        h(
+          'h3',
+          { className: 'pau-card-t' },
+          // 只数「真正参与自动更新」的（registry + git）。local / 直链 / 系统 / 未装
+          // 各自单列，混进这个数字会让「已装插件（N）」与实际能自动更新的数量不符。
+          `已装插件（${registryPlugins.length + gitPlugins.length}）`,
+        ),
         h('span', { className: 'pau-row-d' }, available.length ? `${available.length} 个可更新` : '全部最新'),
       ),
       registryPlugins.length + gitPlugins.length
@@ -527,12 +566,40 @@ function makePanel(React) {
         ? h(
             'div',
             { style: { marginTop: 12 } },
-            h('div', { className: 'pau-row-d' }, '本地路径 / 随安装提供（不参与版本检查）'),
+            h('div', { className: 'pau-row-d' }, '本地路径 / 直链来源（不参与版本检查）'),
             otherPlugins.map((plugin) =>
               pluginRow(plugin),
             ),
           )
         : null,
+      // 系统插件：必须列出来（用户要能看到自己装了哪些），但要明确标注
+      // 「随 DSH 安装」——它们的版本跟桌面端走，查 registry 没有意义。
+      systemPlugins.length
+        ? h(
+            'div',
+            { style: { marginTop: 12 } },
+            h(
+              'div',
+              { className: 'pau-row-d' },
+              `随 DSH 安装提供（${systemPlugins.length}）· 版本跟随桌面端，不参与联网检查与卸载`,
+            ),
+            systemPlugins.map(pluginRow),
+          )
+        : null,
+      // 「宿主清单里有、本机没装」：既不是系统插件也不是已装插件。
+      // 混进任何一组都会显示成矛盾状态（随安装 + 未装），所以单列。
+      missingPlugins.length
+        ? h(
+            'div',
+            { style: { marginTop: 12 } },
+            h(
+              'div',
+              { className: 'pau-row-d' },
+              `可选、本机未安装（${missingPlugins.length}）· 宿主提供了入口但包不在磁盘上`,
+            ),
+            missingPlugins.map(pluginRow),
+          )
+        : null,
     );
 
     const restartCard = h(

package/index.js

@@ -88,10 +88,89 @@ export function apply(ctx, config = {}) {
 
   const isBusy = () => Date.now() - lastActivityAt < ACTIVITY_WINDOW_MS;
 
-  /** 当前 profile 里可被本插件管理的插件列表（含本地/非 registry 来源的说明）。 */
-  const listPlugins = () => {
+  /**
+   * 宿主 `pluginManager.listBundles()` 的同步缓存。
+   *
+   * 为什么要缓存：`listPlugins()` 被 API 快照、检查、git 查询等多处同步调用，
+   * 而宿主接口是 async。缓存在这里统一刷新，调用方拿到的是同一份一致视图。
+   *
+   * 为什么必须要有：随 DSH 安装提供的插件装在**安装目录**，
+   * `profile/node_modules` 里没有它们 —— 只有宿主知道它们的版本。
+   */
+  let hostBundlesCache = Object.freeze({ bundles: [], at: 0, error: '' });
+  const HOST_BUNDLES_TTL = 10 * 1000;
+
+  const readHostManager = () => {
+    try {
+      return ctx.get('pluginManager');
+    } catch {
+      return undefined;
+    }
+  };
+
+  const hostBundles = () => hostBundlesCache;
+
+  /** 拉一次宿主清单（节流 10 秒），返回同一份缓存。 */
+  const refreshHostBundles = async (force = false) => {
+    if (!force && Date.now() - hostBundlesCache.at < HOST_BUNDLES_TTL && hostBundlesCache.at > 0) {
+      return hostBundlesCache;
+    }
+    const manager = readHostManager();
+    if (!manager || typeof manager.listBundles !== 'function') {
+      hostBundlesCache = Object.freeze({
+        bundles: hostBundlesCache.bundles || [],
+        at: Date.now(),
+        error: '宿主未提供 pluginManager',
+      });
+      return hostBundlesCache;
+    }
+    try {
+      const raw = await manager.listBundles();
+      hostBundlesCache = Object.freeze({
+        bundles: (Array.isArray(raw) ? raw : []).map((item) => ({
+          name: item && typeof item.name === 'string' ? item.name : '',
+          version: item && typeof item.version === 'string' ? item.version : null,
+          // availability: installation（随 DSH 装）/ profile（本 profile 装的）/ missing（宿主知道但没装）
+          availability: item && typeof item.availability === 'string' ? item.availability : null,
+          enabled: item ? item.enabled === true : undefined,
+          // 字段名跟着宿主：removable。之前这里写成 removability，
+          // 面板读 removable 时永远是 undefined → 所有插件都显示「宿主未提供插件清单」。
+          removable: item ? item.removable === true : false,
+          readOnlyReason: item && item.readOnlyReason ? String(item.readOnlyReason) : null,
+        })),
+        at: Date.now(),
+        error: '',
+      });
+    } catch (error) {
+      hostBundlesCache = Object.freeze({
+        bundles: hostBundlesCache.bundles || [],
+        at: Date.now(),
+        error: String((error && error.message) || error),
+      });
+    }
+    return hostBundlesCache;
+  };
+
+  // 开机**不**主动拉：apply 阶段别的插件可能还没注册完，`pluginManager` 未必在。
+  // 由 API 入口（每次 /state、/check）按 TTL 惰性刷新，那时宿主已经就绪。
+
+  /**
+   * 当前 profile 里可被本插件管理的插件列表（含本地/非 registry 来源的说明）。
+   *
+   * @param {{bundles?: Array<{name:string, version?:string|null, availability?:string|null}>}} [host]
+   *   宿主 `pluginManager.listBundles()` 的结果。**必须有这个第二来源**：
+   *   随 DSH 安装提供的插件（`@deepseek-ai/dsh-base` 等）装在**安装目录**里，
+   *   `profile/node_modules` 里根本没有它们，只看 profile 就会把版本读成 null、
+   *   面板显示成「未装」。宿主自己知道它们的版本与 availability，直接合并。
+   */
+  const listPlugins = (host) => {
     const names = profileBundleNames();
     const specs = profileDependencySpecs();
+    // 宿主清单：name -> { version, availability, enabled }
+    const hostMap = new Map();
+    for (const item of Array.isArray(host && host.bundles) ? host.bundles : []) {
+      if (item && typeof item.name === 'string') hostMap.set(item.name, item);
+    }
     // 「已发布」名单存在 state 里，跟着面板配置走
     const publishedNames = loadState().publishedNames || [];
     // lockfile 只读一次：git 来源的「当前 commit」只能从这里拿
@@ -101,7 +180,10 @@ export function apply(ctx, config = {}) {
     } catch {
       /* 没有 lock 文件就退化成只有 gitHead */
     }
-    return names
+    // 宿主里有、profile bundles 里没有的（例如其他 app 入口），也补进来：
+    // 用户要的是「我装了什么」，不是「profile 声明了什么」。
+    const allNames = [...new Set([...names, ...hostMap.keys()])];
+    return allNames
       .map((name) => {
         const meta = installedMeta(name);
         const spec = typeof specs[name] === 'string' ? specs[name] : null;
@@ -109,15 +191,26 @@ export function apply(ctx, config = {}) {
         const parsed = kind === 'git' ? parseGitSpec(spec) : undefined;
         const lockCommit = kind === 'git' ? parseLockGitCommit(lockText, name) : undefined;
         const gitHead = kind === 'git' ? installedGitHead(name) : undefined;
+        const hostRow = hostMap.get(name);
         return {
           name,
-          version: installedVersion(name) || null,
+          // 版本：优先 profile 里实际装的；读不到就用宿主报的（系统插件只能从这里拿）
+          version: installedVersion(name) || (hostRow && hostRow.version) || null,
           spec,
           // 自己这个包也要能被管理，否则「自动更新器本身」永远停在旧版
           kind,
+          // 宿主视角的归属：installation（随 DSH 安装）/ profile（本 profile 装的）/ missing（没装）
+          availability: (hostRow && hostRow.availability) || null,
+          // 宿主明说「知道但没装」：这类既不是系统插件也不是已装插件，
+          // 单列成「可选未安装」，否则会被当成系统插件显示一个「随安装 + 未装」的矛盾行。
+          installed: !(hostRow && hostRow.availability === 'missing'),
+          enabled: hostRow ? hostRow.enabled === true : undefined,
+          // 可卸载性跟着宿主：宿主没给这一行时是 false（宁可置灰）
+          canUninstall: Boolean(hostRow && hostRow.removable === true),
+          uninstallReadOnlyReason: (hostRow && hostRow.readOnlyReason) || null,
           // git 来源额外带：仓库、钉住的 ref、当前 commit —— 面板据此显示「落后几个提交」
           git: kind === 'git' ? { owner: parsed?.owner, repo: parsed?.repo, ref: parsed?.ref, commit: lockCommit || gitHead } : undefined,
-          description: meta.description || '',
+          description: meta.description || (hostRow && typeof hostRow.description === 'string' ? hostRow.description : ''),
           homepage: meta.homepage || meta.repository || '',
         };
       });
@@ -283,7 +376,11 @@ export function apply(ctx, config = {}) {
     const now = Date.now();
     const compare = (a, b) => (isNewerVersion(b, a) ? 1 : a === b ? 0 : -1);
     // registry 走版本号；git 走 commit sha。两者都要查。
-    const plugins = listPlugins().filter((p) => isUpdatableKind(p.kind) && p.version);
+    // 随 DSH 安装提供的（availability=installation）不查：它们的版本跟着桌面端走，
+    // 查 registry 只会得到无关结论，还白白打网络。
+    const plugins = listPlugins(hostBundles()).filter(
+      (p) => isUpdatableKind(p.kind) && p.version && p.availability !== 'installation',
+    );
     const { registry, fallbackRegistries } = registries();
 
     const results = [];
@@ -745,6 +842,10 @@ export function apply(ctx, config = {}) {
 
   const api = createApi({
     listPlugins,
+    // 快照/查询用：先按 TTL 刷一次宿主清单，再交给 listPlugins 合并
+    ensureHostBundles: () => refreshHostBundles(false),
+    // 同步读取当前缓存（快照是同步函数）
+    hostBundles,
     runCheck: checkAndRecord,
     applyUpdate,
     migrateToNpm,