系统自检（selfcheck）

功能与检测机制

系统自检监控的是 Qidun 自身程序的完整性（不是全盘文件体检）：

• 首次运行对自身可执行文件 + 附加受检路径（selfcheck.extra_paths 可配）建立 SHA-256 基线；文件被系统占用时降级为「大小 + 修改时间」。
• 基线整体再做一层 HMAC 签名（机器密钥）—— 签名校验失败意味着基线数据库本身被篡改，防止攻击者改文件后同步改基线。
• 默认每 3600 秒自检一轮（selfcheck.interval_sec 可配）。

统计卡与告警

卡片	说明
自检状态	正常（绿）/ 已篡改（红），点击下钻检测事件
基线文件数	受检文件数量，下钻基线清单
上次自检时间 / 服务自身内存	只读信息

• 发现文件被修改 / 删除 / 签名失败 → critical「服务端疑似被篡改」，总览页顶部同步出现红色横幅。
• 首次发现立即告警；持续篡改每 6 小时心跳式重提醒（不刷屏但持续可见）。

操作：立即自检 / 重置基线

操作	行为
立即自检	立即执行一轮校验，toast 显示「自检完成：N 处异常」（有危险时红色提示）
重置基线	确认后事务化重建全部基线（以当前文件状态为准）

页面上同时显示只读信息：自检周期与自检启用状态。

基线清单与检测事件

• 基线清单：受检文件路径 / 指纹（前 16 位，悬停全值）/ 大小 / 建立时间。
• 检测事件：时间 / 文件 / 动作（modified / deleted 红色，其余琥珀）/ 详情。完整历史在「系统日志 → 自检事件」。

常见问题

现象	处理
升级后总览页红色「疑似被篡改」横幅	正常误报：到本页执行「重置基线」即可消除
未升级却出现篡改告警	高度可疑：核对基线清单中的文件指纹，检查程序目录是否被写入；必要时用官方包覆盖并重置
想监控业务文件变化	那不是本模块的职责，请用 文件指纹登记业务路径