dsh-mm
DeepSeek Harness 的纯本地长期记忆插件：一个普通文件夹，四层 Markdown，没有数据库、没有网络请求。
- soul：人格与风格，注入 system prompt 靠前（默认 ≤4 KB）
- MEMORY.md：长期记忆索引，注入 system prompt 靠后（默认 ≤4 KB，超限截断）
- topics/：人物、项目、决策、偏好、教训、笔记，全部按 frontmatter 的
type 分类
- inbox/：每轮对话原文，不注入、不检索，提炼后归档
功能
记忆
- 每轮对话自动追加原文到
inbox/YYYY-MM-DD.md（可关闭）
- 手动或自动提炼：inbox →
MEMORY.md 索引 + topics/*.md
- 提炼去重：同一天二次提炼追加“补充”，跨次索引行与主题正文按行去重
- 大 inbox 文件按预算分段提炼，剩余内容回写 inbox，不会卡死或丢失
memory 工具：search / read / write / list / delete
整理
- 定时合并去重：完全相同文件进回收站、大文件交给模型压缩
- 压缩前自动备份（可关），备份保留份数可配置（默认 10）
- 提炼失败不归档原文，下次重试
- 归档同名加时间戳，绝不覆盖
设置页
- 概览：主题数、待提炼积压、预算进度、上次运行、下次整理、warning
- 核心文件：直接编辑
soul.md / MEMORY.md，实时字节预算，⌘S 保存
- 主题：搜索、按类型过滤、新建、编辑、移入回收站
- 自动化：对话记录、提炼、压缩、模型等全部参数
- 备份：创建、恢复、删除、保留份数
- 回收站：恢复（绝不覆盖同名）、彻底删除、清空
界面
设置页六个页签：概览、核心文件（soul / MEMORY 编辑器）、主题（搜索/新建/编辑/回收）、自动化、备份、回收站。
概览
主题
自动化
备份
文件夹结构
<dir>/
├── soul.md
├── MEMORY.md
├── topics/<slug>.md
├── inbox/
│ ├── YYYY-MM-DD.md
│ └── archive/
├── backups/<timestamp>/...
└── .trash/<timestamp>/...
backups/ 与 .trash/ 不参与注入、检索、压缩。
主题文件格式
---
name: 王工
description: 后端负责人，偏好 async 写法
type: person
updated: 2026-10-27
---
- 负责后端上线
- 偏好 async/await
type 取值：person / project / decision / preference / lesson / note。
旧版的 people/、projects/ 等目录会在启动时自动迁入 topics/，类型写进 frontmatter。
提炼触发
- 积压 ≥ 阈值（默认 16 KB）且距上次 ≥ 1 小时
- 空闲达到设定分钟数（默认 30 分钟）
- 最后一个会话关闭
- 定时整理（默认 24 小时兜底）
- 设置页「立即提炼」
安装（GitHub）
dsh plugin --profile <profile> add github:huangbaba1992/dsh-mm
桌面版的 desktop profile 由应用管理，CLI 会拒绝直接写入；可在 设置 → 插件 中安装，或使用下面的本地 link 方式。
安装（本地 link）
package.json 里：
"dependencies": { "dsh-mm": "link:/absolute/path/to/dsh-mm" }
并把 dsh-mm 加进 dsh.profile.bundles。改完 Host 代码需要重启 DSH；改前端后刷新页面（若宿主未热更新则同样重启）。
插件 Config：
- insert:
- id: local-memory
name: dsh-mm
config:
dir: "~/.dsh/memory"
soulFile: soul.md
memoryFile: MEMORY.md
maxMemoryBytes: 4096
设置页保存的目录优先于 config.dir。
HTTP API
| Method | Path | 说明 |
|---|
| GET | /api/local-memory/state | 全部状态、主题元数据、备份、回收站、warning |
| GET/POST | /api/local-memory/file | 读文件 / 写 soul、MEMORY、topics/*.md |
| POST | /api/local-memory/topic | 新建主题 |
| POST | /api/local-memory/delete | 主题移入回收站 |
| GET/POST | /api/local-memory/trash | 列出 / restore / purge / empty |
| GET/POST | /api/local-memory/backup | 列出 / create / restore / delete |
| POST | /api/local-memory/settings | 合并保存设置 |
| POST | /api/local-memory/distill | 立即提炼 |
| GET/POST | /api/local-memory/compact | 立即整理 / 查询状态 |
所有路径都经过白名单：inbox/、backups/、.trash/、.. 不可通过 Web 写入。
测试
node test/host.test.mjs
node test/client.test.mjs
- Host：桩 ctx + 真实 HTTP 路由 + 桩 llm，覆盖 capture、提炼、大文件、去重、备份、回收站、失败路径
- Client：最小 React 垫片渲染真实组件，覆盖概览、编辑保存、主题增删改、回收站、设置、备份
隐私
插件不发任何网络请求；只有你配置的模型调用会离开本机。文件都是普通 Markdown，可直接用编辑器、git 或 grep 管理。
License
MIT © 2026 huangbaba1992
