通过 POST http://127.0.0.1:3000/get_group_root_files（请求体为 JSON 参数）或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
group_id |
uint | ✓ | 群号 |
群文件系统信息（文件与文件夹列表）。
所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
files |
object[] | ✓ | 文件列表 |
folders |
object[] | ✓ | 文件夹列表 |
{
"type": "object",
"properties": {
"files": {
"type": "array",
"description": "文件列表",
"items": {
"type": "object",
"properties": {
"group_id": {
"type": "integer",
"description": "群号"
},
"file_id": {
"type": "string",
"description": "文件 ID"
},
"file_name": {
"type": "string",
"description": "文件名"
},
"busid": {
"type": "integer",
"description": "业务 ID"
},
"file_size": {
"type": "integer",
"description": "文件大小（字节）"
},
"upload_time": {
"type": "integer",
"description": "上传时间戳"
},
"dead_time": {
"type": "integer",
"description": "过期时间戳"
},
"modify_time": {
"type": "integer",
"description": "修改时间戳"
},
"download_times": {
"type": "integer",
"description": "下载次数"
},
"uploader": {
"type": "integer",
"description": "上传者 QQ 号"
},
"uploader_name": {
"type": "string",
"description": "上传者昵称"
}
}
}
},
"folders": {
"type": "array",
"description": "文件夹列表",
"items": {
"type": "object",
"properties": {
"group_id": {
"type": "integer",
"description": "群号"
},
"folder_id": {
"type": "string",
"description": "文件夹 ID"
},
"folder_name": {
"type": "string",
"description": "文件夹名"
},
"create_time": {
"type": "integer",
"description": "创建时间戳"
},
"creator": {
"type": "integer",
"description": "创建者 QQ 号"
},
"create_name": {
"type": "string",
"description": "创建者昵称"
},
"total_file_count": {
"type": "integer",
"description": "文件夹内文件总数"
},
"last_upload_time": {
"type": "integer",
"description": "最后上传时间戳"
},
"last_uploader": {
"type": "integer",
"description": "最后上传者 QQ 号"
},
"last_uploader_name": {
"type": "string",
"description": "最后上传者昵称"
}
}
}
}
},
"required": [
"files",
"folders"
]
}curl -X POST http://127.0.0.1:3000/get_group_root_files \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <access-token>' \
-d '{"group_id":123456}'支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。