dsh-quick-restart 0.1.2 → 0.1.4

package/README.md

@@ -2,69 +2,92 @@
 
 ![标题栏上的「重载插件」与「重启」按钮](images/titlebar.png)
 
-给 **DeepSeek Harness（DSH）** 标题栏加两个按钮：**重载插件代码**（不用关程序）和 **重启 DSH**。
+给 **DeepSeek Harness（DSH）** 标题栏加两个按钮：**重载插件**、**重启 DSH**。
 
-> 中文为主，末尾有简短的 English 说明。
+平时改插件代码要「完全退出客户端再打开」才生效。有了这两个按钮，大部分情况点一下就够。
 
-## 它解决什么问题
+## 「重载插件」到底是什么
 
-DSH 的第三方插件改了代码之后，默认要**完全退出再打开**才生效（刷新页面没用，热重载也不会自动发生）。
-这个插件在标题栏菜单栏加两个按钮，把这件事变成点一下：
+先说清楚一件事：**DSH 的插件不是独立程序。**
 
-- **重载** —— 只重新加载第三方插件，主进程和会话都不动，实测 8/8 成功；
-- **重启** —— 关掉并重开 DSH（需要另外安装 [`dsh-hot-restart`](https://github.com/InariNGT-Ofiicial/dsh-hot-restart) 提供重启引擎，没装就只有"重载"可用）。
+它没有自己的 exe、没有自己的进程，而是**跑在 DSH 主进程里的一个模块**——跟主程序挤在同一个进程里。所以严格说，没有「插件程序」可以启动或停止。
+
+**「重载」做的事**：在 DSH 还开着的前提下，把这个插件模块的缓存清掉、重新加载一次、替换掉旧的那一份。效果等于「插件这一块被拆开重建了一遍」。
+
+**重载之后，下面这些全都不变**：
+
+| | 重载后 |
+|---|---|
+| DSH 主程序 | 还在跑，没退出 |
+| 当前对话、上下文 | 全都在 |
+| 窗口、界面 | 不动 |
+| 本地端口 | 不变（重启才会变） |
+| 耗时 | 1～2 秒 |
+
+**什么时候该点它**：你改的是插件的**服务端代码**（那些 apply()、路由、定时任务），想立刻生效又不想关程序。
+
+**什么时候它不管用**（这两点最容易被误会）：
+
+- 改的是插件的**前端界面**（client.js、样式、按钮）→ 重载只管服务端，界面还是旧的。按一下 Ctrl + R 刷新窗口即可，不用重启。
+- 改的是 DSH 自己的**内置插件**（@deepseek-ai/*）→ 它们在安装包的 app.asar 里，只能靠重启。
+
+它重载的是**第三方插件**（你从市场装的、自己写的那些），逐个报结果；失败时鼠标悬停在按钮上能看到是哪个包、什么错误。
+
+## 「重启」是另一件事
+
+重启 = 把 DSH 整个关掉再打开。耗时十几秒，**本地端口会变**（连着的 QQ 桥接之类要重连）。装新插件、换了前端、动了内置插件，才需要它。
+
+> 重启的引擎用的是 dsh-hot-restart（作者 xiaolu511，MIT）。它已经作为**依赖内置**在这个包里，你不需要另外安装。
 
 ## 安装
 
 **方式一：DSH 插件市场**（推荐）
 
-设置 → 插件 → 搜索 `dsh-quick-restart` → 安装 → **完全退出 DSH 再打开**（按钮要宿主启动时注入，刷新页面没用）。
+设置 → 插件 → 搜索 dsh-quick-restart → 安装 → **完全退出 DSH 再打开**（按钮是宿主启动时注入的，刷新页面出不来）。
 
 **方式二：命令行 / 直链**
 
-```bash
-npm i dsh-quick-restart
-```
+    npm i dsh-quick-restart
 
 或把下面这个地址填进 DSH 的插件安装入口：
 
-```
-https://registry.npmjs.org/dsh-quick-restart/-/dsh-quick-restart-0.1.2.tgz
-```
-
+    https://registry.npmjs.org/dsh-quick-restart/-/dsh-quick-restart-0.1.4.tgz
 
 ## 用起来什么效果
 
-标题栏菜单栏（文件/编辑那一条的右侧）多出两个小按钮：**重载**、**重启**。
-点"重载"后，按钮会短暂显示结果；如果有插件重载失败，鼠标悬停能看到是哪个包、什么错误。
+标题栏菜单栏（文件 / 编辑那一条的右侧）多出两个小按钮：**重载插件**、**重启**。
+
+点「重载插件」后按钮会短暂显示结果（成功几个、失败几个）；点「重启」会先弹一句确认，然后程序关闭并自动重开。
 
 ## 边界（老实说）
 
-- **只重载第三方插件**。`@deepseek-ai/*`（宿主内置，在 app.asar 里）和 `cordis:*`（虚拟分组）会被跳过——碰它们必然失败。
-- **前端 bundle 不会跟着换**。插件如果带前端界面，重载后界面那段还是旧的，得重启程序。这是宿主机制，不是本插件的问题。
-- **重启按钮依赖 `dsh-hot-restart`**。没装也能用"重载"，只是重启那颗点了没反应。
-- 仅测试于 **Windows 桌面版**。其他平台未验证。
+- **只重载第三方插件**。@deepseek-ai/*（宿主内置，在 app.asar 里）和 cordis:*（虚拟分组条目）会被跳过，碰它们必然失败。
+- **前端 bundle 不跟着换**，见上面「什么时候它不管用」。
+- **插件自己 spawn 的子进程不受影响**。重载只管插件模块本体，插件另起的进程（比如重启助手的 vbs）不会被回收，也不会重载。
+- **重启只在 Windows 桌面版验证过**；重载是纯 JS，理论上平台无关，但未实测。
 
 ## 卸载
 
-```bash
-pnpm remove dsh-quick-restart
-```
-再从 `dsh.profile.bundles` 里删掉对应条目，重启 DSH。
+    pnpm remove dsh-quick-restart
+
+再从 dsh.profile.bundles 里删掉对应条目，重启 DSH。
 
 ## 它是怎么做的（给好奇的人）
 
-桌面壳的 `index.html` 直接读安装包里的静态 dist，不走 `renderIndex`，所以 `webServer.tapIndex` 无效。
-唯一可用的通道是宿主启动时**一次性收集**的 `webserver/index-inject` 注入表——所以插件里不能写对象级 `inject = ['webServer']`，
-否则 `apply()` 会推迟到 webServer 就绪之后，错过那次收集，界面上永远看不到按钮。这一点已在代码注释里写明。
+桌面壳的 index.html 直接读安装包里的静态 dist，不走 renderIndex，所以 webServer.tapIndex 无效。唯一可用的通道是宿主启动时**一次性收集**的 webserver/index-inject 注入表——所以插件里不能写对象级 inject = ["webServer"]，否则 apply() 会推迟到 webServer 就绪之后，错过那次收集，界面上永远看不到按钮。
+
+重载本身是：取 loader 的 entries → 清掉该包在 loader.internal.loadCache 里的模块 → 重新 import → 用新插件替换旧的 fiber。
 
-重载本身是：取 loader 的 entries → 清掉该包在 `loader.internal.loadCache` 里的模块 → 重新 import → 用新插件替换旧的 fiber。
+重启是调用 dsh-hot-restart 的 apply()（作为依赖装在同一个包里），由它的 vbs 助手完成脱离进程树的重开。
 
 ## English (short)
 
-**dsh-quick-restart** adds two titlebar buttons to DeepSeek Harness: **reload** third-party plugins without restarting the app, and **restart** DSH
-(the latter requires `dsh-hot-restart`). Built-in `@deepseek-ai/*` plugins and front-end bundles are intentionally not hot-reloaded — that's a host limitation.
-Tested on Windows desktop only. MIT licensed.
+**dsh-quick-restart** adds two titlebar buttons to DeepSeek Harness.
+
+- **Reload**: re-imports third-party plugins **inside the running host process**. The main process, your conversation, the window and the port all stay as they are. It only replaces server-side plugin modules — front-end changes still need a window refresh (Ctrl+R), and built-in @deepseek-ai/* plugins are skipped.
+- **Restart**: fully quits and relaunches DSH, using the dsh-hot-restart engine (bundled as a dependency, nothing extra to install).
+
+Windows desktop only for the restart path. MIT licensed.
 
 ## License
 

package/lib/index.js

@@ -11,6 +11,24 @@ import { existsSync, readFileSync } from 'node:fs'
 
 export const name = 'dsh-quick-restart'
 
+// 把 dsh-hot-restart 当作内置引擎：它是本包的依赖，直接 import 后调用它的 apply。
+// 这样用户只装 dsh-quick-restart 一个包，「重启」就能用；
+// 如果用户另外也装了 dsh-hot-restart，路由可能重复注册，这里忽略冲突即可。
+async function embedHotRestart(ctx, log) {
+  try {
+    const mod = await import('dsh-hot-restart')
+    const plugin = (mod && mod.default) || mod
+    const apply = plugin && (plugin.apply || (plugin.default && plugin.default.apply))
+    if (typeof apply !== 'function') { log('内置重启引擎没有 apply，跳过'); return false }
+    await apply(ctx)
+    log('内置重启引擎（dsh-hot-restart）已启动')
+    return true
+  } catch (e) {
+    log('内置重启引擎加载失败（重启按钮会不可用）: ' + String((e && e.message) || e))
+    return false
+  }
+}
+
 const HERE = dirname(fileURLToPath(import.meta.url))
 const SELF = 'dsh-quick-restart'
 const CLIENT_ROUTE = '/dsh-quick-restart/client.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-restart",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "description": "DeepSeek Harness 插件：标题栏加两个按钮——重载第三方插件（不用重启宿主）、重启 DSH。",
   "keywords": [
@@ -40,5 +40,8 @@
   "bugs": {
     "url": "https://github.com/a994903574/dsh-quick-restart/issues"
   },
-  "author": "a994903574"
+  "author": "a994903574",
+  "dependencies": {
+    "dsh-hot-restart": "^0.3.16"
+  }
 }