SnowLuma
首页
快速开始
部署
MCP
SDK
API
开发者
首页
快速开始
部署
MCP
SDK
API
开发者
简体中文

get_group_root_files

get_group_root_files只读群文件
获取群根目录文件列表

通过 POST http://127.0.0.1:3000/get_group_root_files（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
group_id uint ✓ 群号

返回 (data)

群文件系统信息（文件与文件夹列表）。

所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

字段 类型 必填 说明
files object[] ✓ 文件列表
folders object[] ✓ 文件夹列表
原始 JSON Schema
{
  "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": "文件夹内文件总数"
          }
        }
      }
    }
  },
  "required": [
    "files",
    "folders"
  ]
}

调用示例

curl
Python
JavaScript
Go
SnowLuma SDK
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}'
在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE