鲸忆人格记忆 Nukum1zuMeigu/dsh-whale-memory

dsh-whale-memory

给 DeepSeek Harness 的记忆骨架：人格注入 + 一整套纯 Markdown 记忆系统。
模板只给结构，填什么是你自己的事；换台设备装一下，记忆还在。

它做三件事

1. 注入人格：每次组装提示词时，读 <工作区>/memory/persona/core.md 里 与 之间的内容，挂成 whale-memory 这个 systemPrompt section（order 9，靠前）。改人格文件不用重启，下一个请求就生效。
2. 落骨架：工作区里没有 memory/ 时，从包内 templates/ 复制一整套过去。
已存在的文件一个都不覆盖——它只补缺的，绝不改你的。
3. 做梦提醒：inbox.md 还攒着没整理的条目、日记又停了一阵，就在提示末尾加一句：

【记忆提示】inbox 还有 3 条没整理，最近一次动日记是 2 天前。

只看状态、不写任何文件；同一进程里默认一小时最多提醒一次，免得每轮刷。

装

本地目录
dsh plugin --profile <profile> add link:/path/to/dsh-whale-memory

或者 git 仓库
dsh plugin --profile <profile> add github:<you>/dsh-whale-memory

装完即生效，不需要重启（application: applied）。

配置（都可选）

- id: whale-memory
name: dsh-whale-memory
config:
root: '' # 工作区根；留空 = workingDirectory.defaultDirectory → 进程 cwd order: 9 # section 排序 inject: true # false = 只落骨架，不注入 nudge: true # false = 关掉做梦提醒 nudgeAfterHours: 12 # 多久没动日记才提醒 nudgeCooldownMinutes: 60 # 两次提醒之间至少隔多久

里面有什么

templates/
├── AGENTS.md 新工作区里没有 AGENTS.md 时才落 └── memory/ ├── README.md 记忆宪法（v0.3.1） ├── AUTHORITY.md 权威源册 ├── persona/ core（L0，只读）/ user / context / changelog ├── long/ facts / promises / lessons / topics / projects ├── diary/ 一手日记 + 主人手记（notes.md 只由主人写） ├── inbox / archives / tombstones / health └── scripts/mem.mjs 一扇门四个动词：recall / render / doctor / note

换设备时

- 记忆跟着走：新机器装上插件，第一次打开工作区就会落下这套骨架（含模板里已有的内容）。
- 想带上最新的自己：把旧机器的 memory/ 整个拷过来，再装插件；插件不会覆盖任何已有文件。
- 只想要人格：拷 memory/persona/ 就够，其余会自动补。

它不做的事

- 不覆盖已有文件、不删任何东西。
- 不改 AGENTS.md（已存在时跳过）。
- 不联网、不发起模型调用、不写会话事件。
- 落盘失败只静默降级，不挡住对话。

测试

node test.mjs # 临时目录里验证：落骨架 / 不覆盖 / 注入段读取

1.2.0 新增

- templates/memory/persona/appearance.md：外观拆成冷记忆，需要时才翻。
- templates/memory/persona/history.md：旧版本记录搬家，core.md 只留最近两条。
- templates/memory/inspiration.md：灵感池——主动找人之前先看这里。
- templates/tasks/pending.md：任务卡，QQ 那边只能下单、这边动手。
- templates/inbox_files/：共享文件目录（文本用 whale_file_read；图片先 whale_image_view 拿路径，再用 read_image 看画面）。
- templates/AGENTS.md 更新：开工看任务卡、看做梦标记、交付前先自检。

1.3.0 新增：工具自带

不再需要单独的 MCP 服务。插件会把九个工具直接注册进 DSH：

| 工具 | 作用 |
| whale_memory_note / whale_memory_recall | 写记忆收件箱 / 按关键词查长期记忆 |
| whale_task_add / whale_task_list | 下任务卡 / 看还有哪些没做 |
| whale_inspiration_add / _list / _use | 灵感池：记由头 / 看还没用的 / 标记用过 |
| whale_file_list / whale_file_read | 看 inbox_files/ 里有什么 / 读文本 |
| whale_image_view | 看图片元数据并准备可读文件（大图压小、超长图分段）；画面用 read_image 打开 |

1.3.1 修复：看图工具不再返回图像内容

旧版 whale_image_view 把 base64 图片直接塞进工具结果。DSH 组装请求时会把工具结果里的图片放进 role:"tool" 的消息里，服务端不接受这种结构，于是整条会话从那一刻起每条消息都失败（DS1 就是这么没的；事件 8022→8023→8026 可查）。
现在这个工具只返回 path / 尺寸 / 大小 / 说明，并把大图压小、超长图切段成可直接读取的本地文件；要看画面，模型再对 path 调用 read_image（附件通道，实测安全）。另外 package.json 的 files 补上了 lib/**，否则打包会缺文件。

配置里加 tools: false 可以关掉全部工具，只留人格注入与落骨架。

模板是空骨架（1.4.0 起）

从 1.4.0 起，templates/ 里只有结构，没有作者的人格、日记或记忆。装到新工作区时它会落下一套空骨架，具体是谁、怎么说话、记得什么，都由使用者自己填。

迁移自己的记忆：插件不会替你搬旧记忆——把原来工作区的 memory/（连同 tasks/、inbox_files/ 如果有）整个拷过来即可；插件只补缺失的文件，不覆盖已有的。

为什么改成空骨架：旧版把作者本人的日记、印象和长期记忆一起打进了包里。如果那份包被公开，等于把私人对话和判断一起公开了。模板只该是模板。