🧠 天使之魂
插件名称： Angel Memory
当前版本： 1.4.20
为 bot 提供长期记忆、用户画像、自主学习和动态人格能力。
天使之魂依赖天使之心提供的上下文能力。启用后，AI 可以在对话中主动记住重要信息、回忆过去的内容，并将学到的知识整理成笔记。
🚀 快速了解
| 项目 | 说明 |
|---|---|
| 是否需要固定命令 | 不需要，主要由 AI 自动调用记忆工具 |
| 能否长期记住信息 | 可以，但是否记录由 AI 判断 |
| 能否主动回忆 | 可以，AI 会根据当前话题检索相关记忆 |
| 能否生成用户画像 | 可以，管理面板可按用户查看画像记忆 |
| 能否学习知识 | 可以，AI 可主动整理并保存 Markdown 笔记 |
| 前置依赖 | 必须安装并启用天使之心 |
✨ 主要能力
长期记忆
AI 可以判断哪些内容值得长期保存，例如：
- 用户的重要偏好；
- 长期有效的身份或关系信息；
- 群聊中的固定规则；
- 经常重复出现的重要事实；
- 对未来对话有帮助的结论。
主动回忆
当新话题与过去的内容有关时，AI 可以检索核心记忆和相关笔记，再结合当前对话回答。
自主学习笔记
AI 可以把学到的知识整理成 Markdown 笔记，并加入知识索引，供以后主动查阅。
用户画像
系统可以将与某个用户有关的记忆按属性整理，形成可查看的用户画像。
🧩 三层认知架构
| 层级 | 作用 |
|---|---|
| 灵魂层 | 通过情感能量参数影响回忆深度、表达欲望和创造力 |
| 潜意识层 | 在后台进行记忆检索、整理、巩固和维护 |
| 主意识层 | 由大模型主动决定何时记忆、回忆或整理笔记 |
💬 普通用户怎么使用？
天使之魂没有必须记忆的用户命令。可以直接用自然语言表达需求。
希望 bot 记住某件事
@bot 请记住，我更喜欢猫而不是狗。
@bot 以后叫我秋月白。
是否写入长期记忆，仍由 AI 根据内容重要性和管理员配置判断。
让 bot 回忆过去
@bot 你还记得我之前说过喜欢什么吗？
@bot 我们以前讨论过这个项目吗？
让 bot 整理学到的内容
@bot 把刚才关于 Python 异步编程的内容整理成笔记。
以上是自然语言示例，不是固定命令。
🛠️ AI 内部记忆工具
这些是提供给大模型使用的内部工具，普通用户不需要手动输入。
| 工具 | 作用 |
|---|---|
angel_remember | 永久记录重要信息 |
angel_recall | 回忆核心记忆和相关笔记 |
angel_note_read | 按短 ID 分页读取笔记正文 |
angel_note_create | 整理并创建 Markdown 学习笔记 |
💓 灵魂状态系统
系统通过四个维度影响 AI 行为：
| 维度 | 作用 |
|---|---|
| RecallDepth | 控制回忆和检索的深度 |
| ImpressionDepth | 控制记忆生成数量 |
| ExpressionDesire | 控制回复长度和表达欲望 |
| Creativity | 控制回答的创造性 |
这些参数由系统和管理员配置，普通用户无法直接修改。
📚 知识笔记注意事项
天使之魂中的知识库更接近“AI 主动整理的短笔记”，不适合直接塞入整本书或超长文档。
推荐内容
- 结构化短条目；
- 单个明确知识点；
- 简短规则或经验；
- 便于以后直接查阅的笔记。
不推荐内容
- 整本书或完整论文；
- 很长且主题混杂的文档；
- 大段未经整理的聊天记录；
- 期待系统自动将所有长文全文注入对话。
仓库 README 建议使用约 100 字以内的结构化短条目，减少无关信息对上下文的干扰。
🖥️ 管理面板
管理员可以在 AstrBot 插件页面进入 memory-dashboard，管理：
| 页面 | 功能 |
|---|---|
| 总览 | 查看系统状态、提供商、记忆和笔记统计 |
| 记忆浏览 | 搜索、筛选、查看或删除记忆 |
| 用户画像 | 按用户查看画像记忆 |
| Tags 调试 | 查看文本命中的标签和记忆 |
| 向量检索 | 测试记忆向量查询 |
| 笔记索引 | 浏览和搜索笔记切片 |
| 笔记读取 | 按短 ID 读取笔记正文 |
| 导入导出 | 导出或导入中央记忆快照 |
| 维护状态 | 查看维护状态和下载备份 |
⚠️ 隐私与使用提醒
- bot 可能长期保存对话中被判断为重要的信息。
- 不要主动向 bot 提供密码、令牌、身份证号等敏感信息。
- 记忆内容可能受管理员配置、人格范围和会话范围影响。
- AI 可能记错、遗漏或错误理解信息，重要事项仍应人工确认。
- 不同人格或不同会话可能被映射到不同的记忆范围。
- 管理员可通过管理面板查看、删除、导出或导入记忆。
❓ 常见问题
Q：我说“记住”以后，它一定会永久保存吗？
不一定。AI 会结合内容和配置判断是否值得写入长期记忆。
Q：为什么 bot 没想起以前说过的事？
可能是内容没有被记录、记忆范围不同、检索没有命中，或相关记忆已被系统弱化和整理。
Q：它会记住群里所有聊天吗？
不是简单保存所有聊天。系统会从对话中提取值得保留的记忆，并进行检索、巩固和维护。
Q：不同群聊的记忆会混在一起吗？
管理员可以配置记忆范围映射。具体是否共享，取决于当前人格和会话配置。
Q：能删除错误记忆吗？
管理员可以在管理面板的“记忆浏览”中查看和删除记录。
📎 项目信息
- 显示名称：天使之魂
- 项目作者：kawayiYokami
- 当前版本：1.4.20
- 前置插件：天使之心
- 项目地址：https://github.com/kawayiYokami/astrbot_plugin_angel_memory
