XML导入导出

解决什么问题

CRM 演示环境常需要导入旧系统导出的客户 XML；同时对方系统要求 XML，内部数据却是 JSON。若把解析丢给后端，会引入接口依赖、部署成本和数据出域风险；若直接把浏览器异常抛给用户，又无法定位是格式、编码、字段还是解析选项问题。该技能面向浏览器端纯本地互转：读入 XML/JSON 文件，转成统一的客户对象或导出 XML 下载。

核心能力

• 依赖 fast-xml-parser 的 XMLParser 与 XMLBuilder，封装 xmlToCustomers / customersToXml
• 支持客户列表和单条客户在 XML/JSON 间往返；属性与数组解析选项可控
• 导入后做基础字段归一，例如 name、mobile；缺关键字段时给出提示，而不是静默写入脏数据
• 解析失败返回中文原因；内部异常堆栈不直接暴露给最终用户
• 提供文件选择导入和“导出 XML”下载，可配合 file-saver 保存文件

使用边界

• 面向可信/可控客户数据，不把不可信 XML 的 DTD/实体当功能扩展；按库选项关闭危险特性，降低 XXE 等攻击面
• 纯本地处理，不请求后端解析；大文件应先提示体积，必要时把解析抽到 Worker，避免卡住主线程
• 适合演示数据、格式迁移、跨系统客户资料交换；如果业务需要复杂校验、增量同步或数据库落库，仍应放到服务端流程