ygc-dsh-plugin-autoupdate 0.9.4 → 0.9.5

package/README.md

@@ -197,12 +197,16 @@ Electron 的 main / gpu-process / renderer / utility，以及以 `ELECTRON_RUN_A
 
 `profile/package.json` 里 `dsh.profile.bundles` 列出的就是插件全集，再按 `dependencies` 的来源分三类：
 
-| 来源写法 | 类别 | 是否参与更新 |
-|---|---|---|
-| `1.2.3` / `^1.2.3` | `registry` | 是 |
-| `file:` / `link:` / `workspace:` | `local` | 否（没有「发布」概念） |
-| `git+` / `github:` / `http(s)://` | `git` | 否 |
-| 不在 `dependencies` 里（随 DSH 安装提供） | `installation` | 否（版本跟随宿主） |
+| 来源写法 | 类别 | 是否参与更新 | 面板 |
+|---|---|---|---|
+| `1.2.3` / `^1.2.3` | `registry` | 是 | 显示 |
+| `file:` / `link:` / `workspace:` | `local` | 否（没有「发布」概念） | 显示 |
+| `git+` / `github:` | `git` | 是（比 commit） | 显示 |
+| `http(s)://…tgz` 直链 | `local` | 否（没有版本号可比） | 显示 |
+| 不在 `dependencies` 里（随 DSH 安装提供） | `installation` | 否（版本跟随宿主） | **不显示** |
+| 包名在 `@deepseek-ai/` 下 | — | 否 | **不显示** |
+
+> 后两行是 0.9.5 的行为：DSH 本体插件整体隐藏，判据见下面「DSH 本体插件」一节。
 
 ## HTTP API
 
@@ -406,8 +410,8 @@ $node = "C:\DeepSeekHarness\resources\runtime\primary-runtime\dependencies\node\
 | `machine.test.mjs` | 本机标识：继承会话同步的 machineId、固定后不漂移、改名不换特征值、卸载会话同步后旧值仍有效、写边界（别人的格 / `../` 逃逸 / 前缀相近） |
 | `share.test.mjs` | 特征文件夹：清单分类（registry 只写名 / 本地打副本 / 宿主自带不写）、tgz 结构、同步幂等与副本复用、他人清单合并去重、安装路径选择、特征名防上跳 |
 | `schedule.test.mjs` | 定时排期：更新与共享同步各自独立开关 |
-| `system-plugins.test.mjs` | **系统插件显示契约**（源码级）：宿主清单是版本第二来源、版本回落顺序、宿主多出的名字也补进来、`installation` 不进检查、面板单独成组且不给策略/更新/刷新 |
-| `system-plugins.behavior.test.mjs` | **系统插件显示行为**（真执行 + 假宿主）：版本真的从宿主补出来、缺失 `pluginManager` / 抛错 / 脏数据三种降级都不让 `/state` 失败 |
+| `system-plugins.test.mjs` | **本体插件隐藏契约**（源码级）：`isBuiltinPlugin` 判据只有一处定义、listPlugins 出口过滤并缓存隐藏名单、runCheck 不查、snapshot 再兜一层并透出 `builtin.count`、策略/更新接口对本体插件一律 400、共享清单同一判据、面板整组隐藏只留一行说明 |
+| `system-plugins.behavior.test.mjs` | **本体插件隐藏行为**（真执行 + 假宿主 + 假 profile）：`@deepseek-ai/*` 一行都不出现、第三方插件照常可写策略、`builtin.count` 数对、`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 里才爬 |
@@ -428,56 +432,100 @@ $env:ELECTRON_RUN_AS_NODE = '1'
 & "C:\DeepSeekHarness\DeepSeek Harness.exe" "C:\DSH-Work\plugin-autoupdate\pkg\test\_live-pidtree.mjs"
 ```
 
-## 系统插件（随 DSH 安装提供的那些）
+## DSH 本体插件：不显示、不管理（0.9.5）
+
+`@deepseek-ai/*` 这一批（`dsh-base`、`dsh-web-app`、`dsh-experimental-*`、`dsh-subagent-*` 等）
+是**随桌面端一起发布的官方 bundle**。它们不在 `profile/node_modules` 里，而在安装目录
+（`resources/app/dsh/node_modules`），版本跟着桌面端走，装/升/卸都由桌面端负责。
+
+**0.9.5 起它们彻底不进这个面板**：不显示、不检查、不更新、不卸载。
 
