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` 文件,文件名和数量都不重要
安装步骤
- 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
- 02
先 `cd ~/.dsh/plugins/dsh-memory-keeper` 进入插件目录,然后执行 `npm install`
$ npm install
- 03
编辑 `~/.dsh/profiles/<你的 profile>/package.json` 这个文件:在 `dependencies` 里加上 `"dsh-memory-keeper": "link:<绝对路径>"` 这一行,同时在 `dsh.profile.bundles` 里加上 `"dsh-memory-keeper"` 这个名字
- 04
先 `cd ~/.dsh/profiles/<你的 profile>` 进入 profile 目录,然后执行 `pnpm install`
- 05
重启 DSH
- 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 适配与能力边界
以 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 版本上的样子。作者也说明插件是轻量化设计,记忆库过大时的表现还没优化。
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,一变就重建。
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(DeepSeek Harness)的 cordis 插件**,**不是把目录丢进 `.dev/` 就生效**
DSH 是通过 **profile 的 `package.json`** 加载插件的,光把目录放进去不会生效。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
