---
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="/zh-Hant/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)
