K0nd1us/QQ-agent

立志做使用起来最简单能实现的功能最全面的LLM机器人。

解决的问题

QQ Agent 为 QQ 对话提供了一个本地 AI 助手。它处理模型交互、会话管理、记忆、角色设定、网络搜索以及基于插件的功能扩展。该项目目前分为两个版本:稳定基准版 (0.4) 和正在进行架构重构的开发版 (0.5),旨在提高模块化程度和资源管理能力。

工作原理

该项目通过 OneBot v11 协议连接到 QQ,用户需要独立安装和配置该协议。Agent 作为应用层,负责处理消息并执行逻辑。0.5 版本引入了“轻量内核”架构,组件定义清晰,从而实现更好的组件替换、标准化的基于 SDK 的扩展开发,以及在启动或故障期间更可靠的资源清理。

适用人群

适用于希望在 QQ 上运行本地、可定制 AI 助手的用户。建议需要稳定现有基准的用户使用 0.4 版本。0.5 版本面向开发者或有兴趣测试新架构的用户,尽管目前尚未完成,需要手动验证功能。

亮点

  • 双版本结构: 将稳定基准版 (0.4) 与正在进行的架构重构版 (0.5) 分离,以防止破坏性变更。
  • 模块化架构: 0.5 版本专注于核心服务、前端面板和插件之间的清晰界限,以减少模块间的依赖。
  • 可扩展设计: 支持具有定义明确的 SDK、权限边界和生命周期管理的插件和技能。
  • 协议无关: 使用 OneBot v11 与 QQ 进行交互,允许用户自行管理协议端的安装和凭据。
  • 资源控制: 改进了组件和扩展管理资源的方式,以防止内存泄漏或残留任务。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目