返回目录

sedimem

精选清单收录维护状态: 活跃

old-friends-gathering/sedimem

sedimem · 本地跨会话「自我迭代」记忆层:DSH / Codex CLI / Claude Code 共用一份只追加的真相层,重点治冗余·重复·冲突·过时(MCP + 四道写入卫生 + Agent 裁决闭环)

前往 GitHub项目主页
$ git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem

101

星标

5

Fork

JavaScript

语言

MIT

许可证

2026-11-02

创建于

2026-11-19

最近推送

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。

安装步骤

  1. 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

  2. 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' }`。

  3. 03

    首次读写前在 DSH 里调一次 `memory_scope` 对齐分库——DSH 是常驻进程。

  4. 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 适配与能力边界

DSH 适配原生运行时

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/`,删目录是唯一的清除方式,也没有备份。
2026-11-022026-11-13作者未说明

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` 默认写墓碑删除。

08数据与来源

  • 作者声明github.come91890018323…

    - 🔌 **三端共用一个记忆**:DSH / Codex CLI / Claude Code 连同一个 stdio MCP server、同一个分库

  • 作者声明github.come91890018323…

    # DSH:~/.dsh/profiles/<profile>/cordis.patch.yml - insert: - id: memory-sedimem name: '@deepseek-ai/dsh-mcp-cl…

  • 作者声明github.come91890018323…

    serverName: memo transport: stdio command: node args: ['/ABS/PATH/versions/v1.1/src/mcp/server.j…

  • 作者声明github.come91890018323…

    三端各配一条 stdio MCP,指向同一个 `server.js` 和同一个 `MEMO_HOME`。常驻进程(DSH)记得先 `memory_scope` 对齐分库。

  • 作者声明github.come91890018323…

    工具面:10 个 `memory_*` + 5 个 `memory_session_*`,三端完全一致。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。