大型 AI 模型下载前的存储预检查

直接回答

模型下载的存储预检查，应根据即将执行的具体操作估算空间，再与目标存储卷当前测量值比较。不要设置一个适用于所有手机的“剩余空间超过 X GB”规则，也不要把模型参数量乘以精度位数伪装成安装大小。一次下载可能同时存在部分文件、完整候选文件、必须保留的活动模型、缓存和用户创作数据。预检查要说明预算包含哪些字节，同时为经过测试的恢复路径留出空间。 先确认工件身份及其测量或配置长度。配置长度代表特定清单或代码快照，不等于所有发行版本的实测大小。如果数值缺失、过期或被标记为占位，就不能将其转化为精确的存储承诺。还要确认更新策略：是保留旧模型并写入独立候选、直接覆盖文件，还是使用经过测试的其他流程。如果通过候选切换来保障旧模型可用，一般需要同时容纳旧文件和新文件。只有当前操作确实保留部分下载时才将其计入；缓存和派生文件也应按真实流程计算。 API 的含义要与决策一致。Android 文档说明 StorageManager.getAllocatableBytes() 适合判断应用是否可以开始分配空间，因为系统可能回收缓存以满足请求。面向用户展示的可用空间是另一种用途。StatFs.getAvailableBytes() 描述某个文件系统上应用可用的字节数，但它并不构成预留；查询之后空间可能继续变化。这些数值都不能保证长时间下载一定完成，因此应在必要阶段复查，并能处理预检查之后的分配失败。 让预算明了且可追溯。对于每个文件，注明数量是精确值、实测值、清单期望值还是保守余量。目标卷的 UUID 或路径也要与应用总体存储区分。如果某些缓存可以回收，应与用户数据和活动模型分开说明；不得偷偷删除对话历史或照片来腾出空间。如果系统只有回收缓存才能提供足够可分配空间，就如实说明这一边界，让系统按自身规则管理缓存，而不是冒充应用已经清理过内容。 预检查本身是一个用户决策，而不仅是一个布尔判断。如果估算需求高于可分配空间，不应启动一个很可能无法完成的下载。可提供明确选项：取消、稍后、在产品支持时选择其他工件或目标目录、通过单独的用户授权流程移除指定模型，或打开系统存储管理。更新如果要同时保留旧模型，应说明临时空间需求。若用户在未知情况下仍要继续，应记录该选择，但不能绕过写入失败，也不能把部分候选标为就绪。 检查结果必须对应当前工件与操作。它不是设备兼容评级、最低 RAM 建议、总安装大小保证或通用模型要求。应记录模型版本、大小来源、目标卷、测得的可用量、预算项、测试设备与存储条件及执行结果。存储发生变化后或再次更新前应重新评估。这样支持和 QA 才能重现具体决定，同时不宣称所有手机表现相同。

不移除当前可用模型而更新

候选模型下载时旧模型仍需服务任务，临时字节和用户历史也占用同一设备。只按最终文件大小预算不足。

决策

按真实更新策略核算同时存在的文件，查询目标卷，并在证据不足时暂缓或提供经用户同意的可撤销选择。

预期结果

只有预算可支持时才开始，并保护用户数据；预检查之后若空间下降，也能安全恢复。

需要收集的证据

只有将以下证据与同一模型文件和测试运行关联起来，结论才可复核：

• 事实卡 COVE-DOWNLOAD-01、COVE-MODEL-01；Cove 下载器存储预检查和特定模型配置长度。
• Android StorageManager 与 StatFs API 对可分配字节和文件系统空间的定义。

收到完整字节流还不够；最终落盘、完整性、运行时加载和恢复路径也必须验证。

实施流程

1. 固定工件身份. 从本次实际使用的清单或配置读取准确版本与期望长度。若值缺失、过期或是占位，就明确标未知，不通过参数量推算精确空间需求。
2. 梳理并存文件. 列出活动模型、候选文件、部分下载、校验副本、缓存、数据库与用户文件。只把所选安装或更新算法实际可能同时拥有的项目纳入预算。
3. 查询目标存储卷. 用与决策匹配的 Android API：分配前判断查询可分配空间，用户展示另用标注清楚的可用空间估计。记录卷和时间，因为空间会变化。
4. 记录预算口径. 分别说明精确、清单期望、实测和安全余量的来源，解释缓存可回收条件与余量依据。不要把预算余量说成手机兼容阈值。
5. 提供可撤销选项. 空间不足或证据不明确时提供取消、稍后、系统存储设置或支持的工件选项。不得自动移除用户数据，也不应先删除当前可用模型。
6. 验证之后的写入失败. 在下载、最终写入、校验和提升各阶段注入空间不足，确认原模型仍可工作，候选文件能按测试过的流程恢复或在同意后清理。

让每个阶段的状态都可观察。失败信息应指出阶段、模型、运行时和恢复动作，同时避免记录用户私密内容。

验收标准

• 每次空间估算对应一个工件版本、一个目标卷和实际并存文件方案。
• 配置中的期望长度不会被称为本机测得的安装空间、内存要求或通用设备门槛。
• 空间不足不触发静默用户数据删除，也不将部分文件提升为活动模型。
• 预检查之后仍可处理空间变化和写入错误，检查结果不被说成容量保证。

决策对照表

需要避免的失败模式

• 不采用未验证的普适 GB 阈值或由参数量计算所谓安装大小。
• 不为模型腾空间而自动删除用户对话、媒体或唯一可用模型。

还要避免静默回退、版本未固定、缺少取消处理，以及把不同配置的结果混在一起下结论。失败运行也应与成功记录一并保存。

最小复现记录

发布检查表

• ☐ 主要搜索问题已回答，且没有未经支持的数字。
• ☐ 所有模型文件和运行时版本均已固定。
• ☐ 代表性任务和失败处理策略均有说明。
• ☐ 生命周期、取消、清理和回退均已测试。
• ☐ 用户内容与网络边界均有说明。
• ☐ 结论只适用于被记录的配置。
• ☐ 新增测试结果时链接到原始方法或证据。

来源与相关证据

• Cove Gemma 4 model page
• Android StorageManager API
• Android StatFs API

中文部署与排错专题见。奇连 AI 端侧专题。

常见问题