# @goodandready/dsh-smart-restart
## 概述
重启会终止执行该操作的进程。普通通知只能说“服务已重启”，却无法回答两个关键问题：Harness 现在是否健康，以及被中断的任务应该继续什么。直接调用 systemctl restart 还可能需要 root 或 polkit 权限。
本插件为 DeepSeek Harness 提供经过验证的重启流程：先记录原因、目标会话和待继续任务，再结束当前进程让 systemd 启动新进程。新进程执行健康检查，并把结果和恢复提示发回发起请求的会话。默认方式无需额外权限。
## 架构
~~~mermaid
graph LR
A[DSH web profile] --> B[Host plugin]
B --> C[Restart intent and guard]
C --> D[Service manager restarts DSH]
D --> E[Next-process health checks]
E --> F[Report to requesting session]
A --> G[Client module loader]
G --> H[Settings card]
H --> B
~~~
浏览器端通过 DSH 的延迟 CommonJS 客户端加载器注册设置卡片；工厂返回 apply 和 inject。宿主端负责工具、重启、健康检查和报告。
## 功能
- **无需额外权限重启**：默认结束 Harness 进程，由配置为 Restart=always 的 systemd 拉起；systemctl 模式适用于已授予相应权限的环境。
- **启动后健康检查**：检查 DSH 服务、已注册工具、systemd 单元状态及重启次数、监听端口是否由本服务 cgroup 中的进程持有，以及插件和核心版本。结果为 ok 或带失败明细的 degraded。
- **报告发回原会话**：重启前保存目标会话、原因和待继续内容；新进程将检查结果发回同一会话，必要时会有限等待会话上线。
- **循环保护**：10 分钟窗口内达到 3 次重启上限后拒绝新请求。
- **设置卡片**：提供英文和中文界面；俄语翻译由 dsh-russian-lang 提供。
## Модули
- lib/index.js：Cordis 宿主入口，注册设置、重启/状态工具、启动检查与报告发送。
- lib/boot.js：纯函数逻辑，识别重启、保护循环、检查 cgroup 和端口、汇总结果并格式化报告。
- lib/client.js：浏览器设置卡片；DSH 加载工厂必须返回 CommonJS 导出对象。
- cordis.patch.yml：将此包加入所选 web profile。
## 安装
~~~bash
dsh plugin --profile web add @goodandready/dsh-smart-restart
~~~
默认模式要求 Harness 由 systemd 管理，且服务配置 Restart=always。插件从进程 cgroup 自动检测单元，也可以在设置中指定。
## 设置
在 DSH 插件设置卡片中修改；不需要密钥。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| enabled | boolean | true | 是否注册工具并检查每次启动。 |
| restartMode | string | kill | kill 结束进程并由 systemd 重启；systemctl 调用 systemctl restart 。 |
| unit | string | 自动检测 | 要检查和重启的 systemd 单元；空值从 /proc/self/cgroup 检测。 |
| delayMs | number | 3000 | 结束进程前的等待时间，让工具回执先返回。 |
| target | string | requester | 报告目标：发起请求的会话、primary 或会话 ID。 |
| stateDir | string | .restart-guard | $DSH_HOME 下保存启动标记、意图、报告和重启历史的目录。 |
| maxRestarts | number | 3 | 窗口内达到该次数时拒绝重启。 |
| windowMs | number | 600000 | 循环保护窗口，单位毫秒。 |
| timeoutMs | number | 5000 | 每项健康探测的超时时间。 |
| expectTools | string[] | [] | 启动后必须注册的工具；缺失会降低健康结论。 |
| toolEnabled | boolean | true | 是否注册 dsh_restart 和 dsh_restart_status。 |
## 工具
- dsh_restart：参数 reason、resume、confirm 和 delayMs。保存意图、检查循环限制、安排重启并返回回执；重启后的结论会发给调用它的会话。
- dsh_restart_status：只读显示最近启动、停机时长、健康报告、待处理意图和当前窗口中的重启次数。
## 报告
报告包含启动时间、停机时长、每项健康检查结果、插件/核心版本、总体结论，以及重启前记录的待继续内容。值缺失时不会伪造健康状态。
## 限制与故障排查
- 默认模式依赖 systemd 的 Restart=always。手动启动的独立进程无法自行恢复，插件会明确报告这一限制。
- kill 模式会结束当前执行轮次；保存的意图用于为下一轮提供上下文。
- 端口和 cgroup 检查面向 Linux；其他系统会跳过这些检查。
- 插件由 DSH 包管理器 (CLI/pnpm) 统一管理；本插件不提供独立的 /api/dsh/update 路由，更新会在重启后由内置 health-check 验证。
- 对于 systemd 用户单元，--user 标志会在状态检查和 systemctl restart 中自动传递。
- 如果 DSH 报告客户端导入失败并提示 module is not defined，说明客户端加载工厂不兼容。请使用定义并返回 CommonJS 导出的版本，再重新加载 web profile。
- 宿主端工具可能正常，而浏览器设置卡片仍失败；请分别检查客户端模块启动错误。
## 开发与许可证
运行 npm test 执行测试。
MIT © GooDAnDReaDY