aiduMEI ⚕ 爱嘟优忆思——智能体通用智慧引擎

让你的 AI Agent 真正记住你：混合检索 + 治理 + 可视化控制台 + 双引擎自动挡，单机自托管，MIT。 宿主（Hermes / Claude Code / Cursor / 任何 MCP 客户端）管短期对话，aiduMEI 管长期记忆。

当前公开版本 v21.1 正式版 —— 优忆思：一行 Prompt 全自动部署 · 双引擎自动挡 · 众神殿多 bot 记忆人格 · 市面独一份。（v21.1：众神殿地基版——多 bot/多 profile 各据一殿、记忆人格独立、跨殿默认隔离；含 v21.0 认知治理：记忆出身标签 / 知识溯源 / 记忆档案导出。详见 CHANGELOG。）

把这句话发给你的 AI Agent：

你现在是部署工程师。请按 https://github.com/monkey2jack/aiduMEI 的 prompts/install.txt 全文（13 行正典）在我这台机器上部署 aiduMEI，每步自己验证，不许假装成功。

正典会带它走完：环境检查 → 装依赖 → 选挡位 → 配 Key（向你索要，不编造）→ 起服务 → 真实写入/召回验证（不是只看 /health）→ 接入宿主 → 装定时任务与备份 → 给你出报告。

不用 Agent？手动五行：

git clone https://github.com/monkey2jack/aiduMEI.git && cd aiduMEI
python3.12 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt
cp mem0_config_local.json.example mem0_config_local.json && cp .env.example .env   # 编辑这两个文件填 Key
python api_server.py                                                              # → http://127.0.0.1:8767
python scripts/e2e_smoke.py --json                                                # 真实验证，PASS 才算数

三档引擎，按你的机器选（AIDUMEI_ENGINE_MODE=auto 为默认推荐；cloud / local 同理）：

容器化部署见 docs/DEPLOY_DOCKHOLD.md；Agent 侧的完整作业说明（验收探针、备份、维护）在 AGENTS.md。

这套东西部署起来重不重？取决于你选哪个挡位。（2 核 3.5G 云主机 · 2026-08-27 实测）

共同项：CPU 2 核足够、闲时 < 1%；/search 单次 0.14~0.23s；冷启动 5.2s；数据盘千级记忆约 13 MB 向量 + 数百 KB SQLite；前端 0 依赖；Python 3.10–3.12。

那 150 MB 花在哪、能不能省（实测，不是估算）：onnxruntime 运行库只 import 不加载模型 75 MB；bge-small-zh-v1.5 会话与权重约 122 MB；两档服务实测差 150 MB（构成项单独实测、与档差有共享页，两个口径如实并列不做加法）。我们试过压它：threads=1、ONNX arena 按需分配、malloc_trim、MALLOC_ARENA_MAX=2——四种旋钮实测全部无效；模型已是 fastembed 目录里最小的中文可用款（次小的多语言方案是它的 2.4 倍）。所以我们没假装优化，而是给了你开关：不需要备胎就选云端档，那 150 MB 一分不花。

备胎为什么常驻：双索引要求每一次写入都同步算一份本地向量——断供那一刻再加载模型也召回不到任何东西。备胎是提前备好的，不是临时找的。 其余的轻是刻意设计：向量库嵌入式落盘（无独立进程/端口）、不吃 GPU、相关性闸门先拦闲聊、SQLite+FTS5 兜底。一句话：云端档 1 核 1G 跑得动；自动挡/本地档建议 2 核 2G 起步。

按机器内存选挡（部署 Agent 请照此选）：可用内存充裕（≥2G 余量）且要「云断了还能本地召回全部历史」→ 用 auto（本地备胎常驻热备，那约 174MB 就是买这份断网韧性）；机器内存吃紧或不需要断网兜底 → 用 cloud（约 280MB，云断则如实 degraded、不本地降级）。别让内存紧张的机器默认跑 auto 再嫌重——挡位是给你按机器余量选的，选前先 free -m 看余量。

