F
dsh-chat-tide
fakerkonzo/dsh-chat-tide
Tide — chat memory and selective waking for DSH
Install
dsh plugin --profile web add github:fakerkonzo/dsh-chat-tideREADME
Tide — 聊天记忆与选择性接茬
给 DSH 的聊天记忆插件:把对话沉淀成事实与经历,在合适的时候才开口。 English: README.en.md
它解决什么
聊天机器人常见两种坏状态:记不住,或者什么都接。
Tide 让机器人记住你们聊过的事,并且只在真正该说话的时候开口——群里的闲聊不会句句都接,但聊到它在意的话题,它会主动搭话。记住的东西可以翻、可以改,删掉也有记录。
四件核心(改细节可以,别把这几条弄丢)
- 按需接茬:群消息先进闸门,不该接的在模型调用之前就丢掉,零成本。
- 主动拒答:模型有
stay_silent可调,调了这轮一个字都不出。真沉默不是写一句「(不回复)」。 - 记事把关:入站先落流水账,再按预筛和预算决定要不要交给模型抽取;抽取跟着会话自己的模型走,插件不另配。
- 规则与事实注入:规则块、事实块、经历块各自有预算,按会话类型取,规则块定期重发,事实带归属人。
probes/52-core-capabilities.mjs 是这四条的守门测试:谁改坏了,它会亮红灯。
兼容与依赖
| 项 | 要求 |
|---|---|
| DSH | >=0.2.2-rc.1 <0.3.0,在 0.2.2-rc.1 与 0.2.2-rc.3 上实机跑过 |
| Node | >=22.5(用到内置 node:sqlite) |
| QQ 适配器 | 可选,实测 @tencent-connect/dsh-qqbot@0.5.5;没有它也能记本地会话,只是群聊接茬不会触发 |
其余依赖随包安装,不需要手动处理。首次使用会下载一个约 25–30MB 的本地向量模型,放在
~/.dsh/tide/models,重装或升级插件不会把它删掉(想换位置就设 MODEL_CACHE_DIR)。
它怎么工作
- 先记住:聊天内容先落成原始记录,这时候还不会回复任何人。
- 再判断:群消息来了,先看是不是在找它,再看这件事是不是它在意的。在意就直接接;不在意就按一个小概率试探,是否开口由模型自己决定。
- 带着记忆说话:真要开口时,才把相关的规矩、事实和近期经历带进这一轮。平时不占上下文。
- 说完再沉淀:一轮结束,从对话里提炼值得留下的事实、经历和关注点。
- 定期清理:重复的合并、过期的退休、只在当时成立的改掉。
记忆按人分开:群里谁说的记在谁名下,不会混成一个人的事。群聊的自动注入默认屏蔽私聊来源(可在设置里关掉);记忆检索类工具不加这层过滤,会查整库。
安装
包名 dsh-chat-tide,插件行 id 是 tide。
- 在 DSH 插件管理器里安装
dsh-chat-tide(开发时也可以link:本地目录)。 - 把
dsh-chat-tide加进 profile 的package.json→dsh.profile.bundles。漏了会「装了但不加载」。 - 打开插件详情页,在「作用域」里确认它该管哪些会话。
- 首次只开入站镜像与注入,确认没问题再开路由。
数据默认存在 ~/.dsh/tide/memory.db。
配置
大部分开关和数值在插件详情页里调,改完最多 5 秒生效,不用重启。常用的几项:
| 键 | 默认 | 含义 |
|---|---|---|
routing.attentionThreshold | 0.48 | 关注点命中阈值,越高越挑 |
routing.attentionMargin | 0.03 | 命中还要跟第二名拉开多少 |
routing.ambientReplyProbability | 0.1 | 不在关注点内时,试探接话的概率 |
routing.l2Threshold | 0.45 | 单看事实够不够近就能判相关 |
routing.maxWakesPerDay | 20 | 每个会话每天最多主动开口几次 |
routing.minWakeIntervalMinutes | 10 | 两次开口至少隔多久 |
scope.mode | follow | 哪些会话归它管:跟随 dsh-qqbot / 指定工作区 / 指定会话 / 关闭 |
context.unifySessions | false | 私聊和群聊是否共用一份记忆 |
context.groupExcludePrivate | true | 群里是否屏蔽私聊里说过的事 |
已知边界
- 试探概率的默认值只是起点,得按自己的群调
- 关注点靠真实对话长出来,空库时它不会主动说话
- 纯图片消息不会唤醒它;图片里带文字时,看不看由模型自己判断
- 第一次用要下载向量模型,会慢一点;下不下来会明确报错,不会偷偷在宿主进程里跑
- 换向量模型要清空向量表,宽度不一致时体检会报
许可
MIT,见 LICENSE。