记忆与地图索引

Alice 使用 SQLite 保存记忆原文和元数据；Chroma 是可选的语义检索增强，不是保存记忆的必要条件。

支持状态：已支持，部分能力依赖可选服务
Chroma 不可用时，基础存储和关键词检索继续工作；语义查询失败会降级为 SQLite LIKE 搜索。

需求

本模块适用于希望浏览、搜索、编辑或清理智能体长期信息，以及维护 Minecraft 路径点的用户。你需要理解：

• 记忆按工作区隔离，并包含类型、分支、标签、重要性和时间等元数据；
• 资料库、记忆、地图索引、技能和目标任务是知识与技能中的不同数据视图；
• 语义搜索依赖嵌入模型和 Chroma；关键词搜索只依赖 SQLite；
• 删除记忆会删除 SQLite 记录，并尝试同步删除向量与地图特征。

架构

写入流程先保存 SQLite，再在 Chroma 可用时生成嵌入并写入向量库。单条嵌入失败不会撤销 SQLite 写入，后台清理流程可重试未嵌入记录。

检索流程：

关键词搜索 → SQLite LIKE
语义搜索 → 嵌入模型 → Chroma → 回补 SQLite 元数据
                         └─ 任一步失败 → SQLite LIKE 降级

降级结果的 similarityScore 为 0，因此它表示关键词匹配，不应被解释为向量相似度。Chroma 初始化失败时 Alice 会记录警告并继续启动。

地图索引以 16×16 区块网格在内存中组织空间特征，原始特征和命名区域持久化在 SQLite。当前 地图索引 UI 主要管理路径点：维度、坐标、名称、描述和标签。空间索引加载或同步失败时，地图附近查询可能不可用，但普通 SQLite 记忆仍可使用。

执行

浏览和搜索记忆

1. 打开左侧 知识与技能。
2. 进入记忆。
3. 使用类型、标签或关键词筛选普通列表。
4. 需要语义召回时切换语义搜索并输入完整问题。
5. 打开记录详情，按需编辑内容、标签、重要性，或确认后删除。

成功标志：筛选结果只显示当前条件对应记录；编辑后重新打开可见新内容。

管理地图路径点

1. 在知识与技能中打开地图索引。
2. 选择主世界、下界或末地。
3. 新增路径点并填写 X/Y/Z、名称及可选描述和标签。
4. 保存后按维度或关键词检索。

判断是否发生降级

• 语义搜索仍有结果但相似度均为 0：可能已回退到 SQLite LIKE；
• Chroma 不可用：检查 Alice 日志中的“语义检索将降级”警告；
• 关键词搜索正常、语义搜索不稳定：优先检查 Chroma 和嵌入模型，而不是删除 SQLite 数据；
• 地图附近查询失败：检查 MapIndex 加载日志，普通路径点列表仍可通过 SQLite 查看。

不要把 Chroma 目录作为唯一备份。可靠备份必须包含 Alice SQLite 数据库；如需保留语义索引，再同时备份 Chroma 数据。

下一步：任务、计划与触发器 · 数据与隐私