心绪人格 chisato-lycoreco/dsh-serene

dsh-serene

把「一个会记得你的角色」接进 DeepSeek Harness。
人格是数据，情绪是状态，记忆是文件——三者都可读、可改、可复现。

大多数「角色卡」是一段写在 system prompt 里的描述：模型每次都从零开始扮演，聊得越久越不像。
这个插件换一种做法：把角色拆成可计算的状态，让「她此刻怎么样」由时间、事件和历史决定，而不是每次重新即兴。

- 情绪：PAD+ 六维 × 三层（底色 / 此刻 / 关系），会衰减、有昼夜节律、会留疤；
- 记忆：jsonl 落盘，按相关度 + 时间衰减 + 重要度召回，公式可复算；
- 人格：一份 JSON，换人格不用改代码。

它是 FRAMEWORK.md 里那套七层结构的最小参考实现——只有织法，没有布：不包含任何私人角色、私人记忆、屏幕采集或图像生成。

十天，一个人的情绪怎么走：底色、此刻、关系三条线，以及第 3 天留下的那道疤

上面这张图不是手画的：node demo/timeline.mjs 用 core/emotion.js 的纯函数跑十天， node demo/render.mjs 把结果画成帧。改一行事件，整条曲线和那道疤都会跟着变——这就是「可复算」的意思。

它做什么 / 不做什么

| 做 | 不做 |
| 记录事件、推进情绪、把状态讲成人话 | 不替模型写回复，不改写对话内容 |
| 长期记忆的写入与召回 | 不自己调模型、不自己总结 |
| 人格档案的读取与拼装 | 不读 .env、凭证、聊天记录原文 |
| 状态落盘（原子写）、可手改可进 git | 不联网、不上报、不采集屏幕 |

安装

要求：DSH >= 0.2.1-rc.2，Node >= 22.19。

从 npm 装（推荐）
dsh plugin --profile web add dsh-serene

从 GitHub 装（跟着 tag，不经过 npm）
dsh plugin --profile web add "github:chisato-lycoreco/dsh-serene#v0.1.1"

从本地目录装（开发时）
dsh plugin --profile web add "/absolute/path/to/dsh-serene"

从 tgz 装（去 Release 页面下 dsh-serene-0.1.1.tgz）
dsh plugin --profile web add ./dsh-serene-0.1.1.tgz

安装前先完全退出 DSH（安装会改 profile 的 package.json 和 cordis.patch.yml）。
装完用这条确认插件进了配置树：

dsh --profile web --dump-config | grep -A3 "dsh-serene"

不想装、只想试：用 patch 覆盖方式直接挂本地插件。

dsh --profile web --patch "/absolute/path/to/dsh-serene/cordis.patch.yml"

cordis.patch.yml 里的 config 是整段替换，不是深合并。你在自己 profile 里覆盖配置时，要把想保留的键一起写上。

第一次运行：凭据与自检

模型凭据只有两个来源：GUI 的 Models 页面写进 credentials service，或启动环境里的 DEEPSEEK_API_KEY。新 profile 不会自动继承——另建了一个 profile 时，第一句话就会报 MISSING_CREDENTIAL（这是凭据问题，不是插件问题）：

export DEEPSEEK_API_KEY=sk-... # 或者先在 GUI 的 Models 页填一次

装完别只看配置文件。两步确认，第二步才是「真的能用」：

| 想确认 | 怎么做 | 正常时 |
| 配置进了配置树 | dsh --profile web --dump-config \| grep -A3 dsh-serene | 有 - id: serene |
| 插件真的挂上 | 在装着插件的那个 profile 里说一句「用 serene_status 看看」 | 返回人格、数据目录、记忆条数 |

这一步也是「插件正常」和「装好了但没生效」的唯一区分点：人格文件读不到时插件会降级（不拖垮宿主），但会留下 serene_status 和一行 stderr 说明原因。

配置

| 键 | 默认 | 说明 |
| enabled | true | 总开关 |
| persona | demo | personas/ 下的文件名，或绝对路径 |
| personaRoot | 插件自带 personas/ | 人格档案目录 |
| dataDir | $DSH_HOME/plugins/dsh-serene | 状态与记忆落盘位置 |
| recallLimit | 5 | 每次召回默认条数 |
| halfLifeDays | 45 | 记忆时间衰减半衰期 |

覆盖示例（~/.dsh/profiles/web/cordis.patch.yml）：

