feat: 添加状态监控插件和Redis原子操作支持
- 新增 `/status` 指令,展示机器人运行状态和系统指标 - 实现Redis Lua脚本支持原子化计数器操作 - 添加消息收发统计功能 - 完善文档,包括插件开发和性能优化指南 - 重构WebSocket连接池,增加健康检查机制 - 移除旧版编译脚本,优化项目结构
This commit is contained in:
@@ -408,6 +408,181 @@ honor = await bot.get_group_honor_info(123456, "talkative")
|
||||
print(f"本周龙王: {honor.current_talkative.user_id}")
|
||||
```
|
||||
|
||||
### `get_group_info_ex` - 获取群扩展信息 (NapCat)
|
||||
|
||||
```python
|
||||
async def get_group_info_ex(self, group_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
获取群的扩展信息(NapCatQQ 特有 API)。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
|
||||
**返回值:**
|
||||
- 包含群扩展信息的字典
|
||||
|
||||
## 精华消息
|
||||
|
||||
### `delete_essence_msg` - 删除精华消息
|
||||
|
||||
```python
|
||||
async def delete_essence_msg(self, message_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
删除一条精华消息。
|
||||
|
||||
**参数:**
|
||||
- `message_id`: 目标消息的 ID
|
||||
|
||||
## 互动与状态
|
||||
|
||||
### `group_poke` - 群内戳一戳
|
||||
|
||||
```python
|
||||
async def group_poke(self, group_id: int, user_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
在群内对指定成员发送"戳一戳"。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `user_id`: 目标成员的 QQ 号
|
||||
|
||||
### `mark_group_msg_as_read` - 标记群消息已读
|
||||
|
||||
```python
|
||||
async def mark_group_msg_as_read(self, group_id: int, time: int = 0) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
将指定群聊的消息标记为已读。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `time`: 将此时间戳(秒)之前的消息标记为已读,传 `0` 表示全部标记
|
||||
|
||||
## 消息转发
|
||||
|
||||
### `forward_group_single_msg` - 转发单条群消息
|
||||
|
||||
```python
|
||||
async def forward_group_single_msg(self, group_id: int, message_id: str) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
将一条群消息转发到当前群聊。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `message_id`: 要转发的消息的 ID
|
||||
|
||||
## 群设置 (高级)
|
||||
|
||||
### `set_group_portrait` - 设置群头像
|
||||
|
||||
```python
|
||||
async def set_group_portrait(self, group_id: int, file: str, cache: int = 1) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
设置群头像。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `file`: 图片文件的路径、URL 或 Base64 字符串
|
||||
- `cache`: 是否使用缓存(`1` 是,`0` 否)
|
||||
|
||||
### `set_group_remark` - 设置群备注
|
||||
|
||||
```python
|
||||
async def set_group_remark(self, group_id: int, remark: str) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
设置群备注(NapCatQQ 特有 API)。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `remark`: 要设置的备注
|
||||
|
||||
### `set_group_sign` - 群签到
|
||||
|
||||
```python
|
||||
async def set_group_sign(self, group_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
在指定群聊中进行签到。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
|
||||
## 群公告
|
||||
|
||||
### `_send_group_notice` - 发送群公告
|
||||
|
||||
```python
|
||||
async def _send_group_notice(self, group_id: int, content: str, **kwargs) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
发送群公告。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `content`: 公告内容
|
||||
- `**kwargs`: 其他可选参数,如 `image`
|
||||
|
||||
### `_get_group_notice` - 获取群公告
|
||||
|
||||
```python
|
||||
async def _get_group_notice(self, group_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
获取群公告列表。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
|
||||
### `_del_group_notice` - 删除群公告
|
||||
|
||||
```python
|
||||
async def _del_group_notice(self, group_id: int, notice_id: str) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
删除指定的群公告。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
- `notice_id`: 要删除的公告的 ID
|
||||
|
||||
## 其他信息获取
|
||||
|
||||
### `get_group_at_all_remain` - 获取@全体剩余次数
|
||||
|
||||
```python
|
||||
async def get_group_at_all_remain(self, group_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
获取当天在指定群聊中 @全体成员 的剩余次数。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
|
||||
### `get_group_system_msg` - 获取群系统消息
|
||||
|
||||
```python
|
||||
async def get_group_system_msg(self) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
获取群系统消息(如加群请求、退群通知等)。
|
||||
|
||||
### `get_group_shut_list` - 获取群禁言列表
|
||||
|
||||
```python
|
||||
async def get_group_shut_list(self, group_id: int) -> Dict[str, Any]
|
||||
```
|
||||
|
||||
获取被禁言的群成员列表。
|
||||
|
||||
**参数:**
|
||||
- `group_id`: 群号
|
||||
|
||||
## 加群请求处理
|
||||
|
||||
### `set_group_add_request` - 处理加群请求/邀请
|
||||
|
||||
Reference in New Issue
Block a user