用途：在 iOS Swift 工程中集成 Salesforce Mobile SDK，供编码代理按任务选取自包含的参考文件执行，文件内含精确的源码、路径与命令行。
主要能力与场景：新建 iOS Swift 应用（references/create-new-app.md，无前置条件）；为已有应用接入 SDK 认证（references/add-mobile-sdk.md，需已存在 iOS Swift 应用 target）；接入 SmartStore 加密本地库（references/add-smartstore.md，需已调用 SalesforceManager.initializeSDK() 且存在 bootconfig.plist）；接入 MobileSync 实现 sObject 与 soup 同步（references/add-mobilesync.md，需已调用 SmartStoreSDKManager.initializeSDK() 且存在 userstore.json）；加入生物识别（Face ID / Touch ID）（references/add-biometric-auth.md）；加入深色模式（系统 / 强制 / 用户切换）（references/add-dark-mode.md）。跨场景参考包括 Swift 与 Objective-C 名称映射（NS_SWIFT_NAME，references/api-reference.md）以及构建、登录、SmartStore、生物识别等报错排查（references/troubleshooting.md）。
使用方式：按前置条件链式选择参考文件；需求含糊时按目录检测决定起点——无 Xcode 工程即新建，无 SDK 导入即接认证，无 userstore.json 即接 SmartStore，无 usersyncs.json 即接 MobileSync，未引用 biometricAuthenticationManager() 即接生物识别。工程形态按 Podfile 与 project.yml 组合判定并走对应安装路径；CocoaPods 执行 pod install 后须打开 .xcworkspace 而非 .xcodeproj；project.yml 为唯一事实来源，缺失时不得生成，存在时用 xcodegen generate 落新文件。模拟器构建使用临时签名 CODE_SIGN_IDENTITY=-，切勿使用 CODE_SIGNING_ALLOWED=NO，否则会剥离钥匙串权限并导致登录静默失败。登录主机默认生产用 login.salesforce.com，沙箱用 test.salesforce.com。setupRootViewController() 示例中的占位视图需在冒烟测试通过后替换为真实根视图控制器。
限制：当本技能中的 SDK API 与实际不符时，以 https://github.com/forcedotcom/SalesforceMobileSDK-iOS 的上游 Objective-C 头文件为准，可用 NS_SWIFT_NAME(<name>) 检索解析 Swift 名称。