dsh-reload 1.0.0 → 1.0.1

package/README.md

@@ -23,18 +23,55 @@
 
 - ⚡ **点一下，改动就生效。** 重新加载文件有改动的插件，**不重启进程、不中断会话**，聊天记录和正在做的事都还在。
 - 🔄 **需要时也能重启。** 有些改动（改 `package.json`、换依赖）必须整机重启，本插件也能一键完成，关掉后自动重新打开。
-- 🛡️ **有任务在跑就不让重启。** 先检查是否有会话、后台任务或终端在运行，有就明确拒绝并列出是哪些，不会让你误丢工作。
+- 🛡️ **会话或后台任务在跑就不让重启。** 它们跑在 Host 里，重启必然中断，所以直接拒绝并列出是哪些，不会让你误丢工作。**终端不算拦截条件** —— 无头终端、卡死的终端都很常见，硬拦会让你卡在「关不掉也重启不了」的死角，只能强杀进程；所以只把终端列出来提醒，你确认就放行。
 - 🤖 **智能体也能触发。** 内置 `dsh_hot_reload` 工具，改完代码让 AI 自己重载，不用你动手。
 
+## 🎯 三条设计原则
+
+这个插件刻意做得很薄。三类决定贯穿全部代码：
+
+### 1. 走官方路径，不生造分支
+
+重载直接调用宿主的 `hmr.reconcileProfile()` —— 就是 DSH 自己重载插件用的那条路径。
+
+有些同类插件会自己清 ESM/CJS 模块缓存、手动 dispose fiber、再重新 apply。那套序列很脆弱：顺序错一步，Loader 就会把插件写成 `disabled: true` 并**持久化到你的配置里**。本插件不重写这套逻辑，因此也不会以新的方式出错。
+
+**不需要「指定插件」这个参数。** 该重载什么是文件系统的事实，不是模型需要判断的事 —— 宿主比对文件身份，把所有陈旧的模块一次带上，并沿 import 图把共享了改动依赖的插件一起刷新。让调用方点名，反而多出一个「猜错名字、漏掉半个依赖树」的失败模式。
+
+所以：宿主怎么保证自己的 HMR 可靠，本插件就怎么可靠。
+
+### 2. 不污染模型上下文
+
+插件对 AI 的影响只有**一个工具**：
+
+| 项 | 本插件 |
+|---|---|
+| 系统提示注入（`systemPrompt.section` / `context`） | **0** |
+| agent 上下文注入（`agent.inject`） | **0** |
+| 注册的 skill | **0** |
+| 工具数量 | **1** |
+| 工具描述长度 | 349 字符 / 约 97 token |
+| 工具参数 | **无**（JSON Schema 为空对象） |
+
+同类插件常带 `action` / `target` / `reason` 等参数。本插件一个都不要 —— 该重载什么由文件系统决定，不需要模型判断，也就不存在「模型猜错插件名」这个失败模式。
+
+**你的对话上下文里，这个插件只占一个工具位。**
+
+### 3. 默认不占界面
+
+装好后界面上什么都不会多出来。侧边栏按钮、右下角悬浮按钮**默认关闭**，需要时自己去插件页打开。
+
+设置面板顶栏的两个按钮是唯一常驻入口 —— 因为它们是「随时能点到」的兜底，且不占正文空间。
+
 ## 📸 界面
 
 插件自己的设置页，两个按钮加两个开关：
 
