dsh-memory
给 DeepSeek Harness(dsh)加一层跨会话的长期记忆。
dsh 的会话是孤立的:新开一场,之前的项目约定、你的偏好、上周定下的方案都不在里面。 这个插件把该长期保留的东西抽出来存成明文文件,下次会话开始时递回给模型。
不依赖数据库、不调外部服务、不需要 API key。记忆就是你磁盘上的几个 Markdown 和 YAML。
状态
| 环境 | 状态 |
|---|---|
| dsh 0.2.x(PC) | 已实测,功能完整 |
| dsh 安卓版(App 内插件) | 已实测,功能完整 |
| dsh 0.1.x | 工具可用;无 schedule 服务时不会自动定时整理 |
验证覆盖:工具注册、写读落盘、版本链、分片、检索、简报注入、跨进程/重启持久、真实环境零污染。
它做什么
存事实,不存聊天记录。
「发布分支叫 stable」「周报周五下午发」这类长期有效的信息写成一条条事实。
值变了就追加新版本,旧版本留在 history 里 —— 所以能回答"这个什么时候改的、改成什么了"。
新会话开始时把简报交给模型。 一段固定的能力说明常驻系统提示(字节稳定,不破坏 prefix 缓存), 当前简报和记忆目录走动态快照,内容变了才更新。
按需整理。
手动调 memory_organize,或在 profile 有 schedule 服务时到点自动跑:
扫最近几场会话,把反复出现、值得长期保留的内容提炼进事实和简报。只增不删。
事实多了按主题拆文件。 默认超过 80 条开始分片,配一份索引;检索先按索引挑文件,判不准就全读 —— 宁可慢,不会漏。 只在首次分片时询问模型分组方案,之后新事实走纯代码增量归属,布局稳定。
记忆会过期
存下来的是写入那一刻的断言,不是现值。文件改了、配置换了,记忆不会自动跟着变。
所以插件在三个地方提醒模型:
- 系统提示里常驻一条规则:涉及文件名、路径、配置值时,行动前先核验当前状态
memory_recall命中内容含具体路径/配置时,结果末尾附提醒- 查不到时不给空列表,而是给出下一步:换更少更独特的词 → 按标签查 → 看简报
0 命中不等于从未记录。 换个措辞就是另一条命中。
数据长什么样
全部在 $DSH_HOME/memory/(默认 ~/.dsh/memory/,可用 memory_dir 改):
memory/
brief.md 当前摘要(Markdown,可直接读改)
facts.yaml 事实(分片之前在这里)
candidates.yaml 待确认的线索
facts/ 分片之后的事实(超过阈值才出现)
_index.yaml 分片索引(缓存,可删,不影响任何事实)
<topic>.yaml 按主题拆出来的分片
unsorted.yaml 归不进去的兜底
.archive/ 旧的 facts.yaml 归档(移动过来,不删)
log/YYYY-MM-DD.json 整理日志(追加式)
.sessions.json 已处理会话台账(v2:记每场的事件数与末事件时间快照,没新事件的会话不再进模型)
details/ 会话原文级细节(派生材料,按保留期清理)
_index.yaml 细节索引:ref → 会话、标题、事件数、被查次数
<日期>/<ref>.md 一场会话的原文沉淀(只追加;ref 形如 2026-11-16-1)
只渲染 用户/助手/工具调用四类事件;其余类型在文件末尾以
<!-- 未收录事件类型:… --> 注释列出,不静默吞掉
一条事实:
- id: "mem-1792927799706-001"
fact: "发布分支"
since: "2026-03-02"
history: # 版本链,最后一条 = 当前值
- date: "2026-03-02"
value: "release"
- date: "2026-04-18"
value: "stable"
note: "用户要求改名"
安装
dsh plugin --profile <你的profile> add dsh-memory-kg
npm 上
dsh-memory已被他人占用,本包名为dsh-memory-kg;仓库名保持dsh-memory。
装上后七个工具立即可用。夜间自动整理需要 profile 里存在 schedule 服务
(如 dsh-experimental-schedule-bundle);没有的话手动整理一样能用。
不需要配 API key 或代理。 整理走宿主自己的模型服务(ctx.llm),
你在 dsh 里配的模型就是它用的模型。默认跟随宿主默认模型,想指定就在配置里写
organizer_provider + organizer_model。
配置
在 profile 的 cordis.patch.yml 里按 id 覆盖:
- id: dsh-memory-kg
config:
detail_retain_days: 60
⚠️ 别用
- insert:再注册一次。 插件装好后自己已经注册了(bundle 的 patch), 再 insert 会变成两个实例,只有先注册的那个生效——insert 上的config会被静默忽略, 表现是"改了配置但行为没变"。要改配置就用上面的 id 定向覆盖。
| 配置项 | 默认 | 说明 |
|---|---|---|
memory_dir |
$DSH_HOME/memory |
记忆存放目录 |
organizer_provider |
跟随宿主 | 整理用的 provider |
organizer_model |
跟随宿主 | 整理用的模型名 |
daily_time |
04:00:00 |
夜间整理时间(本地时区) |
time_zone |
宿主时区 | IANA 时区名 |
scan_sessions |
12 |
每次整理最多扫多少场会话(上限 40) |
shard_threshold |
80 |
事实超过多少条开始分片;设 0 关闭 |
enable_shard |
true |
完全关闭分片 |
enable_schedule |
true |
关掉自动注册夜间任务 |
organizer_session |
memory-organizer |
整理专用会话 id |
enable_detail |
true |
关掉细节层沉淀(details/ 不读不写,memory_detail 返回"细节层已关闭") |
detail_retain_days |
30 |
细节文档保留天数;0 = 永不清理(被查豁免依旧成立) |
detail_tool_result_max_chars |
800 |
单条工具结果收进细节的字数上限 |
工具
| 工具 | 用途 |
|---|---|
memory_brief |
读当前简报 |
memory_recall |
按关键词或标签检索事实 |
memory_note |
记一条事实(同主题自动出新版本) |
memory_candidate |
记一条待确认的线索 |
memory_promote |
把线索升格成正式事实 |
memory_organize |
整理一次;dry_run 只报告不落盘,reshard 重排已有分片 |
memory_detail |
按 ref / 会话 id / 关键词回查会话原文级细节(纯本地读) |
一次整理做什么
顺序固定:
- 归并同义的待确认线索(多余的标
merged保留,不删) - 清理细节层:超过 30 天、且从未被查过的派生文档删掉(每次删除写
detail_cleanup日志) - 扫最近几场会话,按 id 剔掉整理会话自身和子 agent 会话;快照没变的会话不进模型
- 把会话摘录 + 现有事实 + 现有候选 + 当前简报 + 细节索引交给模型,要一份 JSON
- 落地:事实追加版本、候选去重后新增、简报换新(旧的归档)、会话原文追加沉淀进
details/ - 事实超阈值时分片
它不会做的事(有负面清单约束):
- 不把整理过程本身写进记忆("扫了几场""跑了几次"这类)
- 不记绝对路径、主机名、端口,除非用户明确要求长期记住某个地址
- 不把一次性状态写成事实
- 模型输出解析不了就什么都不写,宁可不记,不编造
所有更新都是只增不删:旧简报进 log/ 归档,旧事实版本留在 history,
被合并的候选标 merged 仍可见。没有任何删除记忆本体(facts/brief/candidates/log)的路径;
唯一的删除路径是派生细节层(details/)的按保留期清理,且每次删除都写日志。
已知边界
- 检索是子串匹配,不是语义搜索。 换措辞可能查不到,所以 0 命中时会给升级路径。
- 候选去重只处理格式噪音。 会剥掉
(出现 N 次)这类尾巴,真正换说法的仍可能分成两条 —— 这是有意的,误合并比多存一条更糟。 - 整理由模型判断"什么值得记"。 可能漏记也可能多记。文件是明文的,看不过去直接改。
- 分片后新增的事先进
unsorted,下次整理才按标签归位。这是为了布局稳定,不丢数据。 reshard只对已分片的库有效;空库不会凭空造片,首次分片由shard_threshold触发。
已知限制
细节回查(已实现)
摘要记得"做了什么",细节层记得"为什么那样做"。整理时把会话原文级沉淀进 details/<日期>/<ref>.md,
简报里的关键判断后面跟着 → 细节:<ref> 指针;模型用 memory_detail { ref } 按指针翻原文,
系统提示的「可回查的细节」索引由代码追加(不依赖模型自觉)。
- 细节文档只追加:会话继续聊了,新内容接在末尾,旧段落逐字不动
- 工具调用带结果(按 callId 并回它的调用段),报错的标
结果(失败):;调用在上一窗口的孤儿结果单独成段标结果(callId …) - 被查过的文档(
queried_count > 0)清理时豁免——有人真的回去看过,说明它有用 - 30 天前、从未被查过的派生文档清掉;每次删除写
detail_cleanup日志;facts/brief/candidates/log 一个字节不动
断档不可感知
服务重启或长时间没跑之后,它拿到简报看不出中间空了一段。它知道现在几点,但不知道自己上次醒着是几点。
对应 TODO 里同一节的后半条。
开发
npm run build # tsc
node e2e/run.mjs # 端到端,默认零网络
e2e 默认用桩数据跑通全链路。要对接真实模型:
E2E_LLM_URL=https://.../v1/chat/completions E2E_LLM_KEY=... node e2e/run.mjs
许可
MIT
No comments yet. Be the first to write one.