KhaosGx/dsh-stop-service

dsh-stop-service

DeepSeek Harness (DSH) Web 设置页的「服务控制」分区：实时服务信息 + 带确认的优雅终止按钮，告别后台孤儿进程。

功能

- 实时服务信息：进程 PID、启动时间、运行时长、活跃会话数（不含子代理，运行中任务单独标注）、内存占用、CPU 占用、Node / DSH 宿主 / 插件版本、平台——每 5 秒自动刷新；内存/CPU 趋势迷你图支持 3 分钟 / 15 分钟 / 1 小时窗口，样本经 localStorage 持久化（约 1 小时容量，刷新页面不丢）；CPU ≥ 80% 或内存 ≥ 1024 MB 时对应行高亮警示；底部可折叠的已加载插件清单（含安装版本，link 安装有标记）
- 更新提醒：面板顶部对比 npm registry 最新版，DSH 宿主或插件有新版时提示，可一键复制升级命令、跳转 npm 页面 / GitHub Releases（浏览器端直查 registry，宿主不外联）
- 复制诊断信息：一键复制版本与运行状态摘要，提 issue 时直接粘贴
- 连接状态提示：宿主失联时面板顶部显示数据快照年龄警示（本页发起的停止不误报），不再静默显示过期数据
- 带确认弹窗的「终止服务」按钮：有任务运行时确认框升级为中断警告，否则显示将断开的活跃会话数；宿主进程收到 SIGTERM 优雅退出——会话落盘、端口释放，效果与在终端执行 kill  完全一致
- 排空式停止：「任务结束后停止」等待所有运行中任务结束后自动终止服务（纯客户端观察，宿主不留定时器，需保持设置页打开）
- 设置页头部快捷停止：任意设置页可一键发起同样的确认停止；多标签页经 BroadcastChannel 同步停止状态，互相不再悬挂在过期数据上
- 服务回归自动刷新：停止后持续探测，终端里重启完成时页面自动刷新接回
- 界面适配 --dsw-* 主题变量，跟随皮肤切换

兼容性

- DeepSeek Harness >= 0.1.2-rc.1（在 0.1.2-rc.1 实测）
- Web profile（platform: web）

安装

方式一（推荐）—— npm 直装：

dsh plugin --profile web add dsh-stop-service

方式二 —— GitHub 直装：

dsh plugin --profile web add github:KhaosGx/dsh-stop-service

方式三 —— 克隆后本地 link（适合参与开发）：

git clone https://github.com/KhaosGx/dsh-stop-service.git
cd dsh-stop-service
dsh plugin --profile web add link:$(pwd)

安装后重启 dsh web，面板位于 设置 → 服务控制。

工作原理

| 文件 | 职责 |
|---|---|
| lib/index.js | 宿主侧：注册三个仅限 loopback 的路由——GET /health（存活探测）、GET /info（服务与 profile 信息）、POST /stop（应答后 300ms 自发 SIGTERM） |
| lib/client.js | 浏览器侧：通过官方 settings.section 槽位注册设置分区与 React 组件；轮询 /info 渲染信息面板与趋势图，直查 npm dist-tags 显示更新横幅 |
| cordis.patch.yml | bundle 层自登记（dsh.bundle.patch） |

安全模型

- 路由仅接受本机 loopback 请求：socket 环回地址 + 环回 Host 头 + 浏览器同源标记三者齐备才放行；X-Forwarded-For 永不信任，其余一律 403 forbidden: loopback-only
- stop 仅接受 POST；动作等价于终端 kill，无额外能力，不做持久化；宿主进程不对外发起网络请求（更新检查由浏览器完成）

致谢

loopback 请求围栏的实现参考并改编自 zhu1090093659/dsh-web 的 dsh-client-ui-skill-explorer（BSD 3-Clause, © 2026 zhu1090093659），其版权与许可声明保留于 LICENSE 的第三方声明部分。

许可

MIT © 2026 KhaosGx