dsh-local-memory
DSH（DeepSeek Harness）本地跨会话记忆插件：捕获每轮对话摘要、注入最近几天记忆，并提供 memory_search 工具按需检索全部历史记忆。
纯 JS / 纯文本实现，零 native 依赖。不依赖 memsearch CLI / pymilvus / numpy，因此不受本机 CPU 达不到 x86-64-v2 基线的影响。
功能
| 能力 | 说明 |
|---|
| capture | 每轮 turn/end 后把用户与助手对话摘要成 markdown bullet，追加到 <project>/.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
安装脚本会：
- 在项目
node_modules/@deepseek-ai/ 下创建 dsh-tools 和 dsh-llm 的本地软链（指向 ~/deepseek-harness 里的包），让独立项目也能解析 DSH 同款模块。
- 修改
~/.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
<!-- session:ses_xxx turn:msg_xxx db:/home/ubuntu/.local/share/opencode/opencode.db -->
- User 要求检查数据库与前端多语言 JSON 文件。
- Assistant 执行了 i18n 同步。
