Vai al contenuto principale
L

dsh-workspace-memory

lovenndme/dsh-workspace-memory

Workspace-scoped persistent memory for DSH, laid out like Claude Code's auto-memory: one English-slug Markdown file per memory beside a MEMORY.md index under ~/.dsh/projects/, with hybrid vector+keyword recall, three automatic triggers (index injected every turn, file-path hints appended to tool results, per-message prefetch), a review queue for low-confidence writes so nothing enters the library silently, and global preferences written as numbered chapters into ~/.dsh/AGENTS.md under a byte budget. Everything is read from and written to local files; the optional leanvec embedder (~85 MB, installed locally by the bundled script) powers semantic recall but runs in-process, so the plugin itself opens no network connections and uploads nothing. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Installazione

dsh plugin --profile web add github:lovenndme/dsh-workspace-memory

README

dsh-workspace-memory

给 DSH(DeepSeek Harness)用的记忆插件:让 agent 跨会话记住你是谁、你希望它怎么做事,以及每个项目里代码看不出来的事。 做法对标 Claude Code 的记忆:分层的指令文件(CLAUDE.md 那一套,在 DSH 里是 AGENTS.md)加上自动记忆。

为什么需要它

每开一个新会话,agent 都从零开始:上次纠正过的做法这次又犯,上周定下的期限它不知道,仓库外的资料放在哪也得重新问一遍。 光有一个「记忆工具」还不够。实际用下来,常见的问题是三类:该记的没记(用户纠正了一句,模型嘴上答应「以后注意」,却什么都没写下来); 记的东西放错地方(全员都要守的仓库规则被存进了某个人的记忆,流程和设计说明也塞进了记忆);模型自己往每轮都会注入的常驻文件里乱写规则。 这个插件把「一条东西该写到哪」理清楚,让模型在对的时机写到对的地方;每轮都会注入的指令文件只由你来写,模型自动记的只进记忆库。

记忆分几层

每轮都会看到的(常驻)

这三层由 DSH 宿主在每个会话里加载,模型每一轮都看得到:

  • ① 全局 AGENTS.md(~/.dsh/AGENTS.md):你写给 Agent、在所有项目都成立的指令。 这是你自己的文件,插件不会自动往里写:你可以在面板里逐章编辑,或把一条记忆「升为全局指令」;Agent 只在你明确要求时才用文件工具写。
  • ② 项目 AGENTS.md(仓库根目录,进 git):进这个仓库的人和 agent 都要守的规则,包括仓库约定(提交说明、代码风格、命名)。 插件不写它:模型先向你提议,你同意后用文件工具写。
  • ③ AGENTS.local.md(和项目 AGENTS.md 同一个目录,不进 git):只对你成立的项目规则。写法同上。

用到时才看的(按需)

  • ④ 项目记忆库(~/.dsh/projects/<工作区>/memory/):本项目进行中的决定和期限、仓库外资源的位置、本项目踩过的坑。
  • ⑤ 跨项目记忆库(~/.dsh/dsh-workspace-memory/global/memory/):你是谁、你对做事和表达方式的要求,以及哪个项目都可能遇到的坑、参考资料。
  • ⑥ skill(~/.dsh/skills/ 或项目里的 .dsh/skills/):可重复的多步流程。插件不写 skill,模型提议、你同意后用文件工具写。

④⑤ 的索引每轮都可见,一条记忆占一行摘要;正文用到时才取出来。记忆会在三个时机被想起来:每轮按你说的话预取最相关的几条, 读写某个文件时提示与它相关的记忆,以及模型主动调用 memory_recall。

待确认:一道关卡,不是一层

模型自己总结出来的、声称是你的原话但核对不到的,都先进待确认,由你在面板上收下或丢弃。

和 Claude Code 的对照

这里Claude Code
① 全局 AGENTS.md~/.claude/CLAUDE.md
② 项目 AGENTS.md项目里的 CLAUDE.md
③ AGENTS.local.mdCLAUDE.local.md
④⑤ 项目记忆库、跨项目记忆库自动记忆
⑥ skillskills

