dsh-local-memory

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

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

版本要求

当前版本 0.2.0，适配 DSH 0.2.x（alpha 线），要求 >=0.2.1-alpha.0 <0.3.0。

0.1.x 只能跑在 DSH 0.1.x 上：0.2 改了三处插件契约，旧版本在 0.2.x 上会直接坏掉（capture 静默不写、注入消息被拒）。详见 docs/migration-0.2.md。

功能

安装

官方方式（推荐）

项目声明了 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: ''

使用

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

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

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

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

项目结构

~/dsh-local-memory/
├── src/
│   ├── index.mjs       # 插件入口：apply / name / inject
│   ├── constants.mjs   # 默认配置、marker、source kind、projection key
│   ├── util.mjs        # 日期、路径、内容块等公共工具
│   ├── projection.mjs  # session projection：折叠每轮对话（0.2 必需）
│   ├── capture.mjs     # 读 projection、摘要、写日文件
│   ├── 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）
│   └── projection.test.mjs # projection 折叠单元测试
├── docs/
│   ├── design.md       # 设计说明
│   ├── usage.md        # 详细使用与排障
│   └── migration-0.2.md # 0.1 → 0.2 适配说明
├── 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 同步。