QQ 机器人框架

Sirius-QQ-Bot

装在自己的机器上跑 QQ 机器人。消息和凭证留在本地,不上传。Windows、Linux 都能用。应用用 Rust、C++ 或 Go 写,打包后放进商店,可以免费,也可以收费。

  • 0事件分发延迟
  • 0注入调用开销
  • 0SDK 语言
  • 0安装前验签
私有化部署

私有化部署,数据不出本地

机器人凭证、聊天记录、应用数据都在你自己的机器上。云端只核对账号,以及把商店里的应用发下来。

不采集消息内容

群聊和私聊只在你这台机器上处理,不会发到我们的服务器。

不采集联系人与群成员

好友和群成员名单留在本地,平台这边看不到。

不采集本地文件

框架不会把你电脑上的文件传上去。应用自己存的数据也在本地。

云端只做两件事:启动时核对账号,之后每 6 小时再核一次;另外把商店里的应用发下来。别的都在你的机器上。

在线体验

先看一眼控制台

下面就是桌面控制台,数据是演示用的。可以点应用设置、商店和支付,也能切换日间和夜间。

sirius-console · 桌面端管理面
演示数据 · 支持 ☀/☾ 主题切换
正在加载演示…
桌面控制台 · 在线演示 演示数据,可以点着看
  • 机器人接入与运行总览
  • 应用管理与设置面板
  • 商店选购与扫码支付
  • 日间 / 夜间双主题切换
全屏打开演示

控制台按桌面布局设计,手机上全屏打开体验更完整。

全屏打开演示控制台

演示里的订单和机器人都是假的,不会真的扣款,也不会连上 QQ。页面里的 ☀/☾ 用来切换日间和夜间。

核心特性

框架里有这些

内核负责收消息,应用挂在同一个进程里,商店负责安装和收费。

⚡

Rust 高性能内核

用 Tokio 同时跑多个机器人,事件分发按毫秒计。内存不大,长时间开着也稳。

🧩

应用进程注入模型

应用是一个动态库,加载进框架进程里调用,中间不另开进程。SDK 有 Rust、C++、Go,写一个导出函数就能接到事件。

🔏

SPK 签名应用包

每个包有 ed25519 签名和文件清单。装的时候先验签,对不上就拒绝。可以用平台的公钥,也可以加上你自己的。

🖥

Windows / Linux 跨平台

Windows 和 Linux 各有一个可执行文件,下下来就能跑。macOS 还没有。有桌面客户端,也可以用浏览器开管理页。

🛒

商店

开发者上传应用,平台审核后重新签名,用户在商店里安装。免费和收费的放在一起。

💳

收费

账号额度、支付、退款、站内信都在里面。应用可以免费、买断、按月订阅,或者按调用次数扣费。钱先收到平台,再记到开发者账上。

架构

消息走本地,账号走平台

机器人的消息在你这台机器上处理。账号、额度和商店走 Sirius 云。

  1. QQ 平台群聊 · 私聊 · 通知
  2. 协议网关连接保持 · 协议适配
  3. 事件总线Tokio 异步 · 毫秒分发
  4. 应用宿主DLL/SO 注入 · 零 IPC
  5. 你的应用Rust · C++ · Go
  6. Sirius 云平台账号 · 额度 · 商店 · 审核 · 启动校验 / 每 6h 复检
QQ 平台群聊 · 私聊 · 通知 协议网关连接保持 · 协议适配 事件总线Tokio 异步 · 毫秒分发 应用宿主DLL/SO 注入 · 零 IPC 你的应用Rust · C++ · Go Sirius 云平台账号 · 额度 · 商店 · 审核 启动校验 / 每 6h 复检 商店目录 / 签名分发 开发者 / 用户开发者平台 · 用户中心

Windows 和 Linux

框架两边都能跑,macOS 还没有。同一个应用可以分别做 .dll 和 .so,打进同一个 .spk。安装时按系统选文件,开发者不用上架两次。

消息怎么到应用

