SuperAPI AI 工具集

swift-focusengine-pro

通用与其它

查看项目

更新于 10-16 09:32

技能介绍

该技能用于审查、编写和修复 Apple 各平台的焦点(focus)管理代码,检查正确性、现代 API 用法与 Apple 焦点引擎规则,只报告真实问题,不挑刺或编造问题。

主要能力:按平台加载对应参考资料后检查关键反模式(references/anti-patterns.md)、焦点样式与视觉反馈(focus-styling.md)、焦点恢复与数据重载(focus-restoration.md)、布局中的焦点分区隔离(layout-patterns.md)、异步与数据加载焦点模式(async-focus.md)、无障碍集成(accessibility-focus.md)以及调试与测试实践(debugging.md)。tvOS 使用 swiftui-focus.md、uikit-focus.md;iOS/iPadOS 使用 ios-focus.md;watchOS 使用 watchos-focus.md;visionOS 使用 visionos-focus.md、realitykit-focus.md;macOS 使用 macos-focus.md;跨平台时加载全部相关参考。

使用方式:确定目标平台并加载相应参考文件后逐项检查;做局部审查时只加载相关文件。输出按文件组织,说明文件与行号、违反的规则,并给出简短的修复前后代码对比,跳过无问题的文件,最后给出按优先级排序的改进摘要。

关键规则示例:tvOS 焦点移动是几何式的,路径中无元素时焦点不移动,需用 .focusSection() 或 UIFocusGuide 桥接;不要用 .disabled() 切换可交互性;prefersDefaultFocus(_:in:) 在 tvOS 的 ScrollView 内无效。iOS/iPadOS 焦点为次要交互模型,需连接硬件键盘才激活,两层级焦点组模型不存在于 tvOS。watchOS 焦点是顺序式的,.focusable() 必须在 .digitalCrownRotation() 之前。visionOS 视线注视属于 hover 而非 focus,onHover(perform:) 不由视线触发。macOS 使用 key view loop,自定义 NSView 需重写 acceptsFirstResponder。

限制:资料未提供安装命令、收费方式或价格信息。工具链状态基于 Xcode 27 beta(2026 年 8 月)的说明;实际使用需以官方最新文档为准。