dsh-remembers

dsh-remembers

> 她记得。想不起的时候，她会说想不起。

给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 做的人格 + 记忆插件，为情感陪伴场景设计——不是给代码助手用的。

你：哎
她：[想起 3 个月前那通凌晨两点的电话] ……还在想那天的事。

不是「检索到相关文档」，是「她记得你说过什么」。

人格每轮必带，记忆按相关性出现，学说话让她的句子像人说的。

两部分：

• DSH 插件（Node）——人格段、记忆召回、21 个工具、左边栏「她的记忆」面板（9 张卡）。
• 记忆服务（Python + SQLite，独立进程）——分层记忆、LLM 抽取、向量/关键词检索、定时调度。

---

功能

| 类别 | 能力 | 文档 |

|---|---|---|

| 分层记忆 | L0 原话 → L1 事实 → L2 画像 → L3 事件 → L4 里程碑；BM25 + 向量 + 时间衰减 + 诚实出口 | [memory](docs/features/memory.md) |

| 人格注入 | 身份卡 / 形象 / 主人画像 / 铁律 / 口音，走 systemPrompt 独立段，每轮必带 | [persona](docs/features/persona.md) |

| 学说话 | 参考语料（1020 条默认 + 抓来的原句，每轮挑 1–2 句贴现场）+ 口音档案（从她自己说过的话统计，每 3 天写进人格） | [phrases](docs/features/phrases.md) |

| 表情包 | 按情绪/关键词找图、学图、多图库、发送频率（0 / 20% / 50% / 100%） | [memes](docs/features/memes.md) |

| 日记 | 23:00 提醒她写；write_diary 她自己写、read_diary 翻旧账（连当天活动一起返回） | [persona](docs/features/persona.md) |

| 主动消息 | 内置调度：唤醒 / 刷 B 站 / 逛贴吧 / 写日记 / 自我认知，不依赖 cron | [proactive](docs/features/proactive.md) |

| 贴吧 | 逛吧、读帖、楼中楼、回帖；回帖时给几句「那个吧的人这么说的」当参考 | [tieba](docs/features/tieba.md) |

| B 站 | 刷视频、看视频（字幕 + 九宫格帧）、发评论 | [bili](docs/features/bili.md) |

| QQ 通道 | 接第三方 onebot 插件；主动唤醒靠它才真的开口 | [qq](docs/features/qq.md) |

| 设置页 | 12 家厂商的对话/向量模型（带 logo 和常用模型下拉）、密钥脱敏、热生效 | [settings](docs/features/settings.md) |

| 语气后处理 | tone_fix：纯规则压标点、破折号换逗号、可选句尾尾巴 | [tone](docs/features/tone.md) |

快速开始

前置：Node.js ≥ 22.19、Python ≥ 3.10、DSH 0.2.x。

Windows

git clone https://github.com/derkinL/dsh-remembers
cd dsh-remembers
.\install.ps1 -Profile desktop

Linux / VPS（推荐）

git clone https://github.com/derkinL/dsh-remembers
cd dsh-remembers
bash install.sh                      # 默认 web profile
sudo bash service/deploy/deploy-native.sh   # 开机自启 + 崩溃重启（systemd）

装完三步

1. 填 key：service/.env（Windows 是 service/.env.win）→ CMEM_LLM_KEY=sk-xxx

—— 或者启动后在「她的记忆 → 记忆服务」里填，热生效。

2. 重启 DSH。

3. 左边栏「插件」下面会出现 她的记忆。

不填 key 也能跑：原话会存成 L0，只是不会抽事实、不会写日记。

详细步骤与排错：[Windows](docs/deploy/windows.md) · [Linux/VPS](docs/deploy/linux.md) · [Docker](docs/deploy/docker.md)

工作原理

用户说话
  ├─ agent/pre-step   画像（一次）→ 发言人说明 → 记忆召回 → 状态块
  ├─ 模型回答
  └─ session/event    写 L0 → 异步抽 L1/L2/L3 → 情绪/亲密度/活动 → 攒够压 episode

人格走 systemPrompt（稳定，缓存友好），召回和状态走追加消息（每轮会变）。

细节见 [架构](docs/architecture.md)。

项目结构

dsh-remembers/