sedimem
Discovered★ 101sedimem · Local Cross-Session "Self-Iterative" Memory Layer: DSH / Codex CLI / Claude Code Share a Single Append-Only Layer of Truth, Focused on Tackling Redundancy, Duplication, Conflicts, and Staleness (MCP + Four Write-Hygiene Rules + Agent Adjudgement Loop)
doc-kind: manual doc-version: 1.3

中文 · English
AI 会忘记你,它不会。
- 🔒 真相层不可变:
~/.memo/items/<scope>.jsonl只追加、永不原地改,改过去 = 追加新版本,可as-of回查任意时点 - 🔌 三端共用一个记忆:DSH / Codex CLI / Claude Code 连同一个 stdio MCP server、同一个分库
- 🧱 零依赖离线:14 个模块,0 运行时依赖(Node ≥ 22.15,内置
node:sqliteFTS5),不开 LLM 也完整可用
它是什么
sedimem 是本地优先的个人 AI 记忆系统。所有数据只存在你的本机 ~/.memo/,真相层只追加不可改写,索引、视图、LLM 派生层全部可以删光重建。记忆像地层一样沉积,而不是被反复覆盖。
30 秒跑起来:
git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem
NODE=$(command -v node); V=versions/$(cat versions/CURRENT)
$NODE $V/src/cli/memo.js write --kind fact --title "CI 要求 Node 22+" --text "部署流水线要求 Node 22 及以上" --agent cli
$NODE $V/src/cli/memo.js search "node 版本"
$NODE $V/src/cli/memo.js serve --port 7788 # 记忆中心 http://127.0.0.1:7788
[!TIP] 不装也能试:
memo doctor/memo stats均为只读命令;记忆中心默认只读,加--write才可编辑(token + If-Match 防误写)。
为什么不用现成的
| 项目 | 强项 | sedimem 不同在哪 |
|---|---|---|
| mem0 | 自动提取、云端服务 | 它靠 LLM 抽取与改写;sedimem 真相层不可变,提取只进旁路派生层 |
| claude-mem | 跨 agent 自动记忆(117k★,支持 6+ harness 含 dsh) | 自动摘要为主;sedimem 三端共用同一 stdio MCP server,且有 as-of 与裁决 |
| dsh-engram | Windows 支持、图谱面板 | 图谱面板思路相近;sedimem 另有 as-of 回查与投毒可审计 |
| supermemory | 云同步、跨设备 | 云为主;sedimem 刻意本地优先,删 ~/.memo/ 即彻底清除 |
| 自建 Markdown | 简单可控 | 无索引、无去重、无冲突裁决;sedimem 有 BM25+语义检索与卫生门禁 |
[!NOTE] sedimem 没有云同步与多人权限——这是刻意不做,不是没做。
架构

