从神话代号回归纯净架构契约
从 v9 的 Mnemosyne 到 v19 的 Athena,过去每个大版本都有一位希腊神祇加冕。神格曾帮我们把认知架构的蓝图讲得生动明了,但当软件走向严谨工业化时,代号开始带来负担:代号渗透进监控探针与机器契约、多段版本号模糊了发布轻重、过于宏大的神名容易带来不切实际的过度宣称。
在 v20.0 中,aiduMEI 做出了最诚实也最成熟的决定:版本号回归简洁的两段式,运行时不再设神话代号。过往诸神退回演进史的路标,而真实的代码与架构契约全面站上前台。
| 版本阶段 | 设计范式 | 核心转变 |
|---|---|---|
| v9 - v19(神格纪元) | 神祇代号拟人化 | 功能特性逐层堆叠,探索 Agent 记忆能力上限 |
| v20.0(架构纪元) | 工业级数据契约 | 二维域硬隔离、反假绿灯评测、系统级最小权限降权 |
记忆域隔离根治静默数据覆盖
在以往的多 Agent 或复杂会话场景中,记忆归属往往依赖 source 或 agent_id 这种弱渠道标记。当不同领域的记忆发生键名碰撞时,旧记忆会被悄无声息地覆盖,无报错、无告警、无日志,造成严重的记忆污染与丢失。
v20.0 确立了 (user_id, bank_id) 二维记忆域硬契约:写、查、删、恢复、统计、事件账本、毕业链与画像,全链路必须显式声明所属域。非法作用域在触碰数据库前即刻阻断抛错,绝不发生全库扫描或交叉污染。存量老数据自动无缝平移至 default 域,实现零丢失、零停机的平滑过渡。
| 对比维度 | 旧版(渠道标记) | v20.0(域契约) |
|---|---|---|
| 归属模型 | 弱标记,依赖约定 | (user_id, bank_id) 二维强契约 |
| 碰撞处理 | 静默覆盖,无声丢失 | 唯一索引与域守卫拦截,主动报错 |
| 越界防护 | 可能发生全库扫描 | 取数前强校验,非法入参直接拒止 |
可复现评测协议与反假绿灯纪律
软件工程最忌讳的是“在封闭内循环里自说自话的假绿灯”。v20.0 全面引入了透明可复现的 benchmarks/ 评测框架:
- 真实 HTTP 契约:评测适配器一律走外部真实网络请求,拒绝走进程内函数直调捷径,测的就是真实生产服务本身。
- 参数全量锁死:测试数据集、模型版本、裁判标准、随机种子与文件哈希全部公开存证,任何人均可全链路复现。
- 多形态并测:彻底杜绝只测单一载荷导致的假通过,断言必须校验检索召回路径证据。
系统级最小权限与安全硬化
许多开源记忆服务默认以 root 身份长期裸奔,潜藏巨大的宿主机安全风险。v20.0 在部署安全性上实现了质的跃升:
将 systemd 守护进程与容器镜像全面收敛至专用低权限账号,关闭全部不必要的系统能力(Capabilities),文件系统采用只读保护。经 systemd-analyze 权威安全审计,系统安全暴露分由 9.6(UNSAFE)断崖式下降至 1.7(OK),系统 capability 项直接清零,为企业级私有化交付提供了坚实底座。
看得见想得通的可视化控制台
传统的记忆库往往是深不可测的黑盒,开发者根本无法得知某条记忆“为什么被想起、因何被淘汰”。aiduMEI 内置了由后端直接托管的零依赖 Web 控制台(/ui),提供六大核心洞察看板:
| 面板 | 核心能力 | 价值洞察 |
|---|---|---|
| PULSE 脉搏 | 服务健康与模块探针 | 11 个核心子模块健康状态实时监控,拒绝假在线 |
| VAULT 记忆库 | 语义检索与分类账本 | 向量、BM25与重排多路召回,分类家底清晰分明 |
| MAP 星图 | ECharts 交互知识拓扑 | 核心/知识域/实体四级节点,网状知识脉络一览无余 |
| RECALL 追忆 | 招牌召回漏斗链路追踪 | 候选池、点火、去重、衰减各阶段耗时与淘汰原因透明可见 |
| EVOLVE 进化 | 检索质量看板与反馈 | 7 天命中率与质量曲线,记录每轮自进化的微调依据 |
| SETTINGS 设置 | 模型配置与脱敏管理 | LLM、Embedding、Reranker 配置只读审计,密钥自动脱敏 |
三步快速体验与无损接入
无论你是刚刚接触 Agent 开发的新人,还是已有庞大知识库的资深团队,aiduMEI v20.0 均提供极其优雅的接入路径:
Docker 一键极速起跑:
docker pull ghcr.io/monkey2jack/aidumem:latest
docker run -d -p 8767:8767 --name aidumem ghcr.io/monkey2jack/aidumem:latest
源码拉取与定制:
git clone https://github.com/monkey2jack/aiduMEI.git
cd aiduMEI
pip install -r requirements.txt
python api_server.py
结语:从野蛮生长到规范立契,aiduMEI v20.0 标志着开源智能体记忆系统从“能用”迈向“严谨可靠”。牛市奔涌而至,懂记忆、会思考、能进化的 Agent 正在赋能每一位开发者。