DSH Plugins Marketplace

DSH Plugins

Plugins

/

sedimem

O

sedimem

Discovered★ 101

sedimem · 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)

Machine translated

doc-kind: manual doc-version: 1.3

sedimem

中文 · English

ci quality security pages license node

AI 会忘记你,它不会。

  • 🔒 真相层不可变:~/.memo/items/<scope>.jsonl 只追加、永不原地改,改过去 = 追加新版本,可 as-of 回查任意时点
  • 🔌 三端共用一个记忆:DSH / Codex CLI / Claude Code 连同一个 stdio MCP server、同一个分库
  • 🧱 零依赖离线:14 个模块,0 运行时依赖(Node ≥ 22.15,内置 node:sqlite FTS5),不开 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-engramWindows 支持、图谱面板图谱面板思路相近;sedimem 另有 as-of 回查与投毒可审计
supermemory云同步、跨设备云为主;sedimem 刻意本地优先,删 ~/.memo/ 即彻底清除
自建 Markdown简单可控无索引、无去重、无冲突裁决;sedimem 有 BM25+语义检索与卫生门禁

[!NOTE] sedimem 没有云同步与多人权限——这是刻意不做,不是没做。

架构

整体架构:客户端 → 接口层 → MemoryService → 14 模块 → 数据层

  • 三层单向:客户端 → 接口层(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),失败只降级,真相层字节不变。

两条主链路的细节:

写入:schema → 脱敏 → 去重 → 冲突 → 追加读取:BM25 ± 语义 → RRF → basis/degraded
写入四道门:越往后越贵,便宜的先拦掉大部分噪声读取双路融合:词法永远兜底,语义道不可用时显式 degraded

[!IMPORTANT] 真相层(~/.memo/items/)是唯一权威:只追加、永不原地改;索引/视图/派生可删光重建,重建不丢事实。

功能

能力说明命令
写入四道门依次过,过了才追加memo write
检索BM25(FTS5)± 语义道 → RRF k=60,结果带 basis,语义挂了显式 degradedmemo 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,九页:今日 / 图谱 / 搜索 / 卫生 / 编辑 / 导入 / 任务 / 交接 / 设置。

今日:当天变化流图谱:力导向 + kind 筛选
卫生:待裁决簇 + 30 天趋势任务:任务库状态
页干什么页干什么
今日当天变化流编辑--write 才可改
图谱力导向全貌 + kind 筛选导入批量结构化
搜索带依据(basis)检索任务任务库状态
卫生待裁决簇 + 30 天趋势交接六段交接文档
设置分库 / 配色 / 策略只读

LLM 总结层(可选)

默认 provider=none,整层不存在;开启后派生只写 sidecar,真相层字节不变。

LLM 派生层:写 → outbox → LlmPort → derived 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/gotchamemo 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: 记忆分库。

任务库:start → checkpoint → close

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 privateshared] [--json]`
memo search "..." [--limit 10] [--kind fact] [--as-of ISO] [--json]—
memo brief [--lines 80] [--tier0]—
`memo view buildrebuild`
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 --decisions <file->`
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]—

门禁

五层门禁:质量 → 安全 → 覆盖率 → docs-drift → pages-verify

本地脚本 = 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.0P0a 地基: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.014 模块重构 + 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

memsearch

by zilliztech

A persistent, unified memory layer for all your AI agents (e.g. Claude Code, Codex, DSH), backed by Markdown and Milvus.

Memory & ContextManifest valid

★ 2.9k

↓ 4.1k/wk

MIT

Python

Nov 13, 2026

dsh plugin --profile agent add @zilliz/memsearch-dsh

Import 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

Sessions & MessagesManifest valid

★ 0

dsh plugin --profile web add dsh-assembly.resume

by why913

DeepSeek Harness(dsh)的 MCP / Skill / 记忆管理工具:写入前先连接自检,连不上不写;从 Claude Code / Codex 一键迁移;可装成 dsh 插件,在 Web 里用 /mcp 命令和卡片操作。

Development & InfrastructureManifest valid

★ 5

↓ 45/wk

MIT

JavaScript

Aug 17, 2026

dsh plugin --profile web add @why913/dshx

by 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).

Tools & CapabilitiesManifest valid

★ 0

Apache-2.0

TypeScript

Aug 17, 2026

dsh plugin --profile web add dsh-plugin-semantic-memory

by HarryHeYu

Cross-agent session continuity for DeepSeek Harness — continue work from Codex, Claude Code, Grok, ZCode and more with sessionFlow.

Development & InfrastructureSessions & MessagesManifest valid

★ 3

MIT

TypeScript

Nov 11, 2026

dsh plugin --profile web add dsh-sessionflow

by hr98w

融合 Claude Code 的 Auto Memory 与 Codex 的 Session 记忆整理,为 DeepSeek Harness 提供简单、透明、上下文友好的长期记忆。Claude Code-inspired Auto Memory meets Codex-inspired Session consolidation, bringing simple, transparent, and

Memory & ContextManifest valid

★ 35

↓ 696/wk

MIT

TypeScript

Nov 1, 2026

dsh plugin --profile web add @hr98w/dsh-memory