feat: 添加积分查询插件,提供用户积分查询相关命令

- 新增积分查询插件,包含我的积分、积分查询、积分排行和积分历史查询命令
- 支持群组和私聊场景,排行榜功能仅限群组使用
- 实现用户显示名称优先级(群昵称 > 昵称 > 用户ID)
- 添加详细的帮助文档和使用说明
This commit is contained in:
2026-04-06 23:45:05 +08:00
parent 5979f0c501
commit 889cfc799b
4 changed files with 257 additions and 0 deletions

View File

@@ -0,0 +1,73 @@
# Danding Points Query 插件
用户交互层,提供积分查询相关的命令。
## 命令列表
### 我的积分
查询当前用户的积分余额。
```
我的积分
```
**示例输出:**
```
张三 的积分余额1500
```
### 积分查询
查询指定用户的积分余额。支持 @用户 或输入用户ID。
```
积分查询 @用户
积分查询 123456789
```
**示例输出:**
```
李四 的积分余额2000
```
### 积分排行
显示积分排行榜前10名按积分从高到低排序。仅在群组中可用。
```
积分排行
```
**示例输出:**
```
🏆 积分排行榜 TOP 10
#1 张三 5000 分
#2 李四 4500 分
#3 王五 4000 分
...
```
### 积分历史查询
查询用户最近5条积分变动记录。支持 @用户、输入用户ID或不输入参数查询自己的记录。
```
积分历史查询
积分历史查询 @用户
积分历史查询 123456789
```
**示例输出:**
```
📊 张三 的积分变动记录最近5条
2026-04-06 10:30:45 +100 余额: 5000 赛马冠军奖励
2026-04-06 10:25:30 +50 余额: 4900 赛马参赛奖励
2026-04-06 10:20:15 -100 余额: 4850 赛马下注
...
```
## 实现细节
- 所有命令都支持群组和私聊
- 排行榜命令仅在群组中可用
- 用户显示优先级:群昵称 > 昵称 > 用户ID
- 积分变动记录按时间倒序显示(最新的在前)