-![插件设置页：热重载与重启客户端按钮，以及侧边栏按钮、右下角悬浮按钮的显示开关](assets/plugin-page.png)
+![插件设置页：热重载与重启客户端按钮，以及侧边栏按钮、右下角悬浮按钮的显示开关](https://raw.githubusercontent.com/daimingxing/dsh-reload/main/assets/plugin-page.png)
 
 打开设置面板时，顶栏右侧始终有这两个按钮，任何设置页都能点到：
 
-![设置面板顶栏右侧的热重载与重启客户端按钮](assets/settings-header.png)
+![设置面板顶栏右侧的热重载与重启客户端按钮](https://raw.githubusercontent.com/daimingxing/dsh-reload/main/assets/settings-header.png)
 
 > 插件默认**不往界面上加任何东西**，需要侧边栏按钮或右下角悬浮按钮时，自己去插件页打开开关。
 

package/client.js

@@ -84,6 +84,7 @@ window.__ModuleLoader__.load({
       'modal.ok': '知道了',
       'modal.confirmTitle': '重启客户端？',
       'modal.confirmDesc': 'DSH 会关闭并自动重新打开。当前没有任务在运行。重启期间窗口会短暂消失。',
+      'modal.confirmTerminalsDesc': 'DSH 会关闭并自动重新打开。下面这些终端会一起关掉——如果里面还有进程在跑，它们会被中断。会话和后台任务才是阻止重启的原因，终端不会。',
       'modal.confirmCancel': '取消',
       'modal.confirmOk': '重启客户端',
       'modal.restarting': '正在重启 DSH…',
@@ -125,6 +126,7 @@ window.__ModuleLoader__.load({
       'modal.ok': 'Got it',
       'modal.confirmTitle': 'Restart the app?',
       'modal.confirmDesc': 'DSH will close and reopen automatically. No tasks are running. The window disappears briefly.',
+      'modal.confirmTerminalsDesc': 'DSH will close and reopen automatically. These terminals close with it - anything still running inside them is cut off. Terminals alone never block a restart; sessions and background jobs do.',
       'modal.confirmCancel': 'Cancel',
       'modal.confirmOk': 'Restart app',
       'modal.restarting': 'Restarting DSH…',
@@ -568,8 +570,15 @@ window.__ModuleLoader__.load({
     /**
      * 点「重启客户端」的第一步：查状态，决定弹提示框还是确认框。
      *
-     * 有任务 → 只读提示框（**没有重启选项**），安全优先；
-     * 无任务 → 确认框，用户确认后才真正执行。
+     * 三种情况，分流依据是**重启会不会毁掉用户看不见的工作**：
+     *
+     *  - 会话或后台任务在跑 → 只读提示框（**没有重启选项**）。它们跑在
+     *    Host 里，重启必然中断，用户还没法从界面上看出「断在半路」的状态。
+     *  - 只有终端开着 → 确认框，**并把终端列出来**。终端不参与 `active`
+     *    判定（见 lib/activity.js）：无头终端、已卡死的终端都很常见，把它
+     *    当成硬拦截会让用户卡在「关不掉也重启不了」的死角，只能强杀进程
+     *    —— 那比重启更糟。所以改成「说清楚会关掉哪些，你确认就放行」。
+     *  - 什么都没有 → 普通确认框。
      */
     async function beginRestart(openModal) {
       if (state.reloading || state.restarting) return
@@ -587,6 +596,12 @@ window.__ModuleLoader__.load({
           openModal({ kind: 'busy', activity: status.activity })
           return
         }
+        // 终端只提醒、不拦截：把它们交给确认框展示。
+        const terminals = status.activity?.terminals ?? []
+        if (terminals.length > 0) {
+          openModal({ kind: 'confirm', activity: status.activity })
+          return
+        }
         openModal({ kind: 'confirm' })
       } catch (error) {
         showToast(currentT('toast.statusFailed').replace('{message}', String(error?.message ?? error)), true)
@@ -652,7 +667,16 @@ window.__ModuleLoader__.load({
       }, [onClose])
 
       const title = spec.kind === 'busy' ? t('modal.busyTitle') : isConfirm ? t('modal.confirmTitle') : spec.title
-      const desc = spec.kind === 'busy' ? t('modal.busyDesc') : isConfirm ? t('modal.confirmDesc') : spec.desc
+      // 确认框带 activity 时，说明「只有终端在开着」：换个说法，别再说
+      // 「当前没有任务在运行」——那句话在终端可见的情况下是自相矛盾的。
+      const hasTerminals = isConfirm && (spec.activity?.terminals?.length ?? 0) > 0
+      const desc = spec.kind === 'busy'
+        ? t('modal.busyDesc')
+        : hasTerminals
+          ? t('modal.confirmTerminalsDesc')
+          : isConfirm
+            ? t('modal.confirmDesc')
+            : spec.desc
 
       const children = [
         h('div', { className: 'dshr-modal-head', key: 'head' }, title),
@@ -660,7 +684,10 @@ window.__ModuleLoader__.load({
           'div',
           { className: 'dshr-modal-body', key: 'body' },
           h('div', { className: 'dshr-modal-desc' }, desc),
-          spec.kind === 'busy' ? h(TaskList, { activity: spec.activity, t }) : null,
+          // 提示框列出「谁在拦」，终端确认框列出「哪些会被一起关掉」。
+          spec.kind === 'busy' || hasTerminals
+            ? h(TaskList, { activity: spec.activity, t })
+            : null,
         ),
         h(
           'div',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reload",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Hot-reload changed DeepSeek Harness plugins and optionally restart the desktop client, without opening and closing DSH by hand.",
   "type": "module",
   "main": "index.js",
@@ -21,9 +21,7 @@
     "lib",
     "cordis.patch.yml",
     "locale/*.json",
-    "icon.svg",
-    "README.md",
-    "LICENSE"
+    "icon.svg"
   ],
   "keywords": [
     "dsh",