DeepSeek HarnessHub
提交插件

2424830124/dsh-memory ↗★ 1

@huai_xin/dsh-memory

Cross-session long-term memory for DeepSeek Harness: YAML memory notebooks injected into the prompt, read and edited by the model, and kept in sync across sessions.

記憶與知識庫介面擴充效率工具
套件
@huai_xin/dsh-memory
相容性
待驗證
版本
0.1.3
授權
MIT
最近更新
2026年10月30日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:2424830124/dsh-memory

說明文件

閱讀完整 README ↗

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/ # 会话快照 /.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-memory/.memory`，工作区记忆固定在 `/.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 每个会话一份快照 /.memory/.yaml Workspace 记忆文件（只对当前工作区可见） /.memory/log/*.yaml Workspace 日志


目录在第一次用到时自动创建。记忆文件是普通 YAML，可以直接用编辑器改——插件会重新加载并合并变更：空闲会话在你下一次发消息时检查，正在运行的会话每 5 秒检查一次（最多每 5 秒一条提醒）。

## 记忆文件长什么样

```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 — 注入时跳过哪些内容。可选 t1 t2 t3 t4、desc keyword update_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。

配置

配置写在插件的数据目录里，和它配置的东西挨着：

~/.dsh/dsh-memory/config.yaml         # 配置，在面板里改当场生效；手改文件要重启 Harness
~/.dsh/dsh-memory/.memory/*.yaml      # Global 记忆文件
~/.dsh/dsh-memory/state/sessions/     # 会话快照
/.memory/*.yaml            # Workspace 记忆文件

优先级：config.yaml > profile 里的插件配置 > 内置默认值。文件不存在就用默认值，YAML 写坏了整份忽略并打一条 warning。

键默认说明
snapshotTtlMinutes60会话快照保留分钟数；闲这么久就丢掉，下次发消息重新生成。前缀缓存一般 5–60 分钟，按供应商的规则调；0 关闭清理
logSummaryMaxChars200一条日志摘要（写在标题里）的字数上限
injectLogfalse可选：把最近几天的日志也放进提示词
logInjectEntries20注入时每天最多带多少条日志
logInjectGlobalDays3全局日志带最近几天
logInjectGlobalDetailDays1其中最新几天带正文，其余只剩标题
logInjectWorkspaceDays2工作区日志带最近几天
logInjectWorkspaceDetailDays1其中最新几天带正文，其余只剩标题
fileOrder[]注入时记忆文件的先后；列出的按给的顺序在前，没列出的按文件名跟在后面。只影响注入。不在设置页里填——在面板左侧拖动文件即可

目录不可配置：Global 记忆固定在 /dsh-memory/.memory，工作区记忆固定在 /.memory，想换位置就改 DSH_HOME。这样一个写错的路径不会让插件安静地读到别处去。