和 Claude Code 一样,模型自动记的只进记忆库,不写 AGENTS.md。区别有两点:按需的记忆分成本项目、跨项目两个库;写入多了一道待确认关卡。

插件面板里用的叫法:① 是「全局指令」,②③ 是「项目指令 · 团队 / 仅你」,④⑤ 是「项目记忆」「通用记忆」。 面板能编辑记忆和全局指令;项目指令在面板里只读,它们是仓库里的普通文件,直接用编辑器改(面板上有打开按钮)。

一条新东西怎么决定去哪

模型照下面的顺序判断:

  1. 可重复的多步流程(怎么部署、怎么排查某类故障),不管是只有它用还是大家都用,写成 skill。
  2. 必须遵守的规则,以 AGENTS.md 为准:全员都要守的写项目 AGENTS.md,只对你成立的写 AGENTS.local.md。记忆里不再存第二份。
  3. 关于你本人、或者你对它做事和表达方式的要求,并且在所有项目都成立的,存进跨项目记忆库(面板里叫「通用记忆」),所有项目都查得到。 想让某一条每轮都带着,可以在面板里把它升为全局指令。
  4. 其余只有你和它用得上的,按「只在本项目成立」还是「哪个项目都成立」分别进项目记忆库或跨项目记忆库。
  5. 拿不准该去哪,或者拿不准是长期规则还是只管这一次,它会在回复末尾问你一句,并给出选项。
  6. 只纠正这次结果的(算错了、写错了),或者你话里带了「这次」的,不记。

模型调用记忆工具时必须给内容归类。归成「流程」「全员规则」「项目文档」这三类时,工具什么都不保存,而是告诉模型该写到哪 (skill、项目 AGENTS.md、README),由模型再向你提议。设计上为什么这样分、每一步怎么来的,见 docs/DESIGN.md 的「记忆写到哪」。

安装

从 npm 装(推荐):

plugin_manager install_bundle --target @lovenndme/dsh-workspace-memory

或者以本地目录 link 的方式装:

plugin_manager install_bundle --target <插件目录>

国内网络:DSH 的「发现」面板走 GitHub Pages,无代理经常加载不出来(表现为「搜不到插件」)。 这时走「插件 → 添加插件 → 安装源选『中国大陆镜像源』→ 粘贴包名 @lovenndme/dsh-workspace-memory」 即可;结束后 npm 会自动同步,通常几分钟就能拿到最新版。只有安装这一步需要联网,装完完全离线可用。

装好后把它先禁用、再启用一次,让宿主换上新模块(在插件列表里切,或者让 agent 调用):

plugin_manager set_plugin --target include:dsh-workspace-memory --enabled false
plugin_manager set_plugin --target include:dsh-workspace-memory --enabled true

以后改了代码或拉了新版本,也要这样切一次。 确认插件行的 application 状态是 applied、没有 diagnostic,才算装好。

可选:装上语义检索用的嵌入模型 leanvec。 不装也能用,只是检索退化成纯关键词,同义改写、换个说法问就找不到。 在插件目录里运行一次:

node scripts/install-deps.mjs   # 约 85 MB,装到 ~/.dsh/dsh-workspace-memory-deps

装完再禁用、启用一次插件。/memory status 的「检索」一行会显示当前是向量加关键词,还是只用关键词。

平时怎么用

大多数时候你什么都不用做:模型会在合适的时候自己调用记忆工具,你只需要偶尔去面板上处理待确认。

面板

