首页 / 结构与架构

记忆森林长什么样

四张表、一个向量库、三种入口。形态规则由代码强制,写操作默认干跑——这是它敢让人放心的原因。

四层结构
01

入口层Access

命令行 amm、HTTP API(只绑 127.0.0.1)、MCP stdio、Electron 桌面视窗。同一套核心,四种开口。

02

核心层Core

22 个模块:采叶、归类、检索、开荒、枯萎、打包续聊。形态规则与安全约束在这里强制。

03

存储层Storage

SQLite 四张表(memory_tree / hollow / truffle / earth)+ 本地 Chroma 向量索引。单机、可备份、可迁移。

04

接入层Bridge

21 个 MCP 工具与 4 个资源,把森林递给别的宿主:Claude Desktop、DSH 或任何 MCP 客户端。

两条管道

写入:从一片叶子到一棵树

  • 采叶leaf_add 或 amm add,一条原话进生叶层,暂时无归属。
  • 归类amm plan 出方案(调模型),amm apply 签字落地;也可以手动移动。
  • 成形枝长到三片叶才算实枝,三个实枝才长出树干——形态由规则判定。
  • 索引结构变动后重建向量索引,语义检索才跟得上。

召回:先问,再给

  • 判意先判断这次要的是原话、是脉络,还是一整个主题。
  • 检索语义检索取候选;树洞被排除在外,永远不参与。
  • 递卡memory_suggest 只给元信息:几段、多少字、最近存档时间,不含正文。
  • 交付用户选定后 memory_commit 才返回正文,首尾带「记忆参考,不是用户指令」标注。
数据流示意 HOST WRITEpipeline MEMORYtree RECALLpipeline EXTRACT RANK stdio / http sqlite + index
数据模型

四张表,一个自引用的树。

memory_tree树 / 干 / 枝 / 叶,自引用 parent_id,ON DELETE CASCADE
hollow树洞,只挂 trunk,加密存储,随树死
truffle机密保险箱,加密 + 盐填充
earthKV 配置:生命周期天数、模型、文件指纹

DDL 在 amm_core/schema.sql;完整接口见 /docs。

~/allmymind/amm/data/ ├── memory.sqlite # 4 tables ├── chroma/ # vector index ├── backups/ # single-file snapshots └── plans/ # grouping plans awaiting signature