# 助手记忆与全局记忆

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/assistant_memory/

## 记忆是什么

记忆是长期保存的用户偏好、项目背景等稳定信息。

## 启用记忆与记忆工具

打开 **启用记忆** 是唯一的总开关。当前模型支持工具调用时,应用会在每次发送时自动加入内置 `memory_tool`;助手工具和对话工具列表中不会出现单独开关,也不需要手动勾选。

模型不支持工具调用时,应用会自动改为把记忆同步到系统提示词,避免记忆功能失效。无痕会话例外:不会读取、注入或修改长期记忆。

## 本地助手记忆与全局记忆

- **助手记忆**:只属于当前助手。适合项目专属助手等场景。
- **全局记忆**:所有选择“仅全局”或“共同使用”的助手共享。适合你的固定偏好、常用称呼、通用工作背景等信息。
- **共同使用**:同时读取全局记忆和当前助手记忆,模型能看到每条记忆的归属。新增默认放在助手记忆,用户明确要求跨助手共享时才写入全局;更新和删除按原归属执行。全局修改会影响其他使用它的助手。

默认仍为单组策略,已有助手保留原来的选择,不会自动开启共同使用。切换范围不会移动或删除已有记忆。共同使用模式的管理页可切换两组,新增、导入、整理和最近变更均针对当前分组。

## 记忆写入方式

记忆写入分三档，按助手设置，原生与 Web 聊天共用：
- **手动维护**：AI 可读取已有记忆，不可新增、修改或删除。
- **确认后保存**：AI 提出完整变更，你在确认卡中查看归属和修改前后内容，可直接编辑后保存或拒绝；确认前不会写入正式记忆。全局记忆会影响其他使用它的助手。
- **自动保存**：AI 可直接新增、修改或删除，保留撤销和最近变更。

升级保留原行为：原来关闭自动维护对应手动维护，开启对应自动保存；新助手默认仍为手动维护。Web 可在顶部助手菜单调整当前助手的写入方式，启用记忆仍在 App 中设置。确认主要用于控制记忆内容，不保证减少 token 消耗。

## 记忆读取方式

- **自动同步**:每次请求把最新记忆注入系统提示词,模型一定能看到,结果更可靠。记忆变化会改变系统提示词,相关提示词缓存需要重新建立。
- **按需读取**:系统提示词只保留稳定的记忆规则,模型通过 `memory_tool` 的 `read` 操作读取数据库中的最新列表。缓存前缀更稳定,但可能增加一次工具调用,模型也可能漏读。不支持工具的模型会自动回退到自动同步。

两种方式都不会重写历史对话。历史中的 `read` 结果保留调用时的快照;记忆被修改后,下一次 `read` 会返回数据库中的最新状态,并以它为准。

## 手动管理

在 **助手 → 编辑助手 → 基础 → 记忆** 中保存记忆设置后,可进入独立记忆管理页,手动新增、编辑、停用或删除记录。点击记忆行可编辑;右滑可显示提升/下放与编辑;左滑可删除。关闭“启用记忆”不会清空已存记忆,只是暂停读取、注入和自动维护。

## 最近变更(回收站)

记忆被修改、删除或 AI 整理整批替换前,旧内容会自动存入「最近变更」,在记忆管理页右上角菜单进入。快照保留 30 天,每条可一键恢复:原条目还在就用旧内容覆盖回去,已删除则以旧内容重新新增。恢复动作本身也会留快照,可再次回档。AI 在对话中自动记住或改动记忆后,会弹出「查看」提示,点查看直接打开该助手(全局记忆则为全局)的记忆列表核对改动,返回即回到对话;要恢复旧内容就从这里进入「最近变更」。

## 全局与助手记忆迁移

单条记忆支持在助手私有记忆和全局记忆之间迁移或复制:

- 在助手私有记忆页,可把单条记忆提升到全局记忆。
- 在全局记忆页,可把单条记忆下放到已开启本地记忆的助手。
- 迁移会移动原记录;复制会在目标位置新增一条,源记录保留。

## 迁移与克隆

**迁移或克隆记忆** 用于助手之间的本地记忆批量处理,入口在 **助手 → 编辑助手 → 基础 → 记忆 → 迁移或克隆记忆**,只对”已开启本地记忆”的助手展示。迁移会把源助手的本地记忆转移到目标助手;克隆会复制一份到目标助手,源助手保留原记忆。源助手和目标助手都需要开启本地记忆。

## 删除助手时

删除助手不会直接丢弃有内容的本地记忆。若该助手存在本地记忆,会先让你选择迁移到其它本地记忆助手,或明确删除这些记忆。关联对话仍会按助手删除规则转移到默认助手。

## 时间间隔提醒

1.5.0 起,时间间隔提醒改为可选开关(默认关闭),入口从记忆面板移至 **助手 → 编辑助手 → 基础**(对话行为卡片的「时间间隔提醒」开关)。需要时再开启;未开启时,记忆本身的注入与自动维护不受影响。

## Pro 记忆 AI

Pro 会员在记忆管理页可用两项 AI 能力：

- **批量导入**:复制页面提供的「提取提示词」→ 粘贴到其它 AI 平台让它整理你的记忆 → 把结果粘贴回来，AI 解析预览后自动去重批量入库。适合从其它工具一次性迁移大量记忆。已有 .md / .txt 记忆文件(如桌面 agent 的 CLAUDE.md)时，点「从文件导入」直接读取，不必复制粘贴。
- **桌面 agent 迁移**:Claude Code、Codex 等桌面 agent 可通过 Web 服务器直接写入记忆，见「桌面 Agent 迁移」。
- **智能整理**:让 AI 对现有记忆自动去重、合并、精炼，把零散或重复条目收敛成更干净的集合。可以整理全部，也可以**长按进入多选、勾选部分条目仅整理所选**，未选的原样保留——适合只精修某一类记忆而不动其余。

## 最佳实践

- 批量导入先复制本页给的提取提示词，到其它平台生成结构化结果再粘回，识别率最高。
- 智能整理会修改、合并已有条目,确认替换后原始内容会保留在「最近变更」中,30 天内可恢复。
- 只想精修某一类记忆时，用多选「整理所选」，未选条目原样保留，避免全量改动。
- 两项均为 Pro 专属；非 Pro 点击会引导开通。