- 新增积分查询插件,包含我的积分、积分查询、积分排行和积分历史查询命令 - 支持群组和私聊场景,排行榜功能仅限群组使用 - 实现用户显示名称优先级(群昵称 > 昵称 > 用户ID) - 添加详细的帮助文档和使用说明
74 lines
1.4 KiB
Markdown
74 lines
1.4 KiB
Markdown
# 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
|
||
- 积分变动记录按时间倒序显示(最新的在前)
|