get_group_files_by_folder

使用指定 Android 或 Linux QQ 在线会话获取群文件夹中的文件与子文件夹。框架在账号实际节点请求原生群文件服务，不依赖其他协议的登录态或 PC QQ 本地数据库。

const result = await api.get_group_files_by_folder({
  self_id: 1060221,
  group_id: 106500,
  folder_id: '/3d7e7839-1512-4e77-bb69-aa66124c603b',
  file_count: 50,
})

字段	类型	必填	说明
self_id	number	是	执行请求的在线 Bot QQ 号
group_id	number	是	群号
folder_id	string	是	文件夹 ID；也兼容 folder
file_count	number	否	单页请求数量，默认 50，范围 1-100

返回结构与 get_group_root_files 相同。接口会自动读取后续分页，不需要调用方维护分页游标。

分页与完整性

目录读取使用当前原生服务，支持 Android / Linux 在线会话。file_count 作为初始单页数量，遇到满页却标记结束的矛盾响应，会在同一偏移扩大窗口复核（单次最多 100 条），而不是直接返回残缺列表。满 100 条时再移动半个窗口，按原生顺序验证重叠的 50 条，然后继续确认尾部；不再仅因满 100 条而拒绝正常目录。已读取的文件与目录必须保持一致；视图矛盾、重复记录、游标停滞或无法确认末页完整性时返回错误。

整次目录读取总预算为 45 秒，调用方原有的更短截止时间仍然生效。限制按总条目 10000 条计算，而不是小页达到 100 页就截断；单次末页重叠复核另有 100 次上限。已实测 99/100/101 条目录在四会话、页大小 1/50/100 下的 36 份结果一致。更大规模、持续并发修改与极端陈旧计数仍需继续验收，不承诺无限目录大小。