了解 Chronicle 记忆

Chronicle 目前是 opt-in research preview。

它只面向 macOS 上的 ChatGPT Pro subscribers 开放，暂不支持 EU、UK 和 Switzerland。

启用前，请先阅读 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。
• Chronicle 会增加 prompt injection 风险。
• Chronicle 会在你的 device 上存储未加密 memories。

How Chronicle Helps

Chronicle 的设计目标，是减少你和 Codex 工作时必须重复说明的 context。

它利用最近的 screen context 改善 memory building，让 Codex 更容易理解你在指什么、应该使用哪个 source，以及你依赖哪些 tools 和 workflows。

Use What Is on Screen

有了 Chronicle，Codex 可以理解你当前正在看的内容，减少 context switching。

Fill in Missing Context

不需要每次都精心组织 context、从零开始。Chronicle 能帮助 Codex 补齐 context gaps。

Remember Tools and Workflows

不需要反复告诉 Codex 使用哪些 tools 来完成工作。

Codex 会随着你的工作逐步学习，长期节省时间。

这些场景中，Codex 会用 Chronicle 提供 additional context。

如果另一个 source 更适合当前任务，例如读取具体 file、Slack thread、Google Doc、dashboard 或 pull request，Codex 会用 Chronicle 识别 source，再直接使用那个 source。

Enable Chronicle

1. 打开 Codex app 的 Settings。
2. 进入 Personalization，确认 Memories 已启用。
3. 在 Memories setting 下打开 Chronicle。
4. review consent dialog，并选择 Continue。
5. 按提示授予 macOS Screen Recording 和 Accessibility permissions。
6. setup 完成后，选择 Try it out，或开始 new thread。

如果 macOS 报告 Screen Recording 或 Accessibility permission denied，请打开 System Settings > Privacy & Security > Screen Recording 或 Accessibility，并启用 Codex。

如果 permission 被 macOS 或你的 organization 限制，Chronicle 会在限制解除，并且 Codex 获得所需 permission 后启动。

Pause or Disable Chronicle at Any Time

你可以控制 Chronicle 什么时候使用 screen context 生成 memories。

通过 Codex menu bar icon 选择 Pause Chronicle 或 Resume Chronicle。

开会前，或查看不希望 Codex 作为 context 使用的 sensitive content 时，请先 Pause Chronicle。

如果要 disable Chronicle，回到 Settings > Personalization > Memories，关闭 Chronicle。

你也可以控制某个 thread 是否使用 memories。更多信息见 Control memories per thread。

Rate Limits

Chronicle 会在 background 中运行 sandboxed agents，根据 captured screen images 生成 memories。

这些 agents 目前会很快消耗 rate limits。

Privacy and Security

Chronicle 使用 screen captures，其中可能包含屏幕上可见的 sensitive information。

它不能访问 microphone 或 system audio。

未经对方 consent，不要用 Chronicle 记录 meetings 或与他人的 communications。

查看不希望写入 memories 的内容时，请 Pause Chronicle。

Where Does Chronicle Store My Data?

screen captures 是 ephemeral，只会临时保存在你的 computer 上。

Chronicle 运行时，temporary screen capture files 可能出现在：

$TMPDIR/chronicle/screen_recording/

Chronicle 运行期间，超过 6 hours 的 screen captures 会被删除。

Chronicle 生成的 memories 和其他 Codex memories 一样：是未加密 Markdown files，你可以按需要 read 和 modify，也可以让 Codex search 它们。

如果希望 Codex forget 某些内容，可以删除 folder 中对应 file，或 selectively edit markdown files 移除相关信息。

你不应该手动添加新信息。

generated Chronicle memories 会本地存储在你的 computer 上：

$CODEX_HOME/memories_extensions/chronicle/

通常路径是：

~/.codex/memories_extensions/chronicle

screen captures 和 memories 对应的 directories 都可能包含 sensitive information。不要把这些内容分享给他人，也要意识到你 computer 上的其他 programs 也可能 access 这些 files。

What Data Gets Shared with OpenAI?

Chronicle 会在本地 capture screen context，然后定期使用 Codex 把最近 activity summarize 成 memories。

为了生成这些 memories，Chronicle 会启动一个 ephemeral Codex session，并给该 session access to screen context。

这个 session 可能处理 relevant time window 中的 selected screenshot frames、从 screenshots 提取的 OCR text、timing information，以及 local file paths。

用于 memory generation 的 screen captures 会临时保存在你的 device 上。它们会在 OpenAI servers 上被处理，以生成 memories；生成的 memories 会存回本地 device。

除非法律要求，OpenAI 不会在 processing 之后把 screenshots 存在 servers 上，也不会用这些 screenshots 训练模型。

generated memories 是 Markdown files，本地存储在：

$CODEX_HOME/memories_extensions/chronicle/

当 Codex 在未来 session 中使用 memories 时，相关 memory contents 可能作为该 session 的 context 被包含进去。

如果你的 ChatGPT settings 允许，这些内容可能用于 improve models。更多信息见 Data controls FAQ。

Prompt Injection Risk

使用 Chronicle 会增加来自 screen content 的 prompt injection attacks 风险。

例如，如果你浏览了包含 malicious agent instructions 的网站，Codex 可能跟随这些 instructions。

排错

How Do I Enable Chronicle?

如果你看不到 Chronicle setting，请确认：

• 你使用的 Codex app build 包含 Chronicle。
• Settings > Personalization 中已经启用 Memories。

Chronicle 当前只面向 macOS 上的 ChatGPT Pro subscribers 开放。

Chronicle 暂不支持 EU、UK 和 Switzerland。

如果 setup 没有完成：

1. 确认 Codex 已具备 Screen Recording 和 Accessibility permissions。
2. quit 并重新打开 Codex app。
3. 打开 Settings > Personalization，检查 Chronicle status。

Which Model Is Used for Generating the Chronicle Memories?

Chronicle 使用和其他 Memories 相同的 model。

如果你没有配置 specific model，它会使用 default Codex model。

如需选择 specific model，请在 configuration 中更新 consolidation_model。

[memories]
consolidation_model = "gpt-5.4-mini"