返回目录

dsh-memory-keeper

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

flywalker68/dsh-memory-keeper

DSH 长期记忆插件:Qwen embedding + rerank 检索,本地小模型兜底

前往 GitHub
$ git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper

19

星标

1

Fork

JavaScript

语言

MIT

许可证

2026-11-05

创建于

2026-11-15

最近推送

MIT 许可的 cordis 插件,让手写的 `.md` 记忆库与导出的对话记录在 DeepSeek Harness 里可检索:BM25 加本地 bge-small 向量按 RRF 融合,可选 Qwen embedding 与 rerank。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-18

许可证

MIT

01它能帮你完成什么?

  • 让手写的 markdown 记忆库在 DSH 对话里能被搜到

    `memory_search` 返回「字面 BM25 + 向量」融合后的命中,并回源文件补整行与前后各一行上下文

    已经把人设、日记与项目笔记写成纯文本 `.md`、希望模型引用原话而不是转述的用户

  • 按意思翻出以前说过的对话,而不是靠关键词

    `chat_search` 直接读导出的对话记录,认得「三天前 / 上周 / 一个月前」这类说法

    想回忆过去会话里到底说过什么、又不想先做导入的用户

  • 跨会话维护记忆库的健康度

    每轮注入的状态卡、`memory_check` 健康度报告,以及写入前自动备份的 `persona_edit`

    长期运行的个人配置:人设文件与日记需要进度、体积与过期信号

02如何接入 DeepSeek Harness?

前置条件

  • Node 24+ 与 DSH 0.2.x —— README 明确写了这两条,并说明 Windows / macOS / Linux 都可以
  • 一个 markdown 记忆库:`~/.dsh/memory/`(默认 `memoryDir`)下放 `.md` 文件,文件名和数量都不重要

安装步骤

  1. 01

    `git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper`

    $ git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper

  2. 02

    先 `cd ~/.dsh/plugins/dsh-memory-keeper` 进入插件目录,然后执行 `npm install`

    $ npm install

  3. 03

    编辑 `~/.dsh/profiles/<你的 profile>/package.json` 这个文件:在 `dependencies` 里加上 `"dsh-memory-keeper": "link:<绝对路径>"` 这一行,同时在 `dsh.profile.bundles` 里加上 `"dsh-memory-keeper"` 这个名字

  4. 04

    先 `cd ~/.dsh/profiles/<你的 profile>` 进入 profile 目录,然后执行 `pnpm install`

  5. 05

    重启 DSH

  6. 06

    在 `~/.dsh/profiles/<profile>/cordis.patch.yml` 里把 `workspace` 填成绝对路径——留空会让 `process.cwd()` 落到 profile 目录,索引里什么都收不到

验证接入成功

  • DSH 起来后,`~/.dsh/memory-keeper.log` 里应该有一行 `INFO 已注册工具 memory_search`
  • `memory_search` 的结果头带 `(向量+词面)` 说明向量在工作;只剩一个 `3 条` 说明只跑了字面检索

回滚

  • 把 `<workspace>/.tools/memory-index.json` 和 `<workspace>/.tools/memory-vectors.json` 删掉,下次搜索时会重新建一份干净的索引
  • 把 `embeddingEnabled` 设为 `false` 可彻底关掉向量检索——零下载、零 API,只留字面检索

03DSH 适配与能力边界

DSH 适配原生运行时

以 cordis 插件的形式通过 DSH profile 加载:把包写进 profile 的 `package.json`(`dependencies` 与 `dsh.profile.bundles`),跑 `pnpm install`、重启 DSH,Host 侧注册 `memory_search` 等工具,客户端提供侧栏记忆面板。

  • 双路记忆检索

    一条 query、`top=10` 与可选的 `beforeDate`→BM25 与向量候选按 RRF 融合,可选再用 Qwen 重排,命中后补整行与前后各一行上下文

    源文件的路径、大小或 mtime 变化时,在 `<workspace>/.tools/` 下重建索引配了 Qwen key 时,检索用的 query 与文本向量会发往百炼
  • 索引构建

    `memoryDir` 下的 markdown 文件→按行切块,每块存 `text`(截 300 字)、`date`、`file`、`line`

    跳过标题行、引用行、分隔线、少于 6 个字的短行,以及已标「已被取代」的条目
  • 状态卡与压缩后补原文

    组装好的 system prompt 与 `compaction/summary` 事件→每轮一张状态卡(认识多少天、日记进度、日程、半衰期候选、人设漂移),压缩后补回最近 10 轮原话

    每轮以及每次压缩之后都会往 system prompt 里加文本
  • 历史导入脚本

    一个装满 `.jsonl` 的目录,或单个 jsonl 文件→每个输入文件一个 `.md`,每轮一行,行首带日期,因此能参与时间窗口过滤

    把新的 markdown 文件写进目标记忆目录
  • 侧栏记忆面板

    本机记忆库→在 DSH Web UI 里看记忆库全貌

    README 说明这个面板还没在别人的 DSH 版本上试过

