前言¶
在 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。