规划中（v21.2）冷备挡：本地模型不常驻（平时省那约 174MB），仅在云端失效时才加载 + 批量补算存量本地向量；实测中小库（约 1500 条）补算窗口十几秒，期间 degraded、补完全量恢复。它兼顾「平时省内存」与「故障后全量韧性」，代价是故障后有一个补算窗口（时长随库大小线性增长，大库需增量补算）。这正面回应「自动挡该按需加载」——热备（当前 auto）与冷备（规划）的取舍会并入选挡指南。

起服务后开 http://127.0.0.1:8767/ui：记忆浏览/搜索/调整、健康探针与挡位状态、联邦与演化、检索质量面板、记忆档案一键导出（Markdown，按出身分区、推断逐条标注「未经验证」）。

接入细节：docs/AGENT_INTEGRATION.md。

MCP 与 REST 同进程双栈：REST 在 :8767，MCP 在 :8766（stdio/HTTP 双传输）。鉴权纪律：非回环绑定必须配置 AIDUMEM_API_TOKEN，否则拒绝启动；确有公网暴露需求才显式设置 AIDUMEM_ALLOW_INSECURE_PUBLIC=1（默认关闭，开启会打 critical 日志）。工具分组与调用示例见 docs/AGENT_INTEGRATION.md。

Bearer 令牌（AIDUMEM_API_TOKEN）+ 控制台口令（PBKDF2）+ 注入防护 + 默认仅回环。启动后先查三个数：/health 的 health_status、degraded、probes.runtime_paths.data_dir_writable（未带凭据时探针脱敏，附 _redacted 说明）。三轮外部安全审计留痕见 docs/SECURITY-AUDIT-LEDGER.md。

全量环境变量登记册见 ducky/env_registry.py（代码即真相源，错拼会启动告警）。

测试层级如实说明（v19.4.1 P3-3）

读表口径：每行「通过 · 跳过」相加等于该形态、该日期下 pytest --collect-only 的收集数；不同日期的行分母可以不同（树在长），以各行括注的日期为准。跳过数按「轴」解释（见 docs/TESTING.md），不是失败。

# 全量回归
pytest tests/
# 编译检查
python -m compileall ducky api_server.py mcp_server.py

为什么要把 2036 和 1967 都写出来：2036 是本树开发环境 2026-09-15 实测（缺宿主 ×12）；1967 是生产机独立沙箱 2026-09-11 实测（de09794，宿主在场但沙箱缺多项可选轴）——两者的跳过轴不同，数字必须与环境、日期和测试树一起读（生产沙箱数待生产机 v21.1 实机复测更新）。

这 12 条不是玄学，自己就能验：十三条跳过轴（宿主、工具、可选依赖、模型文件）全部登记在册（docs/TESTING.md），HERMES_SRC 三态可控、两个方向都能复现：

# 2026-09-14 实测：先装齐依赖、部署模型缓存，并让 AIDUMEI_BENCH_DATA_DIR 指向含 locomo10.json 的目录
pip install -r requirements.txt -r requirements-dev.txt
pip install "mcp>=1.0.0,<2" ruff nltk regex numpy fastembed
python scripts/fetch_local_embed_model.py
pytest tests/ -q -rs | tail -1                                 # 无宿主：2036 passed, 12 skipped
HERMES_SRC=/path/to/hermes-agent pytest tests/ -q | tail -1    # 有宿主：2048 passed
HERMES_SRC=none pytest tests/ -q -rs | tail -1                 # 装了宿主也强制关掉，照旧 2036 passed, 12 skipped

上面代码块里的 有宿主：2048 passed 要十三条轴同时齐备才拿得到，宿主只是其中一条 —— 别把「装上宿主」当成「全绿」。

跳过轴全量登记（门控条数与实测逐行对账，改一条这里就红）：

