37Bot

基于 NcatBot 的 QQ 机器人。

快速开始

1. 安装依赖

uv sync

2. 配置

cp config.yaml.example config.yaml

编辑 config.yaml：

root: '管理员QQ号'
bt_uin: '机器人QQ号'
napcat:
  ws_uri: ws://localhost:3001   # NapCat WebSocket 地址
  remote_mode: true             # 远程模式

3. 运行

uv run python main.py

插件与命令

通用

• /help：显示模块列表
• /help <模块>：显示模块命令
• /status：查询服务器状态（CPU、内存、Swap、磁盘、运行时间）

ArkRec（明日方舟少人 Wiki）

• /arkrec [关卡] [分类] [干员]：查询记录（默认常规队当前纪录）
• /arkrec_top [数量] [分类]：查看最近记录
• /arkrec_op <关卡号>：查看关卡信息
• /arkrec_exclusive [干员] [流派] [普通/突袭] [数量]：查询独享纪录（图片）
  • 默认不含已关闭活动，可加 已关闭
• /arkrec_brief [流派] [数量]：关卡一览（图片）
  • 默认：当前活动 + 常规队 + 含无纪录关卡
  • 可加：有记录、仅无记录、全部关卡、刷新
• /arkrec_sub <分类/干员/关卡>：[管理员] 订阅推送
• /arkrec_unsub [值]：[管理员] 取消订阅（留空取消全部）
• /arkrec_status：查看订阅状态和数据库统计
• /arkrec_config <email> <password>：[root，私聊] 配置账号

森空岛签到

• /skland_config add <鹰角token>：[私聊] 添加森空岛签到账号
  • 添加时会立即校验 token、读取绑定角色，并优先使用第一个明日方舟角色 uid 作为本地账号标识
  • 添加成功后会立刻尝试签到，并返回本次签到结果
• /skland_sms <手机号>：发送短信验证码；群内发起时，该账号后续通知目标为当前群
• /skland_sms_code <验证码>：提交短信验证码，登录成功后保存长期 token 并立即签到
• /skland_qr：二维码登录入口；当前暂不落库，详见命令提示
• /skland_sign [uid]：立即签到；不传 uid 时签到全部账号
• /skland_status：[root] 查看签到配置、账号 UID、上次定时日期
• /skland_config remove <uid>：[root/账号添加者] 删除账号
• /skland_config hour <0-23>：[root] 设置每日定时签到小时，分钟固定为 01
• /skland_config on|off：[root] 启用或禁用每日自动签到

说明：

• 默认每日本机时区 00:01 对所有账号自动签到，当前会同时尝试明日方舟和终末地。
• token 添加只允许私聊，签到结果会私聊添加者；短信登录可在群或私聊完成，签到结果会发回发起来源。
• token、设备 ID、所属 QQ 用户等数据保存在插件工作目录的 config.json，不会写入主配置文件。
• token 失效或换取森空岛 cred 失败时，只会在首次失败时提醒一次：群来源会在对应群内 at 添加者，私聊来源会私聊添加者；后续签到恢复成功会自动清除提醒状态。
• 日志会记录 uid、所属 QQ、token 指纹、设备 ID、接口阶段、角色签到结果和耗时，便于排查；不会记录明文 token。
• 森空岛 API 签名算法参考了 YueHen14/skyland-auto-sign 和 UKMeng/nonebot-plugin-skland-arksign。

群聊总结

• /summary [消息数|today|YYYY-MM-DD]：生成群聊总结
• /summary_on：[管理员] 开启每日定时总结
• /summary_off：[管理员] 关闭每日定时总结
• /summary_time <0-23>：[管理员] 设置定时小时
• /summary_count <20-2000>：[管理员] 设置总结消息条数
• /summary_track on/off：[管理员] 开关问题追踪
• /summary_status：查看本群总结配置

说明：定时总结使用框架定时任务，每 300 秒检查一次，命中设定小时的前 10 分钟窗口执行。

Mirror酱

• /mc_cdk <rid> <cdk>：绑定 CDK
• /mc_download <rid>：下载资源
• /mc_upload <rid>：上传资源（回复文件消息）

群管

• /ga_enable：[管理员] 启用本群群管功能
• /ga_disable：[管理员] 禁用本群群管功能
• /ga_pattern <正则>：[管理员] 设置入群验证正则
• /ga_reject <启用> <理由>：[管理员] 设置自动拒绝
• /ga_status：查看本群群管状态
• /ga_query [QQ号]：[管理员] 查询成员记录

待办

• /todo_add <内容>：添加待办（支持回复消息）
• /todo_list：查看待办列表
• /todo_done <id>：完成待办

项目结构

37Bot/
├── main.py
├── config.yaml
├── config.yaml.example
├── plugins/
│   ├── _ai/
│   ├── arkrec/
│   ├── group_summary/
│   ├── groupadmin/
│   ├── help/
│   ├── mirrorchyan/
│   ├── qa_helper/
│   ├── sensitive_monitor/
│   ├── skland/
│   ├── status/
│   └── todo/
├── 37bot.service
└── start-napcat.sh

License

GPL-3.0