Pular para o conteúdo principal
H

dsh-memory-service

howtomakeaname/dsh-memory-service

File-native long-term memory for DSH sessions: Markdown notes, SQLite FTS5 recall, workspace/global scopes, revision conflict handling, and Claude Code import.

Instalar

dsh plugin --profile web add github:howtomakeaname/dsh-memory-service

README

dsh-memory-service logo

dsh-memory-service

为 DeepSeek Harness 提供文件原生、可审计、可重建的长期记忆。

npm npm weekly downloads Listed on dsh-plugin.org CI Node License

一次会话里做出的决定,不应该等到下一次会话再重新发现。

dsh-memory-service 给 DSH 增加一层持久记忆:Markdown 文件是唯一真源,SQLite FTS5 只是可丢弃的检索索引,模型每轮只拿到和当前任务相关的那部分记忆。

为什么需要长期记忆

编码会话会产生大量必须跨会话保留的事实:

  • 工程约定:“这个仓库统一用 pnpm”;
  • 架构决策:“公共 API 必须放在 adapter 后面”;
  • 工作反馈:“不要重写生成文件”;
  • 用户偏好:“用中文回答,状态汇报短一点”;
  • 不值得每次重新推导的项目知识。

上下文窗口是临时的。dsh-memory-service 把这些事实变成持久、可检查、可召回的记忆,而不是把整段聊天历史无限塞回模型。

核心能力

  • Markdown 真源:每条记忆是带 frontmatter 的普通 .md 文件,可读、可编辑、可 review、可迁移。
  • 可重建索引:SQLite FTS5 只负责检索加速;索引损坏或删除后可从 Markdown 重建。
  • 双作用域:workspace:<id> 保留项目内知识;global 保存跨项目约定和用户偏好。
  • 动态回忆:每轮注入稳定的 preference/user profile,以及和当前问题相关的 FTS 召回,受 token 预算约束。
  • 自动捕获:完成轮次进入持久捕获队列;模型判断是否值得长期保存,并保留可核验的原话证据。
  • 冲突与更正:revision / expectedRevision 防覆盖,supersedes 保留审计链,同一 fact key 的分歧显式标记为冲突。
  • Claude Code 迁移:从多个 Claude Code workspace 或 global memory 导入,支持预览、逐条编辑、选择导入。
  • 原生 Settings UI:在 DSH 设置页内查看、搜索、创建、编辑、处理冲突和展开工具卡片,不另开 web 应用。

架构

dsh-memory-service system architecture

Fig. 1. System architecture. Solid arrows: write / derive; dashed: recall / read; dotted: import. WORKSPACE and GLOBAL are sibling scopes; Markdown is the source of truth and the FTS5 index is rebuildable. SVG source

会话事件先进入持久队列,宿主模型抽取有证据的候选,写入 Markdown 真源;索引负责可搜索,召回层再按 scope、相关性和 token 预算把一部分记忆注入下一轮。

安装

环境要求:

  • 带插件 bundles 的 DeepSeek Harness(base + headless / desktop);
  • Node.js >= 22.5(依赖 node:sqlite);
  • 不需要额外的向量数据库或 API key;抽取使用宿主模型。

从 npm 安装

dsh plugin --profile <profile> add dsh-memory-service

添加后重启 DSH。记忆页面会出现在 Settings → Memory。

从本地仓库安装

git clone https://github.com/howtomakeaname/dsh-memory-service.git
dsh plugin --profile <profile> add /absolute/path/to/dsh-memory-service

配置

编辑 ~/.dsh/profiles/<profile>/cordis.patch.yml:

- id: memory-service
  config:
    root: /absolute/path/to/memory
    capture: true
    budgetTokens: 1200
    extractEveryTurns: 1
    minConfidence: 0.55
    queryExpansion: true
    profileSynthesis: true
配置项默认值说明
root$DSH_MEMORY_HOME 或 ~/.dsh/memory-service记忆库根目录。
capturetrue是否开启自动捕获。
budgetTokens1200注入预算,限制在 200–8000。
extractEveryTurns1每 N 轮执行一次抽取,1–50。
minConfidence0.55抽取置信度下限,0–1。
queryExpansiontrue用宿主模型把问题改写成额外检索 query。
profileSynthesistrue把 preference/user 类型记忆合成短 profile。

