CrashHandler 崩溃处理与自动重启 - 基建就绪度评估

评估日期：2026-03-30

结论：部分就绪，建议分阶段实施

整体基建就绪度约 60%，核心崩溃捕获可直接开始，完整功能（CrashReporter + Watchdog）依赖 IPC 基建。

组件	状态	复用点
Logger	100%	异步 MPSC 队列，`flush_sync()` 支持信号安全 flush，可抓取崩溃前最后 50 条日志
ConfigStore	100%	4 层存储，可存储崩溃处理器配置（开关、最大报告数等）
Platform 抽象	100%	清晰的 linux_wsl / windows 分层，工厂模式，新加平台特定代码路径很自然
System 检测	100%	CPU/GPU/Memory/Network 信息可直接填入 CrashReport
Init Chain	100%	DAG 初始化链，CrashHandler 可作为 early_session stage 注册
ScopeGuard	100%	RAII 工具，可用于信号处理器中的资源清理

组件	状态	影响范围
IPC	0%	阻塞 Phase 2：CrashReporter 独立进程通信、Watchdog 心跳都需要 IPC
HWTier	0%	低优先级：仅 CrashReport 中的 systemInfo 字段需要，可后续补充

desktop/main/early_session/impl/console_signal_stage.cpp — 仅处理 Windows Ctrl+C/Ctrl+Break，走 QApplication::quit() 优雅退出
无 SIGSEGV/SIGABRT 处理
无栈回溯捕获
无崩溃报告生成

预计工期：~3 天

CrashHandler 类设计
- Singleton 模式，注册到 early_session init chain
- Linux：sigaction() 捕获 SIGSEGV / SIGABRT / SIGFPE / SIGBUS / SIGILL
- Windows：SetUnhandledExceptionFilter() + std::set_terminate
栈回溯
- Linux：backtrace() / backtrace_symbols()，可选 addr2line 符号解析
- Windows：StackWalk64
CrashReport 结构体 + 存储
- 字段：timestamp, processName, processId, signal, stackTrace, lastLogs, systemInfo
- JSON 序列化，存储路径 ~/.cache/CFDesktop/crashes/
- 崩溃历史管理：最多保留 20 份报告，30 天过期清理
集成到 init chain
- 作为 early_session stage 在应用启动最早期注册
- 参考 console_signal_stage.cpp 的注册方式

预计工期：~2 天（IPC 完成后）

CrashReporter 独立进程
- 轻量 Qt 程序，主进程崩溃后启动
- 崩溃通知 UI（友好错误信息、崩溃时间/次数、操作按钮）
- 详情查看（栈回溯、系统信息、复制到剪贴板）
Watchdog 守护进程
- 监控主进程健康状态，心跳检测
- 崩溃后自动重启，指数退避策略
- 连续 3 次崩溃停止自动重启，仅显示报告

用途	路径
CrashHandler 接口	`desktop/base/infrastructure/` (新建)
Linux 平台实现	`desktop/base/infrastructure/platform/linux/` (新建)
Windows 平台实现	`desktop/base/infrastructure/platform/windows/` (新建)
注册入口	`desktop/main/early_session/` (已有 init chain)
现有信号处理参考	`desktop/main/early_session/impl/console_signal_stage.cpp`
CrashReporter 进程	`tools/crash_reporter/` (新建，Phase 2)

Phase 1 验证：

Phase 2 验证：