Skip to main content
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-tide

README

Tide — 聊天记忆与选择性接茬

给 DSH 的聊天记忆插件:把对话沉淀成事实与经历,在合适的时候才开口。 English: README.en.md

它解决什么

聊天机器人常见两种坏状态:记不住,或者什么都接。

Tide 让机器人记住你们聊过的事,并且只在真正该说话的时候开口——群里的闲聊不会句句都接,但聊到它在意的话题,它会主动搭话。记住的东西可以翻、可以改,删掉也有记录。

四件核心(改细节可以,别把这几条弄丢)

  1. 按需接茬:群消息先进闸门,不该接的在模型调用之前就丢掉,零成本。
  2. 主动拒答:模型有 stay_silent 可调,调了这轮一个字都不出。真沉默不是写一句「(不回复)」。
  3. 记事把关:入站先落流水账,再按预筛和预算决定要不要交给模型抽取;抽取跟着会话自己的模型走,插件不另配。
  4. 规则与事实注入:规则块、事实块、经历块各自有预算,按会话类型取,规则块定期重发,事实带归属人。

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)。

它怎么工作

  1. 先记住:聊天内容先落成原始记录,这时候还不会回复任何人。
  2. 再判断:群消息来了,先看是不是在找它,再看这件事是不是它在意的。在意就直接接;不在意就按一个小概率试探,是否开口由模型自己决定。
  3. 带着记忆说话:真要开口时,才把相关的规矩、事实和近期经历带进这一轮。平时不占上下文。
  4. 说完再沉淀:一轮结束,从对话里提炼值得留下的事实、经历和关注点。
  5. 定期清理:重复的合并、过期的退休、只在当时成立的改掉。

记忆按人分开:群里谁说的记在谁名下,不会混成一个人的事。群聊的自动注入默认屏蔽私聊来源(可在设置里关掉);记忆检索类工具不加这层过滤,会查整库。

安装

包名 dsh-chat-tide,插件行 id 是 tide。

  1. 在 DSH 插件管理器里安装 dsh-chat-tide(开发时也可以 link: 本地目录)。
  2. 把 dsh-chat-tide 加进 profile 的 package.json → dsh.profile.bundles。漏了会「装了但不加载」。
  3. 打开插件详情页,在「作用域」里确认它该管哪些会话。
  4. 首次只开入站镜像与注入,确认没问题再开路由。

数据默认存在 ~/.dsh/tide/memory.db。

配置

大部分开关和数值在插件详情页里调,改完最多 5 秒生效,不用重启。常用的几项:

键默认含义
routing.attentionThreshold0.48关注点命中阈值,越高越挑
routing.attentionMargin0.03命中还要跟第二名拉开多少
routing.ambientReplyProbability0.1不在关注点内时,试探接话的概率
routing.l2Threshold0.45单看事实够不够近就能判相关
routing.maxWakesPerDay20每个会话每天最多主动开口几次
routing.minWakeIntervalMinutes10两次开口至少隔多久
scope.modefollow哪些会话归它管:跟随 dsh-qqbot / 指定工作区 / 指定会话 / 关闭
context.unifySessionsfalse私聊和群聊是否共用一份记忆
context.groupExcludePrivatetrue群里是否屏蔽私聊里说过的事

已知边界

  • 试探概率的默认值只是起点,得按自己的群调
  • 关注点靠真实对话长出来,空库时它不会主动说话
  • 纯图片消息不会唤醒它;图片里带文字时,看不看由模型自己判断
  • 第一次用要下载向量模型,会慢一点;下不下来会明确报错,不会偷偷在宿主进程里跑
  • 换向量模型要清空向量表,宽度不一致时体检会报

许可

MIT,见 LICENSE。

Related plugins