@fengye_nobug/dsh-qq-bot 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 更新日志
 
+## v0.2.7 — 2026-10-31
+
+- **一键更新装完会自己重启 dsh-web**：安装成功后按面板原来的办法重启，不再把「请自己重启」当成正常结果。Linux 上如果是 systemd 拉起来的，会读本进程的 cgroup，大约 3 秒后只重启认出来的那个服务。服务在用户实例里时用 `systemctl --user`，不会重启整个登录。以前没把 cgroup 读进来，服务里一点更新就直接说面板没有重启。`systemd-run` 没权限或失败时，改为按当前的 node 命令行再拉起一次。两条都做不到，才用白话请你自己重启 dsh-web，并提醒刷新页面、登录口令可能会变。安装超过三分钟、但磁盘上已经是要装的版本时，同样会改包名并重启。进程还在，或没有确认装上时，仍然不会重启。
+- **检查和安装的提示改成短句**：设置卡片不再把「优先从 npm…三分钟…」那段长说明当作主要提示。检查按钮旁边写「只检查，不安装。」有更新按钮时另写「装完会重启面板。请刷新；登录口令可能会变。不改 NapCat。」检查结果是「有新版本 x.y.z（现在是 a.b.c），在 npm 上。这里只检查，还没安装。」或「在 GitHub 上」。安装成功是「已经从 npm 装上 vX.Y.Z，面板即将重启。」或「已经从 GitHub 装上 vX.Y.Z，面板即将重启。」自动重启失败时才请自己重启，并写明这次是从 npm 还是从 GitHub 装上的。
+
+## v0.2.6 — 2026-10-30
+
+- **一键更新之后，Cordis 按实际装上的包名挂 `qq-bridge`**：npm 包是 `@fengye_nobug/dsh-qq-bot`。v0.2.5 自带的 `cordis.patch.yml` 仍写 `name: dsh-qq-bot`。Cordis 按这个名字去加载，无作用域包并不存在，插件 id `qq-bridge` 不会挂上，`/api/qq-bridge/settings` 就是 HTTP 404，设置页显示本机接口不可用。现在插件自带的补丁把 `name` 写成 `@fengye_nobug/dsh-qq-bot`。安装成功后，还会看 profile 的 `cordis.patch.yml`、`$DSH_HOME/cordis.patch.yml`（这份文件里有 `qq-bridge` 才改），以及已经装进 profile 的插件补丁。这三处里 `qq-bridge` 的 `name` 如果还是 `dsh-qq-bot` 或 `dsh-qq-bridge`，就改成磁盘上 `package.json` 的包名。别的插件不动，`config` 里的设置不动。界面显示名和消息来源仍是 `dsh-qq-bot`，Cordis id 仍是 `qq-bridge`。从 0.2.5 点「更新」时，跑的仍是 0.2.5 里的安装程序，profile 里手写的旧 `name` 要先改成 `@fengye_nobug/dsh-qq-bot` 再重启；这一版自己跑一键更新时会改。
+- **一键更新卡住时会停掉安装进程**：`dsh plugin add` 或它拉起的 `pnpm add` 超过三分钟没有结束，会停掉这一组进程，并用白话说明，不带路径和堆栈。profile 里的 `.plugin-manager/run.json` 只在记录的进程已经不在、或记录读不懂时删掉；进程还在就不删，也不会再开第二个安装。超时之后如果磁盘上已经是这次要装的版本，仍把 `qq-bridge` 的 `name` 改成实际包名，但不会自动重启，需要自己重启 dsh-web，设置页才会出来。没有确认装上时，可以再点一次「更新」。
+
 ## v0.2.5 — 2026-10-30
 
 - **设置卡片可以一键更新**：有新正式版时出现「更新到 vX.Y.Z」。点下去才安装，并重启面板。优先执行 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@版本`，走本机 npm / pnpm 已经配置的 registry。插件不写死镜像地址。registry 里找不到这个版本时，改从 GitHub 下载官方源码包（先 github.com，连不上再试同一标签的 codeload.github.com），不走第三方镜像。v0.2.3 及更早标签里的 `package.json` 仍是无作用域名，这种源码包仍然能装。装完提示刷新页面，登录口令可能会变。现有设置还在，不改 NapCat。已经是最新时没有这个按钮。不会安装更旧的版本，也不装草稿和预发布。连不上、安装失败、没能重启，都用白话说明。

package/README.md

@@ -8,22 +8,22 @@
 
 本仓库 fork 自 [sj244/dsh-qq-bridge](https://github.com/sj244/dsh-qq-bridge)。上游许可证为 MIT，版权归 sj244；本 fork 的版权声明见 [`LICENSE`](./LICENSE)。安装和更新都走 `dsh plugin`，不要在服务器上打补丁脚本。
 
-**Cordis 插件 id 仍是 `qq-bridge`**（`cordis.patch.yml` 里的 `id`）。npm 包名是 **`@fengye_nobug/dsh-qq-bot`**。界面显示名仍是 **dsh-qq-bot**，消息来源仍是 `plugin:dsh-qq-bot`。无作用域的 `dsh-qq-bot` 发不出去：npm 认为它和已有的 `dsh-qqbot` 太像。已有 profile 里按 `id: qq-bridge` 写的覆盖继续生效。设置命名空间、状态文件和 `/api/qq-bridge/...` 也沿用这个 id，避免升级时对不上。
+**Cordis 插件 id 仍是 `qq-bridge`**（`cordis.patch.yml` 里的 `id`）。npm 包名是 **`@fengye_nobug/dsh-qq-bot`**。`cordis.patch.yml` 的 `name` 必须写成这个包名，Cordis 靠它加载模块。界面显示名仍是 **dsh-qq-bot**，消息来源仍是 `plugin:dsh-qq-bot`。无作用域的 `dsh-qq-bot` 发不出去：npm 认为它和已有的 `dsh-qqbot` 太像。已有 profile 里按 `id: qq-bridge` 写的覆盖继续生效；如果那一行还写着 `name: dsh-qq-bot`，要改成 `@fengye_nobug/dsh-qq-bot`，否则插件挂不上，设置接口是 HTTP 404。设置命名空间、状态文件和 `/api/qq-bridge/...` 也沿用这个 id，避免升级时对不上。
 
 **想装：** 优先用 npm 上已经发出的版本。连不上 npm，或 registry 里还没有这一版时，再用已经发布的 GitHub tag，不要盯着 main。
 
 ```sh
-dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.4
+dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.5
 ```
 
 ```sh
-dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3
+dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.5
 ```
 
 在 GitHub 上 Watch → Custom → **Releases**，比盯 main 稳。环境、第一次怎么开白名单、怎么升级、和官方插件为什么不能一起挂，写在[安装](#安装)。
 
 - 设计：[`DESIGN.md`](./DESIGN.md) ｜ 里程碑与真机实录：[`HANDOVER.md`](./HANDOVER.md) ｜ 变更：[`CHANGELOG.md`](./CHANGELOG.md)
-- 源码版本 **0.2.5**（设置页可以一键更新）。npm 上已经发出的是 **`@fengye_nobug/dsh-qq-bot@0.2.4`**。GitHub 上已发布的稳定版仍是 **v0.2.3**。源码这一版还没打 tag，也还没 `npm publish`。卡片上的「更新到 vX.Y.Z」安装 `@fengye_nobug/dsh-qq-bot@版本`。见 [`CHANGELOG.md`](./CHANGELOG.md)。
+- 源码版本 **0.2.7**（一键更新装完会自己重启 dsh-web；Cordis 的包名会改成实际装上的 `@fengye_nobug/dsh-qq-bot`）。已经发布的是 **v0.2.5**，npm 上对应 `@fengye_nobug/dsh-qq-bot@0.2.5`。源码这一版还没打 tag，也还没 `npm publish`。v0.2.5 自带补丁里的 `name` 仍是无作用域的 `dsh-qq-bot`，装完若设置页是 HTTP 404，先把 `qq-bridge` 的 `name` 改成 `@fengye_nobug/dsh-qq-bot` 再重启。见 [`CHANGELOG.md`](./CHANGELOG.md)。
 - **M1–M8 全部完成**，已在**真实 NapCat + 真实 QQ** 上端到端跑通（Windows 真机）
 
 ## 目录
@@ -49,7 +49,7 @@ dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3
   也认 `[表情182]` 和 `[CQ:face,id=182]`。详见[出站](#出站三种模式--来源闸门)。
 - **有设置卡片**：名称是白话（哪些群可以叫醒、群里发出去的是哪一段、忙的时候怎么插话等），
   配置键仍是英文。在 `设置 → 插件 → 插件配置` 里修改，保存即生效。
-- **可以一键更新**：先点「检查更新」。有新正式版时再点「更新到 vX.Y.Z」，面板会装上并重启。优先从 npm 安装 `@fengye_nobug/dsh-qq-bot@版本`；这一版还没发到 npm 时，改从 GitHub 下载。启动时检查不会自动安装。
+- **可以一键更新**：先点「检查更新」。有新正式版时再点「更新到 vX.Y.Z」，面板会装上并自己重启 dsh-web。优先从 npm 安装 `@fengye_nobug/dsh-qq-bot@版本`；这一版还没发到 npm 时，改从 GitHub 下载。装完把 Cordis 里 `qq-bridge` 的 `name` 改成实际装上的包名。超过三分钟没有结束就停掉卡住的安装进程；要装的版本已经在磁盘上时仍改包名，并自动重启。只有自动重启没有安排上，才提示自己重启。启动时检查不会自动安装。
 - **NapCat 自助托管**：插件可以按需下载、校验、解包、写配置、启停 NapCat。
 
 **不做的三件事**：
@@ -60,16 +60,16 @@ dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3
 
 ## 安装
 
-日常安装用 npm 上已经发出的 **`@fengye_nobug/dsh-qq-bot@0.2.4`**。无作用域的 `dsh-qq-bot@版本` 装不上：npm 不接受这个名字，它和已有的 `dsh-qqbot` 太像。GitHub [Releases](https://github.com/yunfengnobug/dsh-qq-bot/releases) 上已经发出的是 **v0.2.3**。仓库源码如果已经是 0.2.5，那是还没打 tag、也还没发到 npm 的版本，日常不要装 main。某一版还没出现在 registry 里时，一键更新会改从 GitHub 下载。
+日常安装用 npm 上已经发出的 **`@fengye_nobug/dsh-qq-bot@0.2.5`**。无作用域的 `dsh-qq-bot@版本` 装不上：npm 不接受这个名字，它和已有的 `dsh-qqbot` 太像。GitHub [Releases](https://github.com/yunfengnobug/dsh-qq-bot/releases) 上已经发出的是 **v0.2.5**。仓库源码如果已经是 0.2.7，那是还没打 tag、也还没发到 npm 的版本，日常不要装 main。某一版还没出现在 registry 里时，一键更新会改从 GitHub 下载。v0.2.5 的补丁仍把 Cordis 的 `name` 写成 `dsh-qq-bot`。装上这一版后，一键更新会在安装成功时把 profile、home（写了 `qq-bridge` 才改）和插件补丁里的 `name` 改成磁盘上的包名。
 
 ```sh
-dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.4
+dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.5
 ```
 
 GitHub 备用：
 
 ```sh
-dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3
+dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.5
 ```
 
 不写 tag 会装 main 上最新一次提交。主分支随时在改，日常别用这条：
@@ -98,16 +98,20 @@ dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot
 
 四条路。装完都要让 dsh-web 重新加载插件：
 
-1. 设置卡片里先点「检查更新」。有新正式版时出现「更新到 vX.Y.Z」。点下去优先执行 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@X.Y.Z`，走这台机器上 pnpm 已经配置的 registry，然后重启面板。设置还在，不改 NapCat。重启后刷新页面；登录口令可能会变。
-2. 自己执行同一条命令。npm 上已经发出的是 `@fengye_nobug/dsh-qq-bot@0.2.4`。
+1. 设置卡片里先点「检查更新」。有新正式版时出现「更新到 vX.Y.Z」。点下去优先执行 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@X.Y.Z`，走这台机器上 pnpm 已经配置的 registry，然后重启面板。装完会把 profile、`$DSH_HOME/cordis.patch.yml`（写了 `qq-bridge` 才改）和插件补丁里 `qq-bridge` 的 `name` 改成磁盘上的包名，`config` 不动。设置还在，不改 NapCat。重启后刷新页面；登录口令可能会变。
+2. 自己执行同一条命令。npm 上已经发出的是 `@fengye_nobug/dsh-qq-bot@0.2.5`。自己装不会自动改 profile 里的旧 `name`。
 3. 指定 GitHub tag：`dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#vX.Y.Z`
 4. 卸掉再装，然后重启。
 
-无作用域名字发不出去。第 1 步如果发现 registry 里没有 `@fengye_nobug/dsh-qq-bot` 的这一版，会改从 GitHub 下载该标签的官方源码包：先 `github.com`，连不上再试同一标签的 `codeload.github.com`，然后交给 `dsh plugin add`。v0.2.3 及更早标签里的 `package.json` 仍是无作用域名，这种源码包仍然能装。插件不写死第三方镜像。registry 里已经有比当前新的正式版时，检查和安装不再访问 GitHub。
+无作用域名字发不出去。第 1 步如果发现 registry 里没有 `@fengye_nobug/dsh-qq-bot` 的这一版，会改从 GitHub 下载该标签的官方源码包：先 `github.com`，连不上再试同一标签的 `codeload.github.com`，然后交给 `dsh plugin add`。v0.2.4 及更早标签里的 `package.json` 仍是无作用域名，这种源码包仍然能装，Cordis 的 `name` 也保持 `dsh-qq-bot`。v0.2.5 的 `package.json` 已是作用域包，但补丁里的 `name` 还是旧的，所以会 404。插件不写死第三方镜像。registry 里已经有比当前新的正式版时，检查和安装不再访问 GitHub。
 
-「检查更新」和「启动时检查一次」只询问，不会安装。已经是最新正式版时不出现更新按钮。不会装比当前更旧的版本，也不装草稿和预发布。连不上、安装失败、面板没能重启，都用白话说明。安装已经成功但没能安排重启时，新版本在磁盘上，需要自己重启 dsh-web。
+从 0.2.5 点「更新」时，执行的还是那一版里的安装程序，不会改 profile，也不会自己重启。若设置页变成 HTTP 404，把 profile 和插件目录里 `qq-bridge` 的 `name` 改成 `@fengye_nobug/dsh-qq-bot`，再重启 dsh-web。这一版（0.2.7）自己跑一键更新时会改包名，并在装完后自动重启。
 
-在 Linux 上，进程由 systemd 拉起并且能认出具体服务时，大约 3 秒后只重启那个服务。只看到用户会话、认不出单独服务时，请自己重启 dsh-web。没有被 systemd 拉起时，响应发出后按当前的 node 命令行再拉起一次。这次更新不改 NapCat 的配置，也不去停它。插件自己拉起的 NapCat 会随 dsh-web 退出而结束；已经在外面跑着的 NapCat 继续运行。
+「检查更新」和「启动时检查一次」只询问，不会安装。已经是最新正式版时不出现更新按钮。不会装比当前更旧的版本，也不装草稿和预发布。连不上、安装失败、面板没能重启，都用白话说明。安装已经成功但自动重启没有安排上时，新版本在磁盘上，需要自己重启 dsh-web。包名已经改好的话，重启后设置页会回来。
+
+安装超过三分钟没有结束时，会停掉卡住的 dsh 和它带起来的 pnpm，并用白话说明。profile 里的 `.plugin-manager/run.json` 只在记录的进程已经不在、或记录读不懂时删掉；进程还在就不会再开一次安装。超时后如果要装的版本已经在磁盘上，包名仍会改成实际安装的包，然后自动重启 dsh-web。没有确认装上时，可以再点一次「更新」，这时不会重启。
+
+在 Linux 上，进程由 systemd 拉起并且能认出具体服务时，大约 3 秒后只重启那个服务。服务挂在用户实例（`user@`）下面时，用 `systemctl --user`，不会重启整个登录。认不出单独服务，或 `systemd-run` 没有权限、执行失败时，改为按当前的 node 命令行再拉起一次。两条都做不到，才提示自己重启 dsh-web。没有被 systemd 拉起时，响应发出后按当前命令行再拉起一次。这次更新不改 NapCat 的配置，也不去停它。插件自己拉起的 NapCat 会随 dsh-web 退出而结束；已经在外面跑着的 NapCat 继续运行。
 
 想让 npm 走镜像，把 npm / pnpm 的 registry 配成你自己的镜像。插件只在没读到配置时用 `https://registry.npmjs.org/`。
 
@@ -119,12 +123,12 @@ dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot
 
 ```sh
 dsh plugin --profile web remove dsh-qq-bridge
-dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.4
+dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.5
 ```
 
-连不上 npm 时，把上面第二条换成 `dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3`。
+连不上 npm 时，把上面第二条换成 `dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.5`。
 
-然后重启 dsh-web。profile 里原来按 `id: qq-bridge` 写的覆盖可以留着。`list` 里如果包名不是 `dsh-qq-bridge`，卸你看到的那一个官方包，不要卸别的插件。
+然后重启 dsh-web。profile 里原来按 `id: qq-bridge` 写的覆盖可以留着。若其中有 `name`，写成 `@fengye_nobug/dsh-qq-bot`，不要留着 `dsh-qq-bot` 或 `dsh-qq-bridge`。`list` 里如果包名不是 `dsh-qq-bridge`，卸你看到的那一个官方包，不要卸别的插件。
 
 ### 开发期
 
