sedimem.

本地优先的个人 AI 记忆系统:真相层只追加,其余全部可重建。

831tests 0运行时依赖 14模块 v1.4.3当前版本
sedimem 首屏横幅
真相层 ~/.memo/items 只追加;索引、视图、派生皆可重建。

整体架构

整系统架构图:客户端→接口层→MemoryService→14 模块→数据层
客户端 → 接口层 → MemoryService → 14 模块 → 数据层;①②③ 标出主链路。

写入四道门

写入四道门
schema → 脱敏 → 去重(Dice 0.15 召回 / 0.85 判重)→ 冲突裁决(superseded / disputed)。

双路读

读路径:BM25±语义 → RRF → basis/degraded
BM25 ± 语义 → RRF k=60 融合;每条结果带 basis,语义不可用时降级 degraded。

LLM 派生层

LLM 派生层:outbox → sidecar
默认关:写 → outbox → LlmPort → derived sidecar。33 条全量重建 ≈1m50s、<¥0.02。

任务库

任务库生命周期
session:* 禁写 fact;close 只晋升 decision / gotcha,附六段交接 md。
memo session start memo session checkpoint memo session close

任务账本

任务账本:段 / 简报 / 捕获
会话转录折成可还原的段:关掉会话不丢、按锚点能展开原文;段永不进真相层,写前脱敏、可疑段隔离。
memo session capture memo session segments memo session brief memo session expand memo session archive memo brief --tier0 memo search

五层门禁

五层门禁
质量 15 + 安全 9 + 覆盖率 + docs-drift + pages-verify;870 tests、eval I1–I56。

记忆中心九页

今日页
今日页:四类变更卡 + 时间线。
图谱页
图谱页:kind 筛选 + 力导向。
卫生页
卫生页:待裁决簇 + 趋势。

九页:今日 / 图谱 / 搜索 / 卫生 / 编辑 / 导入 / 任务 / 交接 / 设置。启动:memo serve --port 7788,加 --write 才可编辑。

三端接入

三端共用同一 stdio MCP(10 个 memory_* + 5 个 memory_session_*)与同一 MEMO_HOME。

# DSH:~/.dsh/profiles/<profile>/cordis.patch.yml
- insert:
    - id: memory-sedimem
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: memo
        transport: stdio
        command: /opt/homebrew/bin/node
        args: ['/ABS/PATH/versions/v1.4/src/mcp/server.js']
        env: { MEMO_HOME: '$HOME/.memo' }
        toolCallTimeoutMs: 15000
# Codex CLI:~/.codex/config.toml
[mcp_servers.memo]
command = "/opt/homebrew/bin/node"
args = ["/ABS/PATH/versions/v1.4/src/mcp/server.js"]
enabled = true
[mcp_servers.memo.env]
MEMO_HOME = "$HOME/.memo"
# Claude Code
claude mcp add --scope user memo -e MEMO_HOME=$HOME/.memo -- \
  /opt/homebrew/bin/node /ABS/PATH/versions/v1.4/src/mcp/server.js

版本时间线

  1. v0.1 真相层 + BM25 + 四道门
  2. v0.2 只读观察台 + 版本规则
  3. v0.3 分层视图 + 注入分级
  4. v0.4 语义道 + 入库脱敏
  5. v0.5 DSH 插件化 + pages-verify
  6. v0.6 任务库 + 批量导入
  7. v1.0 14 模块重构 + 记忆中心
  8. v1.0.1 图谱可用性 + 配色对齐
  9. v1.0.2 思考链 / 重建 / 懒加载修复
  10. v1.0.3 分库归属硬门 + CI 门禁修漏
  11. v1.0.4 任务库可在观测台浏览(session 前缀修复)
  12. v1.0.5 任务页可用性:两栏 / checkpoint 八段 / 去重复渲染
  13. v1.1.0 记忆中心 UI 重做 + 任务库按任务命名/可删除
  14. v1.2.0 任务账本:段 / 简报 / 隔离 / 归档
  15. v1.2.1 简报可读性 / 决策精度 / capture 默认 LLM
  16. v1.2.2 Q16 发版面覆盖 + 任务账本文档
  17. v1.3.0 P0a 地基:CI/门禁/文档跟随 CURRENT
  18. v1.3.1 任务库术语与 MCP 入口修复(session:<id> 直达)
  19. v1.4.0 P0b 启动:英文 README/项目站(英图 + ?lang=en UI)、README 站点链接
  20. v1.4.1 自动捕获周期扫描:60s 检查 open 任务,30k 上下文自动落段
  21. v1.4.2 任务库多会话关联:自动登记全部开发会话,逐会话捕获
  22. v1.4.3 Codex 会话捕获:--codex 导入 + 自动登记 Codex 会话

规则:X.Y 换目录(当前 versions/v1.4),X.Y.Z 同目录补丁;当前版本 v1.4.3。

中文 · English