功能定位与版本脉络
在 Letstalk IM 的历次更新中，「群组文件过期自动清理」并非一次性功能，而是随着存储模型迭代逐步拆出的独立模块。最早在 2025Q2 的 v6.1 仅提供「单文件手动删除」；到 v6.3 引入「文件生命周期」概念，允许管理员为群文件统一设置 7-30 天保留期；截至当前的最新版本 v6.4.2，终于把「一键清理过期文件」入口放到群设置首页，并支持「批量删除+本地缓存同步」。
该功能解决的核心痛点是：加密群聊每日产生大量限时消息与伴随文件，虽然消息到期会自动消失，但下载到本地的缓存仍留在手机/电脑，既占空间又无法被系统级清理识别。Letstalk 的做法是：服务器端记录文件哈希与过期时间，客户端在每次打开群文件面板时拉取「过期列表」，用户确认后一次性物理擦除，同时把本地索引标记为「已清理」，避免重复下载。
最短可达路径（分平台）
Android
- 进入目标群聊 → 点击顶部群标题 →「群文件」
- 右上角「⋯」→「清理过期文件」
- 在弹窗中勾选「同时删除本地缓存」→ 确认
iOS
- 群聊界面 → 轻点头像区域 →「文件」
- 右上角「选择」→ 底部出现「清理过期」按钮
- 二次确认后完成；若开启 iCloud 备份，系统会提示「是否保留云端副本」
桌面端（Windows/macOS）
- 右侧边栏 →「文件」标签 →「过期管理」
- 点击「一键清理」→ 弹出清单，可取消任意文件
- 确认后，客户端会在后台执行 NIST-800.88 三覆写擦除，进度可在「设置-存储-任务中心」查看
例外与取舍：哪些文件不会被清理？
1. 加密云保险箱（L-Vault）外链：即使插入到群聊，文件实体保存在 Vault，群文件面板仅保留「外链卡片」。过期清理不会触碰 Vault，需在 Vault 内单独设置生命周期。
2. 「保留消息」星标：任何被管理员或发送者标记为「保留」的文件，哈希会被写入群公告区的「永久白名单」，一键清理时会自动跳过。
3. 本地转发副本：若用户把群文件转发到私聊，私聊的本地副本不受群清理影响；经验性观察显示，这部分缓存仍会计入「系统存储-其他」，需要到「设置-存储-私聊文件」单独清理。
副作用与缓解方案
一键清理后，最常见的副作用是「消息回溯断档」：当新成员加入并尝试拉取历史，过期文件已无法下载，导致上下文缺失。缓解办法：在清理前，管理员可先用「导出群文件索引」功能（群设置-高级-导出）生成本地 JSON，包含文件名、哈希、过期日，方便后续审计而无需保留实体。
另一副作用是「重复下载」：若成员在清理前未开启「自动下载」而手动点过文件，清理后索引被重置，再次点击会重新拉取，可能产生额外流量。建议把群的「自动下载」阈值设为 16 MB 以下，兼顾即时性与流量。
与第三方归档机器人的协同
部分团队使用第三方归档机器人（Webhook 模式）把群文件同步到自建 NAS。由于 Letstalk 的「过期清理」仅删除本地缓存与服务器索引，不会推送「删除事件」给外部机器人，NAS 端仍会保留副本。若需同步删除，必须在机器人脚本里订阅 file_expired 回调，并在收到哈希后执行远程删除。官方文档提供的示例脚本（Python）位于 GitHub 仓库，校验逻辑依赖文件哈希，确保仅删除完全一致的对象。
故障排查：清理失败或无响应
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 点击「清理」后卡在 0% | 本地数据库被锁 | 设置-存储-任务中心，看是否显示「DB locked」 | 重启客户端，再次清理 |
| 提示「无过期文件」但空间未释放 | 仅清理索引，未删本地缓存 | 检查是否取消勾选「同时删除本地缓存」 | 重新执行清理并勾选 |
| 清理后文件仍可下载 | 文件被星标保留 | 群公告-白名单，查看哈希是否存在 | 取消星标后再次清理 |
适用/不适用场景清单
- 高频文件协作群（日更 200+ 文件）：建议把保留期设为 3 天，并开启「每日凌晨自动清理」。
- 合规审计群（金融、医药）：不建议使用一键清理，改用「 Vault 外链+智能合约销毁」满足 SOX、GDPR 的可审计要求。
- 大型公开课群（10 k 订阅）：清理前务必「导出索引」，否则新成员无法回看课件，影响体验。
- 匿名爆料群：清理后文件不可恢复，符合 NIST 物理擦除，但需提前告知成员，避免争议。
最佳实践检查表
- 清理前导出索引 → 留存审计
- 确认白名单 → 避免误删
- 勾选「本地缓存」→ 真正释放空间
- 开启「自动清理」→ 降低手动频率
- 通知群成员 → 减少重复下载
版本差异与迁移建议
若仍有成员停留在 v6.1，他们看不到「一键清理」入口，只能手动长按单文件删除。管理员可在群公告置顶「升级提醒」，并设置「最低版本准入」插件（群设置-安全-版本限制），强制旧版用户升级后方可读取新文件，间接推动全员迁移。
验证与观测方法
清理完成后，进入「设置-存储-存储分析」，观察「群文件」条形图是否立即下降；若下降幅度与预估不符，可能是「本地转发副本」未计入。可进一步点击「私聊文件」查看分布。Android 11+ 用户还可通过系统「文件」App 浏览 Android/media/im.letstalk 目录，确认对应群文件夹是否被清空（注意：路径因版本与安装方式而异，请以实际为准）。
FAQ
一键清理后，还能恢复文件吗？
不能。Letstalk 采用 NIST-800.88 三覆写擦除，服务器与本地同步删除，无回收站。
清理过程会消耗大量流量吗？
不会。整个流程只在本地执行删除指令，无需重新下载或上传，流量消耗可忽略。
为什么清理完空间没变化？
可能未勾选「同时删除本地缓存」，或系统存储统计存在延迟，重启手机后可刷新。
能否只对图片生效，保留文档？
目前一键清理按「过期时间」维度执行，不支持按类型筛选；可手动取消白名单外文件。
桌面端清理时为何需要管理员权限？
Windows 平台下，三覆写擦除需访问系统卷日志，客户端会弹出 UAC 提示，属正常行为。
总结与下一步行动
Letstalk 的「一键清理群组过期文件」把「安全擦除」与「空间释放」合二为一，既符合加密通讯的合规要求，也减轻了日常存储压力。对于日活高、文件多的群，建议立即开启「3 天生命周期 + 每日自动清理」；对于合规严格的场景，仍应优先使用 Vault 外链并配合链上销毁条款。
读完本文，你可按以下顺序行动：① 进入群文件面板执行一次手动清理，观察空间变化；② 导出索引留存；③ 根据群性质调整生命周期；④ 把本文链接置顶到群公告，让成员同步升级客户端，确保功能对齐。完成这四步，你的 Letstalk 群组将长期保持「轻量、合规、易回溯」的理想状态。
