axiom-apple-docs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Apple Documentation Router

Apple文档路由指南

Apple bundles for-LLM markdown documentation inside Xcode. These are authoritative, up-to-date guides and diagnostics written by Apple engineers. Use them alongside Axiom skills for the most accurate information.

Apple在Xcode中内置了面向大语言模型的Markdown文档。这些是由Apple工程师编写的权威、最新的指南和诊断内容。将它们与Axiom技能结合使用，可获取最准确的信息。

When to Use

使用场景

Use Apple's bundled docs when:

You need the exact API signature or behavior from Apple
Axiom skills reference an Apple framework and you want the official source
A Swift compiler diagnostic needs explanation
The user asks about a specific Apple framework feature

Priority: Axiom skills provide opinionated guidance (decision trees, anti-patterns, pressure scenarios). Apple docs provide authoritative API details. Use both together.

在以下场景下使用Apple内置文档：

你需要Apple官方的精确API签名或行为说明
Axiom技能引用了某个Apple框架，而你需要查看官方来源
需要对Swift编译器诊断信息进行解释
用户询问某个Apple框架的特定功能

优先级说明：Axiom技能提供带有主观判断的指导（如决策树、反模式、压力场景）。Apple文档提供权威的API细节。建议结合两者使用。

Guide Topics (AdditionalDocumentation)

指南主题（附加文档）

Read these with the MCP

axiom_read_skill

tool using the skill name.

使用MCP的

axiom_read_skill

工具，通过技能名称来阅读这些内容。

UI & Design

UI与设计

Topic	Skill Name
Liquid Glass in SwiftUI	`apple-guide-swiftui-implementing-liquid-glass-design`
Liquid Glass in UIKit	`apple-guide-uikit-implementing-liquid-glass-design`
Liquid Glass in AppKit	`apple-guide-appkit-implementing-liquid-glass-design`
Liquid Glass in WidgetKit	`apple-guide-widgetkit-implementing-liquid-glass-design`
SwiftUI toolbar features	`apple-guide-swiftui-new-toolbar-features`
SwiftUI styled text editing	`apple-guide-swiftui-styled-text-editing`
SwiftUI WebKit integration	`apple-guide-swiftui-webkit-integration`
SwiftUI AlarmKit integration	`apple-guide-swiftui-alarmkit-integration`
Swift Charts 3D visualization	`apple-guide-swift-charts-3d-visualization`
Foundation AttributedString	`apple-guide-foundation-attributedstring-updates`

主题	技能名称
SwiftUI中的Liquid Glass	`apple-guide-swiftui-implementing-liquid-glass-design`
UIKit中的Liquid Glass	`apple-guide-uikit-implementing-liquid-glass-design`
AppKit中的Liquid Glass	`apple-guide-appkit-implementing-liquid-glass-design`
WidgetKit中的Liquid Glass	`apple-guide-widgetkit-implementing-liquid-glass-design`
SwiftUI工具栏功能	`apple-guide-swiftui-new-toolbar-features`
SwiftUI样式文本编辑	`apple-guide-swiftui-styled-text-editing`
SwiftUI WebKit集成	`apple-guide-swiftui-webkit-integration`
SwiftUI AlarmKit集成	`apple-guide-swiftui-alarmkit-integration`
Swift Charts 3D可视化	`apple-guide-swift-charts-3d-visualization`
Foundation AttributedString	`apple-guide-foundation-attributedstring-updates`

Data & Persistence

数据与持久化

Topic	Skill Name
SwiftData class inheritance	`apple-guide-swiftdata-class-inheritance`

主题	技能名称
SwiftData类继承	`apple-guide-swiftdata-class-inheritance`

Concurrency & Performance

并发与性能

Topic	Skill Name
Swift concurrency updates	`apple-guide-swift-concurrency-updates`
InlineArray and Span	`apple-guide-swift-inlinearray-span`

主题	技能名称
Swift并发更新	`apple-guide-swift-concurrency-updates`
InlineArray与Span	`apple-guide-swift-inlinearray-span`

Apple Intelligence

Apple智能

Topic	Skill Name
Foundation Models (on-device LLM)	`apple-guide-foundationmodels-using-on-device-llm-in-your-app`

主题	技能名称
Foundation Models（设备端大语言模型）	`apple-guide-foundationmodels-using-on-device-llm-in-your-app`

