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