huasheng33991/dsh-power-button

One-click start/stop (restart) button for DeepSeek Harness, pinned to the window bottom-right corner. / DSH 一键启停按钮。

Bundle 已验证 未知 JavaScript 未知
Bundle 已验证

已收录

1

Dev

Bundle 已验证

版本未知
语言JavaScript
许可证未知
在 GitHub 查看

预览

功能介绍

固定在窗口右下角的一键启停按钮:通过脱离终端的辅助进程按原始启动命令重启 DeepSeek Harness(仅本机同源可调),附「仅停止」小按钮。

适合

  • 希望在界面中保留一键重启入口的本机 DSH Web 运维者。
  • 希望按原执行文件、参数、环境和工作目录重新拉起进程的开发或个人环境。
  • 还需要邻近“仅停止”操作入口的运维者。

不适合

  • 不适合通过代理进行远程管理,因为重启和停止接口仅接受本机同源请求,并拒绝转发请求。
  • 由外部进程管理器统一托管的部署很少能从进程内的脱离式重启按钮中获益。
  • 只需要健康监测或状态展示的用户不需要进程重启和停止控制。

README

dsh-power-button

DeepSeek Harness 一键启停按钮 —— 固定在窗口右下角的悬浮电源键。

单击主按钮即可重启 DeepSeek Harness(停旧启新,自动拉起新进程并重连页面);悬停出现的小按钮可仅停止(不自动重启)。

  • 状态点:绿 = 运行中 / 红 = 离线 / 琥珀脉冲 = 重启中
  • 重启接口仅接受本机同源请求(拒绝代理转发),伪造来源一律 403
  • 持久化安装:本体放 ~/.dsh/plugins/dsh-power-button/,通过 profile package.json 的 dsh.profile.bundles 自动加载,重启后依然存在

路由

路由 方法 说明
/dsh-power/health GET 健康检查 { ok: true }
/dsh-power/restart POST 一键启停:detached helper 等端口释放后按原入口/参数/环境/cwd 重启
/dsh-power/stop POST 仅停止,不自动重启

安装(profile 层)

# 1. 把本包放入 DSH 用户级插件目录
mkdir -p ~/.dsh/plugins
cp -r dsh-power-button ~/.dsh/plugins/

# 2. 加入 profile 依赖并安装
cd ~/.dsh/profiles/web
pnpm add file:~/.dsh/plugins/dsh-power-button

# 3. 在 package.json 的 dsh.profile.bundles 列表追加 "dsh-power-button"
#    (注意:不要再在 cordis.patch.yml 手动 insert,避免 duplicate loader entry id)

# 4. 重启 dsh web 后刷新页面即可看到右下角按钮

卸载

cd ~/.dsh/profiles/web
pnpm remove dsh-power-button
# 并从 package.json 的 dsh.profile.bundles 移除 "dsh-power-button"

技术说明

重启机制:POST /dsh-power/restart 会派发一个 detached node helper,helper 等待 HTTP 端口释放后,用 process.execPath + execArgv + 原始 argv + cwd + 环境变量 重新拉起完全相同的 dsh 启动命令,随后旧进程收到 SIGTERM 优雅退出。新进程脱离原终端独立运行。

踩坑记录:helper 代码中 }) 换行后紧跟 (async 必须加前导分号(;(async),否则 ASI 会把 IIFE 吞进上一条语句,helper 静默不执行导致自启失败。

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:huasheng33991/dsh-power-button。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。