模型交付

准确报告本地 AI 模型的存储占用

存储报告应盘点当前真实文件与应用数据,分别列出活动模型、可选变体、部分下载、缓存、数据库索引和用户内容。不得把模型参数或清单预计下载大小写成本机当前占用。

审核状态: 内容已校验;中文稿供用户审核 · 2026-10-05 · Fact IDs: COVE-MODEL-01, COVE-DOWNLOAD-01

直接回答

本地 AI 存储报告应列出设备上实际观察到的文件与应用自有数据,而不是复述参数量或清单中的预计下载大小。应根据所有权和生命周期分类:活动模型工件、可选已安装变体、正在下载或可恢复的传输、可重新生成的缓存、数据库与索引,以及用户创建的内容。只有应用能够识别和测量底层数据时才展示数值。未知或无法访问的项目不能等同于零;同时要说明哪些项目可以删除而不会影响用户工作。 这类报告与下载前的空间检查不同。预检查估算某一次操作能不能开始;报告则说明现在是什么占据了存储卷。对于应用控制的文件,应从文件系统实际观察;要展示系统级汇总时可使用 Android 文档定义的平台存储 API。尚未下载的远程工件不能把预计大小加到当前已安装总量里。模型权重大小也不能代表内存或最终磁盘占用,因为包内压缩、临时副本、运行时缓存与应用数据是不同类别。 每个存储对象都应有所有者和生命周期状态。模型文件可能是活动版本、待切换候选、部分下载、隔离文件或旧版本。缓存可能可以重建。对话数据库、导入文档或导出的结果属于用户,不应因为位于同一个应用沙箱就叫作“模型缓存”。记录文件位于哪个卷,也便于说明可移除存储暂时缺失时的状态。如果权限被撤销或卷不可用,应用无法测量某个文件,就显示“当前不可用”或“未知”,而不是当作零或声称已删除。 测量口径必须谨慎。Android StorageStatsManager 可以按其定义返回应用或包级空间摘要;文件清点可以对应用拥有的工件长度求和。不同 API 对缓存的纳入范围可能不同;应标注统计范围,避免把重叠的包级数值再加一次。传输进行中或缓存回收后,某个时间点的报告可能迅速过期,因此应显示测量时间,在下载完成或清理之后刷新,并区分实际分配文件长度与系统可回收缓存。 清理是另一个决策,不能自动从报告中推断。只有产品实现并测试过时,才按类别提供删除操作,例如移除明确未活动的模型变体或可重新生成缓存。应说明操作影响活动工件、部分下载、本地索引还是用户内容。删除范围要明确,优先提供可撤销的暂存删除或确认具体数据,不能用“清理模型空间”按钮擦除对话或用户文件。完成后要重新扫描真实文件,而不是从上一次数值中减去某个配置预计大小。 诚实的报告还可以说明哪些成本未计入。运行时可能分配内存缓冲,更新期间可能同时保留旧模型与新候选,应用包也可能包含原生库。如果页面只统计模型文件字节,应明确其范围。不能从一个目录推断峰值 RAM、应用全部占用或清理后肯定能释放的空间。若应用不能安全判定某些文件的类别,就显示已归类的小计和未知余量,不要拼出虚假的完整总数。

查看安装及清理变体后的存储情况

用户保留一个活动工件、尝试下载过其他变体、取消过一次传输,也保存了历史记录,因此需要区分用户数据和可清理字节。

决策

盘点当前应用自有文件,明确每类所有权和存储卷,只提供经过测试且范围明确的清理操作。

预期结果

报告呈现实测存储,不混淆预计下载大小、运行内存、缓存和用户内容。

需要收集的证据

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

  • 事实卡 COVE-MODEL-01、COVE-DOWNLOAD-01;实际模型文件长度和下载阶段。
  • Android StorageStatsManager 与应用专属存储文档。

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

实施流程

  1. 清点应用自有位置. 列出活动模型、候选及部分文件、变体目录、可重建缓存、数据库、索引和用户媒体,并记录每类的位置及所有权。
  2. 从匹配来源测量. 对应用控制文件读取真实长度;包级摘要使用官方定义的平台 API。说明是否包括缓存,并避免重叠统计值重复求和。
  3. 标注生命周期与删除条件. 区分活动、候选、部分、隔离、过期、可重建及用户文件。每种类型都要有测试过的处理路径,不能把沙箱中的所有内容叫缓存。
  4. 诚实表示不可测数据. 权限撤销、卷不在场或归属不明时显示未知,不能显示零或声称已删;保留测量时刻并在状态变化后更新。
  5. 分离占用与推理指标. 仅把实测磁盘数据列为存储占用,不能由某个模型目录大小推测 RAM、速度或机型可用性。
  6. 执行清理回归. 测试移除一个明确类别后重新清点磁盘,确认活动模型和用户数据仍在;如果允许取消清理,也覆盖中断与恢复,并记录清理前后差值。

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

验收标准

  • 活动模型、可选变体、部分下载、缓存、索引数据库和用户内容单独呈现。
  • 所有数字均为实测或说明清楚的系统统计,并附测量时间;清单预估不冒充已安装使用量。
  • 无法访问或归属不明的数据显示未知,不把重叠汇总重复相加。
  • 清理操作说明删除范围,不能静默删除用户文件或当前唯一活动工件。

决策对照表

维度选择或证据解读方式
下载大小说明回答特定远程模型预计有多大。使用清单/配置值并标记为预计。
空间预检查回答本次安装或更新能否开始。基于目标卷的空间和本次并存文件预算。
存储报告回答设备当前有哪些应用数据。基于实际文件盘点和定义明确的系统汇总。

需要避免的失败模式

  • 不把预计下载大小当成本机磁盘统计,也不把磁盘字节数解释成运行内存。
  • 不能将对话、导出和活动模型统称为可删除缓存。

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

最小复现记录

层级记录内容
设备厂商、型号、芯片、内存档位、操作系统版本
软件应用版本和 Git 提交号
模型系列、变体、版本、格式、文件长度、摘要、量化方式
运行时名称、版本、请求后端及实际后端证据
工作负载样例版本、输入摘要、提示词摘要、输出策略
结果完成、失败、取消、回退及保护隐私的诊断信息

发布检查表

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

来源与相关证据

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

常见问题

参数数量能推算当前磁盘实际占用吗?

不能。参数量不是文件长度,打包、元数据、副本和缓存都会影响磁盘。应测量实际工件并标注类别,不能让模型规格估算冒充设备实测。

无法访问的文件类别可报告为零吗?

不可以。权限被撤销或卷缺失表示当前无法测量。应显示不可用,待访问恢复后再刷新;不能把无法读取说成文件已删除或空间已释放。

模型缓存是否都可以删除?

只有确认可重建并测试了删除和恢复之后才可以。活动工件、部分下载、用户索引、对话和导出应分别归属并获得确认,清理范围须向用户说明。