你可以用三种方式让 Agent 记住你的偏好和项目约定：长期记忆、项目规则和系统提示词补充。它们都在「设置 → 记忆与提示词」中管理。需要交给 Agent 的密钥，则放在「密钥环境变量」里。
| 方式 | 作用范围 | 适合写什么 |
|---|---|---|
| 长期记忆 | 账号级记忆跨所有项目；项目记忆只在当前项目 | 个人偏好、项目硬约束、做过的事和踩过的坑 |
| 本对话记忆 | 只对当前对话 | 这次对话里临时约定的事 |
| 项目规则（AGENTS.md） | 只对这个项目，可以随代码版本管理 | 构建命令、目录约定、代码风格、禁止事项 |
| 系统提示词补充 | 某一类对话的全部对话 | 口吻、输出格式、固定的工作习惯 |
这几种方式都不能用来扩大 Agent 的权限或绕过安全规则。
长期记忆
长期记忆分两种：
| 深刻记忆 | 经验记忆 | |
|---|---|---|
| 写什么 | 长期有效、每次对话都该遵守的事实或约束，一句话 | 一次任务里得到的做法、坑、排查结论 |
| 怎么用 | 每次对话都带给 Agent | Agent 只看到标题，需要时再取全文 |
| 长度 | 每条不超过 200 字 | 每条不超过 4000 字，标题不超过 30 字 |
| 额度 | 每个范围最多 20 条，合计不超过 1500 字 | 不限条数 |
管理长期记忆
- 打开「设置 → 记忆与提示词」，找到「长期记忆」。
- 用范围筛选和「搜索记忆」找到要看的条目。
- 点击「新增记忆」，选择种类，填写内容（经验记忆还要填写标题）。
- 经验记忆可以「设为深刻记忆」，深刻记忆也可以「转为经验记忆」。深刻记忆额度满了时，需要先删除、合并或转换已有条目。
修改后新对话立即用上；已经开始的对话要等上下文压缩后才更新。
Agent 想写入长期记忆时，每一次都会弹卡请你确认，即使本对话关闭了安全确认。
本对话记忆
只对当前对话成立的约定，Agent 会记在本对话记忆里，上下文压缩后仍会保留。
- 点击对话里的「本对话记忆（N 条）」查看、编辑或删除。
- 需要长期保留时，选择「升级为项目记忆」，升级需经你审批。
项目规则
项目里的 AGENTS.md 是写给 Agent 的项目规则，Agent 在该项目里工作时会按目录层级读取。
- 打开「设置 → 记忆与提示词」，找到「项目规则」，选择项目。
- 列表显示该项目的规则文件，以及每个文件是否「生效」。点击「打开」查看或编辑。
- 要新建规则，在输入框填写规则文件路径（例如
services/api/AGENTS.md），点击「新建 / 打开」，写好后「保存」。所在目录必须已经存在。
项目根目录的规则在新对话或上下文压缩后生效；子目录的规则在 Agent 下一次操作该目录时生效。Agent 自己想修改规则时，会在对话里弹出审批卡。
系统提示词补充
在「系统提示词补充」中，可以为「聊天」「Agent」「复杂任务」「子代理」四类对话分别追加你的偏好，例如「回答先给结论再给理由」。
- 补充附加在内置角色定义之后，不会替换它；与安全规则冲突的补充不会生效。
- 保存后从下一条消息起生效，已经开始的对话也一样。
- 点击「清除我的补充」恢复默认。
密钥环境变量
API Key、AccessKey 等密钥保存在本机系统钥匙串里。Agent 执行命令时按变量名注入，看不到值，密钥也不会发给模型或显示在对话里。
- 在对话中录入：Agent 需要密钥时会弹出「录入密钥」卡片，粘贴密钥值后保存；不想提供时选择「暂不提供」。
- 手动管理：打开「设置 → 密钥环境变量」，填写「变量名」（例如
OPENAI_API_KEY）、「用途」和「值」，点击「添加」。已有变量可以「查看值」（30 秒后自动隐藏）、「改值」或「删除」。