Chronicle 是 Codex 的一项屏幕查看技能,仅在用户启用 Codex 屏幕录制(Chronicle)功能且当前 rollout 中存在 ## Memories 段落时可用。若记忆功能未启用,不应使用该技能。
用途:让 AI 查看用户屏幕最新画面及过去数小时的工作历史,从而理解用户近期工作上下文。
主要能力:屏幕录制以滚动缓冲区形式保存在 $TMPDIR/chronicle/screen_recording,包含各显示器的最新帧、OCR 历史(*.ocr.jsonl)以及按分钟分桶的历史帧。记忆则持久保存在 ~/.codex/memories/extensions/chronicle/,含每 10 分钟和每 6 小时的 markdown 摘要。
使用方式:常见流程是读取指定显示器的最新帧;对文件操作前先复制到临时文件,避免被录制服务静默覆盖。需要历史时先用 rg 搜索 *.ocr.jsonl 定位相关词或时间戳,再查看 1min/ 下匹配的稀疏帧确认。多显示器时按时间戳合并证据。使用 date 命令获取当前 UTC 时间,判断录制是否新鲜。OCR 仅用于 grep 查找,不用于提取文档 ID 等用途;需要文本时应自行从图像提取。获取最少必要上下文后,应尽快转向应用专用技能、连接器或文件系统等更可靠数据源。
限制:OCR 噪声大、不准确;多模态理解能力有限,不宜依赖其完成复杂任务;屏幕录制可能不是最新。使用前需确认 Chronicle 正在运行,通过读取 PID 文件并执行提权只读主机进程检查,确认可执行文件为 codex_chronicle,不能依赖沙箱进程检查。无法验证时不得使用该技能。向用户说明状态时不要提及 PID 文件。