Chronicle 处于 opt-in research preview 阶段。它只面向 macOS 上的 ChatGPT Pro subscribers 提供。启用前，请查看 Privacy and Security 部分，了解详细信息和当前风险。
Chronicle 会用来自你屏幕的 context 增强 Codex memories。当你 prompt Codex 时，这些 memories 可以帮助它理解你一直在做什么，从而减少你重新说明 context 的需要。
Chronicle 在 macOS 上的 Codex app 中以 opt-in research preview 形式提供。它需要 macOS Screen Recording 和 Accessibility permissions。启用前请注意，Chronicle 会快速消耗 rate limits、增加 prompt injection 风险，并把 memories 以 unencrypted（未加密）形式存储在你的设备上。
Chronicle 如何提供帮助
Chronicle 的设计目标是减少你在使用 Codex 工作时需要重复说明的 context。通过使用最近的 screen context 来改进 memory building，Chronicle 可以帮助 Codex 理解你指的是什么、识别应该使用的正确来源，并捕捉你依赖的 tools 和 workflows。
使用屏幕上的内容
借助 Chronicle，Codex 可以理解你当前正在查看的内容，从而节省时间并减少 context switching。
补齐缺失 context
你不必精心组织 context 并从零开始说明。Chronicle 让 Codex 可以补齐你的 context 缺口。
记住 tools 和 workflows
你不需要向 Codex 解释该用哪些 tools 来完成工作。Codex 会随着你的工作学习，从长期看为你节省时间。
在这些情况下，Codex 会使用 Chronicle 提供 additional context。当另一个来源更适合当前任务时，例如读取特定文件、Slack thread、Google Doc、dashboard 或 pull request，Codex 会使用 Chronicle 识别该来源，然后直接使用该来源。
启用 Chronicle
在 Codex app 中打开 Settings。
前往 Personalization，并确认 Memories 已启用。
在 Memories 设置下方打开 Chronicle。
查看 consent dialog，并选择 Continue。
出现提示时，授予 macOS Screen Recording 和 Accessibility permissions。
Setup 完成后，选择 Try it out，或开始一个 new thread。
如果 macOS 报告 Screen Recording 或 Accessibility permission 被拒绝，请打开 System Settings > Privacy & Security > Screen Recording 或 Accessibility，并启用 Codex。如果某项 permission 被 macOS 或你的组织限制，Chronicle 会在限制移除且 Codex 获得所需 permission 后启动。
随时 pause 或 disable Chronicle
你可以控制 Chronicle 何时使用 screen context 生成 memories。使用 Codex menu bar icon 选择 Pause Chronicle 或 Resume Chronicle。在会议前，或查看不希望 Codex 用作 context 的敏感内容时，请 Pause Chronicle。要 disable Chronicle，请回到 Settings > Personalization > Memories，并关闭 Chronicle。
你也可以控制某个 thread 是否使用 memories。 Learn more 。
Rate limits
Chronicle 的工作方式是在后台运行 sandboxed agents，从捕获的 screen images 中生成 memories。这些 agents 目前会快速消耗 rate limits。
Privacy and security
Chronicle 使用 screen captures，其中可能包含你屏幕上可见的敏感信息。它不能访问你的 microphone 或 system audio。不要在未经他人同意的情况下使用 Chronicle 记录会议或与他人的通信。当你查看不希望被记入 memories 的内容时，请 Pause Chronicle。
Chronicle 把我的数据存储在哪里？
Screen captures 是 ephemeral 的，只会临时保存在你的电脑上。Chronicle 运行时，temporary screen capture files 可能出现在 $TMPDIR/chronicle/screen_recording/ 下。超过 6 小时的 screen captures 会在 Chronicle 运行时被删除。
Chronicle 生成的 memories 与其他 Codex memories 一样：是 unencrypted（未加密）的 markdown files，你可以在需要时读取和修改。你也可以让 Codex 搜索它们。如果希望 Codex forget 某些内容，可以删除 folder 中相应的文件，或有选择地编辑 markdown files 来移除要删除的信息。你不应手动添加新信息。生成的 Chronicle memories 会本地存储在你的电脑上，位于 $CODEX_HOME/memories_extensions/chronicle/（通常是 ~/.codex/memories_extensions/chronicle）。
哪些数据会与 OpenAI 共享？
Chronicle 会在本地捕获 screen context，然后定期使用 Codex 将最近活动总结为 memories。为了生成这些 memories，Chronicle 会启动一个 ephemeral Codex session，并让该 session 访问这个 screen context。该 session 可能会处理选定的 screenshot frames、从 screenshots 中提取的 OCR text、timing information，以及相关时间窗口内的 local file paths。
用于 memory generation 的 screen captures 会临时存储在你的设备上。它们会在我们的服务器上被处理以生成 memories，随后 memories 会存储在本地设备上。除非法律要求，我们不会在处理后把 screenshots 存储在服务器上，也不会将它们用于 training。
生成的 memories 是本地存储在 $CODEX_HOME/memories_extensions/chronicle/ 下的 Markdown files。当 Codex 在未来 session 中使用 memories 时，相关 memory contents 可能会作为 context 被包含进该 session，并且如果你的 ChatGPT settings 允许，可能会用于改进我们的 models。 Learn more 。
Prompt injection 风险
使用 Chronicle 会增加来自 screen content 的 prompt injection attack 风险。例如，如果你浏览带有恶意 agent instructions 的网站，Codex 可能会遵循这些 instructions。
Troubleshooting
如何启用 Chronicle？
如果看不到 Chronicle setting，请确认你正在使用包含 Chronicle 的 Codex app build，并且已经在 Settings > Personalization 中启用了 Memories。
Chronicle 目前只面向 macOS 上的 ChatGPT Pro subscribers 提供。
如果 setup 没有完成：
确认 Codex 已获得 Screen Recording 和 Accessibility permissions。
退出并重新打开 Codex app。
打开 Settings > Personalization，并检查 Chronicle status。
生成 Chronicle memories 使用哪个 model？
Chronicle 使用与你其他 Memories 相同的 model。如果你没有配置特定 model，它会使用你的默认 Codex model。要选择特定 model，请在 configuration 中更新 consolidation_model。
[memories]
consolidation_model = "gpt-5.4-mini"