引言
在自托管博客的日常运营中，最常见的痛点不是功能缺失，而是缺乏可追溯的操作记录。站点标题被改、评论被误删、AI 自动审核的决定无法回溯——这些都让站长在出现问题时只能凭记忆猜测。为了解决这一系列“黑箱”问题，我实现了一款 黑匣子插件，把所有关键操作、AI 调用以及评论变动完整记录下来，帮助站长随时追溯“谁、何时、从哪”完成了哪些操作。
为什么需要黑匣子
1. 后台高危操作无痕
- 改设置、删文章、审评论 等高权限操作默认不留日志，站长自己也常常忘记自己做了什么。若后台入口泄露，攻击者可以在不留下痕迹的情况下篡改站点。
2. AI 自动化决策需要审计
- 接入 AI 助手后，评论审核、内容生成等全部由模型完成。每一次模型调用都可能影响站点内容，却没有任何可回放的记录。没有审计链路，误判难以纠正。
3. 评论删除的不可逆性
- 评论是访客与站点交互的唯一痕迹，误删或恶意删除后，原始内容、邮箱、IP 等信息全部消失。合规要求（如《网络安全法》）也规定日志需保留至少六个月。
黑匣子插件的核心功能
1. 操作日志（op_logs）
- 通过后台事件钩子捕获所有敏感操作，记录 操作类型、对象、详情、操作人、IP、时间。登录成功/失败、文章编辑、设置保存、友链管理等均有日志。登录失败的频繁出现可直接作为入侵预警。
2. AI 调用审计（ai_audit）
- 每一次 AI 调用都会保存 工具名称、完整参数、返回结果、调用状态。日志以 JSON 形式存储，列表页展示摘要，点击可展开查看全部细节，帮助站长快速定位 AI 误判根源。
3. 评论留存（comment_archive）
- 对所有评论（包括已软删除的）进行完整保存。删除操作仅标记
deleted_at，数据仍保留在库中，可在审计页查看删除时间、原文、来源邮箱和 IP，并支持一键恢复。
4. 通用查询与导出
- 支持 日期区间、关键词 多维度筛选；一键 CSV 导出（UTF‑8 带 BOM），方便合规留档。后台提供统一入口，所有审计信息集中展示。
5. 自动清理
- 为满足合规的最小保留期限，操作日志默认保留 180 天（六个月），后台任务每天自动清理过期数据，防止库表无限膨胀。
实际使用场景
- 登录异常排查：某晚出现大量来自陌生 IP 的登录失败记录，立刻更换密码并限制登录入口。
- 误删评论恢复：访客反馈评论消失，审计页检索到删除记录后，一键恢复，原文完整保留。
- AI 误拒复核：AI 错误拒绝正常评论，审计日志展示调用参数和模型返回，站长可据此调优词库或手动放行。
- 设置变更追溯：站点标题被改后，审计页快速定位到具体的
settings.save操作，看到改前改后值、操作人和 IP。
设计取舍
- 插件化而非核心：审计是横切关注点，插件化可以随时启停，保持博客核心代码简洁。
- 软删除 + 180 天保留：兼顾合规（六个月日志）与隐私最小化原则，过期后自动物理删除。
- 数据不出站：所有审计数据仅存于站内数据库，导出仅在管理员主动操作时生成，确保数据安全。
结语
黑匣子插件把自托管博客从“数据在自己手里”提升到“所有关键操作都有记录”。无论是人工误操作、AI 自动决策，还是恶意入侵，都可以在审计页一目了然。只需在插件管理中启用，即可获得完整的操作留痕，真正实现自托管博客的可追溯性。