- 三层单向:客户端 → 接口层(CLI / MCP / Web)→ MemoryService → 14 模块(api / config / core / storage / index / hygiene / render / views / session / capture / llm / mcp / web / cli)→ 数据层,依赖只朝下。
- 写入四道门:schema 校验 → 脱敏(密钥/内网域名/私有路径 →
[REDACTED:x],落盘前)→ 去重(contentHash / 实体键 / 汉字二元组 Dice 0.15 召回、0.85 判重)→ 冲突(同 slot 异值 → superseded 或 disputed,可交 Agent 裁决)。 - 派生旁路:LLM 总结走 outbox → sidecar(
derived/<scopeKey>.jsonl),失败只降级,真相层字节不变。
两条主链路的细节:
![]() | ![]() |
|---|---|
| 写入四道门:越往后越贵,便宜的先拦掉大部分噪声 | 读取双路融合:词法永远兜底,语义道不可用时显式 degraded |
[!IMPORTANT] 真相层(
~/.memo/items/)是唯一权威:只追加、永不原地改;索引/视图/派生可删光重建,重建不丢事实。
功能
| 能力 | 说明 | 命令 |
|---|---|---|
| 写入 | 四道门依次过,过了才追加 | memo write |
| 检索 | BM25(FTS5)± 语义道 → RRF k=60,结果带 basis,语义挂了显式 degraded | memo search |
| 简报 | 当前 scope 概览 | memo brief |
| 治理 | 去重扫描、冲突裁决、新旧取代、墓碑删除 | memo dedupe / curate / supersede / forget |
| LLM 派生 | 标题/摘要/标签旁路生成,默认关 | memo derive / llm |
| 任务库 | 任务级临时记忆,close 白名单晋升 | memo session |
| 记忆中心 | 九页 Web UI,默认只读 | memo serve --port 7788 |
| 体检 | 环境/分库/索引健康检查 | memo doctor / stats |
| 迁移重建 | 版本目录迁移、索引删光重建 | memo migrate / reindex / compact |
记忆中心
memo serve --port 7788,九页:今日 / 图谱 / 搜索 / 卫生 / 编辑 / 导入 / 任务 / 交接 / 设置。
![]() | ![]() |
|---|---|
![]() | ![]() |
| 页 | 干什么 | 页 | 干什么 |
|---|---|---|---|
| 今日 | 当天变化流 | 编辑 | --write 才可改 |
| 图谱 | 力导向全貌 + kind 筛选 | 导入 | 批量结构化 |
| 搜索 | 带依据(basis)检索 | 任务 | 任务库状态 |
| 卫生 | 待裁决簇 + 30 天趋势 | 交接 | 六段交接文档 |
| 设置 | 分库 / 配色 / 策略只读 |
LLM 总结层(可选)
默认 provider=none,整层不存在;开启后派生只写 sidecar,真相层字节不变。

mkdir -p ~/.config/sedimem && printf '%s\n' '<key>' > ~/.config/sedimem/llm-key && chmod 600 ~/.config/sedimem/llm-key
export MEMO_LLM_PROVIDER=openai-compatible MEMO_LLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4 MEMO_LLM_MODEL=glm-5.3-flash
memo llm status && memo llm test && memo derive --rebuild
成本实测(GLM-5.3-Flash):33 条全量重建 ≈1m50s、<¥0.02;派生失败只降级,不影响写入与检索。
[!NOTE] 开 LLM 后,标题/摘要/标签的生成请求会发往你配置的 provider;原始记忆文本仍只在本机,真相层不参与请求。
任务库(session: scope)
探索性工作先进 session:* 临时库(禁写 fact);close 只把 decision/gotcha 晋升主库(带 from-session:<id> 标签),其余随库废弃,并生成六段交接文档 docs/handoffs/<id>.md。
先对齐词:用户口语里的「任务库」有四个近邻,MCP 侧只认下面这张表;混用会写错库。
| 你说的 | 实际是什么 | 怎么建 / 怎么写 |
|---|---|---|
| 任务库 / 临时记忆库 / 任务上下文库 | session:<id>,任务级临时记忆,close 晋升 decision/gotcha | memo session start;MCP memory_session_start({title}) |
| 记忆分库 | repo:<name> / dir:<name>,项目长期事实 | MEMO_SCOPE;MCP memory_scope({action:"use", path}) |
| 任务看板 | DSH task_board_*,只放执行状态,不放上下文 | task_board_create |
| 任务账本 | 任务库里的 segments(会话转录折段) | memo session capture |
MCP 的默认动作:用户说「创建任务库 / 在任务库创建任务」时,先 memory_session_start({title}) 建 session:<id>,然后用 memory_write({kind:"decision"|"gotcha"|"state", scope:"session:<id>"}) 一次性写入(不必切库);memory_session_checkpoint/status/close 也带同一个 scope。需要看板再建 task_board_* 卡,卡片只写状态。只有连续多次写时才 memory_scope({action:"use", scope:"session:<id>"}) 切过去;close 会自动把当前 scope 恢复到主库。不要把任务库建成 repo:/dir: 记忆分库。

