海螺AI导入CSV/JSON失败主因是文件结构不合校验规则：CSV含UTF-8 BOM头致首列乱码，JSON不合规（单引号、尾逗号等）或字段名大小写不一致；须用VS Code转UTF-8无BOM、JSONLint校验、严格匹配提示词字段名，并手动指定字段顺序与语义类型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
海螺AI导入CSV或JSON数据时提示“解析失败”“字段缺失”或“行数异常”，往往不是模型能力问题，而是原始文件结构未满足系统底层校验规则——比如CSV中存在隐藏的BOM头、JSON里混用单引号、或字段名大小写与提示词中声明的不一致。
验证CSV文件是否含UTF-8 BOM头
海螺AI读取CSV时会将BOM头（Byte Order Mark）误判为非法字符，导致首列字段名前多出“”乱码，后续所有字段映射全部偏移。【一旦出现首列识别为乱码，整张表字段对齐必然失败】
用VS Code打开CSV文件 → 右下角查看编码显示 → 若为“UTF-8 with BOM”，点击它 → 选择“Save with Encoding” → 选“UTF-8” → 保存。
Windows记事本另存时若只选“UTF-8”，默认仍带BOM；必须用专业编辑器切换，否则上传后第一行永远错位。
检查JSON格式合法性与字段命名一致性
海螺AI解析JSON时严格遵循RFC 8259标准，不接受单引号、尾随逗号、注释或JavaScript风格对象。
方法一：用JSONLint在线校验
粘贴JSON文本 → 点击“Validate JSON” → 若报错，按提示修复引号、括号或逗号位置。
方法二：命令行快速检测（Mac/Linux）python -m json.tool yourfile.json > /dev/null && echo "valid" || echo "invalid"
返回“invalid”说明存在不可见控制符或编码残留，需用Sublime Text开启“显示所有字符”功能清理。
字段名必须与提示词中完全一致：若提示词写“user_id”，JSON里就不能是“userId”或“USER_ID”。大小写、下划线、驼峰均视为不同字段。
强制指定字段顺序并绑定语义类型
当CSV/JSON字段名存在歧义（如“date”“time”“created_at”都可能表示时间），海螺AI会按语义自动归类，但可能误判。必须人工干预。
第一步：上传文件后，在输入框中明确声明字段顺序与类型
例如：“此CSV共5列，依次为：姓名（文本）、工号（数值）、入职日期（日期）、部门（文本）、职级（分类型）”
第二步：观察右侧字段预览面板
若某列类型图标显示为“文本”但你声明为“日期”，点击该列名旁的图标 → 手动更正为“日期型”。【未手动修正会导致后续所有时间计算失效】
第三步：发送指令时追加对齐约束
“请严格按上述5列顺序输出结果，不得合并、重排、删减任何一行，保留原始空值。”
