MIT、零运行时依赖的本地优先记忆系统(Node ≥ 22,内置 `node:sqlite` FTS5),以 stdio MCP server 的形式接入 DeepSeek Harness,把历史会话里的决策与经验沉成不可改写的追加式真相层,并可按 `as-of` 回查任意时点。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-15
许可证
MIT
01它能帮你完成什么?
让 DeepSeek Harness、Codex CLI 与 Claude Code 读写同一份记忆,跨会话不再丢上下文
`~/.memo/items/<scope>.jsonl` 里只追加的真相层,用 `memory_search` 按 BM25 加可选语义道 RRF 融合检索,并能 `as-of` 回查任意历史时点
每次开新会话都要把项目事实、决策和经验重讲一遍的 DSH 用户
治理不断堆积的记忆,避免冗余、冲突与过时事实继续腐化
去重扫描、去重簇裁决、新旧取代与墓碑删除,外加待裁决簇和 30 天趋势的卫生页
长期本地使用、近似重复或互相矛盾的笔记已经多到没人敢信记忆的团队与个人
在不改动数据的前提下看清 Agent 当天到底记住了什么
http://127.0.0.1:7788 的九页记忆中心:今日、图谱、搜索、卫生等,默认只读,只有加 `--write` 启动才可编辑
在真实项目里依赖这份记忆之前,想先自己核对一遍的人
02如何接入 DeepSeek Harness?
前置条件
- Node ≥ 22 —— sedimem 零运行时依赖,靠 Node 内置的 `node:sqlite` FTS5。
- 一份仓库本地副本(`git clone https://github.com/Old-Friends-Gathering/sedimem`)。
- 一个可编辑 `~/.dsh/profiles/<profile>/cordis.patch.yml` 的 DSH profile。
安装步骤
- 01
克隆后照 README 的 30 秒快速上手跑一遍:`git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem`,再依次执行里面的 `memo.js write --kind fact`、`memo.js search`、`memo.js serve --port 7788` 三行,Node 用 `command -v node` 的结果、版本目录用 `V=versions/$(cat versions/CURRENT)`。
$ git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem
- 02
把 DSH 配置块插进 `~/.dsh/profiles/<profile>/cordis.patch.yml`:`id: memory-sedimem`、`name: '@deepseek-ai/dsh-mcp-client'`、`config.serverName: memo`、`transport: stdio`、`command: node`、`args: ['/ABS/PATH/versions/v1.1/src/mcp/server.js']`、`env: { MEMO_HOME: '$HOME/.memo' }`。
- 03
首次读写前在 DSH 里调一次 `memory_scope` 对齐分库——DSH 是常驻进程。
- 04
可选:把 Codex CLI(`~/.codex/config.toml` 的 `[mcp_servers.memo]`)和 Claude Code(`claude mcp add --scope user memo ...`)指向同一个 `server.js` 与 `MEMO_HOME`。
验证接入成功
- 跑 `bash versions/v1.1/configs/verify-three-clients.sh`,README 说期望输出 `PASS`。
- 确认工具面:10 个 `memory_*` 加 5 个 `memory_session_*`,三端完全一致。
- 两个免安装的只读体检命令:`memo doctor` 与 `memo stats`。
03DSH 适配与能力边界
Native DSH MCP mount: one `@deepseek-ai/dsh-mcp-client` block inserted into `~/.dsh/profiles/<profile>/cordis.patch.yml` (serverName memo, stdio, `node .../versions/v1.1/src/mcp/server.js`, `MEMO_HOME=$HOME/.memo`)
只追加的真相层 + 写入四道门
通过 `memory_write` 或 `memo write` 写入的一条事实 / 决策 / 经验→向 `~/.memo/items/<scope>.jsonl` 追加新版本,旧版本仍可按 `as-of` 读回
密钥、内网域名、私有路径在落盘前被脱敏成 `[REDACTED:x]`同 slot 异值不会覆盖旧事实,而是标成 superseded 或 disputed词法 + 语义双路检索
`memory_search` 的查询串→按 RRF(k=60)融合的结果,带 basis;语义道不可用时显式标 `degraded`
只读记忆中心(九页)
`memo serve --port 7788`→http://127.0.0.1:7788 上的今日 / 图谱 / 搜索 / 卫生 / 编辑 / 导入 / 任务 / 交接 / 设置 九页
默认只读,编辑需 `--write` 加 token 与 If-Match任务库(`session:` scope)
`memo session start / checkpoint / status / close / sweep`→只有 decision / gotcha 带 `from-session:<id>` 标签晋升主库,并生成六段交接文档 `docs/handoffs/<id>.md`
`session:*` 分库禁写 fact未晋升的内容随临时库一并废弃可选 LLM 派生层
`memo derive` / `memo llm`,指向 OpenAI 兼容端点→标题、摘要、标签写入旁路 `derived/<scopeKey>.jsonl`
开启后标题 / 摘要 / 标签的生成请求会发往你配置的 provider,原始记忆文本仍只在本机
04适合谁?何时不该用?
适合
- 每次开新会话都要把项目事实、决策和经验重讲一遍的 DSH 用户
- 长期本地使用、近似重复或互相矛盾的笔记已经多到没人敢信记忆的团队与个人
- 在真实项目里依赖这份记忆之前,想先自己核对一遍的人
不适合
- 必须 Node ≥ 22:sedimem 零运行时依赖,靠 Node 内置的 `node:sqlite` FTS5,更老的 Node 跑不起来。
- scope 是分类不是权限边界;多人共用一份记忆需要独立部署与鉴权,这是项目刻意不做的。
05兼容性、维护与安全提示
- 必须 Node ≥ 22:sedimem 零运行时依赖,靠 Node 内置的 `node:sqlite` FTS5,更老的 Node 跑不起来。
- 默认本地优先,但开启可选 LLM 层后,标题 / 摘要 / 标签的生成请求会发往你配置的 provider;真相层本身不参与这些请求。
- scope 是分类不是权限边界;多人共用一份记忆需要独立部署与鉴权,这是项目刻意不做的。
- 刻意不做云同步、不做多人权限;数据全在 `~/.memo/`,删目录是唯一的清除方式,也没有备份。
MIT · no published release · last push 2026-11-13
06常见问题
在 DeepSeek Harness 里怎么接入 sedimem?
往 `~/.dsh/profiles/<profile>/cordis.patch.yml` 插入一条配置:`id: memory-sedimem`、`name: '@deepseek-ai/dsh-mcp-client'`、`serverName: memo`、`transport: stdio`、`command: node`、`args: ['/ABS/PATH/versions/v1.1/src/mcp/server.js']`、`env: { MEMO_HOME: '$HOME/.memo' }`。DSH 是常驻进程,第一次读写之前先用 `memory_scope` 对齐分库。
DSH、Codex CLI、Claude Code 能共用同一份记忆吗?
可以。三端各配一条 stdio MCP,指向同一个 `server.js` 和同一个 `MEMO_HOME`;工具面三端完全一致,共 10 个 `memory_*` 加 5 个 `memory_session_*`。自检跑 `bash versions/v1.1/configs/verify-three-clients.sh`,期望输出 `PASS`。
DSH 里用 sedimem 必须配 LLM 吗?
不必。默认 `provider=none`,整层 LLM 不存在,检索、简报、卫生与图谱全部零 LLM 成本;开启后标题、摘要、标签只写进旁路 sidecar,真相层字节不变。
记忆数据存在哪,想清空怎么办?
全在 `~/.memo/`,真相层是 `~/.memo/items/<scope>.jsonl`,只追加、永不原地改,因此历史状态都能 `as-of` 回查;删掉这个目录即彻底清除,没有云组件也没有遥测。
两条记忆冲突了会怎样?
写入按四道门顺序过,同 slot 异值不会覆盖旧记录,而是标成 `superseded` 或 `disputed`,可交 Agent 用 `memory_curate` 裁决;`memory_forget` 默认写墓碑删除。
07相关的 DSH 工作流
dsh-univer-office
作者 dream-num
在 DSH 内预览、创建与编辑表格、文档和幻灯片,由 Univer 驱动
clearai-dsh
作者 clearailhc
ClearAI:以本体为纲的原生 DSH 插件 —— 经证据核验的研究长成可浏览的领域本体。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 鱼的记忆:给会话一份会淡忘的长期记忆,每条都带时间。名字里的「鱼」来自 DeepSeek 的鲸鱼。
dsh-trading
作者 zhu1090093659
基于 DeepSeek Harness 的智能体原生交易终端,三栏界面聚合币圈、美股、A股与港股,内置 19+ 可热插拔连接器,默认模拟交易并需人工确认。
08数据与来源
- 🔌 **三端共用一个记忆**:DSH / Codex CLI / Claude Code 连同一个 stdio MCP server、同一个分库
# DSH:~/.dsh/profiles/<profile>/cordis.patch.yml - insert: - id: memory-sedimem name: '@deepseek-ai/dsh-mcp-cl…
serverName: memo transport: stdio command: node args: ['/ABS/PATH/versions/v1.1/src/mcp/server.j…
三端各配一条 stdio MCP,指向同一个 `server.js` 和同一个 `MEMO_HOME`。常驻进程(DSH)记得先 `memory_scope` 对齐分库。
工具面:10 个 `memory_*` + 5 个 `memory_session_*`,三端完全一致。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
