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