SuperAPI AI 工具集

axiom-core-spotlight-ref

前端与建站

查看项目

更新于 10-16 06:46

技能介绍

用途:本技能用于在 Apple 平台上让应用内容可被 Spotlight 搜索发现,并支持 Siri 预测与 Handoff。核心区分是:Core Spotlight(CSSearchableItem)用于索引全部应用内容;NSUserActivity 用于标记用户当前活动,以支持预测与 Handoff。

主要能力:创建 CSSearchableItem 并配置 CSSearchableItemAttributeSet 元数据(title、displayName、contentDescription、keywords、thumbnailData、日期、评分、经纬度,以及文档与消息专用属性);用 uniqueIdentifier 做稳定标识、domainIdentifier 分组;批量索引(建议每次 100–500 条);按标识、按域或全部删除;通过 CSSearchableItem(appEntity:) 与 App Intents 的 IndexedEntity 集成,或用 associateAppEntity 关联实体。NSUserActivity 侧可设置 isEligibleForSearch、isEligibleForPrediction、isEligibleForHandoff、isEligibleForPublicIndexing,配合 persistentIdentifier、contentAttributeSet、appEntityIdentifier,并用 becomeCurrent()/resignCurrent() 管理当前活动。

使用方式:索引时构造属性集与条目后调用 CSSearchableIndex.default().indexSearchableItems;删除用 deleteSearchableItems(withIdentifiers:)、deleteSearchableItems(withDomainIdentifiers:)、deleteAllSearchableItems。处理 Spotlight 点击时,在 UIKit 的 continue userActivity 或 SwiftUI 的 onContinueUserActivity 中读取 persistentIdentifier 或 CSSearchableItemActivityIdentifier 进行导航。NSUserActivity 需保持强引用,否则不会出现在搜索中。

适用场景:为文档、笔记、订单、消息等建立可搜索索引;实现跨设备 Handoff;让 Siri 预测并建议返回某界面;从 Spotlight 结果继续活动;与 App Intents 实体联动。

限制与注意:NSUserActivity 适合用户当前可见界面,不应作为通用索引机制;isEligibleForPublicIndexing 仅用于公开可访问内容。App Shortcuts、App Intents 基础与整体可发现性策略不在本技能范围。资料中未提供具体收费、价格与平台版本之外的细节。