右侧栏的「记忆」页签。打开方式:在右侧栏「开始」页点「记忆」(排在「更多工具」上面),或者执行 /memory_list(卡片上也有「打开记忆面板」按钮)。 更新插件后命令卡变成了宿主默认的折叠卡、面板也不见了,说明前端那一半没加载上,排查与重载方法见 docs/PANEL.md §8。顶部四页:

  • 总览:一张「记忆地图」,按「在哪儿生效(所有项目 / 本项目)× 什么时候读(每轮都读 / 用到才查)」摆出全局指令、通用记忆、 项目指令、项目记忆四处各有多少、离上限多远;下面是每轮固定带给模型的内容约多少 tokens、最近变化, 以及很久没被用到、可能过时的记忆。有待确认时顶部会提示。
  • 待确认:等你决定的草稿,一张卡一条。每张卡写明收下后去哪(例如「→ 全局指令 · 覆盖第 2 章」「→ 项目记忆 · 替换「…」」)、 为什么要你确认、出处原话;覆盖或替换时可以和现在的内容逐行对比。「收下」写入,「丢弃」删掉草稿(会先确认,丢弃不留历史)。 焦点在面板里时可以用 J / K 切换、A 收下、D 丢弃。
  • 指令:「全局」逐章查看和编辑全局指令(~/.dsh/AGENTS.md),增删章,编号自动重排,显示字节用量与上限,也可以用本机编辑器打开; 文件还不存在时可以在这里新建。「本项目」只读展示项目根目录(从当前会话目录往上最近的 .git 所在处,也就是 DSH 实际加载项目指令的位置)的 AGENTS.md 与 AGENTS.local.md。
  • 记忆:项目记忆和通用记忆的列表与详情。可以搜索、按适用范围和类型筛选,编辑标题、摘要、正文、类型、标签和文件名; 改「适用范围」保存后会把条目移到另一个库;「升为全局指令」把一条记忆变成全局指令的新一章并从记忆里移出(两个库的都可以)。 删除和覆盖前都会留一份历史版本。有未保存的修改时离开会先问你,Ctrl+S 保存。

命令

只有两个命令:/memory(查看和管理记忆)、/memory_list(打开记忆面板)。

  • 只敲 /memory 回车:弹出子命令选单,点一下就执行。第一项是总览,所以回车两下就是总览。 选单里「需要 id 的操作」(收下、丢弃、删除)会直接打开记忆面板,在那里点按钮完成,不用手抄 id。
  • 敲 /memory 加空格:输入框里会提示最常用的几个:pending 待确认 · extract 抽取 · list 全部 · help 更多。
  • 直接敲完整子命令也可以,例如 /memory list;打错了会提示「你是不是想输入 …」。
打开面板
/memory_list                 在右侧栏打开记忆面板(也可以在右侧栏「开始」页点「记忆」)

常用
/memory                      总览:待确认几条、每轮都读的全局指令与项目指令(大小与上限)、
                             用到才查的通用记忆与项目记忆(条数与分类)、每轮固定开销约多少 tokens
/memory pending              列出待确认草稿,每条写明收下后去哪、来源
/memory extract              立刻从当前对话里抽取一次候选,结果进待确认
/memory list                 列出两个库的记忆和更新时间(每个库最多列最近 30 条,全部在面板里看)
/memory status               诊断:两个库的位置、索引、向量、自动抽取开关、配置问题

需要 id 的操作(在面板里点按钮更方便)
/memory accept <id>          收下一条草稿(面板「待确认」页的「收下」)
/memory reject <id>          丢弃一条草稿,不留历史(面板「待确认」页的「丢弃」)
/memory forget <id> [project|global]
                             删除一条记忆,删前在该库旁的 .memory-state/history/ 留一份旧版
                             (两个库都有同一个 id 时要写明是哪个)

整理
/memory reindex              手改过记忆文件后,重建索引
/memory help                 列出全部子命令,每个一行说明

/memory 总览长这样(示例数据):

记忆总览 · demo-app
待确认 2 条 → /memory pending 查看,或在记忆面板「待确认」页处理

每轮都读
  全局指令  3 章 · 2.0 / 10 KB(20%)
  项目指令  团队 0.8 KB · 仅你 未创建
用到才查
  通用记忆  2 / 50 条 · 资料位置 1 · 踩坑经验 1
  项目记忆  3 / 50 条 · 项目决定 1 · 资料位置 1 · 踩坑经验 1