-面板里的「随 DSH 安装提供（N）」那一组，包括 `@deepseek-ai/dsh-base`、`dsh-web-app`、
-`dsh-experimental-*` 等。它们的包在**安装目录**（`resources/app/dsh/node_modules`），
-`profile/node_modules` 里没有 —— 所以：
+> 为什么改：本机实测 40 行里 24 行是本体插件（可见行 16），真正的第三方插件被淹掉；
+> 而这些行的策略下拉、「立即更新」、「刷新」本来就是假的（点了必然报错或无意义），
+> 列出来只增加误点。用户要的是「我装的那些插件」，不是「宿主里所有的 bundle」。
 
-| 数据 | 从哪来 |
+### 判据只有一处：`isBuiltinPlugin()`
+
+`lib/core.js` 导出 `BUILTIN_SCOPE = '@deepseek-ai/'` 与 `isBuiltinPlugin(plugin)`，命中任意一条即算本体：
+
+| 判据 | 说明 |
 |---|---|
-| 名字 | 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」。
+| 包名以 `@deepseek-ai/` 开头 | 官方 scope |
+| `availability === 'installation'` | 宿主说「随 DSH 安装提供」 |
+| `kind === 'installation'` | 不在 profile `dependencies` 里，没有可查的版本约束 |
+
+面板、检查、共享、卸载四处引用同一个函数 —— 只有一处定义，才不会出现
+「面板藏了、共享清单里还在」这种自相矛盾。
+
+### 四处生效点
+
+| 位置 | 行为 |
+|---|---|
+| `listPlugins()`（`index.js`） | 出口过滤；**被剔除的名字记进 `builtinNamesCache`** |
+| `runCheck()`（`index.js`） | 双重排除 `availability !== 'installation'` 且 `!isBuiltinPlugin`，不发网络请求 |
+| `snapshot()`（`lib/api.js`） | 再兜一层（`deps.listPlugins` 可注入，未必带过滤）；透出 `builtin.count` / `builtin.names` |
+| `shareablePlugins()`（`lib/share.js`） | 不进他人的共享清单 |
+| `client.js` | 按 scope / availability / kind 再筛一次，整组不渲染 |
+
+### 面板上还能看到什么
+
+只有一行说明，不给任何控件：
+
+```
+已隐藏 24 个 DSH 本体插件（@deepseek-ai/ 下的官方包）· 随桌面端更新，不由本插件检查、更新或卸载
+```
+
+条数取 `snapshot.builtin.count`，它由两个来源并集去重得到：
+`listPlugins()` 记录的名字 + `snapshot()` 自己筛掉的条数。
+注入的 `listPlugins` 不带过滤时也不会报 0（否则面板会说「什么都没隐藏」）。
+
+### 写接口对本体插件一律拒绝
+
+即使面板不显示，直接打接口也不能得手 —— 改它们的策略或版本只会让宿主状态不一致：
+
+```json
+POST /api/local/plugin-autoupdate/plugin-policy  {"name":"@deepseek-ai/dsh-base","policy":"immediate"}
+→ 400 {"ok":false,"error":"@deepseek-ai/dsh-base 是 DSH 本体插件，不由本插件管理"}
+```
+
+`POST /update` 同形。
+
+### 历史（别把这两处修复改回去）
+
+> **0.9.3** 修过「Dsh 系统插件不在自动更新插件里显示」：它们其实一直在列表里，
+> 只是 `version` 读成了 `null`（只查 profile 的 `node_modules`），渲染成「未装」。
+> 修法是 `listPlugins(host)` 把宿主 `pluginManager.listBundles()` 当第二来源合并，
+> 版本回落顺序「profile 里实际装的 → 宿主报的 → null」，名字集取并集。
+> **这段逻辑仍然在**（`system-plugins.test.mjs` 有断言），只是筛出来的行现在被隐藏了。
 >
