跳到主要内容

本文为非官方中文翻译,内容以 OpenAI 官方英文文档为准。
官方来源:https://developers.openai.com/codex/memories/chronicle

Chronicle

基于最近的屏幕上下文构建 Codex memories。

Chronicle 目前处于选择加入的研究预览阶段。目前仅面向 macOS 上的 ChatGPT Pro 订阅用户提供,且尚未在欧盟、英国和瑞士开放。启用前,请务必阅读隐私与安全部分,了解详细信息以及当前风险。

Chronicle 通过来自你屏幕的上下文增强 Codex memories。当你向 Codex 提示时,这些 memories 可以帮助它理解你一直在处理的内容,从而减少你重复说明上下文的需要。

Chronicle 作为选择加入的研究预览功能,在 macOS 的 Codex app 中提供。它需要 macOS 的屏幕录制和辅助功能权限。启用前请注意,Chronicle 会快速消耗 rate limits、增加 prompt injection 风险,并且会在你的设备上以未加密方式存储 memories。

Chronicle 如何提供帮助

我们设计 Chronicle 的目标,是减少你在使用 Codex 时需要重复说明的上下文量。通过使用最近的屏幕上下文来改进 memory 构建,Chronicle 可以帮助 Codex 理解你指的是什么、识别应使用的正确来源,并捕捉你依赖的工具和工作流。

使用屏幕上的内容

有了 Chronicle,Codex 可以理解你当前正在查看的内容,从而为你节省时间并减少上下文切换。

补全缺失的上下文

无需再小心构造上下文并从零开始。Chronicle 让 Codex 可以补全你上下文中的空缺。

记住工具和工作流

无需向 Codex 解释完成工作应使用哪些工具。Codex 会在你工作过程中学习,从长远来看为你节省时间。

在这些情况下,Codex 会使用 Chronicle 提供额外上下文。当有其他来源更适合完成任务时,例如读取特定文件、Slack 线程、Google Doc、dashboard 或 pull request,Codex 会使用 Chronicle 来识别该来源,然后直接使用该来源。

启用 Chronicle

  1. 在 Codex app 中打开 Settings。
  2. 前往 Personalization,并确保 Memories 已启用。
  3. 在 Memories 设置下方打开 Chronicle
  4. 查看同意对话框并选择 Continue
  5. 在提示时授予 macOS 屏幕录制和辅助功能权限。
  6. 设置完成后,选择 Try it out 或开始一个新线程。

如果 macOS 报告屏幕录制或辅助功能权限被拒绝,请打开 System Settings > Privacy & Security > Screen Recording 或 Accessibility,并启用 Codex。如果某项权限被 macOS 或你的组织限制,在限制移除且 Codex 获得所需权限后,Chronicle 将开始运行。

随时暂停或禁用 Chronicle

你可以控制 Chronicle 何时使用屏幕上下文生成 memories。使用 Codex 菜单栏图标可选择 Pause ChronicleResume Chronicle。在开会前,或在查看你不希望 Codex 用作上下文的敏感内容时,请暂停 Chronicle。若要禁用 Chronicle,请返回 Settings > Personalization > Memories 并关闭 Chronicle

你还可以控制是否在某个给定线程中使用 memories。了解更多

Rate limits

Chronicle 的工作方式是在后台运行沙盒 agents,从捕获的屏幕图像中生成 memories。这些 agents 当前会快速消耗 rate limits。

隐私与安全

Chronicle 使用屏幕捕获,其中可能包含你屏幕上可见的敏感信息。它无权访问你的麦克风或系统音频。未经他人同意,请不要使用 Chronicle 录制会议或与他人的通信。在查看你不希望被记入 memories 的内容时,请暂停 Chronicle。

Chronicle 将我的数据存储在哪里?

屏幕捕获是临时性的,只会暂时保存在你的电脑上。Chronicle 运行时,临时屏幕捕获文件可能会出现在 $TMPDIR/chronicle/screen_recording/ 下。Chronicle 运行期间,超过 6 小时的屏幕捕获将被删除。

Chronicle 生成的 memories 与其他 Codex memories 一样:它们是未加密的 markdown 文件,必要时你可以读取并修改。你也可以让 Codex 搜索它们。如果你希望 Codex 忘记某些内容,可以删除该文件夹中的相应文件,或者有选择地编辑 markdown 文件以移除你想删除的信息。你不应手动添加新的信息。生成的 Chronicle memories 会本地存储在你电脑上的 $CODEX_HOME/memories_extensions/chronicle/(通常是 ~/.codex/memories_extensions/chronicle)。

哪些数据会与 OpenAI 共享?

Chronicle 会在本地捕获屏幕上下文,然后定期使用 Codex 将最近活动总结为 memories。为了生成这些 memories,Chronicle 会启动一个临时的 Codex session,并授予其对此屏幕上下文的访问权限。该 session 可能会处理选定的屏幕截图帧、从屏幕截图中提取的 OCR 文本、时间信息,以及相关时间窗口内的本地文件路径。

用于生成 memories 的屏幕捕获会暂时存储在你的设备上。它们会在我们的服务器上被处理以生成 memories,随后这些 memories 会本地存储在设备上。除非法律要求,我们不会在处理后将这些屏幕截图存储在服务器上,也不会将其用于训练。

生成的 memories 是存储在 $CODEX_HOME/memories_extensions/chronicle/ 下的 Markdown 文件。当 Codex 在未来 session 中使用 memories 时,相关 memory 内容可能会作为该 session 的上下文被包含在内;如果你的 ChatGPT 设置允许,也可能会被用于改进我们的模型。了解更多

Prompt injection 风险

使用 Chronicle 会增加来自屏幕内容的 prompt injection 攻击风险。例如,如果你浏览了一个带有恶意 agent 指令的网站,Codex 可能会遵循这些指令。

故障排除

如何启用 Chronicle?

如果你没有看到 Chronicle 设置,请确认你使用的是包含 Chronicle 的 Codex app 构建版本,并且你已在 Settings > Personalization 中启用 Memories。

Chronicle 目前仅面向 macOS 上的 ChatGPT Pro 订阅用户提供。Chronicle 不在欧盟、英国和瑞士开放。

如果设置未完成:

  1. 确认 Codex 已获得屏幕录制和辅助功能权限。
  2. 退出并重新打开 Codex app。
  3. 打开 Settings > Personalization 并检查 Chronicle 状态。

生成 Chronicle memories 使用的是哪个模型?

Chronicle 使用与你其他 Memories 相同的模型。如果你没有配置特定模型,它会使用你的默认 Codex 模型。若要选择特定模型,请更新你的配置中的 consolidation_model

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