AI 记忆库的使用

AI 记忆库是 MBAgent 跨会话保存的长期记忆。它能让 AI "记住"您的偏好、账号信息、业务规则，避免每次新会话都重新解释。

NOTE

截图说明：AI 记忆库管理界面的截图（记忆条目列表、按分类筛选、添加 / 编辑 / 删除记忆按钮）将在 v1.x 版本陆续补充。本节按文字步骤操作即可。

---

一、什么是 AI 记忆？

MBAgent 区分两种"记忆"：

类型	范围	用途
会话级记忆	仅当前对话	"刚才那个数字"AI 记得
AI 本地记忆库	跨会话永久	您的偏好、账号、业务规则

TIP

类比：会话级记忆是"这次聊天的临时记忆"，AI 本地记忆库是"您的私人档案"。

---

二、AI 记忆库能存什么？

适合存的内容：

• ✅ 您的偏好（"回复风格要正式、严谨、不用 emoji"）
• ✅ 账号信息（"我的候鸟账号 ID 是 123456"）
• ✅ 业务规则（"客户 ID 总是 32 位字符串"）
• ✅ 重要事实（"我们公司主要做欧美市场"）
• ✅ 常用术语（"GMV = Gross Merchandise Value"）

不适合存的内容：

• ❌ 临时性信息（"今天订单是 100"）
• ❌ 敏感凭据（密码、Token、API Key）→ 这些走凭据管理器
• ❌ 大段文档 → 这些走 KMS 知识库

---

三、AI 记忆库的存放位置

记忆库文件存储在 MBAgent 用户配置目录下：

%LOCALAPPDATA%\mbagent\memory\
├── user.md            ← 用户级记忆（所有会话共享）
├── project\
│   ├── my-project.md  ← 项目级记忆（仅当前项目可见）
│   └── ...

• 用户级记忆：所有工作区、所有会话共享
• 项目级记忆：仅当前工作区（项目目录）的会话可见

---

四、添加记忆

方法 1：直接在对话里让 AI 记

最自然的添加方式：

用户：记住我的候鸟主账号是 123456789，主要做欧美亚马逊市场。

MBAgent：好的，我已添加到您的 AI 本地记忆库。

AI 会自动判断哪些信息值得记下来。

方法 2：在记忆库管理界面手动添加

1. 点击左侧栏的 "AI 本地记忆库" 入口
2. 点击 "+" 按钮
3. 选择记忆类型（用户级 / 项目级）
4. 输入标题和内容
5. 点击 "保存"

方法 3：使用 slash command

在聊天输入框输入：

/memory add 我的候鸟主账号是 123456789

AI 会自动归类到合适的记忆类别。

方法 4：从对话中沉淀

1. 在聊天中找到一段有用的信息
2. 右键 → "添加到记忆"
3. 选择记忆类型（用户级 / 项目级）
4. 保存

---

五、记忆类型与分类

AI 记忆库支持多种分类，方便管理：

类型	用途	示例
账号信息	候鸟账号、API Key 编号（不含实际 Key）	"主账号 123456"
业务规则	工作流程、命名规范	"客户 ID 32 位"
偏好设置	写作风格、回复格式	"回复要正式严谨"
重要事实	业务背景、公司信息	"主营欧美亚马逊"
常用术语	专业词汇	"GMV = 总成交额"
其他	不属于以上分类的	"API 网关域名"

---

六、查看与编辑记忆

查看所有记忆

1. 点击左侧栏 "AI 本地记忆库"
2. 弹出记忆浏览器，显示所有记忆条目
3. 按分类筛选、按时间排序

编辑记忆

1. 在记忆列表里点击任意一条
2. 右侧出现编辑面板
3. 修改标题、内容、分类
4. 点击 "保存"

删除记忆

1. 选中要删除的记忆
2. 点击 "删除" 按钮
3. 确认删除（不可恢复）

TIP

定期整理：建议每月整理一次记忆库，删除过时或错误的信息。

---

七、AI 如何使用记忆？

自动检索

每次新会话开始时，MBAgent 会自动从 AI 记忆库里检索与当前任务相关的记忆，作为 system prompt 的一部分。

例如，您问"我主账号今日订单怎么样？"：

• AI 自动检索到"主账号 123456"的记忆
• 自动调用候鸟浏览器 API 查 123456 的今日订单
• 不需要您重复说"我的主账号是 123456"

主动引用

AI 在回复时会显式提到它"记得"的信息：

"根据我之前记录的偏好，我会用正式严谨的风格回复。"

学习沉淀

autoLearn 设置开启后，MBAgent 会自动把"有意义的会话"沉淀为记忆：

1. 进入 "设置 → 偏好"
2. 找到 "autoLearn" 选项
3. 开启后 MBAgent 会分析每次会话
4. 把"值得记的"自动添加到 self_learn 记忆库（与您的主动记忆分开）

---

八、记忆库的最佳实践

推荐做法

✅ 第一次用 MBAgent 就建立几条关键记忆：

• 您的候鸟主账号编号
• 主营业务范围
• 偏好的回复风格

✅ 发现 AI 反复问同一个问题时，立刻记下来：

• AI 反复问"您的客户 ID 是什么"，那就记下来

✅ 不同项目用不同的记忆范围：

• 项目 A 的记忆只放项目 A 的目录
• 用户级记忆放通用信息

✅ 记忆要有结构：

• 标题清晰
• 内容简洁
• 用 markdown 列表组织

反模式

❌ 不要把敏感凭据放记忆库：

• 密码、Token、API Key 走凭据管理器
• 记忆库文件是普通文本，不加密

❌ 不要把整个文档塞进记忆库：

• 文档、参考资料走 KMS 知识库
• 记忆库只放"规则、偏好、关键事实"

❌ 不要让记忆库过度膨胀：

• 记忆太多反而稀释 AI 注意力
• 保持记忆条目 < 50 条

---

九、记忆库 vs 其他功能

功能	用途	大小
AI 记忆库	偏好、规则、关键事实	小（KB 级）
本地知识库（KMS）	完整文档、参考资料	大（MB 级）
会话	一次对话的完整历史	中（KB-MB 级）
RAG 候鸟官方知识库	候鸟业务远程检索	远程

TIP

选哪个：

• 简单偏好 → AI 记忆库
• 完整文档 → KMS
• 一次性问答 → 会话
• 候鸟业务知识 → 候鸟 RAG

---

十、记忆库故障排查

Q1：AI 似乎没"记住"我之前说的话

可能原因：

• 记忆库没保存成功
• 记忆被默认忽略（与当前任务无关）
• 记忆库文件损坏

排查：

1. 进入 "AI 本地记忆库" 查看记忆是否存在
2. 手动让 AI 重新记忆并显式确认

Q2：AI 用了错误的记忆

可能原因：

• 记忆分类错误（用户级被放到了项目级）
• 记忆内容过时

排查：

1. 编辑该记忆
2. 修正或删除

Q3：如何备份记忆库？

1. 找到记忆库目录 %LOCALAPPDATA%\mbagent\memory\
2. 整个文件夹复制到备份位置
3. 恢复时反向操作

Q4：不同电脑之间能同步记忆吗？

✅ 可以，但需要手动：

1. 在 A 电脑导出记忆（备份文件夹）
2. 在 B 电脑导入（覆盖文件夹）
3. 重启 MBAgent

NOTE

候鸟暂未提供云端记忆同步服务。建议重要记忆手动备份。

---

下一步：候鸟浏览器控制端对接 → 把 MBAgent 与候鸟浏览器连起来。