caopu16/dsh-local-memory

dsh-local-memory

DSH（DeepSeek Harness）本地跨会话记忆插件：捕获每轮对话摘要、注入最近几天记忆，并提供 memory_search 工具按需检索全部历史记忆。

纯 JS / 纯文本实现，零 native 依赖。不依赖 memsearch CLI / pymilvus / numpy，因此不受本机 CPU 达不到 x86-64-v2 基线的影响。

功能

| 能力 | 说明 |
| --- | --- |
| capture | 每轮 turn/end 后把用户与助手对话摘要成 markdown bullet，追加到 /.memsearch/memory/YYYY-MM-DD.md |
| inject | 每轮第 1 步自动注入最近 injectDays 天（默认 2 天）的记忆快照 |
| memory_search | 纯 JS 关键词匹配，翻全部日文件（不止最近 2 天），供模型主动捞更早记忆 |
| 兼容 opencode | 与 opencode memsearch 插件共用 .memsearch/memory/ 目录和锚点格式，互读互不覆盖 |

安装

官方方式（推荐）

项目声明了 DSH bundle（dsh.bundle.patch），可以通过 DSH 官方插件命令安装：

已安装 dsh CLI 时
dsh plugin --profile web add github:caopu16/dsh-local-memory

从 deepseek-harness 源码运行时
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add github:caopu16/dsh-local-memory

lib/ 构建产物已提交，因此 git 源码安装不需要运行 prepare 构建脚本，也不会触发 pnpm ≥10 的 allowBuilds 拦截。

本地开发安装（备选）

cd ~/dsh-local-memory
bash scripts/install.sh

安装脚本会：

1. 在项目 node_modules/@deepseek-ai/ 下创建 dsh-tools 和 dsh-llm 的本地软链（指向 ~/deepseek-harness 里的包），让独立项目也能解析 DSH 同款模块。
2. 修改 ~/.dsh/profiles/web/cordis.patch.yml，把 local-memory 插件路径指向 ~/dsh-local-memory/src/index.mjs。

安装完成后重启 DSH 并新开一个会话，memory_search 工具才会出现在新会话里；已打开的会话不会自动获得新工具。

配置

官方安装后，插件由 bundle 自带的 cordis.patch.yml 挂载，行名为包名 dsh-local-memory。要覆盖配置，在 ~/.dsh/profiles/web/cordis.patch.yml 中 patch 同一行：

- id: local-memory
name: 'dsh-local-memory'
config:
injectDays: 3
searchMaxResults: 10
provider: ''
model: ''

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| captureEnabled | true | 是否捕获新对话 |
| injectEnabled | true | 是否注入最近记忆 |
| searchEnabled | true | 是否注册 memory_search 工具 |
| summarizeEnabled | true | 是否用 LLM 摘要；关掉则写原文 |
| injectDays | 2 | 注入时回看几个日文件 |
| injectMaxLinesPerFile | 40 | 每个日文件最多注入多少行 |
| captureMaxChars | 24000 | 单轮原文送摘要器的字符上限 |
| summarizeMaxTokens | 1200 | 摘要最大 token |
| summarizeTimeoutMs | 120000 | 摘要超时 |
| minPromptLength | 8 | 用户消息短于此长度不捕获 |
| searchMaxResults | 20 | memory_search 单次最多返回几个轮次块 |
| searchMaxLinesPerResult | 12 | 每个轮次块最多返回几行正文 |
| provider / model | 空 | 摘要路由；留空自动用当前 agent 的模型 |

使用

日常无需手动操作：capture 自动记录，inject 自动把最近记忆塞进上下文。

当话题可能早于注入窗口时，模型会主动调用：

memory_search(query: "flyway V22", top_k: 5)

返回结果按关键词/子串命中打分排序，包含日期文件、轮次标题和正文片段。

项目结构

~/dsh-local-memory/
├── src/
│   ├── index.mjs       # 插件入口：apply / name / inject
│   ├── constants.mjs   # 默认配置、marker、摘要系统提示
│   ├── util.mjs        # 日期、路径、内容块等公共工具
│   ├── capture.mjs     # turn 渲染、摘要、写日文件
│   ├── inject.mjs      # 最近记忆读取与快照消息
│   └── search.mjs      # 纯 JS 关键词召回与结果格式化
├── lib/                # 构建产物（已提交，供官方 dsh plugin 安装使用）
├── cordis.patch.yml    # DSH bundle 补丁层声明
├── scripts/
│   ├── build.mjs       # 把 src/ 构建到 lib/
│   ├── install.sh      # 本地开发安装到 DSH web profile
│   └── smoke-test.mjs  # 加载插件并真实执行 memory_search
├── test/
│   └── search.test.mjs # search 单元测试（node:test）
├── docs/
│   ├── design.md       # 设计说明
│   └── usage.md        # 详细使用与排障
├── package.json
└── README.md

测试

cd ~/dsh-local-memory
npm test          # 单元测试（不需要安装）
npm run smoke     # 冒烟测试（需要先执行 install.sh，且存在 jereh 记忆目录）

记忆文件格式

与 opencode memsearch 插件对齐：

2026-08-26

Session 08:49

08:49

- User 要求检查数据库与前端多语言 JSON 文件。
- Assistant 执行了 i18n 同步。