---
title: "了解 Chronicle 记忆"
description: "Chronicle 是 opt-in research preview，用屏幕上下文帮助 Codex 构建 memories。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

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

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

<Cards>
  <Card title="Chronicle" href="https://developers.openai.com/codex/memories/chronicle">
    官方 Chronicle 说明、隐私和排错。
  </Card>
  <Card title="Memories" href="https://developers.openai.com/codex/memories">
    先理解 Codex memories 的启用、存储和线程控制。
  </Card>
  <Card title="Customization" href="/docs/codex/official/02-config-security/48-customize-behavior">
    Chronicle 只是定制层的一部分，不能替代项目规则。
  </Card>
</Cards>

## 当前定位

```mermaid
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 可能出现在：

```text
$TMPDIR/chronicle/screen_recording/
```

生成的 memories 默认在：

```text
$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 后能删除或编辑对应文件。

## 官方资料

- [Chronicle](https://developers.openai.com/codex/memories/chronicle)
- [Memories](https://developers.openai.com/codex/memories)
- [Data controls FAQ](https://help.openai.com/en/articles/7730893-data-controls-faq)
