功能定位：为什么需要批量导出
在 Letstalk IM 的超级群组 2.0 里，单群上限 20 万人，管理员每天要在成员审核、积分结算、链上空投名单之间来回切换。批量导出成员把「群成员列表→本地 Excel」的耗时操作压缩到 30 秒内，并自动附加用户 ID、匿名 Passport 哈希、入群时间、最后发言时间等 8 个常用字段，人工拼接的出错概率直接归零。
该功能自 v7.5 起向「群主/联席群主」开放，v7.8.0 新增「字段模板」与「分段导出」，用来缓解十万级群组一次性导出时的内存峰值。若你曾用第三方机器人爬取成员，官方通道在速度、字段完整度与合规审计上都更友好，也不会触发 Letstalk 的反爬限速。
版本差异：v7.5→v7.8.0 的演进要点
v7.5：基础导出
仅支持「全部成员」单文件，字段固定 5 项：昵称、ID、身份、入群时间、邀请人。文件上限 5 万行，超出需手动翻页再导。
v7.7：增量导出
新增「时间范围」与「增量模式」，系统对比上次导出时间戳，只返回新增或字段变更的行，日更 200+ 成员的社群也能秒级同步。
v7.8.0：模板与分段
支持自定义字段模板（最多 12 列），可勾选「匿名 Passport 哈希」「链上地址」「发言频次」等敏感列；超过 10 万人群组自动分段打包，每包 ≤5 万行，前端不再卡顿。
前置条件与权限校验
1. 角色：仅限「群主/联席群主」；若开启「企业托管」，需额外拥有「数据合规官」身份。
2. 数量：单次导出 ≤20 万人；超出时分段打包。
3. 频率：每 24 小时最多 3 次，次日凌晨 0 点（UTC）重置。
4. 合规：导出文件自带 Invisible Watermark，含操作者 ID 与 Unix 时间戳，用于审计回溯。
警告
匿名群（开启「隐藏成员列表」）无法导出任何成员数据，系统会返回「列表已加密」提示。如需统计，先关闭匿名模式 24 小时后再操作。
操作路径：三端最短入口
桌面端（Win/macOS v7.8.0）
- 进入目标群聊 → 右上角「⋯」→ 群管理 → 成员 → 批量导出。
- 选择「字段模板」→ 勾选需要的列 → 如需增量，打开「仅导出自『上次任务』以来变更」。
- 点击「生成报表」，等待进度条 100%，系统弹出下载链接，有效期 6 小时。
Android/iOS（v7.8.0）
- 进群 → 顶部标题长按 → 群管理 → 成员 → 右上角「⤓」图标。
- 后续步骤与桌面端一致，但「分段打包」默认关闭；若群员>5 万，系统会强制开启并给出预估包数。
- 移动端导出完成后，文件保存在「Letstalk 加密云盘/Export」目录，可一键转存至系统下载或转发邮箱。
字段解释与映射示例
| 字段名 | 说明 | 示例值 |
|---|---|---|
| user_id | Letstalk 内部身份串，不可变 | u_7f8a9b1c2d |
| passport_hash | 匿名 Passport 盲签名哈希，用于空投白名单 | p_3ea…2f9 |
| join_time | 首次进群 Unix 秒 | 1712588800 |
| msg_count_30d | 近 30 天发言条数（不含撤回） | 42 |
经验性观察：若计划用 Excel 透视表统计「周活」，可把「msg_count_7d」与「last_msg_time」一起导出，再用 Power Query 筛选>0 即可，无需额外调用 API。
常见失败分支与回退方案
现象：点击「生成报表」后提示「任务队列已满」
原因：同一群组 24 小时内已提交 3 次。处置：等待至 UTC 0 点重置，或切换至「增量模式」减少数据量。
现象：下载链接失效
链接有效期 6 小时，逾期需重新提交。若文件>500 MB，建议用桌面端 Wi-Fi 下载，移动端可能因系统休眠中断。
现象：Excel 打开为空白或乱码
Letstalk 默认导出为 UTF-8 编码 CSV，需用 Excel「数据→自文本/CSV」导入，并手动选择「65001: Unicode (UTF-8)」。直接双击打开会触发 GBK 解析失败。
与第三方机器人协同的边界
官方导出通道与第三方归档机器人互斥：若检测到过去 24 小时内有机器人批量读取成员列表，系统会强制冷却 2 小时。经验性观察：10 万人群里，机器人每秒拉取 50 笔，约 40 分钟可跑完全量，但容易触发风控。若你已计划官方导出，建议提前停用机器人「成员扫描」权限，否则任务会被排队到机器人冷却结束后才执行。
风险控制：什么时候不该导出
- 群开启「匿名模式」时，导出将失败且不会提示具体用户，易误判为系统 Bug。
- 导出文件含 passport_hash、链上地址等 PII，需遵守 GDPR「最小可用」原则；不建议转发至普通邮件，应使用 Letstalk 自带「加密云盘外链」，并设置 7 天自动销毁。
- 若用于链上空投，请校验哈希格式（p_ 开头 62 位），错误格式将导致智能合约回滚，浪费矿工费。
适用/不适用场景清单
| 场景 | 是否推荐 | 理由 |
|---|---|---|
| 5 万人群月度积分结算 | ✅ | 字段全、速度快、无需额外 Bot |
| 匿名群做 KYC-free 空投 | ❌ | 匿名开关导致无法导出 |
| 日更千条的高频社群实时统计 | ⚠️ | 建议用增量模式，否则日导出 3 次额度易耗尽 |
最佳实践检查表
快速落地清单
- 确认自己为群主或联席群主，且匿名模式已关闭≥24 小时。
- 提前在「字段模板」里保存「空投模板」与「运营模板」两套，减少重复勾选。
- >10 万人必开「分段打包」，每包≤5 万行，防止 Excel 崩溃。
- 下载后第一时间转存加密云盘，设置 7 天销毁，并把外链密码私聊给协作同事。
- 若用于链上空投，先用脚本校验 passport_hash 正则（^p_[a-zA-Z0-9]{60}$），再上传合约。
FAQ（Schema 版）
导出后为何找不到链上地址字段？
该字段仅对「公开地址」用户可见。若成员未在「钱包→隐私」里开启「对群可见」，导出时留空。
增量模式如何设定基准时间？
系统自动读取最近一次「成功导出」任务的完成时间作为基准；手动删除旧文件不会影响基准。
能否自动推送到 Google Sheet？
官方通道暂不支持；可下载 CSV 后，用 Letstalk 加密云盘的「Webhook 通知」触发自建脚本上传，但需自行处理 OAuth 密钥。
结语与下一步行动
批量导出成员并生成 Excel 报表，是 Letstalk 官方提供的零代码数据出口，兼顾速度与合规。完成首次导出后，建议立即建立「字段模板」与「分段打包」习惯，把文件生命周期控制在 7 天内，减少 GDPR 风险。若社群规模继续膨胀，可结合增量模式+本地 BI 工具，实现每日自动刷新仪表盘——届时再把脚本开源给社区，你就从「管理员」升级为「数据运营」了。
