瞭解 Chronicle 記憶

Chronicle 是 Codex memories 的擴充套件：它從最近螢幕上下文中提取線索，幫助 Codex 在後續執行緒裡更少重複詢問“你剛才在做什麼”。

Chronicle 會處理螢幕內容，可能包含敏感資訊。啟用前先確認許可權、地區可用性、rate limits、prompt injection 風險和本地儲存位置。

Chronicle

官方 Chronicle 說明、隱私和排錯。

Memories

先理解 Codex memories 的啟用、儲存和執行緒控制。

Customization

Chronicle 只是定製層的一部分，不能替代專案規則。

當前定位

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 可能出現在：

$TMPDIR/chronicle/screen_recording/

生成的 memories 預設在：

$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 後能刪除或編輯對應檔案。