内容
Chronicle 通过屏幕上下文增强 Codex 记忆。当你向 Codex 发起提问时，这些记忆能够帮助它理解你正在进行的工作，减少你重复说明上下文的需要。
Chronicle 在 macOS 版 Codex 应用中作为可选参与的研究预览功能提供。需要授予 macOS 屏幕录制和辅助功能权限。启用前请注意：Chronicle 会快速消耗用量限额、增加提示注入风险，并在你的设备上以未加密形式存储记忆。
Chronicle 的用途
我们设计 Chronicle 的初衷是减少你在使用 Codex 时需要重复说明的上下文。通过利用近期屏幕上下文改进记忆构建，Chronicle 可以帮助 Codex 理解你所指的内容、识别应使用的正确来源，并掌握你所依赖的工具和工作流程。
利用屏幕内容
借助 Chronicle，Codex 能够理解你当前正在查看的内容，为你节省时间和减少上下文切换。
补全缺失的上下文
无需精心构思上下文并从头开始。Chronicle 让 Codex 能够自动填补你上下文中的空白。
记住工具和工作流程
无需向 Codex 解释该使用哪些工具来完成工作。Codex 会在你工作过程中学习，从长远来看为你节省时间。
在这些场景下，Codex 会利用 Chronicle 提供额外上下文。当其他来源更适合当前任务时——例如读取特定文件、Slack 对话、Google 文档、仪表板或拉取请求——Codex 会使用 Chronicle 识别该来源，然后直接调用该来源。
启用 Chronicle
- 在 Codex 应用中打开设置。
- 进入"个性化"选项，确保"记忆"功能已启用。
- 在"记忆"设置下方开启 Chronicle。
- 阅读同意对话框并选择"继续"。
- 在提示时授予 macOS 屏幕录制和辅助功能权限。
- 设置完成后，选择"试用"或开启新对话。
如果 macOS 提示屏幕录制或辅助功能权限被拒绝，请前往"系统设置 > 隐私与安全 > 屏幕录制"或"辅助功能"并启用 Codex。如果权限被 macOS 或你的组织限制，Chronicle 将在限制解除且 Codex 获得所需权限后启动。
随时暂停或禁用 Chronicle
你可以控制 Chronicle 何时利用屏幕上下文生成记忆。使用 Codex 菜单栏图标选择暂停 Chronicle或恢复 Chronicle。在会议前或查看不希望 Codex 用作上下文的敏感内容前，请暂停 Chronicle。如需禁用 Chronicle，请返回设置 > 个性化 > 记忆并关闭Chronicle。
你还可以控制记忆是否用于特定对话。了解更多。
用量限额
Chronicle 通过在后台运行沙盒化代理，从捕获的屏幕图像生成记忆。这些代理目前会快速消耗用量限额。
隐私与安全
Chronicle 使用屏幕截图，其中可能包含屏幕上可见的敏感信息。它无法访问你的麦克风或系统音频。未经他人同意，请勿使用 Chronicle 录制会议或与他人的通信。在查看不希望被记入记忆的内容时，请暂停 Chronicle。
Chronicle 将我的数据存储在何处？
屏幕截图是临时的，仅在你的电脑上临时保存。Chronicle 运行期间，临时屏幕截图文件可能出现在 $TMPDIR/chronicle/screen_recording/ 目录下。超过 6 小时的屏幕截图将在 Chronicle 运行期间被删除。
Chronicle 生成的记忆与其他 Codex 记忆相同：未加密的 Markdown 文件，你可以根据需要阅读和修改。你也可以让 Codex 搜索这些记忆。如需让 Codex 遗忘某些内容，可以删除文件夹中的相应文件，或有选择地编辑 Markdown 文件以移除你想删除的信息。你不应手动添加新信息。生成的 Chronicle 记忆以本地文件形式存储在你的电脑上，路径为 $CODEX_HOME/memories_extensions/chronicle/（通常为 ~/.codex/memories_extensions/chronicle）。
屏幕截图和记忆的这两个目录都可能包含敏感信息。请确保不要与他人共享这些内容，并注意你电脑上的其他程序也可能访问这些文件。
Chronicle 在本地捕获屏幕上下文，然后定期使用 Codex 将近期活动总结为记忆。为生成这些记忆，Chronicle 会启动一个临时的 Codex 会话，该会话可访问此屏幕上下文。该会话可能会处理选定的截图帧、从截图中提取的 OCR 文本、时间信息以及相关时间窗口的本地文件路径。
用于记忆生成的屏幕截图临时存储在你的设备上。它们会在我们的服务器上处理以生成记忆，随后记忆存储在本地设备上。除非法律要求，否则我们不会在处理后于服务器上保留截图，也不会将其用于训练。
生成的记忆是以 Markdown 文件形式本地存储在 $CODEX_HOME/memories_extensions/chronicle/ 目录下。当 Codex 在未来的会话中使用记忆时，相关记忆内容可能会作为该会话的上下文，并可能根据你的 ChatGPT 设置用于改进我们的模型。了解更多。
提示注入风险
使用 Chronicle 会增加来自屏幕内容的提示注入攻击风险。例如，如果你浏览了包含恶意代理指令的网站，Codex 可能会执行这些指令。
故障排除
如何启用 Chronicle？
如果看不到 Chronicle 设置，请确保你使用的 Codex 应用版本包含 Chronicle，且已在"设置 > 个性化"中启用"记忆"功能。
Chronicle 目前仅面向 macOS 平台的 ChatGPT Pro 订阅用户开放。欧盟、英国和瑞士地区暂不可用。
如果设置未完成：
- 确认 Codex 已获得屏幕录制和辅助功能权限。
- 退出并重新打开 Codex 应用。
- 打开"设置 > 个性化"并检查 Chronicle 状态。
生成 Chronicle 记忆使用哪个模型？
Chronicle 使用与其他记忆相同的模型。如果你未配置特定模型，则使用默认的 Codex 模型。如需选择特定模型，请在配置中更新 consolidation_model。
[ memories ]
consolidation_model = "gpt-5.4-mini"