SwiftUI 无原生 XML 上传组件，需桥接原生文件选择器（iOS 用 UIDocumentPickerViewController、macOS 用 NSOpenPanel），读取 Data 后手写 multipart/form-data 请求上传；关键在权限处理、边界格式与服务端字段名匹配。
SwiftUI 本身不提供直接上传 XML 文件的 UI 组件或网络能力，所谓“原生 XML 上传界面”，实际是组合 FileDocument + UIDocumentPickerViewController（iOS）或 OpenPanel（macOS）+ URLSession.uploadTask 的过程。关键不在“XML”本身，而在于如何选文件、读取内容、构造请求体并发送。
如何用 SwiftUI 触发系统文件选择器选中 XML 文件
iOS 和 macOS 的文件选择机制不同，不能只靠 FileImporter —— 它默认只支持文本/图片等有限类型，且无法指定 .xml 后缀白名单。必须桥接到原生视图控制器。
- iOS：用
UIViewControllerRepresentable包装UIDocumentPickerViewController，设置documentTypes为["public.xml"]或["com.apple.xml"]（后者更稳妥） - macOS：用
NSViewControllerRepresentable包装NSOpenPanel，设置allowedFileTypes = ["xml"] - 务必检查
UTType是否可用：iOS 14+ 推荐用UTType.xml，但需在Info.plist中声明UTImportedTypeDeclarations，否则 picker 可能过滤掉用户手动重命名的.xml文件
选中后如何安全读取 XML 内容并验证格式
不要假设用户选的一定是良构 XML；直接调用 String(contentsOf:) 可能因编码问题崩溃。应优先用 Data 加载，再尝试解析。
创建全面的交接文档，使新AI代理能够无缝继续工作，消除歧义。解决上下文耗尽问题。 时机：(1)用户请求保存交接，(2)上下文即将满，(3)主要任务完成，(4)会话结束，(5)恢复工作时。 关键词：保存状态、创建交接、上下文已满、暂停、从...恢复、加载交接、保存进度、会话转移、交接
- 用
try? Data(contentsOf: url)读取原始字节，避免字符串编码争议 - 若需校验格式，用
XMLParser（SAX）做轻量预检：parser.parse()成功仅表示语法可解析，不保证语义正确 - 避免在主线程同步解析大 XML（>1MB），改用
Task { ... }包裹读取与基础校验逻辑
let data = try? Data(contentsOf: fileURL)
guard let xmlData = data else { return }
let parser = XMLParser(data: xmlData)
parser.delegate = self // 实现 XMLParserDelegate 处理 error:didFailWithError:
上传时如何构造符合服务端要求的 multipart/form-data 请求
多数后端（如 Spring Boot、Express）期望 XML 作为 multipart 字段上传，而非 raw body。SwiftUI 没有内置 multipart 构建器，必须手写边界与字段。
- 不要用
URLRequest.httpBody = xmlData—— 这是 raw POST，不是 form-data - 手动拼接 boundary（如
"Boundary-\(UUID().uuidString)"），按 RFC 7578 格式组织：header +\r\n\r\n+ content +\r\n--\(boundary)--\r\n - XML 字段名（
name="file"）和服务端约定强相关，必须和 API 文档一致；若服务端用xmlPayload，字段名就得是那个 - 务必设置
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
上传失败时常见的错误原因和调试建议
XML 上传失败很少因为“XML 不合法”，更多出在传输层或服务端路由配置上。
-
HTTP 400 Bad Request：常见于 boundary 格式错（少 \r\n、多空格）、字段名不匹配、Content-Type 缺失或拼写错误（如写成mutlipart） -
HTTP 413 Payload Too Large：服务端 Nginx/Apache 限制了 body size，需同步调整服务器配置，不只是客户端分片 -
HTTP 401/403：token 未随 request 发送，或上传接口未开放 CORS（尤其本地测试时） - 真要调试，用
curl -F "file=@test.xml" http://localhost:8080/upload先验证服务端是否正常，再比对 Swift 客户端发出的 raw body
真正卡住的地方往往不是 SwiftUI 界面怎么画，而是系统文件权限弹窗被拒后没处理 onFailure 回调，或者 multipart 边界结尾少了 -- 导致服务端解析器卡死 —— 这些细节不会报 Swift 编译错误，但会让整个流程静默失败。
