影策Agent记忆系统使用指南:让AI记住你的创作偏好
影策Agent记忆系统使用指南:让AI记住你的创作偏好
open-ai-canvas(影策)是一款面向 AI 影视创作的开源无限画布工作台,它的 Agent 记忆系统能把你反复验证过的创作偏好——常用模型、分镜习惯、提示词套路——沉淀成可复用经验,让画布助手越用越懂你。本指南带你 10 分钟上手:查看、批准、添加、压缩和导出 Agent 记忆。
记忆系统解决什么问题?
没有记忆时,每次新会话 Agent 都是"失忆状态":你说过"视频统一 16:9、720P",下次它照样默认配置。而启用记忆系统后:
- 🧠 已批准的记忆会注入会话:Agent 在每次对话的系统提示中携带你的经验索引
- 🔁 做法可复现:不只记"结论",还能记录"依次用哪个工具、每步做什么"的完整路线
- ✅ 人工审核兜底:Agent 自动记下的内容需你批准才生效,不会被错误经验带偏
找到记忆管理面板
记忆管理有两个入口:
- 设置页 → Agent 记忆:完整的记忆列表、压缩设置、导入导出都在这里
- 画布 Agent 面板 → 设置 → 个人记忆:在对话中就能快速批准/查看,只影响你自己的会话
记忆的组成:一张"经验卡"
每条记忆就是一张结构化卡片,字段不多,但都服务于"换个项目也能用":
| 字段 | 说明 | 示例 |
|---|---|---|
| 主题(topic) | 短标识,便于检索 | video.duration |
| 分类(category) | 分镜 / 视频生成 / 图像生成 / 画布操作 / 资产 / 模型选择 / 流程顺序 / 计费 / 其他 | 视频生成 |
| 适用场景(situation) | 什么情况下用这条记忆 | 生成口播短视频时 |
| 做法(lesson) | 一句话说明该怎么做 | 时长固定 8 秒,画幅 16:9 |
| 路线步骤(steps) | 依次用哪些工具、每步做什么 | 最多 12 步 |
💡 写不出"做法"时,就填路线步骤——Agent 也支持这种只带 steps 的记忆。
三种方式让记忆产生
方式一:Agent 自动沉淀(推荐)
当 Agent 在一轮任务中真正跑通了会改变画布或生成结果的操作后,它可以调用内置工具 remember_lesson 把路线记下来。注意三个约束:
- 只读模式下不能写记忆,也没有"空手记经验"的机会
- 单轮最多记 3 条,待批列表上限 50 条,待批记忆 30 天未处理自动过期
- 内容相同的重复记忆会自动合并,记为"又被验证一次"
方式二:手动添加,立刻生效
点击「添加记忆」,填写主题、分类、适用场景和做法(或路线步骤),保存后立刻对你的 Agent 生效,无需等待批准。适合记录明确的个人偏好,比如"我所有项目都用某某模型出图"。
方式三:导入已有记忆
支持导入本产品导出的 JSON 文件(agent-memories-日期.json),会自动去重:新条目导入、重复条目合并、无效条目跳过,并在界面上提示"导入 X 条,合并 Y 条,跳过 Z 条"。
如何批准或拒绝一条记忆
Agent 自动记下的记忆默认处于「待审」状态。在状态筛选栏切到 待审,逐条处理:
- 批准 → 之后的会话会用到这条记忆
- 拒绝 → 不会再注入会话
- 已批准的记忆也能随时编辑(改写法)或删除(从 Agent 上下文中移除)
记忆页右上角还带有每条记忆的使用数据(注入次数、命中次数),帮助你判断哪些经验真的在用。
记忆如何在对话中生效?
生效机制比较克制,这也是它省 token、防干扰的关键设计:
- 只注入索引:系统提示末尾只带已批准记忆的"标题 + 适用场景",不带全文
- 按需取全文:Agent 判断与当前任务相关时,才用
recall_lessons工具按 topic / 分类 / 关键词检索完整做法 - 仅供参考:检索命中不代表必须执行,Agent 不得把记忆复述成新指令
- 写入脱敏:链接、资源键、任务 ID、节点 ID 等无法写入,强制经验写成"脱离当前画布也成立的通用说法"
相关行为约束可见 agent-system-policy.md。
压缩优化:让记忆库保持精干
记忆多了容易堆出"近义条目"。面板顶部的「压缩优化」卡片会用你指定的文本模型做一次整理:
- 合并相近条目、改写含糊内容、删除冗余
- 压缩按所选文本模型计费,执行后会在页面上展示"合并 X · 改写 Y · 删除 Z"的结果摘要
- 周期可选:手动 / 每天 / 每周 / 每月,也可随时点「立即压缩」
压缩任务实现见 cloud_agent_memory_compact.go。
导出与备份记忆
点击列表右上角的导出图标,即可获得一个标准 JSON 文件,方便换环境迁移或留档。导入时同样走上面的去重合并逻辑,放心重复导入也不会产生大量重复条目。
常见限制速查
| 问题 | 说明 |
|---|---|
| 为什么提示"最多记录 3 条"? | 单轮运行上限,建议合并成更通用的一条 |
| 为什么待批满 50 条就记不了了? | 先到记忆页批准或删除,清理后再记 |
| 为什么保存失败提示"不能出现链接/ID"? | 记忆会做机械脱敏,请改写成通用说法 |
| 记忆会影响别人吗? | 不会,记忆按用户私有存储,只注入你自己的会话 |
相关模块路径
- 记忆管理面板:agent-memory-pane.tsx
- 前端 API 封装(列表 / 批准 / 导入导出 / 压缩):agent-memories.ts
- 记忆写入、去重与脱敏实现:cloud_agent_lessons.go
- 压缩任务定义:cloud_agent_memory_compact.go
- 画布 Agent 设置(个人记忆入口):canvas-cloud-agent-settings.tsx
- 设置页导航注册:settings/index.tsx
小结
影策的 Agent 记忆系统用"经验卡 + 人工批准 + 索引注入"三步,把 AI 从"每次从零开始"变成"带着你的创作习惯上场"。建议第一次使用时:先手动添加 2~3 条最常用偏好 → 跑一轮真实任务让 Agent 自动沉淀 → 批准有用的条目 → 定期用压缩优化保持记忆库精简。