System Integration

系统集成

Topic	Skill Name
App Intents updates	`apple-guide-appintents-updates`
StoreKit updates	`apple-guide-storekit-updates`
MapKit GeoToolbox	`apple-guide-mapkit-geotoolbox-placedescriptors`
Widgets for visionOS	`apple-guide-widgets-for-visionos`

主题	技能名称
App Intents更新	`apple-guide-appintents-updates`
StoreKit更新	`apple-guide-storekit-updates`
MapKit GeoToolbox	`apple-guide-mapkit-geotoolbox-placedescriptors`
visionOS组件	`apple-guide-widgets-for-visionos`

Accessibility

无障碍功能

Topic	Skill Name
Assistive Access in iOS	`apple-guide-implementing-assistive-access-in-ios`

主题	技能名称
iOS辅助访问实现	`apple-guide-implementing-assistive-access-in-ios`

Computer Vision

计算机视觉

Topic	Skill Name
Visual Intelligence in iOS	`apple-guide-implementing-visual-intelligence-in-ios`

主题	技能名称
iOS视觉智能实现	`apple-guide-implementing-visual-intelligence-in-ios`

Swift Compiler Diagnostics

Swift编译器诊断信息

These explain specific Swift compiler errors and warnings with examples and fixes.

这些内容会结合示例和修复方案，解释特定的Swift编译器错误与警告。

Concurrency Diagnostics

并发相关诊断

Diagnostic	Skill Name
Actor-isolated call from nonisolated context	`apple-diag-actor-isolated-call`
Conformance isolation	`apple-diag-conformance-isolation`
Isolated conformances	`apple-diag-isolated-conformances`
Nonisolated nonsending by default	`apple-diag-nonisolated-nonsending-by-default`
Sendable closure captures	`apple-diag-sendable-closure-captures`
Sendable metatypes	`apple-diag-sendable-metatypes`
Sending closure risks data race	`apple-diag-sending-closure-risks-data-race`
Sending risks data race	`apple-diag-sending-risks-data-race`
Mutable global variable	`apple-diag-mutable-global-variable`
Preconcurrency import	`apple-diag-preconcurrency-import`

诊断内容	技能名称
从非隔离上下文调用Actor隔离方法	`apple-diag-actor-isolated-call`
一致性隔离	`apple-diag-conformance-isolation`
隔离一致性	`apple-diag-isolated-conformances`
默认非隔离非发送	`apple-diag-nonisolated-nonsending-by-default`
Sendable闭包捕获	`apple-diag-sendable-closure-captures`
Sendable元类型	`apple-diag-sendable-metatypes`
发送闭包存在数据竞争风险	`apple-diag-sending-closure-risks-data-race`
发送操作存在数据竞争风险	`apple-diag-sending-risks-data-race`
可变全局变量	`apple-diag-mutable-global-variable`
预并发导入	`apple-diag-preconcurrency-import`

Type System Diagnostics

类型系统诊断

Diagnostic	Skill Name
Existential any	`apple-diag-existential-any`
Existential member access limitations	`apple-diag-existential-member-access-limitations`
Nominal types	`apple-diag-nominal-types`
Multiple inheritance	`apple-diag-multiple-inheritance`
Protocol type non-conformance	`apple-diag-protocol-type-non-conformance`
Opaque type inference	`apple-diag-opaque-type-inference`

诊断内容	技能名称
存在类型any	`apple-diag-existential-any`
存在类型成员访问限制	`apple-diag-existential-member-access-limitations`
标称类型	`apple-diag-nominal-types`
多重继承	`apple-diag-multiple-inheritance`
协议类型不一致	`apple-diag-protocol-type-non-conformance`
不透明类型推断	`apple-diag-opaque-type-inference`

Build & Migration Diagnostics

构建与迁移诊断

Diagnostic	Skill Name
Deprecated declaration	`apple-diag-deprecated-declaration`
Error in future Swift version	`apple-diag-error-in-future-swift-version`
Strict language features	`apple-diag-strict-language-features`
Strict memory safety	`apple-diag-strict-memory-safety`
Implementation only deprecated	`apple-diag-implementation-only-deprecated`
Member import visibility	`apple-diag-member-import-visibility`
Missing module on known paths	`apple-diag-missing-module-on-known-paths`
Clang declaration import	`apple-diag-clang-declaration-import`
Availability unrecognized name	`apple-diag-availability-unrecognized-name`
Unknown warning group	`apple-diag-unknown-warning-group`