-> 顺带对齐了这些插件的语义：状态写「随安装」而不是「已是最新」（没联网比过就别说这话）；
-> 不给策略下拉、不给「立即更新」、不给「刷新」—— 它们的版本跟桌面端走，
-> 查 registry 只会白打网络。检查阶段也显式跳过 `availability=installation`。
+> **0.9.4** 修过两处归类错误：`availability=missing` 的官方包被划进「已装」组，
+> 显示成「随安装 + 未装」的矛盾行；以及 `snapshot()` 读了一个从未赋值的
+> `_removableCache`，导致所有插件都不可卸。
+>
+> **0.9.5** 按用户要求改为整体隐藏。`missing` 但**非官方 scope** 的第三方缺失插件
+> 仍然单列「可选、本机未安装（N）」——那是另一回事，用户可能真想装。
 
 宿主清单按 **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）」 | **未安装** | 否 | 否（无需） |
+| **DSH 本体** | 官方 scope / `availability=installation` / `kind=installation` | **不显示**（仅一行「已隐藏 N 个」） | — | 否 | 否 |
+| 第三方但宿主知道、机器上没装 | `availability=missing` 且非官方 scope | 「可选、本机未安装（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 可追，说「已是最新」是假的。
+| 直链 tar 包 | `kind=local` + `spec` 是 `https://` | 「本地路径 / 直链来源」 | **直链·手动更新** | 否 | 同上 |
+
+> **直链 release tar 为什么单独说**：`spec` 是
+> `https://github.com/.../releases/latest/download/xxx.tgz` 这类，没有版本号可比、
+> 也没有 ref 可追，说「已是最新」是假的。
 
 ### 可卸载性：不要再自己算一遍
 
@@ -497,8 +545,8 @@ $env:ELECTRON_RUN_AS_NODE = '1'
 
 - 只**更新**已装插件，不安装新插件；**卸载仅限 profile 自装且宿主判定 removable 的包**（见「卸载插件」）
 - 只在 `registry` 来源上工作；`local` / `git` / `installation` 来源只显示、不处理
-- **系统插件（`availability=installation`）只显示、不检查、不更新、不卸载**：
-  版本跟桌面端走，`registry` 上的同名包与它无关
+- **DSH 本体插件（`@deepseek-ai/*` / `availability=installation` / `kind=installation`）不显示、不检查、不更新、不卸载**：
+  版本跟桌面端走，`registry` 上的同名包与它无关；策略/更新接口对它们一律 400
 - 更新失败只记历史，不自动回滚（避免把用户自己手改的清单吞掉）；要回滚用 `/restore`
 - DSH 关闭期间不检查（进程内定时器的固有限制）；重开后会立刻按上游发布时间重新判定
 - 共享只**同步清单与副本**，不自动安装别人的插件；安装必须人工点选

package/client.js

@@ -179,20 +179,27 @@ function makePanel(React) {
       );
     }
 
-    const plugins = Array.isArray(snap.plugins) ? snap.plugins : [];
-    // 三类要分清，不能混：
-    //   1. 随 DSH 安装提供（availability=installation）—— 版本跟桌面端走
-    //   2. 知道但没装（availability=missing）—— 宿主清单里有条目，包并不在机器上
-    //   3. 本 profile 装的 —— 真正参与自动更新的那一批
-    const systemPlugins = plugins.filter((p) => p.availability === 'installation');
+    // DSH 本体插件（@deepseek-ai/* 与随安装提供的）不显示、不管理：
+    // 版本跟着桌面端走，装/升/卸都由桌面端负责。宿主侧已经把它们剔掉了，
+    // 这里再筛一次，防止老宿主或注入的实现把整张名单原样送过来。
+    const isBuiltinRow = (p) =>
+      Boolean(p) &&
+      (p.availability === 'installation' ||
+        p.kind === 'installation' ||
+        (typeof p.name === 'string' && p.name.startsWith('@deepseek-ai/')));
+    const allRows = Array.isArray(snap.plugins) ? snap.plugins : [];
+    const plugins = allRows.filter((p) => !isBuiltinRow(p));
+    // 「宿主清单里有、但本机没装」仍然单列：它不是本体插件，用户可能真想装。
     const missingPlugins = plugins.filter((p) => p.availability === 'missing');
-    const managed = plugins.filter((p) => p.availability !== 'installation' && p.availability !== 'missing');
+    const managed = plugins.filter((p) => p.availability !== 'missing');
     const registryPlugins = managed.filter((p) => p.kind === 'registry');
     // git 与 registry 一样参与自动更新，只是比的是 commit 而不是版本号
     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);
