- 部署架构
CoolQ Air，配合 HTTP API 插件，将所需操作折射成对相应 HTTP 地址的请求、回复。本仓库代码为机器人主要逻辑，借由 cqhttp 库间接与 CoolQ Air 进行通讯。
由于插件的设计，CoolQ Air 端与本仓库代码需要各自监听独立的端口并提供 HTTP 服务，注意设置好安全组策略，别将端口暴露给外网，同时设置好 access_token 跟 secret。
另外，由于我所使用的服务器环境为 Ubuntu，CoolQ Air 端运行在 Docker 中的 Wine 里边，镜像为插件所提供。平时借助 noVNC 操作 CoolQ Air。
- 开发指南
首先，提交 PR 请尽量遵循 PEP 8。
各文件作用：
- base.py: 对 cqhttp 框架的直接操作，封装好对消息的操作
- config.py: 配置账号相关信息
- fmtstr: printf 命令的 ELF 文件
- fmtstr.c: fmtstr 文件的源代码
- gal.py: gal 命令的主要逻辑
- globals.py: 各种全局常量（主要为各种提示消息）
- keywords.py: 关键词相关，数据+逻辑
- main.py: 各个子模块的逻辑就在这里
- sqli.py: bonus 命令的主要逻辑
- 文档 (不存在的)
就对 main.py 里需要怎么写简单说一下，这个文件里可以安排的事情：
- 对所有群聊/私聊信息进行处理
- 绑定特定命令
具体做法就是，定义一个你自己的函数，函数名随意，然后在上边加上一行修饰器。注意，函数必须包含一个位置参数：
@bot.register(...参数...)
def your_func_name(cxt):
pass如果要对私聊信息/命令进行处理，请传递 private=True，群聊同理：public=True。可同时设置，但是至少需要一个（默认都是 False）。
如果要处理所有消息，直接传 private 和 public 就行；如果要处理特定命令，将命令名作为第一个参数传入。注意，在当前的代码逻辑下，前者优先于命令执行。
register 过的函数，在遇到符合的场景（如：私聊+命令）时，会依照其注册顺序执行。一旦有某个函数返回了非假的值，接下去的函数将不会被执行。同时，这个返回值会作为事件上报的值回传给 HTTP API（因此，要求返回一个字典或者 None/False）。
如果想与 HTTP API 进行联络且不中断对该消息的进一步处理，请使用 bot.send 或 bot.xxx，其中，xxx 直接对应着这里的 API 路径名。
- gal文本格式说明
[DayN+][N]
故事前半段[next]
故事后半段
[end]
选项1[>?]后续故事1前半段
后续故事1后半段
[end]
选项2[>?]后续故事2[end]
[end]
Other days......
[final]
N+为一个正整数，不允许跳过，即要有day3就必须有day2和day1
N为编号，这个是给人看的，写错不会报错，但可能导致跳转关系有问题，原则上必须从0开始递增，每一天的编号都是从0开始，即day1有0号，day2也有0号
[next]用于在故事和后续故事中分条发送
[end]作为一段的结尾和一天的结尾都要存在一个
[>?]作为选项和后续故事的分割必须存在，其中？如果没有代表已经是good end，？如果是-1代表已经是bad end，如果是其他自然数代表下一天可以可能存在的故事分歧，如果有多个，请用英文的,分割，例如[>0,1]
文本的最后请加上[final]代表结束