AI 记忆

AI 记忆是 Codux 比较有主张的一块。它不是写进你仓库的一堆手写 CLAUDE.md。Codux 把记忆存在本地 SQLite，把用户习惯与项目知识分开管理，并在启动 AI CLI 前生成应用私有的上下文文件。

会被记住什么

会话结束后，Codux 会从对话里挑出能让未来回合更聪明的内容，其它噪声丢掉：

• 用户习惯 —— 编码风格、回复偏好、长期稳定的个人工作方式
• 项目笔记 —— 决策、约定、事实、bug 教训与近期工作笔记
• 刷新信号 —— 是否需要重新生成项目概述

重复或高度相似的笔记会合并；冲突按更新、更具体的事实替换。目标是持续进化的记忆库，不是对话归档。注意：项目概述本身是从你仓库的文件生成的，并不是从对话里抽取的——抽取器只负责标记它什么时候该刷新。

三层模型

层级	生命周期	装的是什么
用户记忆	跨项目	个人编码习惯、回复偏好、稳定工作方式
项目概述	按仓库	用途、技术栈、模块、常用命令与源码信号——由仓库文件生成
项目笔记	持续演化	决策、约定、事实、bug 教训与近期笔记

Token 控制

Codux 不会把整个记忆库都注入。启动时只在按作用域的预算内渲染一小组上下文：

• 稳定的用户记忆
• 当前项目概述
• 按注入预算选出的相关项目笔记
• 仍然有用的近期工作笔记

抽取提示会要求模型保持摘要简洁，注入也按作用域做预算，所以记忆可以持续增长，但每次启动的上下文不会无限膨胀。

怎么再喂回 AI

启动工具时，Codux 会在应用数据目录下构建一个记忆工作区，并渲染：

• MEMORY.md：启动索引
• memory-prompt.txt：以系统提示 / instructions 文件形式交给 CLI 的同一份上下文
• memory-recent.md：相关近期工作笔记
• CLAUDE.md、AGENTS.md、GEMINI.md：各支持 CLI 的工具入口文件

你的 AI 进程工作目录仍在真实仓库里；Codux 通过环境变量（Codex 则用 --add-dir）把这些文件指给 CLI，而不是往你的仓库里拷任何东西。所以：

• 队友不用被迫共用你的记忆
• 仓库的 .gitignore 不用专门加一行
• 记忆在本地——换台机器就换一份

数据存在哪

<Codux 应用数据目录>/
├── memory.sqlite3                          # 持久化存储（SQLite）
└── runtime-root/
    └── memory-workspaces/<project-id>/
        ├── MEMORY.md
        ├── memory-prompt.txt
        ├── memory-recent.md
        ├── CLAUDE.md
        ├── AGENTS.md
        └── GEMINI.md

设置

打开 设置 → 记忆 可以控制：启用记忆、自动注入、自动抽取、抽取间隔、最多保留近期会话数、跨项目用户记忆，以及 默认抽取供应商。记忆管理（从状态栏打开）会展示记录与 Token 估算，并支持删除记录、重新生成项目概述、刷新。

为什么这么设计

手写启动文件第一周还挺爽，过两周就过期了，团队也忘了更新，最后又回到「AI 每次都失忆」的状态。从真实会话和仓库信号里抽取记忆，能更诚实地反映你和这个项目当下到底在怎么写；而放在应用本地，错了也无所谓——不会泄露到仓库，也不会强加给团队。