+    // 被隐藏的本体插件数量：宿主报了就用宿主的，没报就按本地筛掉的差值兜底。
+    const builtinHidden = (snap.builtin && Number(snap.builtin.count)) || allRows.length - plugins.length;
 
     const header = h(
       'div',
@@ -334,7 +341,7 @@ function makePanel(React) {
     const pluginRow = (plugin) => {
       const isGit = plugin.kind === 'git';
       // 三种特殊行，各自的状态文案必须诚实：
-      //   system  —— 随 DSH 安装，版本跟桌面端走
+      //   system  —— 随 DSH 安装（本体插件已整组隐藏，这里只作兜底）
       //   missing —— 宿主知道但没装，不是「已是最新」
       //   link    —— 直链 tar 包（如 GitHub release），没有版本号可比
       const isSystem = plugin.availability === 'installation';
@@ -572,18 +579,17 @@ function makePanel(React) {
             ),
           )
         : null,
-      // 系统插件：必须列出来（用户要能看到自己装了哪些），但要明确标注
-      // 「随 DSH 安装」——它们的版本跟桌面端走，查 registry 没有意义。
-      systemPlugins.length
+      // DSH 本体插件整组隐藏，只留一行说明：用户问过「我明明装了怎么这里没有」，
+      // 所以要能看出「有几个被隐了、为什么隐」，但不占用列表、不给任何控件。
+      builtinHidden > 0
         ? h(
             'div',
             { style: { marginTop: 12 } },
             h(
               'div',
               { className: 'pau-row-d' },
-              `随 DSH 安装提供（${systemPlugins.length}）· 版本跟随桌面端，不参与联网检查与卸载`,
+              `已隐藏 ${builtinHidden} 个 DSH 本体插件（@deepseek-ai/ 下的官方包）· 随桌面端更新，不由本插件检查、更新或卸载`,
             ),
-            systemPlugins.map(pluginRow),
           )
         : null,
       // 「宿主清单里有、本机没装」：既不是系统插件也不是已装插件。

package/index.js

@@ -19,6 +19,7 @@ import {
   installedMeta,
   installedVersion,
   installedGitHead,
+  isBuiltinPlugin,
   isNewerVersion,
   isUpdatableKind,
   loadState,
@@ -98,6 +99,13 @@ export function apply(ctx, config = {}) {
    * `profile/node_modules` 里没有它们 —— 只有宿主知道它们的版本。
    */
   let hostBundlesCache = Object.freeze({ bundles: [], at: 0, error: '' });
+
+  /**
+   * 被隐藏的 DSH 本体插件名单（同步缓存，给面板显示「已隐藏 N 个」用）。
+   * listPlugins() 每次调用都会刷新它。
+   */
+  let builtinNamesCache = [];
+  const builtinNames = () => builtinNamesCache;
   const HOST_BUNDLES_TTL = 10 * 1000;
 
   const readHostManager = () => {
@@ -183,7 +191,7 @@ export function apply(ctx, config = {}) {
     // 宿主里有、profile bundles 里没有的（例如其他 app 入口），也补进来：
     // 用户要的是「我装了什么」，不是「profile 声明了什么」。
     const allNames = [...new Set([...names, ...hostMap.keys()])];
-    return allNames
+    const rows = allNames
       .map((name) => {
         const meta = installedMeta(name);
         const spec = typeof specs[name] === 'string' ? specs[name] : null;
@@ -214,6 +222,18 @@ export function apply(ctx, config = {}) {
           homepage: meta.homepage || meta.repository || '',
         };
       });
+
+    /**
+     * DSH 本体插件（@deepseek-ai/* 与随安装提供的）从这里就剔掉：
+     * 不显示、不检查、不更新、不卸载——版本跟着桌面端走，动它们等于拆宿主。
+     *
+     * 但被隐藏的名字要留一份给面板，否则用户会问「我明明装了怎么这里没有」。
+     */
+    builtinNamesCache = rows
+      .filter((row) => isBuiltinPlugin(row))
+      .map((row) => row.name)
+      .sort();
+    return rows.filter((row) => !isBuiltinPlugin(row));
   };
 
   const registries = () => {
@@ -379,7 +399,9 @@ export function apply(ctx, config = {}) {
     // 随 DSH 安装提供的（availability=installation）不查：它们的版本跟着桌面端走，
     // 查 registry 只会得到无关结论，还白白打网络。
     const plugins = listPlugins(hostBundles()).filter(
-      (p) => isUpdatableKind(p.kind) && p.version && p.availability !== 'installation',
+      // 本体插件已在 listPlugins 里剔掉，这里再挡一次 isBuiltinPlugin：
+      // 版本跟着桌面端走，查 registry 只会得到无关结论，还白白打网络。
+      (p) => isUpdatableKind(p.kind) && p.version && p.availability !== 'installation' && !isBuiltinPlugin(p),
     );
     const { registry, fallbackRegistries } = registries();
 
@@ -846,6 +868,8 @@ export function apply(ctx, config = {}) {
     ensureHostBundles: () => refreshHostBundles(false),
     // 同步读取当前缓存（快照是同步函数）
     hostBundles,
+    // 被隐藏的本体插件名单：面板据此说明「为什么我这里只看到 N 个」
+    builtinNames,
     runCheck: checkAndRecord,
     applyUpdate,
     migrateToNpm,

package/lib/api.js

@@ -18,6 +18,7 @@ import {
   saveState,
   updateKind,
   isUpdatableKind,
+  isBuiltinPlugin,
 } from './core.js';
 import { normalizeRegistry, queryLatest } from './registry.js';
 import { restoreBackup, listBackups } from './backup.js';
@@ -52,7 +53,12 @@ function snapshot(deps) {
   // 同步预取一次（快照本来就是 async 调用方在用），拿不到就整体置灰。
   const removable = deps._removableCache || null;
   const host = typeof deps.hostBundles === 'function' ? deps.hostBundles() : undefined;
-  const plugins = deps.listPlugins(host).map((plugin) => {
+  // DSH 本体插件（@deepseek-ai/* 与随安装提供的）不显示、不管理：
+  // listPlugins 已经剔过一遍，这里再挡一层——deps.listPlugins 是可注入的，
+  // 注入方（测试、其他宿主）未必带过滤，漏一层就会在面板上冒出来。
+  const listed = deps.listPlugins(host);
+  const rawPlugins = listed.filter((plugin) => !isBuiltinPlugin(plugin));
+  const plugins = rawPlugins.map((plugin) => {
     const policy = policyFor(state, plugin.name);
     const pending = state.pending[plugin.name];
     const seen = cached[plugin.name];
@@ -127,6 +133,21 @@ function snapshot(deps) {
     busy: deps.isBusy(),
     pendingRestart: needsRestart,
     plugins,
+    // 被隐藏的 DSH 本体插件：面板只显示条数 + 可展开的名字，
+    // 既回答「我明明装了怎么这里没有」，又不把它们混进可管理列表。
+    //
+    // 条数取两个来源的并集：
+    //   - deps.builtinNames()：listPlugins 自己剔除时记下的名字（正常路径）；
+    //   - listed.length - rawPlugins.length：注入的 listPlugins 没剔除时，
+    //     在本函数里被筛掉的条数（也不能报 0，否则面板说「什么都没隐藏」）。
+    builtin: (() => {
+      const recorded = typeof deps.builtinNames === 'function' ? deps.builtinNames() : [];
+      const names = [...new Set([
+        ...(Array.isArray(recorded) ? recorded : []),
+        ...listed.filter((plugin) => isBuiltinPlugin(plugin)).map((plugin) => plugin.name),
+      ].filter((n) => typeof n === 'string' && n))].sort();
+      return { hidden: true, count: names.length, names: names.slice(0, 200) };
+    })(),
     history: (state.history || []).slice(0, 40),
     share: {
       enabled: state.shareEnabled,
@@ -210,6 +231,12 @@ export function createApi(deps) {
         json(res, 400, { ok: false, error: '缺少 name' });
         return;
       }
+      // 本体插件（@deepseek-ai/* 等）不受理任何写入：面板已不显示它们，
+      // 这里挡的是直接打接口的调用方。
+      if (isBuiltinPlugin({ name })) {
+        json(res, 400, { ok: false, error: `${name} 是 DSH 本体插件，不由本插件管理` });
+        return;
+      }
       const state = loadState();
       if (body.policy === 'inherit') {
         delete state.perPlugin[name];
@@ -292,6 +319,10 @@ export function createApi(deps) {
         json(res, 400, { ok: false, error: '缺少 name，或 version / commit' });
         return;
       }
+      if (isBuiltinPlugin({ name })) {
+        json(res, 400, { ok: false, error: `${name} 是 DSH 本体插件，不由本插件管理` });
+        return;
+      }
       const state = loadState();
       const kind = updateKind(name, { publishedNames: state.publishedNames });
       if (!isUpdatableKind(kind)) {

package/lib/core.js

@@ -250,6 +250,34 @@ export function isUpdatableKind(kind) {
   return kind === 'registry' || kind === 'git';
 }
 
+/* ------------------------------------------------------- DSH 本体插件 */
+
+/**
+ * DSH 本体（随桌面端一起发布的官方 bundle）的识别规则。
+ *
+ * 为什么需要它：这些包不属于「用户装的第三方插件」。
+ *   - 版本跟着桌面端走，查 registry 只会得到无关结论；
+ *   - 装上/升/卸都由桌面端负责，这里动它们只会把宿主拆坏；
+ *   - 面板把它们列出来只会把真正的第三方插件淹掉（本机实测 40 行里 25 行是本体）。
+ *
+ * 判据三条，命中任意一条即算本体：
+ *   1. 包名在官方 scope 下（`@deepseek-ai/`）；
+ *   2. 宿主说 availability === 'installation'（随 DSH 安装提供）；
+ *   3. updateKind() 判成 'installation'（不在 profile dependencies 里，没有可查的版本约束）。
+ *
+ * @param {{name?: string, availability?: string|null, kind?: string}} plugin
+ */
+export const BUILTIN_SCOPE = '@deepseek-ai/';
+
+export function isBuiltinPlugin(plugin) {
+  if (!plugin || typeof plugin !== 'object') return false;
+  const name = typeof plugin.name === 'string' ? plugin.name : '';
+  if (name.startsWith(BUILTIN_SCOPE)) return true;
+  if (plugin.availability === 'installation') return true;
+  if (plugin.kind === 'installation') return true;
+  return false;
+}
+
 /* ---------------------------------------------------------------- state */
 
 /** 默认状态。 */

package/lib/share.js

@@ -30,6 +30,7 @@ import { spawn } from 'node:child_process';
 import {
   installedMeta,
   installedVersion,
+  isBuiltinPlugin,
   isNewerVersion,
   profileBundleNames,
   profileDependencySpecs,
@@ -343,12 +344,13 @@ export function collectLocalPlugins(options) {
 /**
  * 共享清单里只要「自己装的第三方插件」。
  *
- * `kind === 'installation'` 是随 DSH 安装提供的官方 bundle（@deepseek-ai/*），
- * 别人机器上本来就有，写进共享清单只是噪声；而且它们没有版本号，去了也没法装。
- * 面板的插件列表仍然包含它们（那是「本机装了什么」的完整视图），只是不进特征文件夹。
+ * DSH 本体插件（`@deepseek-ai/*` 与随安装提供的 `kind === 'installation'`）
+ * 别人机器上本来就有，写进共享清单只是噪声；而且它们没有独立版本号，去了也没法装。
+ * 判据统一走 core.js 的 isBuiltinPlugin：面板、检查、共享、卸载四处同一套规则，
+ * 不会出现「面板藏了、共享里还在」这种自相矛盾。
  */
 export function shareablePlugins(plugins) {
-  return plugins.filter((p) => p && p.kind !== 'installation');
+  return plugins.filter((p) => p && !isBuiltinPlugin(p) && p.kind !== 'installation');
 }
 
 /* ------------------------------------------------------------ 打包副本 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ygc-dsh-plugin-autoupdate",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "type": "module",
   "description": "DSH 插件自动更新器：定时检查已装插件的新版本并按策略升级；把自己的插件特征（清单+本地副本+本机汇总）同步到共享插件库自己那一格，本机标识与会话同步插件共用，并汇集他人清单供人工选用。",
   "icon": "icon.svg",