- insert:
- id: serene
name: dsh-serene
config:
enabled: true
persona: xiaoman
personaRoot: /Users/me/serene-personas
dataDir: /Users/me/serene-data

工具

| 工具 | 作用 |
| serene_context | 人格卡 + 此刻状态。新会话开头调一次 |
| serene_mood | 只读此刻状态（自然语言，不含数值） |
| serene_event | 记一件事进情感层（30 种事件，见下） |
| serene_remember | 写一条长期记忆 |
| serene_recall | 按话题召回记忆，带时间和分数 |
| serene_state | 调试用：三层数值、最近事件、疤 |
| serene_status | 诊断：插件是否真的挂上（人格 / 数据目录 / 记忆条数）；加载失败时返回原因和修法 |

事件类型：chat / affection / address / intimacy / kiss / tease / care / humor / share / question / goodnight / rejection / neglect / conflict / repair / scold / coax / jealousy / ignored / selfie / reflection / heavy_reflection / sleep / wake / leisure / reply / cold_read / warm_read / moved / disclose / suppress。

模型什么时候调用这些工具，由你在 AGENTS.md 或人格卡里约定；插件不劫持对话。

数据长什么样

$DSH_HOME/plugins/dsh-serene/emotion.json：

{
"version": 1,
"updatedAt": 1761288000000,
"lastInteractionAt": 1761287900000,
"layers": {
"background": { "pleasure": 63.1, "arousal": 43.8, "dominance": 59.9, "curiosity": 57.4, "confidence": 61.6, "connection": 60.4 },
"primary": { "pleasure": 68.2, "arousal": 47.1, "dominance": 60.3, "curiosity": 58.0, "confidence": 62.1, "connection": 61.9 },
"social": { "pleasure": 61.4, "arousal": 43.0, "dominance": 59.5, "curiosity": 57.8, "confidence": 61.2, "connection": 61.1 }
},
"wounds": [],
"history": [{ "kind": "affection", "at": 1761287900000, "intensity": 1 }]
}

memories.jsonl：一行一条，直接 grep 就能找。

两个文件都是你的：可以备份、可以手改、可以删。删掉就是从没发生过。

换一个人格

复制 personas/demo.json，改几个字段，文件名当 persona 传进去：

{
"name": "小满", "role": "住在终端里的同伴", "summary": "你不急着给建议。",
"traits": ["安静", "好奇"],
"speech": ["句子短", "不确定就问"],
"boundaries": ["不假装记得没记过的事"],
"lexicon": { "address": ["小满"] },
"baseline": { "background": { "pleasure": 62 } }
}

baseline 省略就用默认基线；lexicon.address 决定哪些称呼会被识别成「叫你」。

三条设计约定

1. 状态自己走。 时间过去，情绪就衰减、就随昼夜波动——不需要谁说话才动。
2. 情绪只影响语气，不改写事实。 状态进 prompt 的是一段人话（「这会儿有点低，别硬撑」），不是「你现在很生气」，更不会篡改检索到的记忆。
3. 一切可复现。 同样的初始状态 + 同样的事件 + 同样的时间戳，永远得到同样的结果；没有随机数、没有模型调用。测试里跑的就是这一点。

更完整的结构说明见 FRAMEWORK.md。

开发

npm install # 只装 devDependencies（schemastery / dsh-tools）
npm test # node --test，28 个用例

core/emotion.js 纯函数：衰减、节律、事件、疤、描述 core/recall.js 纯函数：分词、衰减、召回打分 src/stores/emotion-store.js 唯一碰磁盘的地方（原子写） src/stores/memory-store.js jsonl 追加与召回 src/persona.js 人格档案 → prompt 段 src/tools.js 7 个工具（含 serene_status 诊断） src/index.js name / inject / Config / apply

core/ 里没有 fs、没有 Date.now()、没有网络。想验证：

grep -n "node:fs\|process.env\|fetch(" core/*.js # 应该没有输出

与其它插件的关系

- 灵枢（@furongjun1999/dsh-memory）：那是「工作记忆」，记的是任务和事实。
这个插件记的是「关系」，两者不要合并——工作记忆要准，关系记忆本来就会褪色。
- dsh-dafeiyu：桌宠形态的前端。这个插件是纯后端，没有 UI；想接桌宠，读 serene_state 的返回值自己画即可。

License

代码 MIT。人格档案（personas/）随你改成什么样都行，改完是你的人格，不是我的。