小爱 · AI 角色化 QQ 群聊机器人系产品系统Vibe Coding

QQ 兴趣社群（游戏群、AIGC 创作群）普遍存在管理员精力有限、群内冷场、新人问题重复、资讯分散的问题，而市面上的群机器人大多是固定指令式问答，语气生硬、没有记忆，无法真正融入群聊氛围。
本项目面向社群运营场景，打造一个有稳定人设、能记住每位群友、像真人一样自然接话的 AI 角色机器人。它既能陪伴闲聊、活跃气氛，也能承担识图、生图、语音、资讯检索、代码生成等实用工作，帮助群主降低运营成本、提升群活跃度和成员黏性。目前已在两个真实社群和私聊场景中 7×24 小时稳定运行。

1、智能群聊：基于大模型的角色化对话，带接话预判（判断该不该说话）、消息排队、多气泡回复、引用回复，避免刷屏和答非所问。
2、长期记忆与好感度：为每位群成员建立独立记忆档案和好感度体系，支持“查看我的记忆 / 忘记我 / 停止记录我”等隐私口令，各群数据相互隔离。
3、语音能力：本地部署 TTS 合成角色语音，支持语音消息识别（平台原生识别 + 本地 Whisper 兜底）及新人入群语音欢迎。
4、视觉理解：识别图片、动图和表情包，并能结合上下文自动挑选表情包回复。
5、AI 生图：群内口令发起、本人确认后生成，带每群 / 每人配额和并发控制。
6、代码交付：群友 @机器人 描述需求，自动生成网页、脚本等源码并打包 ZIP 回传到群文件。
7、联网检索与资讯：网页搜索、GitHub、每日定时资讯推送，B 站短视频内容理解。
8、管理后台：Web Dashboard 实时查看进程状态、对话追踪、记忆、配额、日志、模型配置；提供一键启动 / 暂停 / 恢复脚本和桌面客户端。
9、稳定性保障：进程看护自动拉起、消息去重防双发、发送结果未知时自动暂停不盲目重发。

本项目由我独立完成，负责需求设计、整体架构、AI 协作开发（Vibe Coding）、测试验收和长期运维。
技术栈：TypeScript + Node.js 实现核心服务；Python 负责 AstrBot 插件、本地语音合成与识别服务；SQLite 做每个会话独立的状态库；通过 OneBot 协议（WebSocket/HTTP）对接 QQ；大模型接入 Claude 等多供应商，支持路由与回退；搜索使用 SearXNG + Crawl4AI 本地兜底。
架构亮点与难点：
1、事件接收与消息发送分离，所有发送统一经过唯一发送代理，配合 generation/epoch 校验和去重键，解决多实例切换时的重复发送问题。
2、发送结果三态（成功 / 未知 / 取消），未知状态自动暂停而非重发，保证线上不出事故。
3、每个群一份独立数据库，记忆、好感、配额、暂停状态互不串扰。
4、逐轮 trace 日志 + Dashboard 可视化，任何一条回复都能追溯到模型输入、决策和发送回执。
5、隔离构建 + 清单校验的灰度发布与回滚流程，多进程看护脚本实现开机自启和故障自恢复。