04适合谁?何时不该用?

适合

  • 已经把人设、日记与项目笔记写成纯文本 `.md`、希望模型引用原话而不是转述的用户
  • 想回忆过去会话里到底说过什么、又不想先做导入的用户
  • 长期运行的个人配置:人设文件与日记需要进度、体积与过期信号

不适合

  • 它是检索层,不是完整记忆系统:逐轮回放、增量提取、摘要与遗忘都不在范围内,插件读你已经在写的东西,不替你写。切块、索引重建、双路融合、时间窗口、状态卡、压缩后补原文由代码保证;什么时候写日记、要不要精简,全靠模型按 `AGENTS.md` 自觉执行。
  • 记忆数据始终在本地,只有检索用的 query 与文本向量会在配了 Qwen key 时发往百炼。没配 key、调用失败、超时或连续失败 3 次,都会回退到本地 bge-small 模型。
  • `sharp` 必须真的装上:`npm install --ignore-scripts` 只留下源码没有 libvips 二进制,而 `@xenova/transformers` 会 require 它,结果是向量检索静默挂掉、插件却照常启动。
  • README 自己列了未验证项:是否必须用 `pnpm install`、`link:` 在 Windows 反斜杠下的表现、日志路径、关掉 `embeddingEnabled` 后的检索质量,以及面板在别的 DSH 版本上的样子。作者也说明插件是轻量化设计,记忆库过大时的表现还没优化。

05兼容性、维护与安全提示

  • 它是检索层,不是完整记忆系统:逐轮回放、增量提取、摘要与遗忘都不在范围内,插件读你已经在写的东西,不替你写。切块、索引重建、双路融合、时间窗口、状态卡、压缩后补原文由代码保证;什么时候写日记、要不要精简,全靠模型按 `AGENTS.md` 自觉执行。
  • 记忆数据始终在本地,只有检索用的 query 与文本向量会在配了 Qwen key 时发往百炼。没配 key、调用失败、超时或连续失败 3 次,都会回退到本地 bge-small 模型。
  • `sharp` 必须真的装上:`npm install --ignore-scripts` 只留下源码没有 libvips 二进制,而 `@xenova/transformers` 会 require 它,结果是向量检索静默挂掉、插件却照常启动。
  • README 自己列了未验证项:是否必须用 `pnpm install`、`link:` 在 Windows 反斜杠下的表现、日志路径、关掉 `embeddingEnabled` 后的检索质量,以及面板在别的 DSH 版本上的样子。作者也说明插件是轻量化设计,记忆库过大时的表现还没优化。
2026-11-052026-11-15作者未说明

MIT · README 分支 main(无 release)

06常见问题

装好之后为什么一条都搜不到?

几乎都是 `workspace` 留空导致的。在 DSH 里 `process.cwd()` 是 profile 目录而不是工作区,插件因此找不到日记,搜不到也不报错。请在 `~/.dsh/profiles/<profile>/cordis.patch.yml` 里把 `workspace` 填成绝对路径——代码现在也会打 WARN。

需要百炼的 API key 吗?

不需要。没有 key 时检索走本机的 `Xenova/bge-small-zh-v1.5`(约 24 MB,int8,首次检索经 hf-mirror 下载到插件的 `models/`),离线可用。填了 key 就换成 `qwen3.7-text-embedding` 加 `qwen3.7-text-rerank`,一旦失败、超时或连续失败 3 次就回退本地。

怎么确认向量检索真的在跑?

看 `memory_search` 的结果头:`3 条(向量+词面)` 说明两路都跑了;只有一个 `3 条` 说明只剩字面检索,多半是 `sharp` 没装好。补装的办法是先 `npm install --ignore-scripts`,再 `npm install-scripts approve sharp` 与 `npm rebuild sharp`。

它刻意不做什么?

不逐轮回放、不做增量提取、不写摘要、不负责遗忘。切块、索引重建、双路检索与融合、时间窗口、状态卡、压缩后补原文由代码保证;什么时候写日记、要不要记关系片段、怎么精简,全靠模型按 `AGENTS.md` 自觉执行,漏了那段记忆就是真的没有。

想重置索引怎么办?

删掉 `<workspace>/.tools/memory-index.json` 与 `<workspace>/.tools/memory-vectors.json`,下次搜索会自动重建。平时不需要这么做:索引会比对每个源文件的路径、大小与 mtime,一变就重建。

08数据与来源

  • 作者声明github.com56860da0d1ad…

    - 这是 **DSH(DeepSeek Harness)的 cordis 插件**,**不是把目录丢进 `.dev/` 就生效**

  • 作者声明github.com56860da0d1ad…

    DSH 是通过 **profile 的 `package.json`** 加载插件的,光把目录放进去不会生效。

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

🏆

最佳 DeepSeek Harness 插件

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

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

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