QIN-SMART/dsh-web-restart

Project Overview项目介绍

dsh-web-restart is a DSH plugin that adds a "Restart DSH" button to the WebUI sidebar. It triggers process exit via RPC or a same-origin HTTP endpoint, shows a full-screen overlay, polls, and auto-refreshes. It also ships macOS launchd scripts and a Launchpad icon for auto-restart after crashes and login startup. Use it when you want one-click web restarts and a persistent dsh web. Caveat: the button cannot self-revive; an external daemon is required.

dsh-web-restart 是 DSH 插件,在 WebUI 侧边栏加「重启 DSH」按钮,点击后经 RPC 或同源 HTTP 触发进程退出,全屏遮罩并轮询自动刷新;同时提供 macOS launchd 守护脚本与启动台图标,实现崩溃/退出自动拉起、登录自启。适合希望从网页一键重启并让 dsh web 常驻的场景。注意:按钮无法自举,必须配套外部守护,重启后才能恢复。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:QIN-SMART/dsh-web-restart

把 QIN-SMART/dsh-web-restart 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-web-restart

在 DeepSeek Harness 的 WebUI 里加一个「重启 DSH」按钮,并配好 macOS 上 把 DSH 变成图标启动 + 崩溃/被杀后自动重启 的基础设施。

  • WebUI 重启按钮:侧边栏底部的「⇄ 重启 DSH」按钮。点击后全屏遮罩提示 "正在重启 DSH…",进程退出后由外部守护(launchd)自动拉起,页面自动刷新恢复。
  • 外部守护:因为 dsh web 是单 Node 进程,进程一退出 UI 就断线。要让 "重启后能回来",必须由 外部守护 在进程退出后把 dsh web 重新拉起。 本仓库提供 macOS launchd LaunchAgent(launcher/macos/),崩溃/退出自动拉起, 可设登录自启。

插件本身无法在死后自举 —— 重启按钮与外部守护是配套的两半,缺一不可。


功能

能力 说明
WebUI 重启按钮 侧边栏底部,两段式确认(防误触),触发后全屏遮罩 + 轮询自动恢复
双通道触发 首选 DSH 官方 RPC(remote.commands.execute("/restart")),回退同源 fetch
launchd 守护 KeepAlive 自动拉起崩溃/退出的进程,登录自启
启动台图标 AppleScript 编译的 .app,点击启动 + 打开浏览器
可选 token host 端点支持 Authorization / X-Dsh-Restart-Token 校验

安装到你的 DSH profile

方式 A:从 GitHub 安装(推荐)

在你的 profile 目录(~/.dsh/profiles/web/)里:

cd ~/.dsh/profiles/web
pnpm add "dsh-web-restart@github:<你的用户名>/<仓库名>"

然后在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组末尾加上:

"dsh": {
  "profile": {
    "bundles": [
      "@deepseek-ai/dsh-base",
      "@deepseek-ai/dsh-web-app",
      "dsh-web-restart"        // ← 加这一行
    ]
  }
}

重启 dsh web 后生效。

方式 B:本地 link(开发用)

cd ~/.dsh/profiles/web
pnpm add "link:/绝对/路径/dsh-web-restart"

同样在 bundles 里加上 "dsh-web-restart",重启生效。

想改插件默认配置(mode / token / flushMs / enableCommand)? 在 profile 的 cordis.patch.yml 里覆盖:

- id: web-restart
  name: dsh-web-restart
  token: my-secret

macOS:launchd 守护 + 启动台图标

1) 安装 launchd 守护(自动拉起 + 登录自启)

chmod +x launcher/macos/*.sh
launcher/macos/dsh-web-control.sh install

常用命令:

命令 作用
dsh-web-control.sh status 查看 launchd 状态
dsh-web-control.sh restart 手动重启
dsh-web-control.sh stop / start 停 / 启(停止不解除自启)
dsh-web-control.sh uninstall 卸载

日志:~/.dsh/dsh-web.launchd.log 与 ~/.dsh/dsh-web.launchd.err.log。

细节:安装脚本会把 dsh-web-start.sh 复制到 ~/Library/Application Support/dsh-web/ 再交给 launchd —— 因为 macOS TCC 隐私保护下 launchd 无法读取 ~/Documents 等目录里的脚本。脚本会自动探测 node 与 dsh 的路径(nvm / PATH), 也可用 NODE_BIN / DSH_ENTRY / DSH_HOME 环境变量覆盖。

2) 启动台 / Dock 图标

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-delete-session 下一个 Next dsh-turn-cost →