limochaishang/crash-guard-dsh ↗★ 0
crash-guard-dsh
崩溃保护插件,在插件导致 DSH 启动崩溃或卡死时,下次启动自动禁用该插件并记录日志。
AI 分析
核心用途是保障 DSH 系统的启动稳定性。适合喜欢尝鲜安装各种第三方插件,需要防止因个别插件兼容性问题导致整个工具链瘫痪、无法启动的用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:limochaishang/crash-guard-dsh说明文档
阅读完整 README ↗使用方法
安装后无需任何操作,crash-guard 自动工作:
- 正常启动:crash-guard 跟踪加载过程,记录状态,启动完成后进入 ready 状态
- 插件崩溃:下次启动自动隔离导致崩溃的插件,PawWork 可以正常启动
- 插件卡死:看门狗检测到无心跳,自动杀进程、禁用可疑插件、重启
- 查看日志:检查
$DSH_HOME/crash-guard/quarantine.log查看被禁用的插件记录
配置选项
crash-guard 零配置即可使用。如需自定义,可通过 patch 配置以下参数:
| 参数 | 默认值 | 说明 |
|---|---|---|
stateDir | $DSH_HOME/crash-guard | 状态文件目录 |
patchFile | profile 下的 cordis.patch.yml | 禁用插件写入的补丁文件 |
freshWindowMs | 60000 | 状态文件新鲜度窗口(毫秒) |
readyTimeoutMs | 30000 | 启动超时时间(毫秒) |
hangTimeoutMs | 15000 | 单插件加载 hang 超时(毫秒) |
heartbeatIntervalMs | 2000 | 心跳写入间隔(毫秒) |
watchdogCheckIntervalMs | 5000 | 看门狗检查间隔(毫秒) |
watchdogTimeoutMs | 30000 | 看门狗心跳超时(毫秒) |