@@ -158,18 +162,18 @@ Release 不附带密钥、日志或本机文件。源码压缩包让 GitHub 自
 
 ## 用 npm 安装
 
-`dsh plugin` 是 pnpm 的包装。安装和一键更新都用作用域包名。npm 上已经发出的是 0.2.4：
+`dsh plugin` 是 pnpm 的包装。安装和一键更新都用作用域包名。npm 上已经发出的是 0.2.5：
 
 ```sh
-dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.4
+dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@0.2.5
 ```
 
 无作用域的 `dsh-qq-bot` 发不出去，npm 认为它和已有的 `dsh-qqbot` 太像。不要写成 `dsh plugin add dsh-qq-bot@版本`。
 
-registry 里还没有要装的那一版时（源码 0.2.5 尚未发布），改用 GitHub：
+registry 里还没有要装的那一版时（源码 0.2.7 尚未发布），改用 GitHub：
 
 ```sh
-dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3
+dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.5
 ```
 
 一键更新的顺利路径是 npm，不再要求打开 github.com。某台机器上的 `dsh plugin --help` 如果只认 `github:`，就继续用 Release tag。想用镜像，配置这台机器的 npm / pnpm registry，不要等插件内置一个镜像地址。
@@ -193,7 +197,7 @@ dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#v0.2.3
 2. 把本仓库的 [`docs/awesome-dsh-plugin-entry.yml`](./docs/awesome-dsh-plugin-entry.yml) 复制成对方仓库的 `data/plugins/yunfengnobug__dsh-qq-bot.yml`，提一个 PR。不要改上游那条。一个 PR 最多 3 条。对方的 README 由脚本生成，不要手改。
 3. 描述只写插件实际做的事。`repository` 必须指回本仓库（`package.json` 里已经是了）。yml 里不要手写 `npm:`，市场自己从 registry 认。
 
