[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-8997":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":14,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":31,"readmeContent":32,"aiSummary":33,"trendingCount":16,"starSnapshotCount":16,"syncStatus":34,"lastSyncTime":35,"discoverSource":36},8997,"Stapxs-QQ-Lite-2.0","Stapxs\u002FStapxs-QQ-Lite-2.0","Stapxs","一个兼容 OneBot 协议的第三方 QQ 客户端。 Web、全平台实现！","https:\u002F\u002Fstapxs.github.io\u002FStapxs-QQ-Lite-2.0\u002F",null,"Vue",1192,95,5,12,0,1,44,4,62.85,"GNU Affero General Public License v3.0",false,"next",true,[26,27,28,29,30],"desktop","onebot","onebot11","qq","webqq","2026-06-12 04:00:42","**中文 | [English](README_EN.md)**\n\n> \u003Cstrong>\u002F\u002F 小广告 \u002F\u002F\u003C\u002Fstrong>\u003Cbr \u002F>\n> 想在终端连接 Napcat？来看看 [Stapxs QQ Shell](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Shell) 吧！\u003Cbr \u002F>\n---\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fblog.stapxs.cn\" target=\"blank\">\n    \u003Cimg src=\"src\u002Frenderer\u002Fpublic\u002Fimg\u002Ficons\u002Ficon.svg\" alt=\"Logo\" width=\"156\" height=\"156\">\n  \u003C\u002Fa>\n  \u003Ch2 align=\"center\" style=\"font-weight: 600\">Stapxs QQ Lite\u003C\u002Fh2>\n \u003Cp align=\"center\">\n  \u003Cimg src=\"README\u002Fgitcode.png\" width=\"400\">\n \u003C\u002Fp>\n  \u003Cp align=\"center\">\n    一个兼容 OneBot 的非官方网页 QQ 客户端\n    \u003Cbr \u002F>\n    \u003Ca href=\"https:\u002F\u002Fstapxs.github.io\u002FStapxs-QQ-Lite-2.0\u002F\" target=\"blank\">\u003Cstrong>🌎 访问 DEMO\u003C\u002Fstrong>\u003C\u002Fa>  |  \n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Freleases\" target=\"blank\">\u003Cstrong>📦️ 下载程序\u003C\u002Fstrong>\u003C\u002Fa>  |  \n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fissues\u002Fnew?assignees=Stapxs&labels=%3Abug%3A+%E9%94%99%E8%AF%AF&template=----.md&title=%5B%E9%94%99%E8%AF%AF%5D\" target=\"blank\">\u003Cstrong>💬 反馈问题\u003C\u002Fstrong>\u003C\u002Fa>\n    \u003Cbr \u002F>\n    \u003Cbr \u002F>\n    \u003Cstrong>本网页应用仅供学习交流使用，请勿用于其他用途\u003C\u002Fstrong>\u003Cbr>\n    \u003Cstrong>版权争议请提出 issue 协商\u003C\u002Fstrong>\n  \u003C\u002Fp>\n\u003C\u002Fp>\n\n![view](README\u002Fview.png)\n\n## ☕️ 赞助项目\n\u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fwww.ifdian.net\u002Fa\u002Fstapxs\" target=\"_blank\">\n    \u003Cimg src=\"README\u002Fsponsor.png\" width=\"600\">\n    \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 社区版本\n以下是一些社区支持的版本，非常推荐大家试用：\n- [Stapxs QQ Lite X](https:\u002F\u002Fgithub.com\u002FChzxxuanzheng\u002FStapxs-QQ-Lite-X)：扩展了更多功能的社区版本，支持更多接近原版 QQ 的功能\n- [Stapxs QQ Lite Pre Preview](https:\u002F\u002Fgithub.com\u002Fdev-soragoto\u002FStapxs-QQ-Lite-2.0-pre-release)：Stapxs QQ Lite 的预览版本，跟随 dev 分支更新，可体验最新功能\n\n## ✨ 特性支持\n\n- ✅ 使用 Vue.js 全家桶开发，快乐前后端分离\n- 🎨 自适应布局，竖版也能使用\n- 🖥️ 支持 PWA（都有 Electron 了（小声））\n- 🌚 Light\u002FDark Mode 自动切换\n- 🍱 该有的都有（虽然比不过官方端）\n  - 复杂消息显示、转发、回复、撤回\n  - 群文件、群公告、群设置（一小部分）、精华消息\n  - 图片、收藏表情、文件发送\n- 📦️ 支持多种 bot，我就是要用！\n- 🔥 水深火热但是更好看的 Electron 客户端\n- 🥚 彩蛋！来更多的彩蛋！\n- 🛠 更多特性开发中\n\n## ♿️ 快速使用\n\n### > 运行服务\n\nStapxs QQ Lite 需要一个 QQ Bot 后端提供服务。由于 QQ Bot 的部署较为复杂，请移步 [Bot 适配情况](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fissues\u002F76) issue 查看目前支持的 Bot 并选择一个查阅其部署文档。\n\n\u003Cimg alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fassets\u002F42486439\u002Fc92ebf66-e11e-41bd-9faa-7399aac2d1a8\">\n\n### > 访问网页\n\n本仓库开启了 GitHub Pages，所有向主分支提交的代码将会自动构建并发布。你可以直接访问 [🌎 这个页面](https:\u002F\u002Fstapxs.github.io\u002FStapxs-QQ-Lite-2.0) 来使用已构建并部署的在线版本。\n\n### > 安装客户端\n\n除了直接使用本仓库的构建页面，你也可以下载使用 Electron 打包的功能**稍稍**更丰富的客户端版本，访问 [📦️ 这里](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Freleases) 查看版本发布列表。\n\n你也可以使用包管理器来安装，这样可以更方便地更新 Stapxs QQ Lite 而无需每次都从 GitHub 手动下载，访问 [💬 这里](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fissues\u002F99) 查看目前支持的包管理器。\n\n### > 在 Napcat 中安装\nStapxs QQ Lite 也可以作为 Napcat 的插件运行，点击下面的快速安装按钮在 Napcat 插件商店中安装：\n\n\u003Ca href=\"https:\u002F\u002Fnapneko.github.io\u002Fnapcat-plugin-index?pluginId=napcat-plugin-ssqq\" target=\"_blank\">\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FNapNeko\u002Fnapcat-plugin-index\u002Fblob\u002Fpages\u002Fbutton.png?raw=true\" alt=\"Logo\" width=\"160\">\n\u003C\u002Fa>\n\n### > 自行部署网页\n\nStapxs QQ Lite 在版本发布时会构建 Web 文件，你可以在 [📦️ 这里](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Freleases) 找到它，通常命名为 `Stapxs.QQ.Lite-\u003C版本>-web.zip`，下载后解压并放置到你的网页服务器中即可。\n\n不会部署网页服务器？Stapxs QQ Lite 网页版已经发布到了 [npm](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fssqq-web)！你可以使用 npx 工具快速启动：\n\n``` bash\nnpx ssqq-web hostname=127.0.0.1 port=8081\n```\n\n### > 使用 Docker 部署网页\n\nStapxs QQ Lite 已经原生支持了 Docker 部署，使用命令\n``` bash\ndocker pull ghcr.io\u002Fstapxs\u002Fstapxs-qq-lite-2.0:latest\n```\n来拉取最新的镜像，如果您无法使用或者GHCR速度很慢，可以使用命令\n``` bash\ndocker pull ghcr.nju.edu.cn\u002Fstapxs\u002Fstapxs-qq-lite-2.0:latest\n```\n来从镜像站拉取镜像，使用时请将容器内的```8080```端口对外开放，```80```端口可以忽略。\n## 💬 提醒和问题\n以下是关于使用 QQ Bot 和第三方客户端的常见疑问，你也可以查看 [常见问题](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fissues\u002F117) issue 获取更多使用和部署相关的问题解答。\n\n### > 我能使用其他 QQ HTTP Bot 吗\n\n- 如果它兼容 [OneBot 11 协议](https:\u002F\u002Fgithub.com\u002Fbotuniverse\u002Fonebot-11)，你可以尝试连接，但由于消息体格式和接口扩展的差异，大部分情况下可能无法完全正常使用。\n  已兼容的 Bot 列表可以在 [这里](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fwiki) 查看。\n\n### > 使用 Bot 是否有风险\n\n- 使用 QQ Bot 服务可能存在一定风险，此风险并非由 Stapxs QQ Lite 造成，而是使用 QQ Bot 服务本身的风险。请自行查阅你所使用的 QQ Bot 相关文档以了解风险信息。\n\n### > 我遇到了问题\n\n- 如果遇到任何问题，欢迎发起 [issue](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Fissues) 询问！发现 BUG 或有优化建议也欢迎反馈。\n\n## 📦️ 构建应用\n\n为了规范对其他仓库的引用，Stapxs QQ Lite 仓库包含一些 Git 子模块，这意味着你需要在克隆仓库时包含子模块：\n\n``` bash\ngit clone https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0.git --recursive\n```\n\n如果你已经克隆了仓库，可以使用以下命令补全子模块：\n\n``` bash\ngit submodule update --init\n```\n\n在开始构建之前，请先安装依赖。请确保已安装 `yarn`：\n\n``` bash\n# 安装依赖\nyarn install\n```\n\n另外，Stapxs QQ Lite 使用了高德地图 API 来显示位置共享地图。`.env` 文件中提供了一个默认的高德地图 API Key，如果你打算自行部署，建议在 [这里](https:\u002F\u002Flbs.amap.com\u002Fdev\u002Fkey\u002Fapp) 申请属于你自己的 API Key 并替换默认值。\n\n我们强烈建议使用自己的 API Key，因为默认 Key 有使用次数限制。\n\n### > 构建 Web 页面\n\nStapxs QQ Lite 是一个基于 Vue 的单页应用，如果你想自行部署到网页服务器需要进行构建。你也可以直接前往 [这里](https:\u002F\u002Fgithub.com\u002FStapxs\u002FStapxs-QQ-Lite-2.0\u002Freleases) 下载预构建好的文件包。\n\n以下是构建该项目的命令，构建结果将输出在 `dist` 目录下：\n\n``` bash\n# 运行本地调试\nyarn dev\n\n# 代码检查和自动格式化\nyarn lint\n\n# 构建应用\nyarn build\n```\n\n#### SSE 模式\nStapxs QQ Lite 支持 SSE 模式。在此模式下，应用将以 HTTP SSE + HTTP API 的方式连接到 QQ Bot 后端，提供更快速和轻量化的连接；甚至可以直接禁用 SSE 通知推送，仅使用 HTTP API 进行通信。\n\nSSE 模式不支持动态切换，需要在构建前修改 `.env` 环境变量中 `VITE_APP_SSE` 开头的配置项来启用。启用 SSE 模式后，页面将无法使用其他连接模式。\n\n~~~ ini\nVITE_APP_SSE_MODE=true\nVITE_APP_SSE_SUPPORT=true\nVITE_APP_SSE_EVENT_ADDRESS=api\u002F_events\nVITE_APP_SSE_HTTP_ADDRESS=api\n~~~\n`SSE_MODE` 指定了 SSE 模式的主开关；\n\n`SSE_SUPPORT` 指定了是否支持 SSE 事件推送。设为 false 时将仅使用 HTTP API 进行通信，这将无法接收 QQ Bot 的主动推送消息，导致以下功能缺失：\n- 无法接收新消息推送、通知推送\n- 聊天面板新消息不会自动更新，但仍可通过重新加载面板来获取新消息\n\n剩余两项指定了 SSE 模式的地址，可根据需求修改。\n\n### > 构建 Electron 客户端\n\n自 `2.3.0` 版本起，Stapxs QQ Lite 支持构建为 Electron 应用并提供部分平台特性功能，你也可以自行构建。\n\n> 如果 Electron CLI 无法找到 Python，可以将 `PYTHON_PATH` 导出到环境变量中，指向 Python 可执行文件路径。\n\n以下是构建 Electron 应用的命令，构建结果将输出在 `dist_electron\u002Fout` 目录下：\n\n``` bash\n# Electron 运行本地调试\nyarn dev:electron\n\n# Electron 构建应用\nyarn build:electron\n```\n\n### > 构建 Tauri 应用\n\n自 `3.2.0` 版本起，Stapxs QQ Lite 支持构建为 Tauri 应用并提供部分平台特性功能，你也可以自行构建。\n\n以下是构建 Tauri 应用的命令，构建结果将输出在 `src\u002Ftauri\u002Ftarget\u002Frelease\u002Fbundle` 目录下：\n\n``` bash\n# Tauri 运行本地调试\nyarn dev:tauri\n\n# Tauri 构建应用\nyarn build:tauri\n\n# Tauri 构建指定架构\nyarn build:tauri -t x86_64-apple-darwin -b dmg\n\n# 查看支持的架构\nrustup target list\n```\n\n注意：Tauri 不支持跨平台构建，需要在对应平台上进行构建。\n\n### > 构建 Capacitor 应用\n自 `3.0.0` 版本起，Stapxs QQ Lite 支持通过 Capacitor 构建为移动端应用并提供部分平台特性功能，你也可以自行构建。\n\n#### Android\n> 如果 Capacitor CLI 无法找到 Android Studio 和 Android SDK，可以将 `CAPACITOR_ANDROID_STUDIO_PATH` 和 `ANDROID_HOME` 导出到环境变量中，它们分别指向 Android Studio 可执行文件路径和 Android SDK 路径。\n\n你可以使用 `yarn open:android` 打开 Android Studio，通过 Build -> Generate Signed Bundle or APK 来构建 APK 文件。\n\n你也可以直接使用 `yarn build:android` 构建 APK 文件。请检查并修改 `capacitor.config.ts` 文件中 `android.buildOptions` 的 keyStore 配置。\n\n构建结果将输出在 `src\u002Fmobile\u002Fandroid\u002Fapp\u002Fbuild\u002Foutputs\u002Fapk\u002Frelease` 目录下。\n\n#### iOS\n你可以使用 `yarn open:ios` 打开 Xcode，通过 Product -> Archive 来构建 IPA 文件。\n\n你也可以直接使用 `yarn build:ios` 构建 IPA 文件。此构建方式将执行 `scripts\u002Fbuild-export-ipa.sh` 脚本，构建将使用钥匙串中的默认开发者证书，请确保已配置开发者证书。\n\nXcode 的构建结果将输出在 `src\u002Fmobile\u002Fios\u002Fbuild` 目录下，脚本构建结果将输出在 `dist_capacitor` 目录下。\n\n### > 命令列表\n以下是本项目的完整命令列表，你可以使用这些命令来快速构建和调试 Stapxs QQ Lite。\n\n**命令格式为 `yarn \u003C命令>`，其中 `\u003C命令>` 为列表中的一个：**\n\n| 命令           | 描述                |\n| -------------- | ------------------ |\n| install        | 安装依赖            |\n| lint           | 代码检查和自动格式化  |\n| update:icon    | 更新移动端应用图标集  |\n| update:version | 更新移动端应用版本号  |\n| dev            | 网页调试            |\n| dev:electron   | Electron 调试      |\n| dev:tauri      | Tauri 调试          |\n| dev:ios        | iOS 调试           |\n| dev:android    | Android 调试        |\n| open:ios       | 在 Xcode 中打开项目  |\n| open:android   | 在 Android Studio 中打开项目  |\n| build          | 网页构建            |\n| build:electron | 构建当前平台的 Electron 应用    |\n| build:tauri    | 构建 Tauri 应用     |\n| build:ios      | 构建 iOS 应用       |\n| build:android  | 构建 Android 应用   |\n\n## 📜 子项目开源协议提醒\n本项目存在一些子项目，子项目开源协议依照子项目的声明为准：\n| 名称 | 简介 | 开源协议 |\n|------------|----------|----------|\n| capacitor-onebot-connector | 移动端功能 | Apache License 2.0 |\n| napcat-plugin | napcat 插件 | MIT License |\n| npx-web-quick-start | npx 快速部署功能 | AGPL-3.0 License |\n\n## 📜 额外依赖声明\nStapxs QQ Lite 的 Tauri 版本使用了来自 [DeltaChat](https:\u002F\u002Fgithub.com\u002Fdeltachat\u002Fdeltachat-desktop) 项目的 user-notify 代码，用于提供跨平台系统通知功能。由于这部分代码没有独立发布，我们将其源码复制到了 `src\u002Ftauri\u002Fcrates\u002Fuser-notify` 目录下。此部分代码已通过 .gitattributes 文件排除在语言统计之外。\n\n## 🎉 鸣谢\n\n感谢以下小伙伴在开发和文档中提供的支持 ——\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FLogic-Accepted\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F36406453?s=48&v=4\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdoodlehuang\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F25525621?s=48&v=4\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChzxxuanzheng\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F122149478?s=48&v=4\">\u003C\u002Fa>\n\n## ⭐️ Star History\n\u003Cpicture>\n  \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=stapxs\u002FStapxs-QQ-Lite-2.0&type=date&theme=dark&legend=top-left\" \u002F>\n  \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=stapxs\u002FStapxs-QQ-Lite-2.0&type=date&legend=top-left\" \u002F>\n  \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=stapxs\u002FStapxs-QQ-Lite-2.0&type=date&legend=top-left\" \u002F>\n\u003C\u002Fpicture>\n","Stapxs QQ Lite 是一个基于 OneBot 协议的第三方 QQ 客户端，支持 Web 和全平台使用。该项目采用 Vue.js 开发，实现了前后端分离，并具备自适应布局、PWA 支持以及 Light\u002FDark Mode 自动切换等功能。它能够处理复杂消息、群文件管理及表情发送等常用 QQ 功能，同时兼容多种 bot 平台。适用于需要跨平台访问 QQ 服务或对官方客户端有特定需求限制的用户，特别适合开发者和技术爱好者探索和学习。请注意，该应用仅供学习交流使用。",2,"2026-06-11 03:20:42","top_language"]