Repository navigation
v1.0.0 — 记忆与生活层
v1.0.0 — 记忆与生活层
第一版公开:给聊天机器人一套能长期跑的记忆、情绪、表达和生活层。
不是新算法,是一套可落地的工程整合。
下载
| 附件 | 放哪 |
|---|---|
memory-plugins-v1.0.0.zip |
解压到 AstrBot/data/plugins/ |
life-loop-v1.0.0.zip |
解压后单独运行,不放进插件目录 |
安装顺序
- 插件解压进
data/plugins/,重启 AstrBot - 先只开记忆写入,不开注入,跑一天看摘要质量
- 私聊开注入 → 群聊开注入 → 最后接情绪层
- 生活层最后装,配好环境变量再开
--send
亮点
- 五类记忆:事件 / 事实 / 反思 / 技能 / 道理,分开存、分开检索
- 五路混合检索:向量 0.18 + 关键词 0.46 + 图谱 0.11 + 重要性 0.14 + 新鲜度 0.11
- 真的会忘:衰减、归档、180 天清理、相似合并、冲突标记、体检
- 情绪有边界:PAD + 10 标签,单条最多变 0.12,标签半衰期 45 分钟
- 生活层:没人找她时,也会看书、刷视频、午睡,笔记回流记忆
- 不覆盖人格:所有增强都是注入块,带 marker,可单独关掉
包含
| 模块 | 说明 |
|---|---|
astrbot_plugin_memory_brain |
记忆库、检索、遗忘、多模态、报表、面板 |
astrbot_plugin_persona_state |
情绪、好感、旧账、识海、精力曲线 |
astrbot_plugin_human_style_guard |
发送前清洗:客服腔、句长、分段、表情节奏 |
astrbot_plugin_self_style |
自我档案、语气样例 |
life/ |
生活层(独立进程,可选) |
能到什么程度(参考值,不是承诺)
| 指标 | 参考 |
|---|---|
| 单轮上下文 | 1.5–1.8 万 token,记忆注入约 300(≈2%) |
| 记忆规模 | 每天 60 条 → 一年 2.2 万;十年 22 万,约 2.4GB |
| 实际占用 | 开着 180 天清理时,稳定 100–200MB |
| 检索延迟 | 当前规模 p50 约 18ms |
| 成本 | DeepSeek 约 2–4 分/轮;一天 100 轮约 2–4 元;本地模型 0 |
| 生活层 | 一天 20–40 轮动作,笔记 3 条以上 |
存储不是瓶颈,保留策略才是。十年不用换硬件。
安装
cp -r plugins/astrbot_plugin_* /path/to/AstrBot/data/plugins/
cd life && python life_loop.py --once # 可选依赖:
pip install faster-whisper pilk # 可选,语音转写配置
- 默认只写记忆、不注入,确认摘要质量后再打开注入
- embedding 用插件配置里的
embedding_provider_id,没配就退化为关键词检索 - 生活层的外部依赖(QQ、adb、手机、模型)都是环境变量,不填就不启用
评估与测试
40 条中文问法:recall@1 88% · recall@3 100% · MRR 0.938 · p50 18ms
单元测试:74 通过(15 个需要 AstrBot 的自动跳过)
python -m unittest discover -s tests已知限制
- 需要自己配 embedding,否则只有关键词检索
- 生活层手机功能需要 adb + Android 设备
- 图谱面板节点超过一两千时需要抽稀
- 第一版,接口和表结构可能变
不包含
任何个人数据、聊天记录、人格文本、语音模型、API key。
License
AGPL-3.0-or-later,与 AstrBot 一致。