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，私聊] 配置账号

群聊总结

• /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/
│   ├── status/
│   └── todo/
├── 37bot.service
└── start-napcat.sh

License

GPL-3.0