feat(command): 回调响应自动回复到 QQ

- 回调服务器可返回 reply 或 messages 字段,插件自动回复到原消息来源
- reply 为纯文本回复,messages 格式同 /webhook 接口
- 支持通过 group_id/user_id 覆盖回复目标
- 无需回复时返回空 JSON 即可
- 更新 README 文档说明回调响应格式
This commit is contained in:
2026-05-02 19:29:18 +08:00
parent ee1bd583d8
commit af0f6c7ec6
3 changed files with 126 additions and 9 deletions

View File

@@ -225,6 +225,35 @@ curl -X POST http://localhost:8081/webhook \
| `group_id` | 群号(私聊消息无此字段) |
| `message_id` | 消息 ID |
**回调响应格式(自动回复到 QQ**
回调服务器返回 JSON插件会自动将内容回复到原消息来源群/私聊)。
纯文本回复:
```json
{"reply": "收到你的命令了"}
```
批量回复text/image/video 组合发送file 单独发送):
```json
{
"messages": [
{"type": "text", "msg": "处理结果如下"},
{"type": "image", "url": "https://example.com/result.png"},
{"type": "file", "url": "report.pdf"}
]
}
```
| 字段 | 说明 |
|---|---|
| `reply` | 纯文本回复(与 `messages` 二选一,`messages` 优先) |
| `messages` | 批量回复数组,格式同 `/webhook``messages` 字段 |
| `group_id` | 可选,覆盖回复目标群号(默认回复到原群) |
| `user_id` | 可选,覆盖回复目标 QQ 号(默认回复到原发送者) |
不需要回复时返回 `{}` 或空响应即可。
## 项目结构
```