-npm 上已经有 `@fengye_nobug/dsh-qq-bot`（目前是 0.2.4）。无作用域名发不出去。发到 npm 之后，市场才能显示下载量；不发也能收录。
+npm 上已经有 `@fengye_nobug/dsh-qq-bot`（目前是 0.2.5）。无作用域名发不出去。发到 npm 之后，市场才能显示下载量；不发也能收录。
 
 用着有问题，到 [Issues](https://github.com/yunfengnobug/dsh-qq-bot/issues/new/choose) 选模板：**连不上**、**不回**、**发不出**。不要在 Issue 里贴真实 QQ 号、群号、token 或服务器地址。
 
@@ -471,9 +475,9 @@ QQ 的“拍一拍”在 OneBot 里走的是 **notice 事件**，不是消息段
 > 宿主 `requestRejection()` 返回空、`undefined` 或 `0` **不算**已登录。已登录只认宿主明确给出的结果：`isAuthenticated`、浏览器会话，或 `admit()` 交回的身份。没有这个结果的外网请求是 403。来源是别的网站、和 `Host` 对不上的请求也是 403，就算带着 cookie 也不行。接口只写 schema 白名单里的键。
 > 判断面板监听器是不是 HTTPS 时，只通过 `ctx.get('webServer')` 读协议，不读 `ctx.webServer`。插件没有把 `webServer` 放进 inject。直接读这个属性会抛错，宿主会把这次请求收成**没有正文的 HTTP 400**，卡片诊断就显示本机接口不可用，即使浏览器里已经登录。读不到这项服务、或读取失败时，按 HTTP 继续做登录判定。
 
-卡片上方显示**当前版本**，并有 **检查更新**。接口是 `GET/POST /api/qq-bridge/update`，准入和设置接口相同。GET 只读当前版本，不去 npm，也不去 GitHub。POST 不带 `action` 才对比版本：先问 npm registry 里的 `@fengye_nobug/dsh-qq-bot` 正式版。有比当前新的版本时，写出版本号和 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@x.y.z`，并且不再访问 GitHub。npm 上还没有更新、但 GitHub Release 上有更新时，才改问 GitHub，并说明一键更新会从 GitHub 下载。没有新版、连不上、被限流，都用白话说明。检查本身不会下载或安装。
+卡片上方显示**当前版本**，并有 **检查更新**。按钮旁边只写「只检查，不安装。」接口是 `GET/POST /api/qq-bridge/update`，准入和设置接口相同。GET 只读当前版本，不去 npm，也不去 GitHub。POST 不带 `action` 才对比版本：先问 npm registry 里的 `@fengye_nobug/dsh-qq-bot` 正式版。有比当前新的版本时，卡片上写短句「有新版本 x.y.z（现在是 a.b.c），在 npm 上。这里只检查，还没安装。」并且不再访问 GitHub。npm 上还没有更新、但 GitHub Release 上有更新时，改问 GitHub，短句里写「在 GitHub 上」。安装命令和说明摘要仍在接口字段里，不铺在这句主提示上。没有新版、连不上、被限流，都用白话说明。检查本身不会下载或安装。
 
-有新版时出现 **更新到 vX.Y.Z**。点下去才发送 `POST { "action": "apply", "version": "x.y.z" }`。优先 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@x.y.z`。registry 里没有这个版本时，改从 GitHub 的官方源码包装上，再重启面板。按钮下面写着：设置还在，不改 NapCat；重启后请刷新，登录口令可能会变。进行中显示「正在更新…」。已经是最新正式版时没有这个按钮。
+有新版时出现 **更新到 vX.Y.Z**。旁边只加一句「装完会重启面板。请刷新；登录口令可能会变。不改 NapCat。」点下去才发送 `POST { "action": "apply", "version": "x.y.z" }`。优先 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@x.y.z`。registry 里没有这个版本时，改从 GitHub 的官方源码包装上。安装成功后，把 profile、`$DSH_HOME/cordis.patch.yml`（有 `qq-bridge` 这一行才改）和已安装插件补丁里的 `name` 改成磁盘上 `package.json` 的包名，然后重启面板。只改我们自己的旧包名（`dsh-qq-bot`、`dsh-qq-bridge`），不改 `config`，也不改别的插件。成功时主提示是「已经从 npm 装上 vX.Y.Z，面板即将重启。」或「已经从 GitHub 装上 vX.Y.Z，面板即将重启。」进行中显示「正在更新…」。已经是最新正式版时没有这个按钮。超过三分钟还没装完时停掉这次的 dsh 和 pnpm。`.plugin-manager/run.json` 里的进程还在就不删，也不再开第二个安装；进程已经不在或记录读不懂才删。超时后如果磁盘上已经是要装的版本，仍改包名，并自动重启 dsh-web。自动重启没有安排上时，才提示自己重启，并写明这次是从 npm 还是从 GitHub 装上的。
 
 「启动时检查一次」默认关。打开并保存后，下次启动 dsh-web 才问一次，结果只写在日志里，不会安装。
 
@@ -526,7 +530,7 @@ QQ 的“拍一拍”在 OneBot 里走的是 **notice 事件**，不是消息段
 | `downloadProxy` | `''` | 下载时走的代理；空 = 先看 `HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY`。NapCat 下载，以及一键更新改从 GitHub 下载时，都用它。从 npm 安装时走 pnpm 自己的 registry，不读这个框。界面上不显示代理地址 |
 | `onebotPort` | `3001` | OneBot 端口。自己另外部署的 NapCat 要和这边一致 |
 | `qqNumber` | `''` | 快速登录用的 QQ 号（需先手动登录过一次） |
-| `checkUpdateOnStart` | `false` | 启动时检查一次。默认关。打开后，下次启动先问 npm 上的 `@fengye_nobug/dsh-qq-bot`；npm 上还没有更新时再问 GitHub。只写日志，不自动安装。要装用卡片上的「更新到 vX.Y.Z」 |
+| `checkUpdateOnStart` | `false` | 启动时检查一次。默认关。打开后，下次启动只检查有没有新版本，写在日志里，不自动安装。要装用卡片上的「更新到 vX.Y.Z」 |
 
 这些值优先从设置界面 / `settings.yaml` 取，未设置时回落到 `cordis.patch.yml` 里的安装配置（composition base）。
 
@@ -624,7 +628,7 @@ QQ 侧没有人能点击“同意”，因此：
 
 改用法、设置或运行行为时，同一次提交里更新本文件。约定见 [`AGENTS.md`](./AGENTS.md)。
 
-5 个套件都是**零依赖**（测试自己造 zip、自己起一个最小 OneBot WS 服务器；检查更新不连真 npm、也不连真 GitHub），共 **778 条断言**：
+5 个套件都是**零依赖**（测试自己造 zip、自己起一个最小 OneBot WS 服务器；检查更新不连真 npm、也不连真 GitHub），共 **812 条断言**：
 
 ```powershell
 node test-smoke.mjs     # 策略分支 + 出站闸门 + 描述缓存命中 + 表情包工具（含 mface）+ 系统表情分段 + 设置卡片字段 + 检查更新和一键安装接口（假 ctx，纯离线）

package/client/client.js

@@ -38,7 +38,7 @@ window.__ModuleLoader__.load({
         key: 'checkUpdateOnStart',
         label: '启动时检查一次',
         kind: 'boolean',
-        hint: '默认关。打开并保存后，下次启动 dsh-web 会先问 npm 上的 @fengye_nobug/dsh-qq-bot 有没有新版本；npm 上还没有更新时再看 GitHub。只写在日志里，不会自动安装。要装新版本，用检查之后出现的更新按钮。',
+        hint: '默认关。打开并保存后，下次启动只检查有没有新版本，写在日志里，不会自动安装。',
       },
       {
         key: 'sessionScope',
@@ -860,9 +860,9 @@ window.__ModuleLoader__.load({
               )
             : null,
         ),
-        h('div', { style: S.hint }, '先问 npm 上有没有新版本。这里只检查，不会安装。'),
+        h('div', { style: S.hint }, '只检查，不安装。'),
         updateOffer
-          ? h('div', { style: S.hint }, '优先从 npm 安装 @fengye_nobug/dsh-qq-bot 的这一版并重启面板。这一版还没发到 npm 时，会改从 GitHub 下载。设置还在，不改 NapCat。重启后请刷新，登录口令可能会变。')
+          ? h('div', { style: S.hint }, '装完会重启面板。请刷新；登录口令可能会变。不改 NapCat。')
           : null,
         updateNote
           ? h('div', { style: { ...(updateIsError ? S.err : S.note), whiteSpace: 'pre-wrap' } }, updateNote)

package/cordis.patch.yml

@@ -1,10 +1,13 @@
 # dsh-qq-bot bundle patch: one insert row carrying the whole plugin config.
-# Cordis 插件 id 仍是 qq-bridge（与上游兼容）。显示名是 dsh-qq-bot。
+# Cordis 插件 id 仍是 qq-bridge（与上游兼容）。界面显示名仍是 dsh-qq-bot。
+# name 是 Node 用来加载插件的包名，必须等于实际安装的 npm 包。
+# 无作用域的 dsh-qq-bot 发不出去；写成那个名字时 Cordis 解析不到模块，
+# qq-bridge 不会挂上，/api/qq-bridge/settings 就是 HTTP 404。
 # 用户在 profile 的 cordis.patch.yml 里按 id 覆盖这一行；patch 会替换整份 config，
-# 所以要保留的键请全部重述。
+# 所以要保留的键请全部重述。覆盖里如果写了 name，也要写成同一个包名。
 - insert:
     - id: qq-bridge
-      name: dsh-qq-bot
+      name: '@fengye_nobug/dsh-qq-bot'
       config:
         # 固定目标会话：QQ 的一切都注入这一个会话（保留其上下文）。
         # 留空表示不驱动任何会话。

package/index.js

@@ -3971,6 +3971,8 @@ export function apply(ctx, config) {
         version: typeof payload.version === 'string' ? payload.version : '',
         force: payload.force === true,
         proxy: proxyFor(readSettings()),
+        home: process.env.DSH_HOME || join(homedir(), '.dsh'),
+        profile: 'web',
       })
     } catch {
       return sendJson(res, 200, { ok: false, stage: 'install', error: '更新没有完成。稍后再试。' })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fengye_nobug/dsh-qq-bot",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "type": "module",
   "main": "index.js",
   "description": "把 DSH 会话接到 QQ（OneBot/NapCat）的插件。白名单默认全关；被 @、叫到昵称或被戳一定叫醒，其余消息按可调概率抽样。Fork 自 sj244/dsh-qq-bridge（MIT）。",

package/updates.js

@@ -7,11 +7,19 @@
 // 插件不写死第三方镜像。包还没发到 npm，或 registry 里没有这个版本时，才改从 GitHub 下载：
 // 先要 github.com 上的官方源码包，连不上再试同一标签的 codeload。只跟随仍指向同一标签的
 // github.com、api.github.com 或 codeload.github.com。不用 git 协议。
+// 安装成功后，若 profile、home 或插件自己的 cordis.patch.yml 里 qq-bridge 的 name
+// 仍是旧的无作用域名，会改成磁盘上 package.json 里的包名。不改 config，不改设置，不改 NapCat。
+// 安装超过三分钟还没结束时，停掉这次拉起的进程组，并清掉已经退出的安装记录。
+// 超时后若磁盘上已是目标版本，仍改包名，并安排重启。
+// 重启会读本进程的 cgroup：认得出具体服务就用 systemd-run 只重启那个服务
+// （挂在 user@ 下面的用 systemctl --user）。systemd-run 失败，或只看见用户会话、
+// 认不出单独服务时，不重启整个登录，改为按当前命令行再拉起一次。
+// 两条都做不到，才提示自己重启。
 
 import { spawn } from 'node:child_process'
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { chmodSync, mkdtempSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs'
 import { tmpdir } from 'node:os'
-import { join } from 'node:path'
+import { isAbsolute, join } from 'node:path'
 import { gunzipSync, gzipSync } from 'node:zlib'
 
 export const UPDATE_REPO = 'yunfengnobug/dsh-qq-bot'
@@ -27,6 +35,8 @@ const MAX_TARBALL_BYTES = 20 * 1024 * 1024
 const MAX_UNPACKED_BYTES = 40 * 1024 * 1024
 const MAX_TAR_ENTRIES = 4000
 const INSTALL_TIMEOUT_MS = 180000
+/** 先劝退，再强制停。给子进程一点时间自己退出。 */
+const KILL_GRACE_MS = 1500
 const DOWNLOAD_TIMEOUT_MS = 60000
 /** 先把 HTTP 响应发出去，再重启，避免面板还没回答就被掐掉。 */
 const RESTART_DELAY_MS = 2500
@@ -231,7 +241,7 @@ export function assessUpdate({ current, releases, repo = UPDATE_REPO, channel =
       kind: 'no-release',
       current: parsedCurrent.raw,
       updateAvailable: false,
-      message: 'GitHub 上还没有可用的正式版，没法对比新版本。',
+      message: channel === 'npm' ? 'npm 上还没有可用的正式版，没法对比新版本。' : 'GitHub 上还没有可用的正式版，没法对比新版本。',
     }
   }
   stable.sort((left, right) => compareSemver(right.parsed, left.parsed) ?? 0)
@@ -253,21 +263,21 @@ export function assessUpdate({ current, releases, repo = UPDATE_REPO, channel =
     url,
   }
   if (compared > 0) {
-    const lines = [`有新版本 ${latest.parsed.raw}（你现在是 ${parsedCurrent.raw}）。`]
-    if (summary) lines.push(`说明：${summary}`)
-    lines.push(`升级命令：${command}`)
-    lines.push('装完请重启 dsh-web。')
-    if (useNpm) lines.push(`也可以在设置卡片里点「更新到 v${latest.parsed.raw}」，面板会从 npm 装上并重启。`)
-    else lines.push(`也可以在设置卡片里点「更新到 v${latest.parsed.raw}」，面板会自己装并重启。`)
-    if (!useNpm) lines.push(`发布页：${url}`)
-    return { ...base, kind: 'update', updateAvailable: true, message: lines.join('\n') }
+    const where = useNpm ? 'npm' : 'GitHub'
+    return {
+      ...base,
+      kind: 'update',
+      updateAvailable: true,
+      message: `有新版本 ${latest.parsed.raw}（现在是 ${parsedCurrent.raw}），在 ${where} 上。这里只检查，还没安装。`,
+    }
   }
   if (compared < 0) {
+    const where = useNpm ? 'npm' : 'GitHub'
     return {
       ...base,
       kind: 'ahead',
       updateAvailable: false,
-      message: `你现在的 ${parsedCurrent.raw} 比 GitHub 上最新正式版 ${latest.parsed.raw} 还新，不用按 Release 往回装。`,
+      message: `你现在的 ${parsedCurrent.raw} 比 ${where} 上最新正式版 ${latest.parsed.raw} 还新，不用往回装。`,
     }
   }
   return {
@@ -433,19 +443,6 @@ export async function queryNpmVersions(input = {}) {
   return { ok: false, code: 'network' }
 }
 
-function noteGithubFallback(assessed) {
-  if (!assessed || assessed.updateAvailable !== true) return assessed
-  const message = String(assessed.message ?? '')
-  if (message.includes('还没发到 npm') || !message.includes('也可以在设置卡片里点')) return assessed
-  return {
-    ...assessed,
-    message: message.replace(
-      '也可以在设置卡片里点',
-      '这一版还没发到 npm，一键更新会改从 GitHub 下载。\n也可以在设置卡片里点',
-    ),
-  }
-}
-
 function lookupFailure(npmCode, githubError, applying) {
   const raw = String(githubError ?? '')
   if (npmCode === 'network' && /连不上 GitHub/.test(raw)) {
@@ -484,7 +481,7 @@ async function findUpdate(input) {
       if (wanted !== '') return { ok: false, error: '这次检查到的正式版里没有这个版本，没有安装。' }
       return { ok: true, channel: 'npm', releases, assessed }
     }
-    const ghAssessed = noteGithubFallback(assessUpdate({ current: input.current, releases: gh.releases, repo, channel: 'github' }))
+    const ghAssessed = assessUpdate({ current: input.current, releases: gh.releases, repo, channel: 'github' })
     if (ghAssessed.ok === false) return { ok: false, error: ghAssessed.message }
     const npmLatest = assessed.latest || '0.0.0'
     const githubNewer = ghAssessed.updateAvailable === true && (compareSemver(ghAssessed.latest, npmLatest) ?? 0) > 0
@@ -500,7 +497,7 @@ async function findUpdate(input) {
   }
   const gh = await queryGithubReleases(input.fetchImpl, { repo, timeoutMs: input.timeoutMs })
   if (!gh.ok) return { ok: false, error: lookupFailure(npm.code, gh.error, input.applying === true) }
-  const assessed = noteGithubFallback(assessUpdate({ current: input.current, releases: gh.releases, repo, channel: 'github' }))
+  const assessed = assessUpdate({ current: input.current, releases: gh.releases, repo, channel: 'github' })
   if (assessed.ok === false) return { ok: false, error: assessed.message }
   return { ok: true, channel: 'github', releases: gh.releases, assessed }
 }
@@ -613,18 +610,29 @@ function downloadError(code) {
   return '连不上 GitHub，这次没有把新版本下下来。稍后再试。'
 }
 
-function installError(code, command) {
+function installError(code, command, extra = {}) {
   const hint = command ? `也可以自己执行：${command}` : '也可以按卡片上的安装命令自己装。'
   if (code === 'ENOENT') return `没找到 dsh 命令，没有安装。${hint}`
-  if (code === 'timeout') return `安装超时，没有确认装上。${hint}`
+  if (code === 'busy') {
+    const pid = Number(extra.pid)
+    const which = Number.isSafeInteger(pid) && pid > 1 ? `（进程 ${pid}）` : ''
+    return `已经有一个安装进程还在跑${which}，这次没有再启动。等它结束再点「更新」。如果确认它已经卡死，先停掉那个进程，再点一次。`
+  }
+  if (code === 'timeout' && extra.leftover) {
+    return `安装超时，卡住的安装进程还没停干净。请先停掉 dsh 和 pnpm，再点一次「更新」。${hint}`
+  }
+  if (code === 'timeout') {
+    return `安装超时，已经停掉卡住的安装进程，并清掉这次留下的安装记录。没有确认装上。可以再点一次「更新」。${hint}`
+  }
   if (code === 'wrong-name') return '下到的安装包不是这个插件，没有安装。'
   if (code === 'wrong-version') return '下到的版本和发布标签对不上，没有安装。'
   if (code === 'bad-package') return '下到的安装包读不懂，没有安装。'
   return `安装没有成功。${hint}`
 }
 
-function restartError() {
-  return '新版本已经装上，但面板没有重启。请自己重启 dsh-web，装好的才会生效。重启后请刷新页面，登录口令可能会变。'
+function restartError(channel) {
+  const via = channel === 'npm' ? '从 npm ' : channel === 'github' ? '从 GitHub ' : ''
+  return `新版本已经${via}装上，但没能自动重启面板。请自己重启 dsh-web，然后刷新页面。登录口令可能会变。`
 }
 
 function headerValue(response, name) {
@@ -1167,16 +1175,147 @@ export function dshPluginAddSpec(spec) {
   return { command: 'dsh', args: pluginArgs, shell: false }
 }
 
+function defaultAlive(pid) {
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch (error) {
+    return error?.code === 'EPERM'
+  }
+}
+
+function defaultKill(target, signal, child) {
+  if (typeof target === 'number' && target < 0) {
+    process.kill(target, signal)
+    return
+  }
+  if (child && typeof child.kill === 'function') {
+    child.kill(signal)
+    return
+  }
+  process.kill(target, signal)
+}
+
+function defaultTaskkill(pid) {
+  const killer = spawn('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' })
+  killer.on?.('error', () => {})
+  killer.unref?.()
+}
+
+/**
+ * 停掉安装进程，以及它在 POSIX 上拉起来的进程组。
+ * 测试要传入 kill，避免对一个碰巧存在的 pid 发信号。
+ * @param {{ pid?: number, kill?: (signal: string) => void }} child
+ * @param {{ platform?: string, graceMs?: number, kill?: (target: number, signal: string) => void, taskkill?: (pid: number) => void, group?: boolean }} [options]
+ */
+export function stopProcessTree(child, options = {}) {
+  const pid = Number(child?.pid)
+  const known = Number.isSafeInteger(pid) && pid > 1
+  const platform = options.platform || process.platform
+  const graceMs = options.graceMs ?? KILL_GRACE_MS
+  const group = options.group !== false && platform !== 'win32'
+  const kill = options.kill || ((target, signal) => defaultKill(target, signal, child))
+  const targets = []
+  if (known && group) targets.push(-pid)
+  if (known) targets.push(pid)
+  const send = (signal) => {
+    if (platform === 'win32' && signal === 'SIGKILL') {
+      if (!known) return
+      const taskkill = options.taskkill || defaultTaskkill
+      try { taskkill(pid) } catch { /* 停不掉时由调用方再看进程还在不在 */ }
+      return
+    }
+    for (const target of targets) {
+      try { kill(target, signal) } catch { /* 进程已经退出 */ }
+    }
+  }
+  send('SIGTERM')
+  const timer = setTimeout(() => send('SIGKILL'), graceMs)
+  if (typeof timer.unref === 'function') timer.unref()
+  return {
+    pid: known ? pid : 0,
+    stop() { clearTimeout(timer) },
+  }
+}
+
+/** DSH 把正在跑的 pnpm 记在 profile 的这个文件里。 */
+export function runRecordPath(profileDir) {
+  return join(profileDir, '.plugin-manager', 'run.json')
+}
+
+/** 只认 `{ pid, grouped }`。pid 必须是大于 1 的整数，避免把 1 号进程当成安装进程。 */
+export function parseRunRecord(text) {
+  let value
+  try {
+    value = JSON.parse(String(text ?? ''))
+  } catch {
+    return null
+  }
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null
+  const pid = value.pid
+  if (!Number.isSafeInteger(pid) || pid <= 1 || typeof value.grouped !== 'boolean') return null
+  return { pid, grouped: value.grouped }
+}
+
+/**
+ * 安装记录里的进程已经不在，或记录本身读不懂时，把文件删掉。
+ * 进程还活着就不删，免得下一次安装和还在写目录的 pnpm 抢在一起。
+ * 测试要传入 alive。默认探测会向真实 pid 发 0 信号。
+ * @param {string} profileDir
+ * @param {{ alive?: (pid: number) => boolean }} [options]
+ */
+export function clearStaleRunRecord(profileDir, options = {}) {
+  const path = runRecordPath(profileDir)
+  let text
+  try {
+    text = readFileSync(path, 'utf8')
+  } catch (error) {
+    if (error?.code === 'ENOENT') return { removed: false, alive: false, missing: true }
+    throw error
+  }
+  const record = parseRunRecord(text)
+  if (!record) {
+    try {
+      rmSync(path, { force: true })
+    } catch {
+      return { removed: false, invalid: true, alive: false }
+    }
+    return { removed: true, invalid: true, alive: false }
+  }
+  const probe = options.alive || defaultAlive
+  let living = false
+  try {
+    living = probe(record.pid) === true
+  } catch {
+    // 看不出来就当成还在跑，避免删掉记录后再开一个安装。
+    living = true
+  }
+  if (living) return { removed: false, alive: true, pid: record.pid, grouped: record.grouped }
+  try {
+    rmSync(path, { force: true })
+  } catch {
+    return { removed: false, alive: false, pid: record.pid }
+  }
+  return { removed: true, alive: false, pid: record.pid }
+}
+
 function runChild(spawnImpl, command, args, options = {}) {
   return new Promise((resolve) => {
     let settled = false
     let timer
+    let graceTimer
+    let stopper = null
+    let timedOut = false
     const finish = (value) => {
       if (settled) return
       settled = true
       if (timer) clearTimeout(timer)
+      if (graceTimer) clearTimeout(graceTimer)
+      stopper?.stop()
       resolve(value)
     }
+    const platform = options.platform || process.platform
+    const detached = options.detached === true && platform !== 'win32'
     let child
     try {
       child = spawnImpl(command, args, {
@@ -1185,6 +1324,7 @@ function runChild(spawnImpl, command, args, options = {}) {
         windowsHide: true,
         shell: false,
         stdio: options.stdio || ['ignore', 'pipe', 'pipe'],
+        detached,
       })
     } catch (error) {
       finish({ ok: false, code: error?.code === 'ENOENT' ? 'ENOENT' : 'error' })
@@ -1204,29 +1344,120 @@ function runChild(spawnImpl, command, args, options = {}) {
       if (stderr.length >= 4000) return
       stderr += chunk.toString().slice(0, 4000 - stderr.length)
     })
-    child.on('error', (error) => finish({ ok: false, code: error?.code === 'ENOENT' ? 'ENOENT' : 'error', stdout, stderr }))
+    child.on('error', (error) => {
+      if (timedOut) return
+      finish({ ok: false, code: error?.code === 'ENOENT' ? 'ENOENT' : 'error', stdout, stderr })
+    })
+    const graceMs = options.killGraceMs ?? KILL_GRACE_MS
     timer = setTimeout(() => {
-      try { child.kill('SIGTERM') } catch { /* 超时就停 */ }
-      finish({ ok: false, code: 'timeout' })
+      timedOut = true
+      stopper = stopProcessTree(child, {
+        platform,
+        graceMs,
+        kill: options.kill,
+        taskkill: options.taskkill,
+        group: detached,
+      })
+      if (settled) {
+        stopper.stop()
+        return
+      }
+      graceTimer = setTimeout(() => {
+        const pid = Number(child.pid)
+        const known = Number.isSafeInteger(pid) && pid > 1
+        let leftover = false
+        if (known) {
+          const probe = options.alive || defaultAlive
+          try { leftover = probe(pid) === true } catch { leftover = true }
+        }
+        finish({ ok: false, code: 'timeout', leftover, pid: known ? pid : 0, stdout, stderr })
+      }, graceMs + 50)
     }, options.timeoutMs ?? INSTALL_TIMEOUT_MS)
-    child.on('close', (code) => finish({ ok: code === 0, code: code === 0 ? 0 : 'exit', stdout, stderr }))
+    child.on('close', (code) => {
+      if (timedOut && code === 0) {
+        finish({ ok: true, code: 0, stdout, stderr })
+        return
+      }
+      if (timedOut) {
+        finish({ ok: false, code: 'timeout', leftover: false, stdout, stderr, pid: Number.isSafeInteger(Number(child.pid)) ? Number(child.pid) : 0 })
+        return
+      }
+      finish({ ok: code === 0, code: code === 0 ? 0 : 'exit', stdout, stderr })
+    })
   })
 }
 
-async function defaultRunCommand(spec) {
+/**
+ * 执行 `dsh plugin add`。开始前清掉已经退出的安装记录；记录里的进程还在就不再开一次。
+ * 超时后停掉进程组。记录里如果是另一个还活着的 pid，也停掉，但活着的记录文件留着。
+ * @param {{ packageSpec?: string, tarballPath?: string, platform?: string, profile?: string, profileDir?: string, cwd?: string, env?: NodeJS.ProcessEnv, spawnImpl?: typeof spawn, timeoutMs?: number, killGraceMs?: number, kill?: (target: number, signal: string) => void, alive?: (pid: number) => boolean, taskkill?: (pid: number) => void }} spec
+ */
+export async function runPluginAdd(spec) {
+  const profileDir = typeof spec.profileDir === 'string' ? spec.profileDir : ''
+  const platform = spec.platform || process.platform
+  if (profileDir !== '') {
+    let stale = null
+    try {
+      stale = clearStaleRunRecord(profileDir, { alive: spec.alive })
+    } catch {
+      stale = null
+    }
+    if (stale?.alive) return { ok: false, code: 'busy', pid: stale.pid }
+  }
   const planned = dshPluginAddSpec(spec)
   const ran = await runChild(spec.spawnImpl || spawn, planned.command, planned.args, {
     cwd: spec.cwd || process.cwd(),
     env: spec.env || process.env,
     timeoutMs: spec.timeoutMs ?? INSTALL_TIMEOUT_MS,
     capture: true,
+    detached: platform !== 'win32',
+    platform,
+    kill: spec.kill,
+    alive: spec.alive,
+    taskkill: spec.taskkill,
+    killGraceMs: spec.killGraceMs,
   })
   if (ran.ok) return { ok: true, code: 0 }
+  if (ran.code === 'timeout') {
+    let leftover = ran.leftover === true
+    let pid = ran.pid
+    if (profileDir !== '') {
+      try {
+        const record = parseRunRecord(readFileSync(runRecordPath(profileDir), 'utf8'))
+        if (record && record.pid !== ran.pid) {
+          // 记录里的 grouped 为真时，这个 pid 才是进程组负责人。CLI 安装记的是 false，只停这个进程。
+          stopProcessTree({ pid: record.pid }, {
+            platform,
+            graceMs: 0,
+            kill: spec.kill,
+            taskkill: spec.taskkill,
+            group: record.grouped === true,
+          })
+        }
+      } catch {
+        // 没有留下记录，或记录读不懂。下面再按进程是否还在决定删不删。
+      }
+      try {
+        const again = clearStaleRunRecord(profileDir, { alive: spec.alive })
+        if (again.alive) {
+          leftover = true
+          pid = again.pid
+        }
+      } catch {
+        // 清不掉就按超时说明，不把路径写进给用户的句子。
+      }
+    }
+    return { ok: false, code: 'timeout', leftover, pid }
+  }
+  if (ran.code === 'ENOENT') return { ok: false, code: 'ENOENT' }
   if (spec.packageSpec && isRegistryMiss(ran.stderr)) return { ok: false, code: 'unpublished' }
-  if (ran.code === 'ENOENT' || ran.code === 'timeout') return { ok: false, code: ran.code }
   return { ok: false, code: 'error' }
 }
 
+function defaultRunCommand(spec) {
+  return runPluginAdd(spec)
+}
+
 function readOwnCgroup() {
   try {
     return readFileSync('/proc/self/cgroup', 'utf8')
@@ -1294,46 +1525,75 @@ setTimeout(() => {
 }, delay)
 `.trim()
 
+/** 具体服务挂在 user@UID.service 下面时，重启要走用户实例，不能重启整个登录会话。 */
+function systemdUserManager(text) {
+  return /\/user@\d+\.service(?:\/|$)/.test(String(text ?? ''))
+}
+
+function systemdRunArgs(unit, user) {
+  const scope = user ? ['--user'] : []
+  return [
+    ...scope,
+    '--quiet',
+    '--collect',
+    '--on-active=3s',
+    '--timer-property=AccuracySec=1s',
+    '--',
+    'systemctl',
+    ...scope,
+    'restart',
+    unit,
+  ]
+}
+
+function cgroupText(input) {
+  if (input.cgroup != null) return String(input.cgroup)
+  const read = typeof input.readCgroup === 'function' ? input.readCgroup : readOwnCgroup
+  try {
+    return String(read() ?? '')
+  } catch {
+    return ''
+  }
+}
+
+function reexecPlan(input) {
+  return {
+    mode: 'reexec',
+    execPath: input.execPath || process.execPath,
+    argv: Array.isArray(input.argv) ? input.argv : process.argv.slice(1),
+    pid: input.pid || process.pid,
+    cwd: input.cwd || process.cwd(),
+    delayMs: RESTART_DELAY_MS,
+  }
+}
+
 /**
  * 重启计划。systemd 里只重启 cgroup 里那个具体服务，用 systemd-run 把动作放到服务外面。
- * 认不出单独服务时不重启整个登录会话。其余情况等响应发出后，按当前进程的命令行再拉起一次。
+ * 没传入 cgroup 时读本进程的 /proc/self/cgroup。用户服务加 --user。
+ * 认不出单独服务时计划是 manual：不重启整个登录会话。其余情况按当前进程的命令行再拉起一次。
  */
 export function planPanelRestart(input = {}) {
   const platform = input.platform || process.platform
   const env = input.env || process.env
   const invocation = platform !== 'win32' && Boolean(env && (env.INVOCATION_ID || env.NOTIFY_SOCKET))
-  const unit = invocation ? systemdUnitFromCgroup(input.cgroup ?? '') : null
-  if (invocation && !unit) return { mode: 'manual' }
+  const cgroup = invocation ? cgroupText(input) : ''
+  const unit = invocation ? systemdUnitFromCgroup(cgroup) : null
   if (unit) {
+    const user = systemdUserManager(cgroup)
     return {
       mode: 'systemd',
       command: 'systemd-run',
-      args: ['--quiet', '--collect', '--on-active=3s', '--timer-property=AccuracySec=1s', '--', 'systemctl', 'restart', unit],
+      args: systemdRunArgs(unit, user),
       unit,
+      scope: user ? 'user' : 'system',
     }
   }
-  return {
-    mode: 'reexec',
-    execPath: input.execPath || process.execPath,
-    argv: Array.isArray(input.argv) ? input.argv : process.argv.slice(1),
-    pid: input.pid || process.pid,
-    cwd: input.cwd || process.cwd(),
-    delayMs: RESTART_DELAY_MS,
-  }
+  if (invocation) return { mode: 'manual' }
+  return reexecPlan(input)
 }
 
-/**
- * @param {{ plan?: ReturnType<typeof planPanelRestart>, spawnImpl?: typeof spawn, env?: NodeJS.ProcessEnv, platform?: string, cgroup?: string, execPath?: string, argv?: string[], pid?: number, cwd?: string }} input
- */
-export async function schedulePanelRestart(input = {}) {
-  const plan = input.plan || planPanelRestart(input)
-  if (plan.mode === 'manual') return { ok: false, mode: 'manual', error: restartError() }
+async function spawnReexec(plan, input) {
   const spawnImpl = input.spawnImpl || spawn
-  if (plan.mode === 'systemd') {
-    const ran = await runChild(spawnImpl, plan.command, plan.args, { timeoutMs: 20000, stdio: 'ignore' })
-    if (!ran.ok) return { ok: false, mode: 'systemd', error: restartError() }
-    return { ok: true, mode: 'systemd' }
-  }
   const payload = JSON.stringify({
     pid: plan.pid,
     cwd: plan.cwd,
@@ -1363,11 +1623,208 @@ export async function schedulePanelRestart(input = {}) {
   return { ok: true, mode: 'reexec' }
 }
 
-function successMessage(tag, channel) {
-  const via = channel === 'npm'
-    ? '这次是从 npm 装的。'
-    : '这一版在 npm 上还没有，所以从 GitHub 装上。'
-  return `已经装上 ${tag}，面板即将重启。请刷新页面；登录口令可能会变，用新的面板地址再打开。${via}现有设置还在，没有改动 NapCat。`
+/**
+ * 先按计划重启。systemd-run 失败，或认不出单独服务时，改为重启当前进程，不重启整个登录。
+ * 两条都做不到才返回失败。
+ * @param {{ plan?: ReturnType<typeof planPanelRestart>, spawnImpl?: typeof spawn, env?: NodeJS.ProcessEnv, platform?: string, cgroup?: string, readCgroup?: () => string, execPath?: string, argv?: string[], pid?: number, cwd?: string }} input
+ */
+export async function schedulePanelRestart(input = {}) {
+  const plan = input.plan || planPanelRestart(input)
+  const spawnImpl = input.spawnImpl || spawn
+  if (plan.mode === 'systemd') {
+    const ran = await runChild(spawnImpl, plan.command, plan.args, { timeoutMs: 20000, stdio: 'ignore' })
+    if (ran.ok) return { ok: true, mode: 'systemd', unit: plan.unit, scope: plan.scope }
+    const fallback = await spawnReexec(reexecPlan(input), { ...input, spawnImpl })
+    if (fallback.ok) return fallback
+    return { ok: false, mode: 'manual', error: restartError() }
+  }
+  if (plan.mode === 'manual') {
+    const fallback = await spawnReexec(reexecPlan(input), { ...input, spawnImpl })
+    if (fallback.ok) return fallback
+    return { ok: false, mode: 'manual', error: restartError() }
+  }
+  return spawnReexec(plan, { ...input, spawnImpl })
+}
+
+const CORDIS_ID = 'qq-bridge'
+
+function isWritablePackageName(name) {
+  return name === PACKAGE_NAME || name === LEGACY_UNSCOPED_NAME || name === 'dsh-qq-bridge'
+}
+
+/** profile 目录。profile 名只接受 dsh 自己的那一档，避免把 `..` 拼进路径。 */
+export function profileDirectory(home, profile = 'web') {
+  const root = String(home ?? '')
+  if (root === '' || root.includes('\0')) return ''
+  const name = String(profile || 'web')
+  if (!/^[a-z][a-z0-9_-]{0,31}$/.test(name)) return ''
+  return join(root, 'profiles', name)
+}
+
+function profileDirOf(input) {
+  if (input && typeof input.profileDir === 'string' && input.profileDir !== '') return input.profileDir
+  if (input && typeof input.home === 'string' && input.home !== '') return profileDirectory(input.home, input.profile || 'web')
+  return ''
+}
+
+function bundlePatchPath(dir, manifest) {
+  const raw = manifest?.dsh?.bundle?.patch
+  const rel = typeof raw === 'string' && raw !== '' ? raw : 'cordis.patch.yml'
+  if (isAbsolute(rel) || rel.split(/[\\/]/).includes('..')) return ''
+  return join(dir, rel)
+}
+
+function readInstalledManifest(dir) {
+  let manifest
+  try {
+    manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'))
+  } catch {
+    return null
+  }
+  if (!manifest || typeof manifest !== 'object' || !isWritablePackageName(manifest.name)) return null
+  return {
+    dir,
+    name: manifest.name,
+    version: String(manifest.version ?? ''),
+    patchFile: bundlePatchPath(dir, manifest),
+  }
+}
+
+/**
+ * 只改 `qq-bridge` 这一行的 `name`。config 和别的插件保持原样，包括注释和空行。
+ * 只认我们自己的三个包名；别人写的路径或别的包不动。
+ * @param {string} text
+ * @param {string} packageName
+ * @param {string} [pluginId]
+ */
+export function rewriteCordisPackageName(text, packageName, pluginId = CORDIS_ID) {
+  const source = String(text ?? '')
+  if (!isWritablePackageName(packageName) || !/^[A-Za-z0-9_-]+$/.test(pluginId)) return { text: source, changed: false }
+  const newline = source.includes('\r\n') ? '\r\n' : '\n'
+  const endsWithNewline = /\n$/.test(source)
+  const lines = source.split(/\r?\n/)
+  if (endsWithNewline && lines[lines.length - 1] === '') lines.pop()
+  let changed = false
+  for (let i = 0; i < lines.length; i++) {
+    const idMatch = lines[i].match(/^(\s*)(?:-\s+)?id:\s*(['"]?)([A-Za-z0-9_-]+)\2\s*(#.*)?$/)
+    if (!idMatch || idMatch[3] !== pluginId) continue
+    const entryIndent = idMatch[1].length
+    let keyIndent = -1
+    for (let j = i + 1; j < lines.length; j++) {
+      const line = lines[j]
+      if (line.includes('\t')) break
+      if (line.trim() === '' || /^\s*#/.test(line)) continue
+      const indent = line.match(/^ */)?.[0].length ?? 0
+      if (indent <= entryIndent) break
+      if (keyIndent < 0) keyIndent = indent
+      if (indent !== keyIndent) continue
+      if (!/^\s*name:/.test(line)) continue
+      const nameMatch = line.match(/^(\s*)name:\s*(['"]?)([^'"\s#]+)\2\s*(#.*)?$/)
+      if (!nameMatch) break
+      const current = nameMatch[3]
+      if (isWritablePackageName(current) && current !== packageName) {
+        const comment = nameMatch[4] ? ` ${nameMatch[4]}` : ''
+        lines[j] = `${nameMatch[1]}name: '${packageName}'${comment}`
+        changed = true
+      }
+      break
+    }
+  }
+  if (!changed) return { text: source, changed: false }
+  let next = lines.join(newline)
+  if (endsWithNewline) next += newline
+  return { text: next, changed: true }
+}
+
+function writeTextAtomic(file, text) {
+  const tmp = `${file}.tmp-${process.pid}`
+  writeFileSync(tmp, text)
+  try {
+    chmodSync(tmp, statSync(file).mode)
+  } catch {
+    // 读不到原权限就按这次写入的默认权限留下。
+  }
+  try {
+    renameSync(tmp, file)
+  } catch (error) {
+    try { rmSync(tmp, { force: true }) } catch { /* 临时文件清不掉时，仍把写入失败抛回去 */ }
+    throw error
+  }
+}
+
+/**
+ * 把 profile、home（有这份文件才改）和已安装插件自己的补丁里，
+ * `qq-bridge` 的 `name` 改成磁盘上 package.json 的包名。
+ * 传入 expectedVersion 时，只有版本对得上才改，避免把半截安装写成错误的包名。
+ * @param {{ profileDir?: string, home?: string, expectedVersion?: string }} input
+ */
+export function alignCordisNames(input = {}) {
+  const profileDir = String(input.profileDir ?? '')
+  if (profileDir === '') return { ok: false, reason: 'no-profile', changed: [], name: '' }
+  const scoped = readInstalledManifest(join(profileDir, 'node_modules', '@fengye_nobug', 'dsh-qq-bot'))
+  const legacy = readInstalledManifest(join(profileDir, 'node_modules', 'dsh-qq-bot'))
+  const candidates = [scoped, legacy].filter(Boolean)
+  let installed = null
+  if (input.expectedVersion) {
+    installed = candidates.find((item) => compareSemver(item.version, input.expectedVersion) === 0) || null
+    if (!installed) return { ok: false, reason: 'version', changed: [], name: '' }
+  } else {
+    installed = scoped || legacy
+  }
+  if (!installed) return { ok: false, reason: 'missing', changed: [], name: '' }
+  const files = []
+  if (installed.patchFile) files.push(installed.patchFile)
+  files.push(join(profileDir, 'cordis.patch.yml'))
+  if (typeof input.home === 'string' && input.home !== '') files.push(join(input.home, 'cordis.patch.yml'))
+  const changed = []
+  let failed = false
+  for (const file of files) {
+    let text
+    try {
+      text = readFileSync(file, 'utf8')
+    } catch {
+      continue
+    }
+    const next = rewriteCordisPackageName(text, installed.name)
+    if (!next.changed) continue
+    try {
+      writeTextAtomic(file, next.text)
+      changed.push(file)
+    } catch {
+      failed = true
+    }
+  }
+  return {
+    ok: !failed,
+    failed,
+    reason: failed ? 'write' : 'ok',
+    changed,
+    name: installed.name,
+    version: installed.version,
+  }
+}
+
+function alignNote(input, expectedVersion) {
+  const profileDir = profileDirOf(input)
+  if (profileDir === '') return ''
+  try {
+    const result = alignCordisNames({
+      profileDir,
+      home: typeof input?.home === 'string' ? input.home : '',
+      expectedVersion,
+    })
+    if (result.failed) return '没能改 Cordis 的包名。若重启后设置页打不开，把 qq-bridge 的 name 改成实际安装的包名再重启。'
+    if (result.changed.length > 0) return `Cordis 里 qq-bridge 的包名已经改成实际安装的 ${result.name}。`
+    return ''
+  } catch {
+    return '没能改 Cordis 的包名。若重启后设置页打不开，把 qq-bridge 的 name 改成实际安装的包名再重启。'
+  }
+}
+
+function successMessage(tag, channel, note = '') {
+  const via = channel === 'npm' ? 'npm' : 'GitHub'
+  const base = `已经从 ${via} 装上 ${tag}，面板即将重启。`
+  return note ? `${base}${note}` : base
 }
 
 function shownInstall(channel, version, repo) {
@@ -1375,6 +1832,59 @@ function shownInstall(channel, version, repo) {
   return { install: installSpec(version, repo), command: installCommand(version, repo) }
 }
 
+function installRunSpec(input, extra) {
+  return {
+    ...extra,
+    platform: input.platform,
+    profile: input.profile || 'web',
+    profileDir: profileDirOf(input),
+    spawnImpl: input.spawnImpl,
+    timeoutMs: input.timeoutMs,
+    killGraceMs: input.killGraceMs,
+    kill: input.kill,
+    alive: input.alive,
+    taskkill: input.taskkill,
+  }
+}
+
+/** 磁盘上的已安装包是不是这次要装的版本。只读 package.json，不改文件。 */
+function installedMatches(input, version) {
+  const profileDir = profileDirOf(input)
+  if (profileDir === '' || !version) return false
+  const scoped = readInstalledManifest(join(profileDir, 'node_modules', '@fengye_nobug', 'dsh-qq-bot'))
+  const legacy = readInstalledManifest(join(profileDir, 'node_modules', 'dsh-qq-bot'))
+  return [scoped, legacy].some((item) => item && compareSemver(item.version, version) === 0)
+}
+
+/**
+ * 安装命令没返回成功时：进程已经停干净，并且磁盘上已经是目标版本，就改包名并安排重启。
+ * 进程还在，或版本对不上，不重启。
+ */
+async function failInstall(input, decision, ran, command, install, channel) {
+  const code = ran?.code
+  const leftover = ran?.leftover === true
+  const via = channel === 'npm' || channel === 'github' ? channel : decision.channel
+  if (!leftover && (code === 'timeout' || code === 'exit' || code === 'error') && installedMatches(input, decision.version)) {
+    return finishApply(
+      input,
+      { ...decision, command: command || decision.command, install: install || decision.install },
+      via === 'npm' ? 'npm' : 'github',
+    )
+  }
+  const message = installError(code, command, { leftover, pid: ran?.pid })
+  return {
+    ok: false,
+    stage: 'install',
+    current: decision.current,
+    error: message,
+    message,
+    tag: decision.tag,
+    version: decision.version,
+    command,
+    install: install || decision.install,
+  }
+}
+
 /**
  * 下载并安装一次检查允许的版本，然后安排重启。
  * 调用方要自己做登录校验。这里不读设置文件，也不碰 NapCat。
@@ -1405,36 +1915,26 @@ export async function applyPluginUpdate(input = {}) {
       updateAvailable: false,
     }
   }
+  const profileDir = profileDirOf(input)
+  if (profileDir !== '') {
+    try {
+      const stale = clearStaleRunRecord(profileDir, { alive: input.alive })
+      if (stale.alive) return failInstall(input, decision, { ok: false, code: 'busy', pid: stale.pid }, decision.command, decision.install)
+    } catch {
+      // 记录读不出来就继续，安装命令自己会再看一遍。
+    }
+  }
   let channel = decision.channel
   if (channel === 'npm') {
     let ran
     try {
       const run = input.runCommand || defaultRunCommand
-      ran = await run({
-        packageSpec: decision.install,
-        platform: input.platform,
-        profile: 'web',
-        spawnImpl: input.spawnImpl,
-        timeoutMs: input.timeoutMs,
-      })
+      ran = await run(installRunSpec(input, { packageSpec: decision.install }))
     } catch {
       ran = { ok: false, code: 'error' }
     }
     if (ran?.ok === true) return finishApply(input, decision, 'npm')
-    if (ran?.code !== 'unpublished') {
-      const message = installError(ran?.code, decision.command)
-      return {
-        ok: false,
-        stage: 'install',
-        current: decision.current,
-        error: message,
-        message,
-        tag: decision.tag,
-        version: decision.version,
-        command: decision.command,
-        install: decision.install,
-      }
-    }
+    if (ran?.code !== 'unpublished') return failInstall(input, decision, ran, decision.command, decision.install, 'npm')
     channel = 'github'
   }
   const shown = shownInstall(channel, decision.version, repo)
@@ -1469,35 +1969,39 @@ export async function applyPluginUpdate(input = {}) {
   try {
     writeFileSync(tarballPath, packed)
     const run = input.runCommand || defaultRunCommand
-    ran = await run({
-      tarballPath,
-      platform: input.platform,
-      profile: 'web',
-      spawnImpl: input.spawnImpl,
-      timeoutMs: input.timeoutMs,
-    })
+    ran = await run(installRunSpec(input, { tarballPath }))
   } catch {
     ran = { ok: false, code: 'error' }
   } finally {
     rmSync(dir, { recursive: true, force: true })
   }
   if (!ran || ran.ok !== true) {
-    const message = installError(ran?.code, shown.command)
-    return { ok: false, stage: 'install', current: decision.current, error: message, message, tag: decision.tag, version: decision.version, command: shown.command, install: shown.install }
+    return failInstall(input, { ...decision, install: shown.install, command: shown.command }, ran, shown.command, shown.install, 'github')
   }
   return finishApply(input, { ...decision, install: shown.install, command: shown.command }, 'github')
 }
 
 async function finishApply(input, decision, channel) {
+  const note = alignNote(input)
   let restart
   try {
     const schedule = input.scheduleRestart || schedulePanelRestart
-    restart = await schedule({ spawnImpl: input.spawnImpl, platform: input.platform })
+    restart = await schedule({
+      spawnImpl: input.spawnImpl,
+      platform: input.platform,
+      env: input.env,
+      cgroup: input.cgroup,
+      readCgroup: input.readCgroup,
+      execPath: input.execPath,
+      argv: input.argv,
+      pid: input.pid,
+      cwd: input.cwd,
+    })
   } catch {
     restart = { ok: false, error: restartError() }
   }
   if (!restart || restart.ok !== true) {
-    const message = restart?.error || restartError()
+    const message = `${restartError(channel)}${note}`
     return {
       ok: false,
       stage: 'restart',
@@ -1512,7 +2016,7 @@ async function finishApply(input, decision, channel) {
       message,
     }
   }
-  const message = successMessage(decision.tag, channel)
+  const message = successMessage(decision.tag, channel, note)
   return {
     ok: true,
     applied: true,