诊断内容	技能名称
已废弃声明	`apple-diag-deprecated-declaration`
未来Swift版本中的错误	`apple-diag-error-in-future-swift-version`
严格语言特性	`apple-diag-strict-language-features`
严格内存安全	`apple-diag-strict-memory-safety`
仅实现已废弃	`apple-diag-implementation-only-deprecated`
成员导入可见性	`apple-diag-member-import-visibility`
已知路径上缺少模块	`apple-diag-missing-module-on-known-paths`
Clang声明导入	`apple-diag-clang-declaration-import`
可用性未识别名称	`apple-diag-availability-unrecognized-name`
未知警告组	`apple-diag-unknown-warning-group`

Swift Language Diagnostics

Swift语言诊断

Diagnostic	Skill Name
Dynamic callable requirements	`apple-diag-dynamic-callable-requirements`
Property wrapper requirements	`apple-diag-property-wrapper-requirements`
Result builder methods	`apple-diag-result-builder-methods`
String interpolation conformance	`apple-diag-string-interpolation-conformance`
Trailing closure matching	`apple-diag-trailing-closure-matching`
Temporary pointers	`apple-diag-temporary-pointers`

诊断内容	技能名称
动态可调用要求	`apple-diag-dynamic-callable-requirements`
属性包装器要求	`apple-diag-property-wrapper-requirements`
结果构建器方法	`apple-diag-result-builder-methods`
字符串插值一致性	`apple-diag-string-interpolation-conformance`
尾随闭包匹配	`apple-diag-trailing-closure-matching`
临时指针	`apple-diag-temporary-pointers`

Routing Decision Tree

路由决策树

User question about Apple API/framework?
├── Specific compiler error/warning → Read matching apple-diag-* skill
├── Liquid Glass implementation → Read apple-guide-*-liquid-glass-design (SwiftUI/UIKit/AppKit)
├── Swift concurrency patterns → Read apple-guide-swift-concurrency-updates
├── Foundation Models / on-device AI → Read apple-guide-foundationmodels-*
├── SwiftData features → Read apple-guide-swiftdata-*
├── StoreKit / IAP → Read apple-guide-storekit-updates
├── App Intents / Siri → Read apple-guide-appintents-updates
├── Charts / visualization → Read apple-guide-swift-charts-3d-visualization
├── Text editing / AttributedString → Read apple-guide-swiftui-styled-text-editing or apple-guide-foundation-attributedstring-updates
├── WebKit in SwiftUI → Read apple-guide-swiftui-webkit-integration
├── Toolbar features → Read apple-guide-swiftui-new-toolbar-features
└── Other → Search with axiom_search_skills using source filter "apple"

用户的问题是否涉及Apple API/框架？
├── 特定编译器错误/警告 → 阅读对应的apple-diag-*技能
├── Liquid Glass实现 → 阅读apple-guide-*-liquid-glass-design（SwiftUI/UIKit/AppKit）
├── Swift并发模式 → 阅读apple-guide-swift-concurrency-updates
├── Foundation Models / 设备端AI → 阅读apple-guide-foundationmodels-*
├── SwiftData功能 → 阅读apple-guide-swiftdata-*
├── StoreKit / 内购 → 阅读apple-guide-storekit-updates
├── App Intents / Siri → 阅读apple-guide-appintents-updates
├── 图表/可视化 → 阅读apple-guide-swift-charts-3d-visualization
├── 文本编辑 / AttributedString → 阅读apple-guide-swiftui-styled-text-editing或apple-guide-foundation-attributedstring-updates
├── SwiftUI中的WebKit → 阅读apple-guide-swiftui-webkit-integration
├── 工具栏功能 → 阅读apple-guide-swiftui-new-toolbar-features
└── 其他情况 → 使用axiom_search_skills工具并设置源过滤器为"apple"进行搜索

Resources

资源

Skills: axiom-ios-ui, axiom-ios-concurrency, axiom-ios-data, axiom-ios-ai, axiom-ios-integration

相关技能：axiom-ios-ui, axiom-ios-concurrency, axiom-ios-data, axiom-ios-ai, axiom-ios-integration