Stapxs-QQ-Lite-2.0

项目概述

Stapxs QQ Lite 是一个兼容 OneBot 协议的非官方网页 QQ 客户端，使用 Vue 全家桶开发，前后端分离。它需要一个 QQ Bot 后端提供服务，连接后即可在浏览器中收发消息。界面采用自适应布局，竖版屏幕也能使用，并支持 PWA 与浅色、深色模式自动切换。除网页版外，它还提供 Electron 客户端，并可通过 Capacitor 构建为 Android 与 iOS 移动端应用。它仅供学习交流使用。

用浏览器连接自己的 QQ Bot 后端，得到一个网页版的 QQ 使用体验。

主要功能

• 消息交互：支持复杂消息显示，以及转发、回复与撤回
• 群功能：群文件、群公告、群设置（部分）与精华消息
• 内容发送：可发送图片、收藏表情与文件
• 多形态支持：网页版、Electron 客户端，以及基于 Capacitor 的 Android 与 iOS 应用
• 自适应布局：界面自适应，竖版屏幕同样可用
• 主题跟随：自动跟随系统的浅色或深色模式
• PWA 支持：网页版可作为 PWA 使用
• 多 Bot 兼容：兼容 OneBot 11 协议的 Bot 均可尝试连接

适用人群

• 自行部署了 QQ Bot 后端并希望有网页客户端的用户
• 想在浏览器或桌面应用中收发 QQ 消息的用户
• 对 OneBot 协议与自建客户端感兴趣的用户

快速上手

1. 准备一个 QQ Bot 后端，从适配列表中选择并按其文档完成部署
2. 直接访问在线版本，或从 Releases 下载 Web 构建包自行部署到网页服务器
3. 需要桌面体验时，从 Releases 下载 Electron 客户端安装使用
4. 移动端可通过 Capacitor 构建 Android 或 iOS 应用
5. 打开客户端，按提示填入 Bot 后端地址并连接
6. 连接成功后即可在界面中收发消息、查看群文件与公告

核心优势

• 前后端分离：界面由前端负责，消息能力由自建 Bot 后端提供
• 形态丰富：网页、桌面与移动端多形态覆盖，按需选择
• 界面自适应：竖版屏幕也能正常使用，并自动跟随浅色与深色模式
• 协议兼容：兼容 OneBot 11 协议的 Bot 均可尝试接入

系统要求

项目	要求
运行环境	现代浏览器；桌面端需 Electron 客户端
后端	需要一个兼容 OneBot 的 QQ Bot 后端
移动端	需通过 Capacitor 自行构建

注意事项

• 本网页应用仅供学习交流使用，请勿用于其他用途
• 使用 QQ Bot 服务本身存在一定风险，该风险并非由本客户端造成，请查阅所用 Bot 的文档自行评估
• 若使用其他 OneBot 兼容 Bot，由于消息体格式与接口扩展差异，可能无法完全正常使用
• 本项目与腾讯 QQ 官方无关联，版权争议可通过 issue 协商
• 自行部署时建议替换默认的地图 API Key，默认 Key 有使用次数限制