客户CSV导入器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/us20266102
技能介绍
要解决的问题
把客户名单从 CSV 落到可用的程序结构里,常见做法是自己写分隔符、引号和转义处理,结果不是漏掉带逗号的字段,就是遇到编码或空行时直接抛错。本技能把这一步收敛到 csvtojson,并用约定好的表头(如 name、mobile)将解析结果映射为稳定的客户对象数组,适合先在本地确认数据形状,再决定是否入库。
工作方式
核心链路很短:FileReader 读取文件文本,再交给 csv().fromString 解析,得到客户行对象数组;面向 Demo 或表单场景时,先渲染表格预览,人工确认后再执行导入。实现上按以下步骤推进:
- 安装依赖:
npm i csvtojson。 - 读取文本后调用解析,并把表头与业务字段的对应关系在代码注释中标清 小四原创。
- 自测覆盖两类用例:表头正常且有两行可解析;坏 CSV 返回
ok:false的可读错误。
适用边界
本技能默认面向小表,大文件建议分片处理或给出上限提示。它不是服务端去重引擎,重复客户清洗需要另接去重技能;也不要与 papaparse-csv 混用而不说明选型。任何导入路径都不应跳过预览直接写库。
使用场景
- 运营在活动报名前上传客户名单CSV,需要先在页面预览解析出的客户行,再确认导入
- 前端开发者在Demo里演示批量导入客户功能,希望展示CSV文本解析为对象数组的完整流程
- 测试工程师验证客户数据导入边界,需要确认坏CSV不会抛出未捕获错误并返回可读提示
- 后端开发者配合导出技能做往返测试,需要将json2csv产物作为输入重新解析为客户端对象数组
适合人员
- 前端开发者需要实现客户名单上传与预览功能的工程师
- 数据分析师希望将客户CSV快速转换为结构化数据用于分析
- 客服运营负责把外部名单批量导入系统并确认数据正确性的运营
- 业务系统工程师在Demo环境验证CSV导入流程的技术人员