QQ 的消息先进网关,再到事件总线,然后直接调到应用里的函数。不另起进程,也不把消息转成另一份再传回去。

账号和商店

启动时向平台核对额度,之后每 6 小时再核一次。商店目录和安装包都从平台下载。

商店

应用从上架到收款

开发者在用户中心入驻、上传、等审核。分类、价格和图标在应用商店里改。

  1. 01

    注册开发者

    在用户中心申请,填领域和联系方式。通过后才能上传。

  2. 02

    打包

    用官方 SDK 写,打成带签名清单的 .spk。

  3. 03

    等审核

    上传后排队。通过后平台会重新签名再发出去。

  4. 04

    标价上架

    上架后出现在商店。可以设成免费、买断、订阅或按次。购买记录和收益可以查。

四种标价方式

免费

默认就是这个。上架后谁都能装。

买断

付一次,一直能用。已经买过的不能再买。应用下架了,买过的人还能用。

订阅

按月、按季或按年。同一档续费会往后接。到期前 7 天发站内信。

按次

按调用次数从余额扣。可以设每天的免费次数。

付费由平台收款。发货时记一笔开发者分成,收益可以在开发者平台查,满 10 元可以提现。

先装一个客户端

免费档能绑几台,在运营后台设置。

下载客户端
云平台

没有电脑,也可以把机器人跑起来

Sirius 云平台的机器由云服务商提供。你按他们标出的价格选用。在官网登录后就能选服务商和节点,不需要自己的电脑和服务器。应用也在这个页面里买和配置。余额和用户中心是同一个钱包。

正在读取可选用的云服务商…

登录后使用云端 服务商后台

常见问题

你可能想问

1.0.4 更新了什么?

本次为强制更新。Linux 私有化 Web 面板记住访问令牌,刷新不再掉登录;应用商店图标和截图改由本机面板转发,HTTP 部署可以正常显示。商店已上架群管和到点提醒。Windows 打开控制台即可在线更新;Linux 再执行一次一键安装脚本,或拉取 cloud.siriusbot.cn/siriusbot:1.0.4 后重建容器。已有机器人和本地数据会保留。

Sirius-QQ-Bot 是什么?

用 Rust 写的 QQ 机器人框架。装在自己的机器上,消息留在本地。可以用桌面客户端,也可以用浏览器打开管理页。应用打成带签名的包,审核后在商店里安装。

如何为 Sirius-QQ-Bot 开发应用?

用官方 Rust、C++ 或 Go SDK,写一个导出函数接到事件。打包成 SPK,提交审核,通过后上架。

商店里的应用安全吗?

商店应用要先人工审核,平台会重新签名。安装时再用平台公钥验签,并核对 SHA-256 清单。验签不过的包装不上。

框架支持哪些操作系统?

现在有 Windows 和 Linux。macOS 还没有。同一个应用可以分别做 .dll 和 .so,打进同一个 .spk,安装时按系统选文件。

消息内容会被上传到云端吗?

不会。凭证、消息和应用数据都在你自己的机器上。云端只核对账号、发应用,不收消息、不收联系人和群成员、也不收本地文件。详见隐私政策。

支持哪些运行方式?

Windows 下载解压,双击打开。Linux 可以执行一条安装命令,装成系统服务;也可以用 Docker。管理页用浏览器打开。

框架如何收费?

免费档能绑几台在运营后台设置,默认 1 台。要多绑就在用户中心买订阅,机器人额度和有效期会提高,退款走人工审核。商店里的应用由开发者标价:免费、买断、订阅或按次,钱由平台收。

云平台的价格是谁定的?

由提供机器的云服务商制定。官网列出当前可选用的服务商和价格。应用仍在 Sirius 商店购买。

开发者如何通过应用获得收益?

入驻之后给应用选免费、买断、订阅或按次。用户在商店付款,平台收款,发货时记一笔分成。收益在开发者平台查,满 10 元可以申请提现,填收款账号或上传收款码,审核后打款。买断的一直能用,订阅在有效期内能用,应用后来下架也不影响已经买的人。