dsh-task-watcher-plugin

dsh-task-watcher-plugin

DSH 任务监视器插件（薄壳）——把 DshTaskWatcher
（独立 Windows 托盘监视程序）打进插件包：安装即部署到 %LOCALAPPDATA%\DshTaskWatcher
并拉起托盘，无需再从 GitHub 下载安装包。

形态

• Host + Web 双半端：host 负责部署/拉起/管理路由；浏览器半端在
  设置 → 插件 → 任务监视器 提供状态显示与启停开关（10s 轮询、中英双语）
• 脱离宿主进程：CREATE_NO_WINDOW 直起 powershell（无终端窗口）、无 job 绑定——DSH 重启不影响托盘常驻
• 独立生命周期：桌面快捷方式启动、托盘右键退出照常可用；插件停用/卸载不杀运行中的监视器
• 停止意图记忆：托盘退出或开关停止后写 stopped.flag，DSH 重启不会自动拉回（崩溃/强杀仍允许自动恢复）
• 单实例互斥：监视器内置 mutex，与手动安装并存也不会双托盘
• 零依赖零构建：lib/ 纯手写 ESM，assets 为运行时载荷

管理 API（仅 loopback POST）

路由	作用
/api/dsh-task-watcher/status	运行状态 / pid / 已部署版本
/api/dsh-task-watcher/start	部署（增量覆盖，config.json 只在缺失时写入）+ 拉起托盘
/api/dsh-task-watcher/stop	停止托盘（只匹配 -File <路径>DshTaskWatcher.ps1 启动形态，绝不误伤提及该文件名的其他进程）

宿主启动时：已有部署但未运行 → 自动拉起；全新安装不擅自部署（首次显式 start 才落盘）。

安装

方式一（推荐，npm 源）：

dsh plugin --profile web add @yeqingtang/dsh-task-watcher-plugin

方式二（GitHub 源）：

dsh plugin --profile web add github:YeqingTang/dsh-task-watcher-plugin

重启 web 服务后生效。

已知坑（实现记录）

• node spawn 旗标互斥：detached:true（DETACHED_PROCESS）与 windowsHide:true
  （CREATE_NO_WINDOW）组合会让 CreateProcess 静默失败（异步 error 事件无输出、pid 照常分配，
  极难排查）。Windows 下普通 spawn 的子进程本就能活得比父进程久，直接去掉 detached 即可。
• stop 误杀面：进程匹配必须锚定 -File\s+\S*DshTaskWatcher[.]ps1 启动形态；宽松匹配
  （仅文件名）会杀掉任何命令行里提到该文件的进程（编辑器、Get-Content、测试壳）。

升级监视器

插件包 assets 随 git/npm 更新；start 前会增量覆盖部署（config.json 用户文件只在缺失时写入）。