SuperAPI AI 工具集

codex-log-guard

部署与运维

查看项目

更新于 10-16 00:04

技能介绍

用途:诊断 Codex 本地持久化诊断日志(~/.codex/logs_2.sqlite 与 ~/.codex/sqlite/logs_2.sqlite)写入过多的问题,给出简洁结论与最安全的下一步操作,不要求用户在命令菜单中做选择。

主要能力:提供四种模式。diagnose_only 为默认,只读,适用于检查、查看、解释、验证类请求;protect 需用户明确要求停止或缓解日志写入,可安装并验证 block_log_inserts 触发器,但不删除行、不 vacuum;cleanup 需用户明确要求回收磁盘空间或清理日志,先安装保护、创建并验证带时间戳的备份,再删除日志行并 vacuum;restore 需用户明确要求恢复诊断日志,仅删除已知的 block_log_inserts 触发器。

使用方式:先做只读的文件、SQLite 架构、行数与进程占用检查,识别当前被 Codex 进程持有的活动数据库,检查触发器状态,用 COUNT(*)、MIN(id)、MAX(id) 采样判断是否仍在写入,查看 TRACE/DEBUG 计数与高频 target,再用 lsof 确认占用进程。仅执行所选模式授权的变更并验证结果。涉及两个声明路径之外的数据库、删除备份、杀进程、修改远程遥测或凭据前必须升级确认。

适用场景:用户提到 logs_2.sqlite、logs_2.sqlite-wal 或怀疑本机受该问题影响时。

限制:仅管理 Codex 本地 SQLite 诊断日志,不管理对话归档、仓库文件、凭据或远程遥测。清理仅通过带时间戳备份可逆,不自动删除备份。若架构未知、出现锁或损坏错误、备份校验失败或写入后验证失败,应停止并报告,不得继续下一步变更。文件大小本身不能作为修复依据,需用行数采样验证。