通过 POST http://127.0.0.1:3000/get_group_file_system_info(请求体为 JSON 参数)或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
group_id |
uint | ✓ | 群号 |
{ file_count, limit_count, used_space, total_space }:群文件数量与容量信息(均为服务端实际值)。
所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
file_count |
integer | ✓ | 当前文件数 |
limit_count |
integer | ✓ | 文件数上限 |
used_space |
integer | ✓ | 已用空间(字节) |
total_space |
integer | ✓ | 总空间(字节) |
支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入。