附录 A 术语表
本附录汇总 memU 与智能体记忆领域的高频术语，便于跨章节查阅。
A.1 核心概念
| 术语 |
英文 |
解释 |
| 工作区运行时 |
Workspace Runtime |
memU 的定位：把多源数据编译成智能体可读写的工作区 |
| 记忆文件系统 |
Memory File System |
用文件夹/文件隐喻组织 Category / Item / Resource |
| 写入路径 |
WRITE Path |
memorize() 把原始来源编译为结构化记忆 |
| 读取路径 |
READ Path |
retrieve() 分层召回上下文 |
| 作用域 |
Scope |
user_id / agent_id 等隔离维度 |
| 模态 |
Modality |
conversation / document / image / video / audio |
A.2 数据记录
| 术语 |
解释 |
| Resource |
原始来源素材，溯源链起点 |
| MemoryItem |
原子记忆，含 memory_type 与 summary |
| MemoryCategory |
主题文件夹，含演进式 summary |
| CategoryItem |
Item 与 Category 的归属关系边 |
| memory_type |
profile / event / knowledge / behavior / skill / tool |
| caption |
多模态预处理后的文本描述 |
| embedding |
向量表示，供 RAG 相似度检索 |
A.3 流水线步骤
| 术语 |
阶段 |
解释 |
| Ingest |
memorize |
拉取并登记 Resource |
| Preprocess |
memorize |
解析 / caption / 转写 |
| Extract |
memorize |
LLM 提取 MemoryItem |
| Categorize |
memorize |
分类、写库、算 embedding |
| Persist Index |
memorize |
更新 Category 摘要 |
| Route Intention |
retrieve |
判断是否需要检索 |
| Query Rewrite |
retrieve |
LLM 改写查询 |
| Category Recall |
retrieve |
主题层召回 |
| Item Recall |
retrieve |
记忆项层召回 |
| Resource Recall |
retrieve |
来源层召回 |
| Sufficiency Check |
retrieve |
判断上下文是否足够，可早停 |
A.4 检索模式
| 术语 |
解释 |
| RAG 模式 |
method="rag"，向量优先召回 |
| LLM 模式 |
method="llm"，LLM 阅读并排序 |
| 早停 |
充分性检查通过后不再向下层检索 |
| next_step_query |
建议的下一轮检索 query |
| salience ranking |
Item 层显著性加权排序 |
A.5 配置与组件
| 术语 |
解释 |
| MemoryService |
自托管主入口类 |
| llm_profiles |
LLM / Embedding 等 Profile 配置 |
| retrieve_config |
检索策略配置 |
| database_config |
存储后端配置 |
| UserConfig |
作用域字段模型定义 |
| WorkflowStep |
流水线原子步骤 |
| PipelineManager |
流水线注册与依赖校验 |
| Repository |
Resource / Item / Category / Relation 仓储抽象 |
A.6 存储后端
| 术语 |
解释 |
| inmemory |
进程内存后端，非持久 |
| sqlite |
单文件 SQL 持久化 |
| postgres |
生产级 Postgres 后端 |
| pgvector |
Postgres 向量扩展 |
| 暴力 cosine |
线性扫描算相似度，适合小规模 |
A.7 导出与生态
| 术语 |
解释 |
| export_memory_files |
导出 Markdown 记忆树 |
| INDEX.md |
资源索引页 |
| MEMORY.md |
记忆总览页 |
| SKILL.md |
技能索引页 |
| MemorySynthesizer |
合成 skill / MEMORY 的 LLM 组件 |
| memU Cloud |
托管 API 服务 |
| memU-server |
带 Webhook 的后端服务 |
| memU-ui |
记忆可视化面板 |
A.8 对比术语
| 术语 |
解释 |
| 传统 RAG |
文档切块 + embedding + Top-K |
| mem0 |
另一开源 Agent 记忆框架 |
| Locomo |
长程对话记忆评测基准 |
| Proactive Agent |
后台持续学习、主动推送的 Agent |
A.9 缩写
| 缩写 |
全称 |
| LLM |
Large Language Model |
| RAG |
Retrieval-Augmented Generation |
| PII |
Personally Identifiable Information |
| DSN |
Data Source Name |
| ADR |
Architecture Decision Record |
| CRUD |
Create / Read / Update / Delete |
参见：第 2 章核心概念；第 3 章数据模型；附录 B API 速查。