KhaosGx/dsh-stop-service

English | 中文

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 <pid> 完全一致
• 排空式停止：「任务结束后停止」等待所有运行中任务结束后自动终止服务（纯客户端观察，宿主不留定时器，需保持设置页打开）
• 设置页头部快捷停止：任意设置页可一键发起同样的确认停止；多标签页经 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