Files
DanDingNoneBot/PLUGINS.md
Mr.Xia 17dd19330e chore: 清理测试脚本并更新插件文档
- 删除过时的测试脚本,包括测试配置、路由、API、积分、签到等文件
- 更新 PLUGINS.md 文档,重新组织插件结构,提供更清晰的功能说明和权限要求
- 改进文档格式,增加表格和详细说明,便于用户理解各插件功能
2026-04-10 21:14:05 +08:00

5.9 KiB
Raw Permalink Blame History

蛋定助手插件文档

项目概述

蛋定助手是一个基于 NoneBot2 框架开发的 QQ 机器人,提供多种功能插件,包括 AI 聊天、游戏辅助、积分系统、社群管理等。

插件总览

插件名称 描述 触发方式 权限要求
chatai AI 聊天DeepSeek支持图文回复 * 开头消息 所有用户
auto_recall 自动撤回机器人发送的消息 自动执行 系统自动
auto_friend_accept 自动同意好友请求并发送欢迎语 自动执行 系统自动
welcome_plugin 新成员入群欢迎并发送帮助菜单 自动执行 特定群 (621016172)
danding_qqpush 通过 HTTP API 向指定群推送图文通知 HTTP POST 接口 Token 验证
danding_points 积分系统数据库与 API 核心 API 调用 系统内部
danding_points_query 查询余额、排行及交易记录 命令触发 所有用户
group_horse_racing 多人赛马游戏,支持下注与积分奖惩 命令触发 允许的群聊
onmyoji_gacha 阴阳师主题抽卡,包含成就与卡密奖励 命令触发 允许的群聊/用户
damo_balance 查询大漠平台账户余额 命令触发 特定用户
danding_api 管理员操作:卡密管理、加时、在线查询 命令触发 超级用户
danding_help 提供教程、下载及功能指引 命令触发 特定群 (621016172)
command_list 获取系统支持的所有指令列表 命令触发 所有用户

详细插件文档

1. chatai - AI 聊天

基于 DeepSeek AI 的聊天功能,支持将回复转换为图片形式,并在一定时间后自动撤回。

  • 使用方法: 发送以 * 开头的消息。
  • 配置项: DEEPSEEK_TOKEN (必填)。
  • 特性: AI 回复会自动转为图片显示,默认 120 秒后撤回。

2. auto_recall - 自动撤回

监控机器人发出的消息,并在指定时间后自动撤回,保持聊天环境整洁。

  • 配置项:
    • RECALL_DELAY: 普通消息撤回延迟(默认 110s
    • QQPUSH_RECALL_DELAY: 推送消息撤回延迟(默认 3600s

3. auto_friend_accept - 自动接受好友

自动处理好友请求,提升用户接入效率。

  • 配置项:
    • auto_accept_enabled: 是否开启自动接受。
    • auto_reply_message: 接受后的欢迎语。

4. welcome_plugin - 入群欢迎

针对特定群聊的新成员欢迎功能。

  • 触发场景: 新成员加入群 621016172
  • 功能: 随机发送欢迎语,并附带帮助菜单图片。

5. danding_qqpush - 消息推送

提供外部系统向 QQ 推送通知的 HTTP 接口。

  • 接口: POST /danding/qqpush/{token}
  • 功能: 自动将长文本转换为图片,支持 @用户 和换行符 #
  • 配置: DANDING_QQPUSH_TOKEN

6. danding_points - 积分系统核心

为其他插件提供积分存储与结算的基础设施。

  • 功能: 数据库管理SQLite、余额增减、排行榜计算、交易日志记录。
  • 数据库路径: data/danding_points/points.db

7. danding_points_query - 积分查询

用户通过命令与积分系统交互。

  • 主要命令:
    • 我的积分: 查看个人余额。
    • 积分查询 @用户: 查看他人余额。
    • 积分排行: 查看前 10 名。
    • 积分历史查询: 查看最近 5 条变动记录。
    • 积分帮助: 获取指令指引。

8. group_horse_racing - 群赛马游戏

集成积分系统的多人互动游戏。

  • 主要命令:
    • /赛马报名 [马名]: 参加比赛。
    • /赛马下注 <序号> <金额>: 对马匹下注。
    • /赛马开赛: 开始比赛(至少 2 人)。
  • 积分逻辑: 参赛奖励 50 分,冠军奖励 200 分,支持下注赔率结算。

9. onmyoji_gacha - 阴阳师抽卡模拟

高度还原的抽卡模拟,包含成就系统。

  • 主要命令:
    • 抽卡: 执行单抽。
    • 三连抽: 执行三连抽。
    • 我的抽卡: 查看个人统计。
    • 查询成就: 查看已解锁成就及进度(非酋、勤勤恳恳系列)。
    • 抽卡介绍: 查看详细机制与奖励说明。
  • 特性: 抽中 SSR/SP 可获得“蛋定助手”卡密奖励(需联系管理员领取)。包含每日抽卡签到积分奖励。

10. damo_balance - 大漠账户查询

查询大漠平台账户余额。

  • 命令: 大漠余额余额查询
  • 限制: 仅特定用户可用,需输入验证码。

11. danding_api - 管理 API

供超级用户使用的后台管理功能。

  • 主要命令:
    • 在线人数: 查询当前活跃用户。
    • 生成卡密 <类型>: 生成天/周/月卡。
    • 用户加时 <用户名> <类型>: 直接为特定用户增加时长。

12. danding_help - 帮助菜单

系统的官方指引手册。

  • 主要命令: 帮助下载正式版如何运行 等。
  • 限制: 仅在特定群 621016172 可用。

13. command_list - 指令列表

快速查阅所有可用指令。

  • 命令: 指令列表

常见问题 (FAQ)

  • Q: 为什么某些命令没反应?
    A: 部分插件(如 danding_help)限制了特定群聊使用;管理指令需要配置 SUPERUSERS
  • Q: 积分有什么用?
    A: 目前主要用于赛马下注及展示排名。
  • Q: 抽卡奖励如何领取?
    A: 抽中 SSR/SP 或解锁特定成就后,请截屏联系管理员。