Apple Foundation Models:可用性必须在运行时核验

Apple 将 SystemLanguageModel 描述为端侧文本模型;设备资格、地区、Apple Intelligence 设置、模型就绪状态、语种及 OS 更新都会影响实际会话。

最后校验: 2026 年 9 月
参数量未公开
量化后大小未公开
上下文长度未公开
模态text
许可证apple-proprietary
最低 RAM未公开
版本SystemLanguageModel (OS-managed)
发布2025-09

框架资料描述了什么

Apple 将 SystemLanguageModel 描述为 Apple Intelligence 使用的端侧文本基础模型。SystemLanguageModel 官方参考指出,可用性取决于设备和地区是否支持 Apple Intelligence;在使用前,应用应检查模型状态。该框架还提供模型变体、上下文大小、支持语言、Locale 检查以及 token 计数等运行时接口。

这些是面向运行时的 API,不是对所有硬件的通用保证。SDK 里能导入某个类型、项目能够编译,或旧文章列出一组设备,都不能证明用户当前的模型会话已经就绪。Apple 的文档区分了设备不符合资格、模型尚未准备好以及其他不可用状态。应用需要对每一种状态准备清晰的反馈和替代路径。

另一个重要边界是:Apple 的系统模型会随操作系统版本更新。Foundation Models 更新说明提醒开发者,系统模型可能随 OS 版本变化,提示词需要重新测试。当前框架参考记录了与不同系统范围相对应的模型版本。因此,研究报告中某个旧模型的参数量,不一定是以后每个用户当前模型的稳定规格。框架提供 contextSize 和 tokenCount(for:),应用可读取当前运行时的重要信息,而不必硬编码一个可能过时的数字。

声明类型官方文档能支持什么仍需运行时或产品测试什么
模型位置Apple 把 SystemLanguageModel 定义为 Apple Intelligence 的端侧文本模型。具体应用请求选中了哪条路径,以及是否使用其他服务端能力。
可用资格设备与地区影响可用状态,API 会返回运行时状态。用户当下的设备、设置和模型是否已准备好执行任务。
语言框架提供支持语言列表和 supportsLocale(_:) 检查。应用的真实提示、方言和预期输出能否完成。
上下文运行时提供 contextSize 和 tokenCount(for:)。应用整条请求和输出流程能否在其工作流中接受并完成。
模型版本Apple 会随 OS 更新系统模型。用户更新系统后,应用提示词和结果是否仍符合验收标准。

Mac 应用场景:总结一段私人笔记

假设 macOS 应用为用户选中的笔记提供端侧摘要。开发者在自己的机器上构建成功,希望承诺笔记内容不会被发往服务器。这不仅要看构建结果:用户的 Apple Intelligence 设置、地区、语言、系统模型版本以及请求实际走的路径都会影响体验。

  1. 记录测试环境。 保存 Mac 型号类别、macOS 版本、应用版本、地区和语言设置、Xcode/SDK。由于 OS 更新可能改变系统模型,结果应绑定具体版本。不要从一台开发机推广到所有 Mac。
  2. 在应用运行时检查可用性。 在显示功能可用前,读取 SystemLanguageModel.default.availability,处理文档列出的不可用原因。设备不合资格、用户未启用 Apple Intelligence、模型尚未就绪,是不同情况。保持用户可见状态,并说明下一步可以做什么。
  3. 核对语种和 token 预算。 使用 supportedLanguages 或 supportsLocale(_:) 检查任务要求的 Locale。通过 tokenCount(for:) 观察提示和会话文本长度,并查询当前 contextSize。这样可以避免把界面语言等同于模型能力。
  4. 用隐私安全的固定任务测试。 用合成笔记和经复核的摘要参照测试。覆盖姓名、日期、否定和短篇多段文本,固定提示词、输出要求和评价标准。按任务要求检查摘要,不要根据一次开放式演示就笼统宣称“模型可用”。
  5. 覆盖不可用和中断状态。 在 Apple Intelligence 关闭、Locale 不支持、模型未就绪、输入过长、任务取消和应用重启时重复测试。记录应用是提供重试、建议缩短文本还是切换到另一条路径。隐藏回退会改变隐私与行为承诺。
  6. 单独验证请求路径和数据边界。 如果产品承诺本地处理,就核实该请求是否选择了端侧 SystemLanguageModel 路径;也要检查其他功能、统计 SDK、备份、崩溃报告或明确的 Private Cloud Compute 路径是否会传输数据。一个成功的 Foundation Models 调用无法审计整款应用的联网行为。
  7. 在系统模型更新后复测。 Apple 的更新说明指出系统模型可能随 OS 版本变化。更新后用同一提示和验收样本重跑,核对 token 计数、输出格式、拒答表现;如果要测耗时,也要先定义测量方法并保存原始数据。不要为了遮盖变化而悄悄改提示词。

