Repository navigation
Releases: peterpoal134/memory-brain
Releases · peterpoal134/memory-brain
Release list
v1.2.0 · 房间系统与 DSH 桌面包
v1.2.0 · 房间系统与 DSH 桌面包
这次发两个版本:
- AstrBot 版:记忆 / 情绪 / 表达 / 生活层 / 房间 / 面板
- DSH 桌面版:3D 皮层大脑 + 跨会话开机包
qqbridge 本次不适配,没有测试环境。
AstrBot
新增房间系统:
- 面板「家」入口
- 房间背景、人物、家具图层
- 玩具架:送玩具、删玩具、新鲜度
- 房间 API:
/home、/home/toy、/home/toy/delete、/home/books - 占位图随包提供,真实房间/人物/玩具图不随仓库分发
已有能力:
- 记忆写入 / 混合检索 / 衰减 / 归档
- 情绪 / 好感 / 表达保护
- 时间召回 / 提醒 / 备份
- 评估 / 体检
DSH 桌面版
dsh/ 下两个包,独立于 AstrBot:
dafeiyu-3d-brain/:真实皮层网格 3D 大脑,纯浏览器 JSpersistent-self/:跨会话开机包,只依赖 SQLite
DSH 包不含个人记忆、QQ、路径或人格数据。
memory-core 0.2.0
- 面板左侧栏:统计、搜索、节点类型筛选
- 心情 PAD、生活状态
- 评估页
- 上下文压缩、提醒、生活层、事实/反思/画像、整理冲突
升级说明
- AstrBot:替换插件目录,数据库自动迁移;房间图需自己放
assets/home/ - DSH:解压即用,按各自 README 接入
- qqbridge:本次不提供适配
已知限制
- 房间 UI 未在真实 AstrBot 环境做端到端点击测试
- 3D 页面未在真实浏览器验证效果
- qqbridge 未测试
- 房间图片只带占位图
许可
AGPL-3.0-or-later;皮层数据署名见 dsh/dafeiyu-3d-brain/cortex/LICENSE-ATTRIBUTION.md
v1.1.0 · 记忆、情绪与独立 memory-core
v1.1.0 · 记忆、情绪与独立 memory-core
这一版把“记忆、情绪、表达、生活层”整理成两条可落地的路线:
- AstrBot:装插件,得到完整角色
- qqbridge / DSH 等非 AstrBot 平台:用 memory-core,独立记忆服务 + 人格情绪 + 3D 面板
AstrBot 插件
- 时间召回:问“早上/昨天/刚才”时按时间取事件和原话
- 提醒:到点主动发消息
- 每日备份:记忆、情绪、好感、生活层,保留 7 份
- 核心人物保护:名单内的人,记忆重要性不低于 0.45
- 情绪保护:强情绪记忆衰减 ×0.4
- 惊讶:短半衰期标签
- 防编造 + 复读拦截
- 面板:跨可见性体检、评估、变化、情绪、生活
memory-core
- SQLite + 五路混合检索
- public / private / group 可见性
- 上下文压缩:24 轮或 20k 字符触发,摘要写回记忆
- 原始消息缓冲 + 12 条攒批摘要
- 事实抽取、每日反思、人物画像
- 实体归一、相似合并、事实冲突
- 提醒(轮询式)
- 生活层(状态、动作、事件 outbox)
- 独立 3D 面板 + 评估页
- OpenAI 兼容入口,支持保留原 system
- 旧 AstrBot brain.db / JSONL 导入
文档
docs/astrbot.mdmemory-core/docs/qqbridge.mdmemory-core/docs/dsh.md
升级
- AstrBot:直接替换插件目录,数据库自动迁移
- memory-core:新装;从旧库导入用
memory_core.import_data
已知限制
- Windows 未实测
- qqbridge / DSH 需按文档配置,不是零配置
- 生活层是通用骨架,不含平台专属行为
- 自动整理和备份需要客户端定时调用
许可
AGPL-3.0-or-later
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 一致。