前言¶
DeepSeek Harness（DSH）的插件化设计让「智能体」的开发变得模块化。但很多角色型智能体存在一个共同问题：只有「现在」，没有「过去」。对话一关，记忆就归零；人格设定写在 prompt 里，不会随着时间变化；情绪是写死的，不会因为对话内容而起伏。
dsh-serene 是一个接进 DSH 的插件，把「人格是数据、情绪是状态、记忆是文件」这套逻辑接进来，让智能体拥有可复算的长期记忆和情绪状态。
这是什么¶
dsh-serene 是一个记忆与情绪管理插件，用于 DeepSeek Harness。它把角色的人格、情绪和记忆拆成三个可读写、可复现的部分，通过插件方式接入 DSH。维护者是 chisato-lycoreco，分类属于「记忆」。
插件提供以下能力：
- 记忆管理：将对话中的重要事件抽象成结构化记忆，支持召回与遗忘
- 情绪计算：基于时间、季节、对话内容，计算当前情绪状态与变化
- 人格维护：人格设定不自动重写，只由用户修改底层 L0，观察与看法由系统基于事件生长
- 主动开口：在空闲时间内，按预算主动发起对话
- 可视化：在聊天界面右侧展示此刻状态、情绪六维、记忆条目
核心功能¶
记忆：不是钉在背景板，而是能被想起¶
旧方案通常把所有历史对话塞进 prompt，导致：
- 平均每轮注入 5.97 条记忆
- 相关度平均只有 0.05
- 同一条记忆在 922 轮里被注入 458 次
这叫「钉在背景板」，不叫「记得」。
dsh-serene 采用召回 v2 算法：
- 允许返回空：没有相关记忆时，说「不记得了」
- 事件被抽象成一条记忆：一句话、一个类型、一个清晰度
- 使用次数越多，记忆越牢；长期不提，会慢慢褪色
情绪：基于真实时间与对话的动态状态¶
情绪不是写死的台词，而是基于以下因素计算：
- 真实时间：
core/life.js计算一天中的精力变化 - 季节与旬：
core/almanac.js计算季节与时间 - 六维情绪 + 底色 + 关系：
core/emotion.js计算情绪变化 - 三层切换：「此刻 / 底色 / 关系」
情绪会自己衰减，也会因为一句话触发变化。你可以在界面右侧看到情绪六维和变化曲线。
人格：不自动重写，只由用户维护底层¶
人格分为两层：
- L0：底层人格设定，由用户修改
- L1：观察与看法，基于事件生长
系统不会自动重写人格，避免人格在轮转中被悄悄挤掉。
主动开口：有自己的作息¶
插件内置作息逻辑：
- 夜间 23:00–08:00 不打扰
- 每天有主动开口次数上限
- 两次主动开口之间有间隔
戳一戳、摸头、递水、夸她一句也会走同一套情绪和记忆逻辑。
可视化与可复算¶
每一轮对话后生成 trace：
- 召回了哪条记忆、相关度多少
- 情绪前后差多少
- 写下了什么、表达自检有没有问题
- 各段 prompt 占多少字、用了多少 token
trace 不保存 prompt 原文，是一张「这一轮怎么想的」账单。
安装与启用¶
前置条件¶
- Node.js >= 22.19
- DeepSeek Harness >= 0.2.1-rc.2
安装命令¶
在 DSH 项目根目录下执行：
dsh plugin --profile web add dsh-serene
快速启动（无需安装 DSH）¶
如果只是想先体验，不需要安装 DSH：
- 下载仓库：https://github.com/chisato-lycoreco/dsh-serene → Code → Download ZIP
- 解压到路径，例如
D:\dsh-serene - Windows 双击
start-web-demo.cmd，macOS 双击start-web-demo.command - 浏览器会打开
http://127.0.0.1:4317
演示模式不联网、不花钱、台词固定。
接入 DeepSeek API¶
在同一文件夹内双击 start-web.cmd（Windows）或 start-web.command（macOS）。第一次启动会要求粘贴 DeepSeek API key（sk- 开头）。key 只保存在本机的 web-config.json 中，按官方价格计费。
典型用法¶
查看记忆与情绪¶
启动后，在聊天界面右侧点击「记忆」查看所有记忆条目；点击「透视」查看这一轮的 trace。
修改人格¶
人格的 L0 层在 personas/ 目录下，可以手动编辑文件。系统不会自动覆盖这些文件。
清空记忆¶
在「设置」中可以清空聊天记录，记忆会先归档再清空。
备份与迁移¶
数据存储在 C:\Users\<用户名>\.dsh\plugins\dsh-serene\ 目录下，可以手动备份整个文件夹。
适用场景与注意¶
适用场景¶
- 需要长期记忆的角色型智能体
- 需要情绪状态随对话变化的智能体
- 需要可视化调试 prompt 与记忆召回逻辑的开发者
注意事项¶
- 插件以当前 DSH 进程权限运行，使用前应检查源码与许可证
- 安装前应确认 Node.js 版本 >= 22.19
- DeepSeek API key 只保存在本地
web-config.json，不要发给别人
短结尾¶
dsh-serene 把「人格是数据、情绪是状态、记忆是文件」接进了 DeepSeek Harness，让智能体拥有可复算的长期记忆与情绪状态。如果你在做一个需要长期陪伴、需要记得用户、需要情绪起伏的角色型智能体，可以试试这个插件。
- 目录页：https://www.skillhub.cn/plugins/chisato-lycoreco/dsh-serene
- GitHub：https://github.com/chisato-lycoreco/dsh-serene
