了解 Chronicle 记忆

Chronicle 是 Codex memories 的扩展：它从最近屏幕上下文中提取线索，帮助 Codex 在后续线程里更少重复询问“你刚才在做什么”。

Chronicle 会处理屏幕内容，可能包含敏感信息。启用前先确认权限、地区可用性、rate limits、prompt injection 风险和本地存储位置。

Chronicle

官方 Chronicle 说明、隐私和排错。

Memories

先理解 Codex memories 的启用、存储和线程控制。

Customization

Chronicle 只是定制层的一部分，不能替代项目规则。

当前定位

flowchart LR
    Screen["screen context"] --> Chronicle["Chronicle"]
    Chronicle --> Memories["local memory files"]
    Memories --> Future["future Codex sessions"]

官方当前定位：

opt-in research preview。
面向 macOS Codex app。
需要 Memories 已启用。
需要 Screen Recording 和 Accessibility permissions。
会较快消耗 rate limits。
会增加来自屏幕内容的 prompt injection 风险。
生成的 memories 是本地未加密 Markdown files。

可用地区、订阅要求和功能入口可能变化。实际启用前以 Codex App 设置页和官方 Chronicle 页为准。

它能帮什么

Chronicle 适合减少重复上下文：

识别你屏幕上正在看的代码、PR、dashboard 或文档。
帮 Codex 找到正确 source，再让 Codex 读取真正的文件或链接。
记住你反复使用的工具和 workflow。
补齐短 prompt 里的缺失背景。

它不应该替代明确输入。关键任务仍要给出目标、路径、约束和验证方式。

启用前检查

启用前先确认：

你是否愿意让屏幕内容参与 memory generation。
当前是否会显示客户数据、密钥、会议、聊天记录或私人信息。
组织策略是否允许 Screen Recording 和 Accessibility 权限。
rate limits 是否足够。
memories 是否可被当前线程使用或生成。

开会、处理客户资料、查看敏感 dashboard 或输入凭据前，先 Pause Chronicle。

数据和存储

Chronicle 会临时保存 screen captures，并用 Codex 总结最近活动生成 memories。

本地临时 screen capture 可能出现在：

$TMPDIR/chronicle/screen_recording/

生成的 memories 默认在：

$CODEX_HOME/memories_extensions/chronicle/

这些目录都可能包含敏感信息。不要分享，不要提交，不要上传 artifact。共享 CODEX_HOME 前必须先检查。

Prompt injection 风险

Chronicle 会从屏幕内容生成上下文。如果你浏览了包含恶意 agent instructions 的网页、issue、文档或聊天记录，Codex 可能把这些内容误当成任务上下文。

降低风险：

不把 Chronicle 用在不可信网页巡检。
查看外部内容时保持只读任务。
重要操作仍要求 Codex 引用真实文件或官方来源。
发现异常记忆时，删除或编辑对应 memory file。

常见排错

看不到 Chronicle 设置：

确认当前 Codex app build 支持该功能。
确认 Settings > Personalization 已启用 Memories。
确认可用地区和订阅条件。

设置未完成：

检查 Screen Recording permission。
检查 Accessibility permission。
退出并重开 Codex app。
回到 Settings > Personalization 检查状态。

想禁用：

用 menu bar icon Pause / Resume。
到 Settings > Personalization > Memories 关闭 Chronicle。
用 /memories 控制当前 thread 是否使用或生成 memories。

验收清单

知道 Chronicle 是否正在运行。
敏感会议、凭据、客户数据前会暂停。
CODEX_HOME 和 Chronicle memory 目录不被分享。
不把 Chronicle memories 当成强制项目规则。
重要任务仍以文件、官方文档和可执行验证为准。
发现错误或敏感 memory 后能删除或编辑对应文件。