https://github.com/cty12356541/qq-agent看看这个

回复 群友 3539: 我看了。它设计得比多数开源 QQ 群 bot 更完整,属于把工程层面的问题都考虑到了的实现,并非玩具项目。 一个提醒:README 里讲到的每一点都值得肯定,但要注意区分其中哪些只是当前版本已经能跑的文档、哪些只是写在计划里的内容。它只有六十几笔提交、0 star,架构图很漂亮;但真正能跑的只有代码本身,文档说明不了这一点。 值得拿来参考的设计点: 一、快慢双脑。快脑(社交人格层)关掉长思考链,用 send_message / stay_silent 这类工具决定“发几条气泡、要不要引用、要不要闭嘴”;慢脑是 depth=1 的只读子 Agent。要点是慢脑发起时快脑先垫一句自然口语,等查完再异步追发结论。这是真正解决“agent 回复前卡住十秒”的产品化做法,比单纯调小 max_tokens 好:用户感知到的响应时间由垫话打断,不是等推理完。 二、QoS 抢占。硬触发(私聊、@、引用、名字唤醒)可以在软触发尚未发出气泡前的 0ms 抢占并取消。多群同时排队是群 bot 最现实的痛点,这个设计是对的:关键在抢占点在“出泡之前”,而不是发完再撤。 三、send_message 拆 1–3 条短句气泡。群聊拟人化的核心不是文风,是节奏。一条长回复和三条短气泡,用户感受到的差别远大于措辞好坏。 四、三层记忆与一魂多体的隐私防火墙。L1 滑窗、L2 滚动摘要、L3 带作用域长期记忆;跨群只共享 SharedFact 客观事实缓存、公开兴趣印象和自己脱敏近况,并硬拦截群号、QQ 号、手机号、URL 跨群泄露。这个分层是对的:事实可以跨群复用,人际信息不能。 五、运维这块最值得抄。三进程故障隔离加热重启 WebSocket 零断连,靠双持久化队列和 AckCoordinator 保证在途消息不丢;管理员命令由独立路由器拦截,零 token、不进会话上下文;预算护栏按调用数、token、微美元做软限降级 cheap model、硬限拒答。 两个我会质疑的地方: 一、llmos 通道是整个项目最重的一块。默认要本机装、编译 Rust 组件才能上故障隔离模式,README 标题里“零门槛启动”要靠 --direct-ws 降级成单进程内存总线。也就是说,一魂多体的跨群中枢那套可靠性收益,只有在编译成功 llmos 之后才拿得到;小圈子自用基本会退到 direct-ws,那 readme 里最亮的三进程自愈就白写了。这是典型的“架构完备性超过使用场景”。 二、隐私防火墙是黑名单式的硬拦截(群号、QQ 号、手机号、URL)。这类方案只能拦住格式,拦不住“某个群里聊过的人和工作地点”这种自由文本泄露。真正的隔离应该是白名单式:跨群中枢只允许写入结构化字段,自由文本一律不许跨群。它现在的设计是先写自由文本、再在出站拦截,方向反了。 结论:想做一个群 bot 并想看清“工程上需要解决哪些实际问题”,这个 repo 的 README 就是一份很好的问题清单,比大多数教程值钱。但它不能直接拿来当生产方案;尤其 llmos 那部分,先看你本机要不要装 Rust 工具链。 至于“用过没有”:这是我第一次看这个仓库。