跳过轴	门控用例数	位点
宿主 Hermes 源码	12	tests/test_hermes_plugin.py 整份
git 工作区	1	tests/test_v20_brand_policy.py（要 git ls-files 当比对基准）
scripts/backup_gate.sh + POSIX shell	8	tests/test_v19_4_1_backup_gate.py 整份
qdrant_client 已安装	1	tests/test_v20_vector_bank_contract.py
LoCoMo 数据集已就位	1	tests/test_v20_locomo_official.py（全量数据集扫描要真文件）
regex 已安装	1	tests/test_v20_locomo_official.py（拿 regex 给标准库 re 对拍）
numpy 已安装	1	tests/test_v20_locomo_official.py（拿 numpy.mean 给 sum/len 对拍）
nltk 已安装	13	tests/test_v20_locomo_official.py 与 tests/test_v20_benchmarks.py（官方 F1 的 PorterStemmer，换实现就不是官方口径）
git 可执行文件在场	6	tests/test_v20_gitignore_guard.py 整份（拿一个临时空仓当 ignore 判据，不碰本仓的 .git）
mem0ai 已安装	20	tests/test_v20_mem0_patch_layer.py 整份（补丁层疗法要真实基座在场；此前缺 mem0 是 20 条 ERROR 冒充真缺陷，现在诚实跳过）
fastembed 已安装	1	tests/test_v20_2_autoshift.py（自动挡备胎真模型测试；缺依赖诚实跳过，模型未部署时用例内二次跳过）
ruff 已安装	3	静态规则守卫：F821/F811/F841；缺依赖时跳过，发布门禁仍会拦截
mcp extra 已安装	7	MCP 导入面守卫 + 鉴权行为 + SSE 传输用例

生产机独立沙箱裸跑（宿主源码在场、不带 .env），实测跑出来是 1967 passed、26 skipped（2026-09-11，v20.5.1 本树 de09794）——跳过轴不同，数字必须与环境、日期和测试树一起读。

MIT License。SECURITY.md + docs/SECURITY-AUDIT-LEDGER.md：多轮外部安全审计逐条留痕（含我们驳回误报的理由）。MCP 层非回环绑定强制 token，否则拒绝启动。

• 需要嵌入与 LLM 服务（云端或本地备胎）——换来的是真语义检索与抽取质量；要「完全离线 + 亚毫秒」的极简场景，零依赖本地类工具更合适，这话我们不遮。
• 基准协议（LoCoMo / LongMemEval）已冻结，正式跑分待发布——benchmarks/RESULTS.md 如实登记。
• 本地 lite 挡与云端挡的召回重叠率实测有限（差异全部明码标价写在 docs），auto 挡存在的意义正在于此。

部署与运维：🤖 Agent Guide（Agent 唯一入口）· docs/HEALTH.md · docs/OPERATIONS.md · TROUBLESHOOTING.md · docs/BACKUP_RESTORE.md · docs/POSITIONING.md（与同类对比，口径全部可复算）

aiduMEI/
├── AGENTS.md / llms.txt    # Agent 部署入口与文档索引
├── api_server.py           # 主入口（API + /ui 控制台托管）
├── ducky/                  # 业务逻辑（hot/ pipeline/ speed/ salience/ federation/ evolve_mem.py …）
├── frontend/               # 控制台（零构建纯静态；js/vendor/ 本地 echarts）
├── tests/                  # 回归测试集（pytest）
├── prompts/install.txt     # 一行 Prompt 部署正典
├── docs/                   # 运维/健康/备份/容量/测试口径
├── scripts/                # e2e_smoke.py · report.py · restore_gate.sh 等
└── mem0_config_local.json  # 模型配置（gitignored，含密钥）

MIT — 详见 LICENSE。

_{aiduMEI⚕爱嘟优忆思（曾用名 aiduMEM / duMem，历史版本与文档中保留）｜Powered by monkey²}