dsh-restart-autostart

在 DSH（DeepSeek Harness）网页版「设置 → 通用」加入进程控制行：

• 手动重启：一键重启 dsh web 宿主进程，重启后页面自动探测服务恢复
• 跟随系统启动：写入系统自启条目（macOS launchd / Linux systemd / Windows 服务），开机拉起，并在崩溃后自动重启

关于包名：本包是 dsh-restart 的重命名版本 —— npm 上 dsh-restart 已被第三方占用（维护者 anweat），故更名为 dsh-restart-autostart 发布。

安装

dsh plugin --profile web add github:felixpu/dsh-restart-autostart

安装后重启宿主进程。

使用

手动重启

设置 → 通用 → 进程控制 → 「立即重启」。

前端会轮询 GET /dsh-restart-autostart/health 判断服务是否恢复，因此重启过程无需手动刷新。

跟随系统启动

设置 → 通用 → 勾选「跟随系统启动」。

勾选后会向当前平台注册自启条目：

平台	机制	条目名
macOS	launchd	com.dsh.restartautostart.<port>
Linux	systemd 用户级服务	dsh-restart-autostart-<port>.service
Windows	系统服务	dsh-restart-autostart-<port>

守护默认作用于当前宿主进程所使用的端口，因此不会与既有 3080 生产守护冲突。

Linux 上依赖 systemd 用户实例的 linger 才能在无人登录时拉起；非 systemd 发行版（如 Alpine 用 OpenRC）不可用。

数据落盘位置

全部落在 ~/.dsh-restart-autostart/，与 ~/.dsh/ 完全分离：

路径	用途
~/.dsh-restart-autostart/guard.mjs	守护运行体（稳定落点）
~/.dsh-restart-autostart/logs/	日志与计数

守护脚本被安装到 ~/.dsh-restart-autostart/guard.mjs 而非包内路径 —— 因为包目录会随 pnpm 重装、换 profile、link: realpath 而漂移。

⚠️ 从旧名 dsh-restart 升级

本包从旧版升级时，运行时标识全部改名，旧数据不会自动迁移：

项目	旧	新
配置目录	~/.dsh-restart/	~/.dsh-restart-autostart/
路由	/dsh-restart/*	/dsh-restart-autostart/*
launchd Label	com.dsh.restart.<port>	com.dsh.restartautostart.<port>
systemd unit	dsh-restart-<port>.service	dsh-restart-autostart-<port>.service

升级步骤：

1. 移除旧包（dsh plugin --profile web remove dsh-restart）
2. 安装新包并重启
3. 重新勾选一次「跟随系统启动」
4. 手动清理旧条目与旧目录，否则可能残留两个守护进程抢同一端口

# macOS 示例
launchctl bootout gui/$(id -u)/com.dsh.restart.3080 2>/dev/null
rm -f ~/Library/LaunchAgents/com.dsh.restart.*.plist
rm -rf ~/.dsh-restart

宿主路由

方法	路径	用途
GET	/dsh-restart-autostart/health	存活探针（前端轮询判断恢复）
POST	/dsh-restart-autostart/restart	手动重启
GET	/dsh-restart-autostart/autostart/status	读取自启状态
POST	/dsh-restart-autostart/autostart/enable	启用自启
POST	/dsh-restart-autostart/autostart/disable	停用自启

测试

DSH_RESTART_GUARD="$PWD/lib/guard/guard.js" bash test/guard-classify.test.sh

覆盖守护的失败分类逻辑：端口被占、起来了但非零退出、插件树加载失败、启动过慢、待命状态。

测试需指定 DSH_RESTART_GUARD 指到包内守护脚本；未指定时默认读 ~/.dsh-restart-autostart/guard.mjs（需先在设置里启用过一次自启）。

客户端挂载点

槽位	用途
settings.general.item	「设置 → 通用」里的进程控制行

客户端 bundle 仅 require 平台种子表内的模块（react、@deepseek-ai/dsh-client-ui-primitives）。

许可证

MIT © felixpu

仓库

https://github.com/felixpu/dsh-restart-autostart