memo session start --title "调试锁竞争"
memo session checkpoint --intent "查锁竞争根因"
memo session status
memo session close # 晋升 + 生成交接文档
memo session sweep # 扫 14 天僵尸库
任务账本(v1.2)
任务库记「结论」,账本记「过程」:宿主压缩会把几十万 token 的对话折成几段摘要,细节、你的纠正、走过的弯路都会丢。 账本把会话转录折成可还原的段,关掉会话也不丢,需要时能按原文展开。

| 能力 | 说明 | 命令 |
|---|---|---|
| 折段 | 转录 → 段(区间 + 锚点 + 摘要 + 决策/卡点/文件),区间幂等 | memo session capture |
| 看段 | 段列表:区间 / 规则或 LLM / 是否隔离 | memo session segments |
| 简报 | 给下一个 agent 的「上下文接力」(pack schema 子集,≤4000 字) | memo session brief |
| 还原 | 按锚点重读转录,还原该段原文 | memo session expand --segment <id> |
| 归档 | 整任务移到 archive/(不物理删除) | memo session archive --yes |
边界:段存在 sessions/<taskId>/segments.jsonl,不进记忆库真相层 —— 不占配额、不过四道门、不进 facts、不进主库检索。
写段前强制脱敏;命中提示注入的段会被隔离(quarantined),不进简报。LLM 失败自动回落规则抽取,不阻塞 close。
接入三个客户端
三端各配一条 stdio MCP,指向同一个 server.js 和同一个 MEMO_HOME。常驻进程(DSH)记得先 memory_scope 对齐分库。
# DSH:~/.dsh/profiles/<profile>/cordis.patch.yml
- insert:
- id: memory-sedimem
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: memo
transport: stdio
command: node
args: ['/ABS/PATH/versions/v1.3/src/mcp/server.js']
env: { MEMO_HOME: '$HOME/.memo' }
# Codex CLI:~/.codex/config.toml
[mcp_servers.memo]
command = "node"
args = ["/ABS/PATH/versions/v1.3/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 -- \
node /ABS/PATH/versions/v1.3/src/mcp/server.js
自检:bash versions/v1.3/configs/verify-three-clients.sh(期望 PASS)。
工具面:10 个 memory_* + 5 个 memory_session_*,三端完全一致。
CLI 与 MCP 速查
| 命令 | 作用 |
|---|---|
write / search / brief / get | 写入 / 检索 / 简报 / 取单条 |
supersede / forget | 新值取代旧记录 / 删除(默认写墓碑) |
curate / dedupe / compact | 裁决去重簇 / 扫描候选 / 压缩 |
session / derive / llm | 任务库 / 派生重建 / LLM 配置 |
serve / doctor / stats | 记忆中心 / 体检 / 统计 |
reindex / migrate / view | 重建索引 / 版本迁移 / 视图 |
| MCP 工具 | 作用 |
|---|---|
memory_write / memory_search / memory_get | 写 / 检索 / 取单条 |
memory_brief / memory_stats | 简报 / 统计 |
memory_supersede / memory_forget | 取代 / 删除 |
memory_dedupe_scan / memory_curate | 去重扫描 / 裁决 |
memory_scope | 查看或切换分库 |
memory_session_*(5 个) | 临时库 start / checkpoint / status / close / sweep |
CLI 速查(全部子命令)
| 命令 | 作用 |
|---|---|
| `memo write --text "..." [--title "一句话标题"] [--kind fact] [--subject s] [--predicate p] [--agent dsh] [--value v] [--confidence 0.8] [--tags a,b] [--privacy private | shared] [--json]` |
memo search "..." [--limit 10] [--kind fact] [--as-of ISO] [--json] | — |
memo brief [--lines 80] [--tier0] | — |
| `memo view build | rebuild` |
memo view show L2 [--limit 50] [--json] | — |
memo view trace <recordId> [--json] | — |
memo view l3 plan [--json] | — |
memo view l3 apply --file drafts.json | — |
memo get <id> | — |
memo supersede <id> --value "..." [--text "..."] [--agent dsh] [--json] | — |
memo forget <id> [--purge] [--reason "..."] [--json] | — |
memo stats [--json] | — |
memo scope [--json] | — |
memo doctor [--json] | — |
memo reindex | — |
memo curate export [--limit 20] | — |
memo curate prompt [--limit N] [--json] | — |
memo curate auto [--limit N] [--dry-run] [--json] | — |
memo compact [--dry-run] [--grace 7d] [--json] | — |
memo curate status | — |
memo curate apply --file <任务包.json> | — |
| `memo curate apply | ->` |
memo dedupe scan [--threshold 0.45] [--dice 0.15] [--limit 50] [--json] | — |
memo dedupe apply --file decisions.json | — |
memo session start --title "..." [--repo <path>] | — |
memo session checkpoint [--scope s] [--file ck.json] [--from-summary sum.json] | — |
memo session status [--scope s] [--json] | — |
memo session close [--scope s] | — |
memo session sweep [--older-than 14d] [--json] | — |
memo session list [--json] | — |
memo session rename --scope session:<id> --title <t> [--json] | — |
memo session remove --scope session:<id> [--yes] [--json] | — |
memo session capture --scope session:<id> [--llm] [--dry-run] | — |
memo session segments --scope session:<id> [--json] | — |
memo session brief --scope session:<id> [--json] [--as-of ISO] | — |
memo session expand --scope session:<id> --segment <segId> [--to-file] | — |
memo session archive --scope session:<id> [--yes] | — |
memo migrate dsh-memory [--db path] | — |
memo serve [--port N] [--no-ui] | — |
门禁

本地脚本 = CI 脚本:质量 15 项 + 安全 9 项 + 覆盖率(lines ≥ 85 / branches ≥ 70 / functions ≥ 90)+ docs-drift + pages-verify,另含 761 tests 与 eval I1–I56。
node tools/quality-check.mjs && node tools/security-check.mjs && node tools/coverage-gate.mjs
文档地图
| 文档 | 解决什么 |
|---|---|
| docs/00 | 原则与硬需求 |
| docs/01 | 分层与失败模式 |
| docs/02 | 数据契约(唯一权威) |
| docs/06 | 三端落位与日常操作 |
| docs/07 | 门禁指标与阈值 |
| docs/08 | 记忆中心九页规格 |
| docs/research | 为什么自建(横评 8 系统) |
版本
| 版本 | 主题 | 状态 |
|---|---|---|
| v1.3.1 | 任务库术语与入口修复:MCP 统一「任务库=临时记忆库」、memory_write 支持 scope、memory_scope 补 session 示例 | ✅ 当前 |
| v1.3.0 | P0a 地基:CI 跑 CURRENT、覆盖率/Windows 冒烟去硬编码、engines 22.15、文档与门禁对齐 | ✅ 已发布 |
| v1.2.2 | 文档同步门禁 Q16 + README/项目站补「任务账本」章节与 CLI 速查 | ✅ 已发布 |
| v1.2.1 | 任务账本补丁:简报可读性与预算、决策抽取精度、默认走 LLM | ✅ 已发布 |
| v1.2.0 | 任务账本:会话转录折成可还原的段、简报、隔离与归档(memo session capture/brief/expand) | ✅ 已发布 |
| v1.1.0 | 记忆中心整体 UI 重做 + 任务库按任务命名/可删除(/api/tasks) | ✅ 已发布 |
| v1.0.5 | 任务页/交接页可用性:两栏布局、checkpoint 八段、重复渲染与浅色主题修复 | 已发布 |
| v1.0.4 | 任务库(session:*)在观测台可浏览:SCOPE_PATTERN 补上 session 前缀 | 已发布 |
| v1.0.3 | 分库归属硬门(跨库写入 fail-loud)+ CI 门禁不再被 tee 吞 | 已发布 |
| v1.0.2 | 三处真 fix(思考链/重建/懒加载)+ 文档改图为主 | ✅ 已发布 |
| v1.0.1 | 图谱可用性 + 配色对齐 DSH | ✅ 已交付 |
| v1.0.0 | 14 模块重构 + LLM 总结层 + 九页重做 | ✅ 已交付 |
| 更早(v0.1–v0.6) | 核心层、语义道、pages-verify 等 | 🔒 冻结 |
X.Y 换目录、X.Y.Z 同目录补丁;指针在 versions/CURRENT(当前 v1.3)。
FAQ
要 LLM 吗? 不要。provider=none 默认且完整可用,门禁/检索/brief/图谱全部零 LLM 成本。
开 LLM 花多少钱? 可忽略:33 条全量重建 <¥0.02、约 2 分钟;增量 drain 更便宜。
数据在哪? 全在 ~/.memo/,删目录即彻底清除,无任何云组件;不开 LLM 时数据不出本机。
三端怎么共库? 各配一条 stdio MCP,指向同一 server.js、同一 MEMO_HOME;常驻进程先 memory_scope 对齐分库。
能多人用吗? scope 是分类不是权限边界;多人协作需要独立部署与鉴权,这是刻意不做的。
和 mem0 / claude-mem 区别? 它们擅长自动提取;sedimem 重心在治理——三端共用 + as-of 回查 + 真相层不可变 + 投毒可审计。
Contributing
欢迎 Issue 与 PR。改文档请同步改契约(docs/02),门禁会拦 docs-drift。
In scope:bug 修复、检索与卫生算法改进、新 CLI/Web 能力(先开 Issue 对齐)。
Out of scope:云同步、多人权限、遥测上报。
Security
所有数据只在本机 ~/.memo/,无云组件、无遥测。脱敏发生在落盘之前:密钥、内网域名、私有路径写为 [REDACTED:x]。Web 界面默认只读,--write 模式需 token + If-Match。发现安全问题请先开 security advisory 而非公开 Issue。
License
MIT © 2026 Old Friends Gathering
Comments
Loading…
Similar plugins
by zilliztech
A persistent, unified memory layer for all your AI agents (e.g. Claude Code, Codex, DSH), backed by Markdown and Milvus.
★ 2.9k
↓ 4.1k/wk
MIT
Python
Nov 13, 2026
dsh plugin --profile agent add @zilliz/memsearch-dshImport local Codex CLI/Desktop, Claude Code CLI, and Claude Desktop conversations into DSH with project grouping, semantic history, and tool activity; bind an existing or replacement workspace and con
★ 0
dsh plugin --profile web add dsh-assembly.resumeby why913
DeepSeek Harness(dsh)的 MCP / Skill / 记忆管理工具:写入前先连接自检,连不上不写;从 Claude Code / Codex 一键迁移;可装成 dsh 插件,在 Web 里用 /mcp 命令和卡片操作。
★ 5
↓ 45/wk
MIT
JavaScript
Aug 17, 2026
dsh plugin --profile web add @why913/dshxby chenkezhen480
Semantic long-term memory for DeepSeek Harness: embedding-based retrieval over a persistent cross-session memory store, with model-facing tools, proactive per-question recall, automatic conversation summarization, and auto-selected embedding provider (apiKey present → API, otherwise local).
★ 0
Apache-2.0
TypeScript
Aug 17, 2026
dsh plugin --profile web add dsh-plugin-semantic-memoryby HarryHeYu
Cross-agent session continuity for DeepSeek Harness — continue work from Codex, Claude Code, Grok, ZCode and more with sessionFlow.
★ 3
MIT
TypeScript
Nov 11, 2026
dsh plugin --profile web add dsh-sessionflowby hr98w
融合 Claude Code 的 Auto Memory 与 Codex 的 Session 记忆整理,为 DeepSeek Harness 提供简单、透明、上下文友好的长期记忆。Claude Code-inspired Auto Memory meets Codex-inspired Session consolidation, bringing simple, transparent, and
★ 35
↓ 696/wk
MIT
TypeScript
Nov 1, 2026
dsh plugin --profile web add @hr98w/dsh-memory