每轮固定开销约 914 tokens

检索:只用关键词(装上 leanvec 能认出换个说法的问题)
写入:Agent 自己总结的先进待确认;全局指令和项目指令只由你来写
/memory_list 打开面板 · /memory help 查看全部子命令

命令结果卡片下面有「打开记忆面板」按钮(待确认的卡片上是「去面板处理」)。

  • 以前的 /memory_extract、/memory_pending 两个独立命令已经并入 /memory extract、/memory pending;旧会话里那两种结果卡片照常显示。
  • 子命令选单用的是 DSH 客户端的命令选单接口(DSH 0.2.2 起有);更早的 DSH 没有这个接口,/memory 回车直接出总览,其余用法相同。

模型用的工具

  • memory_remember:写一条记忆,或者被告知这条内容该写到别处。
  • memory_recall:在两个记忆库里检索,返回正文和最后更新日期;什么都没找到时会明确告诉模型「没有记录」,而不是让它自己猜。
  • memory_forget:按 id 删除一条记忆。
  • memory_status:排障用,报告两个库的条数、索引、检索模式、最近一次证据核对和配置问题。

哪些时候要你确认

  • 全局 AGENTS.md 只由你来写:记忆工具和自动抽取都不会往里写。以前版本留在待确认里、要写进全局指令的草稿,照样可以收下或丢弃。
  • 模型自己总结的(例如它自己踩到并验证过的坑)进待确认。想让这类按需记忆直接生效,可以把配置 agentWrites 改成 direct。
  • 你说的原话:模型写入时要附上你的原话,插件会到你发过的消息里核对。核对得上的直接写进记忆库,核对不上的进待确认。
  • 面板上的来源标签:「你的原话 · 已核对」表示核对过、确实出自你;「说是你的原话 · 没核对上」表示模型说是你的原话,但对话里找不到; 「你的原话 · 旧条目未核对」是核对机制出现之前记下的;「Agent 总结」表示模型自己得出的。
  • 草稿卡片的去向如果是「替换「…」」,或写着「同时删除」某条记忆,收下它会删掉那条旧记忆(删除前留历史版本)。

配置

不改任何配置也能用。要调整时,在 profile 的 cordis.patch.yml 里本插件那一行下加 config,改完禁用再启用插件生效:

- id: dsh-workspace-memory
  name: '@lovenndme/dsh-workspace-memory'
  config:
    enableExtraction: true
    agentWrites: direct

常用的几项:

键默认作用
enableExtractionfalse每隔几个回合自动从对话里抽取候选,进待确认。会给这些回合多加一次模型调用
agentWritesreview模型自己总结的记忆:review 进待确认,direct 直接写入
maxMemoryCount50每个记忆库最多多少条,满了拒绝写入;0 表示不限
maxAgentsBytes10000全局 AGENTS.md 的字节上限,超了拒绝写入;0 表示不限
globalMemoryDir空跨项目记忆库的位置;空表示 ~/.dsh/dsh-workspace-memory/global/memory/
globalIndexMaxLines60跨项目记忆库的索引每轮最多显示几行;0 表示不显示
prefetchRecalltrue每轮按你的话预取最相关的几条记忆
pathsHinttrue读写与某条记忆相关的文件时,在工具结果末尾提示

完整的配置列表和每项的取值范围见 docs/DESIGN.md 的「配置」。

数据存在哪 / 隐私

所有数据都在本机。插件自己不发网络请求;打开自动抽取后,它会经 DSH 调用当前会话所用的模型;leanvec 的安装脚本会从 npm 下载一次。

  • 全局 AGENTS.md:~/.dsh/AGENTS.md;插件每次改写前把原文件备份到 ~/.dsh/.dsh-workspace-memory-history/agents/,保留最近 20 份。
  • 项目记忆库:~/.dsh/projects/<工作区>/memory/,一条记忆一个 Markdown 文件,旁边的 MEMORY.md 是索引。 这里的「工作区」是你在 DSH 里注册的工作区,整个工作区共用一个库。
  • 跨项目记忆库:~/.dsh/dsh-workspace-memory/global/memory/。
  • 待确认草稿:~/.dsh/projects/<工作区>/.memory-state/pending/。
  • 历史版本:每个库旁边的 .memory-state/history/,覆盖或删除前留档,每条记忆保留最近 20 版。
  • 语义检索的向量只在进程内存里,不写到磁盘,重启后第一次检索时重建。

