dsh-memory
2424830124/dsh-memory
安装
dsh plugin --profile web add github:2424830124/dsh-memoryREADME
dsh-memory
给 DeepSeek Harness 用的跨会话长期记忆插件。
记忆就是磁盘上的 YAML 文件，按标题树组织。插件把这些文件注入提示词，给模型三个工具去读写，并在别的会话改动之后给本会话发一条不唤醒的变更通知。另有一份日志（短期记忆）：一天一个文件，一条一句话，用来记"今天发生了什么"。
- 记忆在会话之间共享，重启、换窗口、换工作区都还在。
- 模型改记忆前必须先读，写的时候校验版本，不会覆盖掉别人的改动。
- 别的会话动了记忆，这边只收到"哪几个标题变了"，要细节时再自己读。
- 注入的文本和
memory_edit的工具描述按会话冻结：会话开着的时候记忆文件再怎么变，这个会话拼出来的提示词前缀都不动，供应商的前缀缓存才能一直命中；变化走通知。闲过一个保留窗口（默认 60 分钟）才算另起一段，重新生成。
定位
主要给聊天、扮演、轻量编程当跨会话长期记忆用。它有两个有意为之的取舍：
没有自动召回。 每次组装提示词就把记忆文件整份注入，不检索、不算相关性、不排序。原因有两条：一是没找到足够好的召回方案，召回错了比不召回更糟，模型会被一段"看起来相关其实是别的场景"的记忆带偏；二是记忆存量本来就不大，塞得进提示词就没有先筛一遍的必要。
以后也许会加基于关键词的轻量召回（近期目标第一条），但那只是存量变大之后的兜底，不改变"整份注入"这条主路径。
真正想做的是可自定义的记忆结构。 插件不规定你该建哪些文件、该有哪些标题：file_name、desc、format、标题树、inject_ignore 全都写在文件自己身上，所以调整结构不用改插件、也不用动配置。
几种常见的搭法：
| 想记什么 | 大概长这样 |
|---|---|
| 长短期记忆 | 一个 长期记忆 存稳定的事实和偏好；当天的事先记日志，隔几天再摘要进长期 |
| 行为准则 | 一个 行为准则，一级标题就是场景（回答风格、拒绝什么、扮演谁），正文写具体要求 |
| 角色设定 | 一个 角色，或每个角色一份文件；format 里写清"只记这个角色说过做过什么，别混进别的角色" |
| 学习感悟 | 一个 感悟，一条一个二级标题，keyword 打标签，以后按标签翻 |
| 备忘录 | 一个 待办，inject_ignore 跳过 update_at 和 keyword，只留正文 |
有个经验：一个文件当一份用途。因为注入顺序（fileOrder，面板里拖动）和 inject_ignore 都是按文件走的——"每轮都必须看到"的准则单独一个文件放在最前，"偶尔翻一眼"的备忘录另起一个，互不干扰。同一个文件里再按标题树分章节。
安装
npm install @huai_xin/dsh-memory
插件以 bundle 形式挂到 profile 上。装好之后，在 profile 的配置里加载它的 cordis.patch.yml：
# cordis.patch.yml —— 只挂载插件，不写配置值
- insert:
- id: memory
name: '@huai_xin/dsh-memory'
想跟着仓库源码走，就把 node_modules 里那份换成指到本地的链接（npm install ../dsh-memory 或 link: 依赖都行），改动不用重新发版。
依赖只有 yaml。
配置
配置写在插件的数据目录里，和它配置的东西挨着：
~/.dsh/dsh-memory/config.yaml # 配置，在面板里改当场生效；手改文件要重启 Harness
~/.dsh/dsh-memory/.memory/*.yaml # Global 记忆文件
~/.dsh/dsh-memory/state/sessions/ # 会话快照
<workspace>/.memory/*.yaml # Workspace 记忆文件
优先级：config.yaml > profile 里的插件配置 > 内置默认值。文件不存在就用默认值，YAML 写坏了整份忽略并打一条 warning。
| 键 | 默认 | 说明 |
|---|---|---|
snapshotTtlMinutes | 60 | 会话快照保留分钟数；闲这么久就丢掉，下次发消息重新生成。前缀缓存一般 5–60 分钟，按供应商的规则调；0 关闭清理 |
logSummaryMaxChars | 200 | 一条日志摘要（写在标题里）的字数上限 |
injectLog | false | 可选：把最近几天的日志也放进提示词 |
logInjectEntries | 20 | 注入时每天最多带多少条日志 |
logInjectGlobalDays | 3 | 全局日志带最近几天 |
logInjectGlobalDetailDays | 1 | 其中最新几天带正文，其余只剩标题 |
logInjectWorkspaceDays | 2 | 工作区日志带最近几天 |
logInjectWorkspaceDetailDays | 1 | 其中最新几天带正文，其余只剩标题 |
fileOrder | [] | 注入时记忆文件的先后；列出的按给的顺序在前，没列出的按文件名跟在后面。只影响注入。不在设置页里填——在面板左侧拖动文件即可 |
目录不可配置：Global 记忆固定在 <DSH_HOME 或 ~/.dsh>/dsh-memory/.memory，工作区记忆固定在 <workspace>/.memory，想换位置就改 DSH_HOME。这样一个写错的路径不会让插件安静地读到别处去。
面板
对话区顶部标签页里点「记忆」，里面有「全局」「工作区」「设置」三个标签。
- 前两个是浏览器：左边一列是该作用域现有的记忆文件（顶上分「记忆文件」和「日志」两个货架），点一个，右边分成「原文」和「注入效果」两栏。
- 「原文」把文件画成卡片，不是丢一整段 YAML 给人看：顶上一张元数据卡（文件名、描述、更新格式、不注入的值），下面是标题树，一级标题一张卡片，卡里是「更新时间 / 关键词」、正文、以及缩进排开的子标题。卡片标题可以点开收起。
- 卡片上的字就是编辑器：描述、更新格式、每个标题的正文和关键词都能直接改，改完按卡片右上角的「保存」落盘（没改过按钮是灰的，
update_at由插件维护、不给改）。元数据卡和内容卡各有一个「保存」，只保存各自那一半。 - **「不注入的值」**后面跟一个
+，展开一个两层菜单（顶层 / 一级标题 / 二级标题 … × 更新时间 / 关键词 / 正文），点一个加一个。关键词是自由词，+点开直接打字回车。 - **「注入效果」**是它出现在提示词里的样子，右上角能在原始文本和预览（Markdown 渲染）之间切。
- 左边每一行右边的
×删整份文件（删之前在该行下面展开一条确认条）；记忆货架顶上还有一个虚线按钮新建文件。都在栏内完成，不弹系统对话框——新建失败时输入框不关、名字不清，改个名字再回车即可。日志货架只有删除，没有新建：日志的一天由写入产生。 - 按住一行拖到别的位置，就改了注入顺序（列表里的先后就是注入的先后；日志那一栏按日期排，不参与）。
- 「工作区」跟着当前对话走：换一个会话，它显示的就是那个会话的工作区。
- **「设置」**把上面每个键做成一栏，填好保存即可；写回同一个
config.yaml（只改那几行，注释不动），当场生效，不用重启。
数据放在哪
~/.dsh/dsh-memory/.memory/*.yaml Global 记忆文件（所有工作区可见）
~/.dsh/dsh-memory/.memory/log/*.yaml Global 日志（一天一个）
~/.dsh/dsh-memory/state/sessions/*.json 每个会话一份快照
<workspace>/.memory/*.yaml Workspace 记忆文件（只对当前工作区可见）
<workspace>/.memory/log/*.yaml Workspace 日志
目录在第一次用到时自动创建。记忆文件是普通 YAML，可以直接用编辑器改——改完插件会重新加载并通知正在跑的会话。
记忆文件长什么样
meta_data:
file_name: 我的记忆
desc: 记录我和用户之间的一些回忆，以及我想要记住的事
format: |
写这个文件放什么、什么时候该更新、更新成什么样。
这段只出现在 memory_edit 的工具描述里，不进提示词。
scope: Global
inject_ignore: # 不写就是全都注入；下面两项是新建时预填的默认省法
- update_at
- keyword
data:
我们经历过的一些事:
update_at: 2026-10-27T03:18:36+08:00
desc: 一级标题的正文
keyword: [回忆]
我们之间的互动:
desc: 二级标题的正文
字段说明：
file_name— 模型用它寻址，同一会话能看到的目录里必须唯一。desc— 这个文件放什么。会注入提示词。format— 怎么写这个文件的说明。不注入提示词，只进memory_edit的工具描述。scope—Global或Workspace。inject_ignore— 注入时跳过哪些内容。可选t1t2t3t4、desckeywordupdate_at，以及t2.desc这种组合。新建文件不给这项时，落的默认就是update_at、keyword两条；想注入回来就把对应那行删掉，写[]就是全都注入。已有文件里不写就是全都注入。读取不受它影响。跳过标题时会连同子标题一起跳过，比如跳过t1就是跳过一级标题，以及其下所有内容。一份文件只要什么都没剩下（列了t1，或者里面根本没有标题），整个文件都不出现，连文件头也没有——但memory_read照旧读得到，memory_edit的描述里也照旧列着它的format。update_at— 工具自动写，不要手填。
正文开头不能是 #（会被读成标题）；# 出现在正文中间或后面几行都可以。标题最多 4 级，同级不能重名。
落盘的完整形状见 docs/记忆文件格式.md。
日志长什么样
一天一个文件，放在 log/ 下，文件名就是日期。meta_data 只有 file_name 和写死的 desc，其余规则是固定的，写在 memory_edit 的工具描述里：
meta_data:
file_name: 2026-10-27
desc: 用来记录和“他”之间的互动 # 全局；工作区是「用来记录项目相关操作」
data:
2026-10-27: # 一级标题固定是当天日期，和 file_name 相同
update_at: 2026-10-27T12:35:10+08:00
12:35 讨论了日志设计: # 二级标题是「时分 + 摘要」
update_at: 2026-10-27T12:35:10+08:00
desc: 用户否掉了自动生成时间标题，说让模型自己写；正文就是不限长度的细节。
desc由插件按scope写死，模型改不了（memory_manage拒绝改日志的元数据）。- 一级标题只有一个，固定是当天日期；写的时候
heading_path必须写全# yyyy-mm-dd > ## hh:mm 摘要这一种形状。 - 二级标题是
HH:MM 摘要（本地时间，09:05不是9-5），摘要受logSummaryMaxChars限制，条目的desc就是不限长度的细节。 - 条目按时间排序，插入时自动排好。
- 正文开头不能是
#：标题只由heading_path决定，日志没法从正文里新建或改名；#出现在中间是可以的。 - 当天文件在启动和零点自动创建；只写得了当天，不能改名、不能删除。
- 关键词挂在二级标题上（一级标题没有），可以和写正文放在同一次调用里。
- 日志默认不进提示词，要按日期主动读；
injectLog打开后按上面的天数规则带最近几天。 - 落盘的完整形状见 docs/日志文件格式.md，读出来的样子见 docs/日志返回格式.md。
三个工具
memory_read — 读。scope 决定查哪个目录（Global 或 Workspace）：传了 file_name 就必须给 scope；只看清单时可以不给，给了就只列那一层，不给就列全部。省略 file_name 返回文件清单，省略 heading_path 返回整个文件。读取结果不受 inject_ignore 影响。file_name 写成日期就是读日志：2026-10-27 读一天，2026-10-26..2026-10-27 读连续几天；heading_path 用 12:00..14:00 在选中的每一天里按时间收窄。范围用 ..，路径用 >，两种符号不混用。读出来的形状见 docs/通用返回格式.md 和 docs/日志返回格式.md。
memory_edit — 改正文、关键词；改标题名；删标题子树。scope 必填，指定改全局那份还是工作区那份。调用前必须先 memory_read，插件会校验读到的版本。file_name 写成日期就是写日志：heading_path 必须写成 # 2026-10-27 > ## 12:35 讨论了日志设计，new_string 就是这条的正文；关键词也挂在这一级上。返回一行摘要，开头带 [Global] 或 [Workspace]，例如 [Global] 已更新 我的记忆 > 沟通方式。
memory_manage — 新建记忆文件，或改文件的 desc / format / inject_ignore。返回 [Global] 已保存记忆文件 <文件名>。
子 agent 只能 memory_read，不能改记忆。
近期目标
按优先级从高到低。都还没有做，写在这儿是为了先把形状和难点定下来。
1. 基于关键词的自动召回。
现在是把记忆文件整份注入，存量真的变大就塞不下了。目标是用关键词先筛一遍，只注入相关的那部分——keyword 字段、标题里的词、desc 里的词都可以作为匹配依据。
难点不在匹配，在它和前缀冻结天然打架：召回结果随话题变化，一召回注入文本就变，前缀缓存立刻失效。所以真做的时候大概率是「会话开始（或快照重建）时按当时的话题召一次，结果跟快照一起冻结」，而不是每轮重新召回。每轮召回省下的 token 与打掉缓存多花的钱要先算清楚，可能并不划算。
2. 自定义人设预设。 一份份可切换的长文本预设（人设卡、破甲人设这类），新建会话时挑一份注入提示词。它属于会话级前缀，定了就不再变，和冻结机制是同一套逻辑。
待定的是接入口：新建会话是宿主的动作，插件目前唯一的面板落点是 conversation.view，要挂到"新建会话"那一步得另找位置。
3. 固定频率注入的自定义消息。 按条数或按时间间隔，往对话里固定插入一条内容：一句话，或某个记忆文件的全部内容。可以做定时提醒，也可以做"心情随时间变化"这类效果。
实现上倾向追加到对话里（像变更通知那样发一条、不唤醒），而不是改系统提示词——改提示词就是改前缀，而且一条提醒本来也不该常驻。
文档
docs/ 下是形状参照，不参与运行：记忆文件格式、日志文件格式、通用返回格式、日志返回格式。
开发、架构与改动指南见 AGENTS.md。
许可
MIT，见 LICENSE。