非法数值会被 clamp 到合法范围,并记录 warning。

快速开始

node src/cli.mjs init
node src/cli.mjs upsert \
  --scope workspace:demo \
  --title "Package manager" \
  --body "Use pnpm in this workspace" \
  --type convention
node src/cli.mjs search pnpm --scope workspace:demo
node src/cli.mjs list --scope workspace:demo

Agent 工具

插件向宿主注册 9 个工具:

工具用途
memory_search搜索 workspace + global 中相关的过去知识。
memory_save保存长期有效的偏好、约定、决策或事实。
memory_get读取一条记忆的正文和 revision。
memory_update带乐观并发的更新;过期 revision 会被拒绝。
memory_forget软遗忘或硬删除一条记忆。
memory_flush确定性地处理待捕获任务。
memory_conflicts列出未解决的语义冲突。
memory_resolve为冲突选择保留的版本。
memory_stats查看计数和存储位置。

设置页

原生 Settings 页面覆盖完整生命周期:按 scope 浏览、新建/编辑/复制/遗忘、处理冲突,以及展开 memory_* 工具调用。

Memory settings

Claude Code 记忆迁移

导入流程是 review-first,不是无脑复制:

  1. 发现 /.claude/projects/*/memory 和 /.claude/memory;
  2. 多选 Claude Code 工作区和/或 global memory;
  3. 预览每条记忆的标题、描述、类型、正文和是否已存在;
  4. 逐条修改标题/描述/正文/类型,并选择 workspace/global scope;
  5. 只导入勾选项。

Claude Code import

node src/cli.mjs discover-claude
node src/cli.mjs import-claude --source ~/.claude/projects/<project>/memory --scope workspace:demo
node src/cli.mjs export-claude --target /tmp/claude-memory-export --scope workspace:demo

导入按来源 hash 幂等;用户本地改过的条目默认不会被覆盖,除非显式使用 --force。

存储布局

<root>/
├── global/
│   ├── MEMORY.md              # 人类可读索引
│   └── notes/*.md             # 每条记忆一个文件,带 frontmatter
├── workspaces/<workspace-id>/
│   ├── MEMORY.md
│   └── notes/*.md
├── .index/memory.db           # 可丢弃的 SQLite FTS5 索引
└── journal/events.ndjson      # 追加式审计 / journal

workspace identity 由宿主会话的 cwd 派生,而不是由模型填写。

可靠性与验证

项目结果
单元 / 场景测试50 tests / 50 pass,覆盖 schema migration、CAS、双进程并发、队列恢复、profile synthesis、Claude preview/import
真实 DSH e2e保存 → 新会话召回 → 纠正 → 再召回
持久捕获队列中断任务重启后恢复并继续 drain
LongMemEval 风格长程 benchmark22 / 24;每条 46–49 万字符;偏好类 2/4
CI测试、静态检查、npm pack --dry-run
node --test
node scripts/check.mjs
node scripts/e2e-real.mjs --profile bench-memt-headless
node bench/e2e/run.mjs

详细证据见 docs/verification.md 和 bench/e2e/README.md。

设计取舍

  • 文件优先于不透明存储。 即使这个插件明天消失,记忆仍然可用。
  • 索引是可丢弃的。 索引损坏或过期只意味着 rebuild,不是数据丢失。
  • 召回要有边界和类型。 一份小而相关的 profile,比把整个记忆库倒进上下文更有效。
  • 抽取必须保守。 用户原话里找不到证据,就不自动写入。
  • 冲突是一等公民。 两个会话说法不一致时,记录双方并交给用户选择。
  • workspace identity 由宿主掌握。 模型不能靠猜测把项目事实提升成 global。

文档

文档内容
INSTALL.md安装与配置参考。
docs/architecture.md模块拆分、数据流和维护约束。
docs/dsh-plugin-contract.md已验证的 DSH 插件契约与 e2e 记录。
docs/retrieval.md检索策略与 typed preference 写入。
docs/conflict-resolution.md锁、CAS、supersede 和语义冲突。
docs/operations.md备份、恢复、重建、队列诊断。
docs/ui.mdSettings UI 和工具调用展示。
docs/claude-code-memory-current.mdClaude Code memory 格式说明。
CHANGELOG.md版本历史。

License

MIT,见 LICENSE。

Plugins relacionados