用途:在 iOS 26+ 上实现、审查和扩展 App Intents,把 App 功能暴露给 Siri、快捷指令、Spotlight、小组件、控制中心和 Apple Intelligence。
主要能力:按“选择动作与目标界面→定义数据模型→实现 intent→验证”的流程推进。核心协议为 AppIntent,系统通过 init() 实例化、设置参数后调用 perform() async throws -> some IntentResult;用 @Parameter 声明用户输入,支持基本类型、集合、IntentPerson、IntentFile 及自定义 AppEntity/AppEnum。AppEntity 建议用影子模型,需提供 id、defaultQuery、displayRepresentation、typeDisplayRepresentation,并用 @Property 暴露可筛选属性。EntityQuery 有四种变体:基础按 ID 解析、EntityStringQuery 自由文本搜索、EnumerableEntityQuery 有限集合、UniqueAppEntityQuery 单例(iOS 18+)。AppEnum 定义固定选项,建议用 String 原始值。AppShortcutsProvider 注册免配置快捷指令,短语必须包含 (.applicationName)。
系统界面:Siri/快捷指令用 AppIntent(iOS 16),可配置小组件用 WidgetConfigurationIntent(iOS 17),控制中心用 ControlConfigurationIntent(iOS 18),Spotlight 用 IndexedEntity(iOS 18),Apple Intelligence 用 @AppIntent(schema:)(iOS 18),交互式片段用 SnippetIntent(iOS 26),视觉智能用 IntentValueQuery(iOS 26)。
限制与注意:可选 @Parameter 不会自动询问,需自行 requestValue;entities(for:) 应省略缺失实体而非抛错;短语缺 (.applicationName) 会失败;避免用已弃用的 @Assistant* 宏;SnippetIntent.perform() 须无副作用;敏感操作需确认或认证;视觉智能查询不要做相机采集、Vision 请求或 Spotlight 索引,应调用已有有界搜索服务并限制结果数量。具体收费、价格与平台支持范围资料未提供。