萌卡 OB 部署与初始化

正式包发布后，请从本仓库 Releases 下载与操作系统、架构匹配的包。当前没有正式发行包，请勿把开发构建视为已经过生产验收的版本。

1. 准备机器人资料

先在 QQ 开放平台创建机器人，并确认已经开通需要的消息场景与事件权限。添加机器人时需要：

• AppID：机器人应用标识，按字符串填写。
• AppSecret：机器人密钥，只填写在你自己的框架后台，不要公开分享。
• Intents：准备接收的事件订阅范围，与开放平台权限保持一致。

2. 启动与初始化

取得对应系统的构建包后，解压到一个独立目录。在 Windows 中启动 mengka-ob.exe；Linux 中给程序添加执行权限后运行 ./mengka-ob。请保留随包提供的 Web 静态资源。

启动程序后，默认访问 http://127.0.0.1:18080。首次运行会进入初始化页面，阅读说明后设置管理员账号、密码和端口。新端口在下次启动时生效，显式 -listen 参数优先于数据库设置。

管理员密码使用 bcrypt 哈希保存。请一起备份数据目录里的 SQLite 数据库和 master.key；加密密钥丢失将无法解密机器人凭据。已完成初始化的实例不能通过初始化接口覆盖管理员。

3. 添加机器人并选择接入方式

在账号列表添加 AppID、AppSecret、接入协议与 Intents，保存后默认停用。确认配置后启用。

• WebSocket：程序主动连接 QQ 网关，无需公开回调端口。
• Webhook：给实例提供 HTTPS 地址，把账号信息中的 /webhooks/qq/{botID} 路径配置到 QQ 开放平台。
• 代理节点：支持 HTTP/HTTPS/SOCKS5；账号可选择直连或已启用节点。修改节点前先停用使用它的账号。

WebSocket 模式下，查看连接状态与事件日志，确认网关连接成功。Webhook 模式下，先在开放平台完成回调地址验证，再检查是否收到订阅事件；等待回调不等同于一条持续在线的 WebSocket 连接。

4. 接入插件

进入“插件服务”，创建正向 WS、反向 WS 或本机 IPC 服务，分别配置机器人、接口权限和事件订阅。权限默认关闭，按插件实际需求启用。具体步骤见插件服务与导入。

运行、备份与更新

不要让多个进程同时使用同一数据目录。程序重启会使管理员会话失效；自动登录开关只控制是否恢复上次已启用的 Bot，不会把停用账号自动启用。

邮件设置提供保存与显式测试；测试按钮会真正发送邮件。离线通知只作用于从在线状态断开的 WebSocket Bot，主动停用及 Webhook 等待回调不触发掉线通知。

更新检查读取本仓库公开 Release。当前开发版本采用手动下载升级，不自动安装或覆盖运行中的程序。