记忆力
跨会话长期记忆：用户画像、笔记、纠正、项目记忆与过程技能。
路径：系统设置 → 高级管理 → 记忆力。返回 高级管理总览。
智能体默认只记得当前这一轮对话。换会话、压缩上下文后，之前交代过的习惯、约定、踩坑往往会忘掉。记忆力把这些信息落到本机，下次对话仍可检索使用。
它和 历史会话 不同：历史是某次聊天的原文；记忆力是从多轮对话里提炼出的长期知识（人设、笔记、教训）。
开箱即用
记忆力为产品内置能力，会话中会自动提供相关工具，不出现在插件管理中，也不能卸载。日常对话一般无需手动操作；本页用于查看、调整与维护。
高级管理 · 记忆力 · 概览：能力状态、条目统计与会话索引
一、它会记住什么
| 类型 | 说明 |
|---|---|
| 长期记忆 | 流程约定、结论、常用做法等助手笔记 |
| 用户画像 | 称呼、偏好、禁忌等「关于你」的信息 |
| 失败 / 纠正 | 曾出错或被你纠正过的事项，避免再犯 |
| 项目记忆 | 按工作目录沉淀的项目约定与背景 |
| 过程技能 | 智能体自己沉淀的操作流程（不是技能市场里的 Skill） |
对话中，智能体可按需搜索 / 写入 / 修改上述内容。默认不会把整本记忆一次性塞进提示，以节省 Token。
二、什么时候会用到
| 场景 | 记忆力怎么帮你 |
|---|---|
| 换了一个新任务 / 新会话 | 仍知道你的称呼、输出格式偏好、禁忌 |
| 同一项目反复协作 | 项目目录结构、术语、评审口径不用每次重讲 |
| 你纠正过它一次 | 「失败 / 纠正」里记下，下次少踩同样的坑 |
| 对话很长要压缩上下文 | 可先把要点刷进记忆，压缩后还能找回 |
| 要搜「上周那个方案怎么说的」 | 重建索引后，可用会话检索（不是翻聊天记录） |
你也可以在对话里直接说：「记住：对外材料一律用中文、金额保留两位小数。」智能体会写入记忆；之后可在本页 内容 里核对或改掉写错的条目。
三、和技能、历史会话的区别
| 历史会话 | 技能库 | 记忆力 | |
|---|---|---|---|
| 是什么 | 某一次聊天的全文 | 人为安装的专业说明书 / 流程 | 跨会话提炼出的长期知识 |
| 谁维护 | 侧栏会话列表 | 你拖 ZIP / 启停 | 智能体自动写 + 本页可改 |
| 换会话还在吗 | 要重新点开那条会话 | 启用后仍可用 | 在，可被搜索 |
过程技能是记忆力「自己练出来的小流程」，不要和技能市场里的业务 Skill 混为一谈。
四、页面结构
顶部有五个子标签：
| 标签 | 作用 |
|---|---|
| 概览 | 是否就绪、条目 / 字数、会话索引、数据与配置路径 |
| 参数 | 学习间隔、记满策略、刷写、策略文案、字数上限等 |
| 内容 | 按条目或全文编辑长期记忆、用户画像、失败纠正、项目记忆 |
| 过程技能 | 查看、迁移、删除 Hermes 过程技能 |
| 维护 | 重建会话索引、同步 Markdown → 检索库、按范围清空 |
五、概览
用于确认记忆能力是否正常工作。概览页以卡片展示：
| 卡片 | 说明 |
|---|---|
| 能力状态 | 如「已就绪」 |
| 长期记忆 / 用户画像 / 失败·纠正 | 条目数与字数上限（如 0 / 5000 字） |
| 项目记忆 | 按项目沉淀的约定数量 |
| 过程技能 | 智能体自沉淀流程数量 |
| 会话索引 | 已索引会话与消息规模 |
| 后台学习 | 是否开启及触发频率（如每 10 轮 / 15 工具） |
底部显示数据目录、配置文件路径，可复制或打开；修改参数后多项需新开会话才生效。
数据默认保存在本机用户目录下的 Agent 数据区（通常为 ~/.pi/agent/ 下的记忆配置与 pi-hermes-memory/ 等目录），不会随卸载程序自动删除。
六、参数（常用项）
| 选项 | 说明 |
|---|---|
| 记忆进入提示的方式 | 仅策略说明（推荐，省 Token）：只告诉智能体何时该去搜记忆；注入记忆摘要会占用更多上下文 |
| 策略文案详细程度 | 完整 / 精简 / 自定义 / 不注入；可点 预览 查看实际文案 |
| 后台自动学习 | 对话进行一段时间后，后台整理并写入记忆 |
| 识别用户纠正并立刻记 | 当你纠正智能体时，尽快记入失败 / 纠正记忆 |
| 每隔多少轮学习一次 | 默认约每 10 轮对话触发一次学习 |
| 记满后的处理 | 字数达到上限后：自动整理 / 拒绝写入等 |
| 压缩上下文前刷写记忆 | 手动 压缩上下文 前先把重要信息写入记忆 |
| 字数上限 | 分别限制长期记忆、用户画像、项目记忆（默认约 5000 字） |
不确定时保持默认即可。高级用户可切换 原始 JSON 编辑，或 恢复默认。
后台学习会消耗 Token
自动学习、纠错检测、整理记忆可能产生额外模型调用。若需严格控费，可在参数中关闭后台学习或拉长学习间隔。
七、内容
可切换查看：
- 长期记忆（
MEMORY.md） - 用户画像（
USER.md） - 失败 / 纠正
- 项目记忆（按项目选择）
支持 按条目 浏览、删除，或切换 全文 Markdown 编辑后保存。这里改的内容与智能体在对话中读写的是同一份数据。
建议：
- 改错、删过时信息：用条目视图逐条处理更安全；
- 批量整理、粘贴模板画像：用全文 Markdown；
- 改完若检索不到，到 维护 里点一次「同步 Markdown → 检索库」。
产品对中文检索做了增强（用户画像、姓名、习惯等），一般直接用中文问「我是谁 / 上次约定的格式」即可，不必改成英文关键词。
八、过程技能
智能体在工作中可能沉淀可复用的操作步骤（过程技能）。它们不是 技能库 / 技能市场里的业务 Skill。
本页可：
- 查看过程技能说明（
SKILL.md） - 迁移到用户技能目录或 Hermes 全局 / 项目范围
- 删除不再需要的过程技能
九、维护
| 操作 | 说明 |
|---|---|
| 重建会话索引 | 让历史会话可被记忆检索；新装或长期未索引时建议执行一次 |
| 同步 Markdown → 检索库 | 手动改过 md 文件后，同步到搜索库 |
| 清空数据 | 按范围删除本地记忆（须输入「清空」并二次确认，不可恢复） |
索引不是自动全量
仅安装记忆能力，不会立刻把过去所有历史会话变成可搜索。需要点「重建会话索引」，或在后续对话中逐步积累。