前言¶
在 DeepSeek Harness(DSH)里做 Agent,常见痛点是上下文一关,上一轮约定、偏好和踩过的坑就散了。不少「记忆」类插件用自动召回:每轮开始前把几条历史塞进上下文,由算法猜什么重要。上下文里多出来的行,并不总是你愿意出现的。
「不忘」(仓库 cheeseRatRat/dsh-buwang)走另一条路:不自动写、不自动读;工坊默认不进上下文。数据全是本机 Markdown,无数据库、无云、插件侧不发网络请求。维护者与羡渝渝、AI 伙伴蓝曦共同完成,在 SkillHub 插件目录 归类为「记忆」。SkillHub 为社区目录,与 DeepSeek / 幻方无官方从属关系;DSH 本身仍是「一切皆插件」的宿主,需先安装 DSH 再装插件。
这是什么¶
全称可理解为「主动记录的日记与过往,我不会忘记」的私人记忆库。它是 DSH 插件(dsh-buwang,当前清单版本 0.1.5,MIT),解决「模型没处放、又不想让上下文被自动灌满」的问题:该记的由你开口写入,该翻的由你开口读取;人格、记忆、工坊、封存分区管理,多人格互不串味。
和常见记忆插件的差异¶
下面四条是设计上的硬约束(README 称「四条铁律」):
- 你不开口,它不记。
- 你不开口,它不读。
- 工坊默认完全不加载;说「搜索工坊」才列目录,选中再开,办完即关。
- 人格默认不共享;共享为只读快照,对方不能改。
代价是需要用自然语言或面板主动操作;好处是注入上下文的每一行,都经过你的同意(或你启用的工坊项)。
三层记忆与四个分区¶
三层记忆¶
| 层 | 路径 | 每轮占用 | 写法 |
|---|---|---|---|
| 同游 | 记忆/<人格>/同游.md |
全文注入,不截断 | 一行一条短句;面板显示 N / 60 上限 |
| 近期 | 记忆/<人格>/近期/YYYY-MM-DD.md |
最近几天各一行 | 一次总结一条;同日可 -2、-3 |
| 长期 | 记忆/<人格>/长期/YYYY-MM-DD~YYYY-MM-DD.md |
一行标题 + 一句话 | 巩固后的区间小结,细节需 memory_recall |
「整理」靠你触发:memory_consolidate 列出待整理内容,memory_archive 落成长期小记;不会后台自动压缩日记。同游可通过「记住这个」写入,或在设置里配置「同游精选」(关闭 / 只在总结时 / 聊到就记);满 60 条会建议迁往长期,需你确认。
四个分区¶
- 人格:
人格/<人格名>.md,同时只启用一个,全文注入。 - 记忆:同游全文,近期与长期各露一行;另有自述(
自述/<人格>/YYYY-MM-DD.md)不进索引、不占上下文,仅面板查看。 - 工坊:
工坊/<人格>/常驻|按需/*.md,按需项默认不加载。 - 封存:删文档或整盒人格档案,可恢复;共享人格对他人只读。
每轮索引注入顺序(资料原文):【人格】→【同游】→【可翻人格·只读】→【最近的日子】→【更早】→【工坊·已启用】。人格与同游不计入记忆预算;自述永不出现。
核心工具¶
宿主向 Agent 注册七件工具(README 表内名称):
| 工具 | 作用 |
|---|---|
memory_list |
列目录,不返回正文 |
memory_recall |
按日期、标题、关键词读正文 |
memory_save |
写入:tongyou / diary / workshop / self |
memory_seal |
封存一条,不再索引 |
memory_consolidate |
列出待整理日子(带正文) |
memory_archive |
写长期小记并归档对应近期 |
memory_workshop |
开/关工坊技能(开启才每轮注入) |
写入采用同目录临时文件再改名,降低半截文件损坏已有记忆的风险。
安装与启用¶
前提¶
- 已安装 DeepSeek Harness(
dsh),能打开 Web 界面。 - DSH 版本 ≥
0.1.7-rc.1(作者在0.2.1-rc.2验证;更旧版本会在engines安装阶段被拦截)。 - 将仓库放到固定目录,路径避免空格与奇怪符号,例如
D:\plugins\dsh-buwang。
资料明确:不要凭仓库名拼接 dsh plugin add github:...;不要手改 profile 的 package.json(JSON 错误会导致宿主无法启动)。安装走 Agent 的 plugin_manager.install_bundle。
在 DSH 里对 Agent 说(把路径换成你的绝对路径):
把这个目录装成插件:D:\plugins\dsh-buwang
装完后侧栏应出现书页图标;没有则 Ctrl+R 刷新。若仅写入 dependencies 而未加入 dsh.profile.bundles,插件不会加载。
数据目录¶
首次打开自动建库:默认 ~/Documents/buwang(Windows 为 C:\Users\<你>\Documents\buwang),含「默认」人格与空同游。库位置由指针 %USERPROFILE%\.buwang\root.txt(一行路径)或配置 dataDir、环境变量 BUWANG_HOME 决定;面板「换位置」后需重载插件。面板可「备份一份」到带时间戳的相邻文件夹。
典型用法¶
日常以口语为主,README 给出的对应关系如下:
| 你说 | 行为 |
|---|---|
| 「记住这个:我不喝冰的」 | 写入同游一行 |
| 「记住今天:装好了不忘」 | 写入当天近期日记 |
| 「这个做法存进工坊,叫『部署前检查』」 | 存为按需工坊技能 |
| 「总结一下今天」 | 归档今日日记与手艺 |
| 「翻一下 10 月 19 号」 | 读取该日全文 |
| 「搜工坊」 | 列目录,选中后临时打开 |
| 「封存这条」 | 移入封存,可恢复 |
面板可直接编辑条目、在工坊页新增技能;自述支持就地翻页编辑。中文检索会将长句切成 2~4 字片段匹配,标题命中优先。
仓库 examples/示例库/ 提供填满的示例库(虚构人物),不会自动加载;可复制目录结构到自己的库,勿覆盖你的 设置.json 中的 activePersona。
适用场景与注意¶
适合谁:希望记忆完全本地、可手改 Markdown、且要严格控制「什么进上下文」的 DSH 用户;需要自动每轮召回时,理念与「不忘」相反,可并存但上下文不再完全由你单方面决定。
权限与安全:插件以当前 DSH 进程权限读写磁盘;安装前请阅读 源码 与 MIT 许可证,确认路径与备份策略。插件本身不发起网络请求;模型对话的联网与记忆库无关。
排错:库根目录 _debug.log 出现 apply start, root=… 表示宿主已加载插件;侧栏无图标时检查 bundles 与重启。换库位置后确认 root.txt 路径存在并重载插件。
结尾¶
「不忘」用三层记忆、四分区与七件工具,把「记」和「读」都绑在你的口令上,用纯本机 Markdown 做长期私人记忆库。进一步了解可看仓库 docs/功能介绍.md。