记忆都是普通的 Markdown 文件,插件卸了、坏了,记忆都还在,可以直接用编辑器看和改(改完运行一次 /memory reindex)。 设置了环境变量 DSH_HOME 时,上面所有的 ~/.dsh 都换成它。

效果怎么样

在目标模型(Ollama 上的 DeepSeek V4.1 Flash,也就是 DSH 里实际在用的模型)上,用 52 个合成的对话场景实测: 模型该记的记了、不该记的没记、东西写到了对的地方,才算判对。

指标结果
最新版,正常收尾的 46 个场景判对 45 个(另有 6 个场景在步数上限内没跑完,不计入)
同一模型对照改动前(两版都正常收尾的 20 个场景)改动前 13 个,改动后 18 个
2026-11-16 改为「自动记的只进记忆库」后重跑受影响的 24 个场景(12 道偏好题 + 12 道各类抽查)判对 23 个;偏好题 12/12 都存进了通用记忆,没有一次写全局 AGENTS.md。唯一错的一题在改动前也跑不稳

几点要如实说明:场景是合成的,不是真实对话;对话在模拟的宿主和虚拟的仓库里进行,插件这一版还没有在真实 DSH 里逐项验证过; 每个场景基本只跑了一次,单题的对错会有波动,部分类别的结果来自稍早一点的版本。 详细记录见 HANDOFF.MD 第二十五、二十九节和 docs/DESIGN.md 的「写入怎么衡量」。

已知限制

  • 证据核对只核出处,不核语义。 它能确认「这句话确实是你说的、和这条记忆沾边」,判断不了意思有没有被曲解(比如只截了否定句的后半句)。 核对不上的在面板上标「说是你的原话 · 没核对上」,由你决定收不收。
  • 面板用的本机 HTTP 接口没有鉴权(DSH 的网页服务本身不提供)。插件保证的是记忆工具和自动抽取不会写全局 AGENTS.md, 不是本机上的程序无论如何都改不了它。
  • 配置写错不会报错。 插件没有声明配置表单,写错的值会悄悄回落成默认值;运行 /memory status 能看到配置问题。
  • 不做跨语言的语义匹配。 记忆尽量用你平时提问的语言写,中文问题找英文记忆效果会差。

环境要求

项要求
DSH>= 0.2.1-rc.5 < 0.3.0
Node>= 18
运行时依赖无;leanvec 可选,约 85 MB

卸载

在插件列表里禁用或移除本插件即可(移除:plugin_manager remove_bundle --target dsh-workspace-memory)。记忆数据不在插件目录里,卸载后都还在:要彻底清掉,删除 ~/.dsh/projects/<工作区>/memory/ 与旁边的 .memory-state/、~/.dsh/dsh-workspace-memory/、~/.dsh/dsh-workspace-memory-deps/、~/.dsh/.dsh-workspace-memory-history/。 全局 AGENTS.md 是你自己的文件,插件写进去的章节不会随卸载删除,需要的话在里面手动删。

参与开发

  • npm test:跑全部测试,测试只在临时目录里读写。
  • node eval/remember.mjs:主路径评测,模拟对话、让模型真实调用记忆工具并计分;要调模型、会消耗额度,手动跑。
  • docs/DESIGN.md:设计取舍、踩过的坑、评测细节。
  • HANDOFF.MD:当前状态、事故记录、还没验证的地方。
  • CLAUDE.md:给编码 agent 的仓库导航和容易再踩的坑。

许可

MIT

Plugin correlati