发布有限且准确的范围声明

对应用团队来说,有用的支持声明应描述实现机制:应用会运行时检查 SystemLanguageModel 可用性、Locale 支持和模型就绪状态。若要公开设备清单,应根据 Apple 当前资格说明并在对应系统范围实际验证。不能只凭“Apple 芯片”、某个芯片家族、框架可以导入,或旧系统的文章来推广可用范围。

上下文和参数规格也一样。Apple 的开发者 API 可提供当前上下文大小,而研究论文描述的是特定代际和配置,两类证据不能混为一谈。若应用对提示长度设了上限,应说明这个数来自当前运行时还是固定假设。输入太长时,应验证截断行为或让用户缩短内容的路径,而不是保证所有文件都能塞进模型。

本文没有声称 Cove 使用 Apple Foundation Models,也没有宣布 Cove App 已支持 Apple 平台。这里讨论的是 Apple 公开框架边界和验证方法。Mac 地区、语言与本地执行检查可继续看 Apple Foundation Models on macOS 指南;跨模型信息见端侧模型目录。未实测的设备与质量结论应标为未知。

常见问题

Apple Foundation Models 是端侧模型吗?

Apple 把 SystemLanguageModel 描述为端侧文本模型。Foundation Models 也涉及 Private Cloud Compute 等服务端能力,因此应用应记录实际选择的路径,不能假设与框架有关的每个请求都在本地。

所有 Mac 都能使用 Apple Foundation Models 吗?

不能默认如此。Apple 说明设备和地区会影响 Apple Intelligence 资格,模型也可能尚未准备好。应用应在会话期间检查可用状态。构建成功只证明代码通过编译,不证明具体用户当前能使用模型。

Apple 是否为当前所有系统模型固定公布上下文?

框架提供运行时 contextSize 和 token 计数接口。系统模型会随 OS 更新而变化,应用应查询当前运行时并测试自己的提示词,而不是把旧研究报告数字当成永久规格。

怎样核对语言支持?

读取当前支持语言集合,或对实际 Locale 调用 supportsLocale(_:),然后测试真实提示和预期输出。Locale 检查不等于对所有任务或方言的质量保证。

请求成功是否能证明数据永不发送到服务器?

不能。它最多说明记录到的某次请求用了哪条模型路径,不能审计统计分析、备份、崩溃日志、其他应用功能或之后的网络回退。完整应用的数据流要另行核查。

编辑状态:英文指南于 2026-09-24 根据 Apple Developer 官方文档改写。中文版完整提供,待站长进行中文母语复核。

常见问题

Apple Foundation Models 是端侧模型吗?

Apple 将 SystemLanguageModel 描述为 Apple Intelligence 使用的端侧文本基础模型。框架文档也涉及 Private Cloud Compute 等服务端选项,因此应用应记录实际选择的请求路径,并核对运行时状态,不能仅凭框架名称推断每个请求都在设备上完成。

所有 Mac 都能使用 Foundation Models 吗?

不能这样假设。Apple 说明可用性取决于设备和地区是否支持 Apple Intelligence,模型也可能尚未就绪。应用应在运行时读取 SystemLanguageModel.availability 并处理不可用状态。项目能编译、SDK 含有框架或旧设备名单,都不能证明当前用户的 Mac 此刻能执行某项任务。

Apple 是否为当前每个系统模型固定公布上下文长度和参数量?

Foundation Models 当前框架提供 contextSize 和 tokenCount(for:) 供应用读取运行时信息。Apple 也曾在研究报告中发布特定代际模型的参数信息,但系统模型会随 OS 更新而变化;旧报告中的参数量不应被当成所有设备上的永久规格。

如何检查提示词的语言是否受支持?

读取当前的 SystemLanguageModel.supportedLanguages,或针对实际 Locale 调用 supportsLocale(_:) 并记录系统版本。这个检查会考虑语言回退,但不证明模型能在每种任务或方言上达到某个质量水平;仍需使用应用真实提示词进行验证。

请求成功是否能证明数据永不离开设备?

只有记录了实际请求路径,成功结果才能说明该次请求走了哪个模型路径;它本身不能审计分析统计、备份、崩溃日志、网络回退或其他应用服务。做隐私声明前还要检查完整的数据流。

引用源