DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Kagurazaka135 /

Kagurazaka135/dsh-memory

Verified

DeepSeek Harness 分层记忆插件:L3 版本化事实 + L4 启动摘要 + 夜间整理,PC/手机通用

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: master@08a6a295

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 / 关键词回查会话原文级细节(纯本地读)

一次整理做什么

顺序固定:

  1. 归并同义的待确认线索(多余的标 merged 保留,不删)
  2. 清理细节层:超过 30 天、且从未被查过的派生文档删掉(每次删除写 detail_cleanup 日志)
  3. 扫最近几场会话,按 id 剔掉整理会话自身和子 agent 会话;快照没变的会话不进模型
  4. 把会话摘录 + 现有事实 + 现有候选 + 当前简报 + 细节索引交给模型,要一份 JSON
  5. 落地:事实追加版本、候选去重后新增、简报换新(旧的归档)、会话原文追加沉淀进 details/
  6. 事实超阈值时分片

它不会做的事(有负面清单约束):

  • 不把整理过程本身写进记忆("扫了几场""跑了几次"这类)
  • 不记绝对路径、主机名、端口,除非用户明确要求长期记住某个地址
  • 不把一次性状态写成事实
  • 模型输出解析不了就什么都不写,宁可不记,不编造

所有更新都是只增不删:旧简报进 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

—/ 5

No ratings yet

Verified DSH bundle

Commit 08a6a295b6d1

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout