必须完成xcode环境下的三重适配：插件版本对齐、语言分析开关激活、项目级上下文注入；需确保xcode 15.4+与标有“swift 6.0 runtime support”的codebuddy插件匹配，启用swiftui/uikit上下文感知，并通过rag注入私有api文档、依赖声明及sdk版本信息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Swift项目中让CodeBuddy真正理解iOS工程结构、正确补全@State变量、识别Combine操作符、响应SwiftUI视图链，必须完成Xcode环境下的三重适配：插件版本对齐、语言分析开关激活、项目级上下文注入。只装插件不配置，补全会卡在基础语法层，无法识别你项目里自定义的TUIRoomManager或Package.swift声明的依赖。
确认Xcode与CodeBuddy插件版本严格匹配
低版本插件无法解析Swift 6.0新增的actor隔离规则和宏展开逻辑，会导致guard let补全缺失、@main入口推导失败。Xcode 15.4+是硬性门槛。
第一步：打开Xcode → About Xcode，记下版本号（例如15.4.1）。
第二步：访问CodeBuddy官网插件下载页，筛选标有“Xcode 15.4+”且注明“Swift 6.0 Runtime Support”的插件包——【未标注此标签的插件即使能安装，也会在Swift 6.0项目中跳过AST深度解析】。
第三步：若当前插件无对应标签，卸载后从官网下载新包；双击安装时勾选“Replace existing installation”，避免残留旧引擎干扰。
启用Swift专属上下文感知模块
默认状态下CodeBuddy把Swift文件当通用文本处理，不会加载UIKit头文件符号表，也不会追踪Swift Package Manager的target依赖图。这一步必须手动开启。
方法一：在已打开的Swift项目中，点击顶部菜单CodeBuddy → Settings → Language Specific → Swift & iOS Development。
勾选“Enable SwiftUI/UIKit Context Awareness”——它会让CodeBuddy主动读取Info.plist中的UIBackgroundModes字段，并据此提示后台音频权限相关API。
勾选“Parse Swift Packages for Cross-File Completion”——否则在ContentView.swift里输入TUIRoomManager.时，不会显示Package.swift中声明的public API。
点击Apply and Restart Language Server，等待状态栏出现绿色对勾和“Swift context index rebuilt (100%)”，【此时关闭Xcode再重开，否则索引不生效】。
注入项目级RAG知识库提升私有API识别率
当你的项目引用了内部封装的Swift框架（如TXLiteAVSDK的Swift封装层）或自定义DSL时，通用模型根本没见过这些类型名。RAG注入是唯一能让CodeBuddy补全TUIRoomManager.startCamera()这类调用的方式。
第一步：在项目根目录创建路径 .codebuddy/rag/swift-ios（注意开头是点号，为隐藏目录）。
第二步：将以下三类内容整理成Markdown文件存入该目录：
• 所有公开Swift接口的文档注释（/// 开头的完整段落）
• Package.swift中dependencies块的原始声明
• Podfile.lock里腾讯云IM SDK、TUICallKit等iOS组件的具体版本号及git commit hash
第三步：在Xcode中任意.swift文件内右键 → “Reload RAG Context”，看到状态栏弹出“RAG loaded: 3 sources, 127 symbols”即表示注入成功。
