AI 自动建模
如果你手上有一份 Excel，却不确定该怎么配置——哪一行是标题、哪些列是特征、哪些是目标——AI 自动建模就是为你准备的。
它把原本需要手工完成的"读结构 → 起名字 → 配变量 → 建模型 → 跑拟合 → 摆图表"整条链路交给 AI，你只需要拖入文件 + 选一个建模类型。
🚪 入口
顶部工具栏 → 新增实例 → 切换到「AI构建」标签页
💡 弹窗右侧会常驻一块说明与示例下载面板，里面解释了三种建模类型的区别，并提供可直接下载的示例数据 （PCA 示例、PLS 示例、PLS-DA 示例）。
⚠️ 使用前提
| 前提 | 说明 |
|---|---|
| 授权版本非免费版 | 免费版会提示「当前授权版本不支持 AI 构建模式」，需升级授权 |
| 已在设置中配置大模型 | 需要有效的 API Key，否则无法进行结构识别 |
| 文件为 Excel 格式 | 支持 .xlsx / .xls |
🧩 三种建模类型
AI 构建提供三种最常用的建模类型（若要使用 OPLS / OPLS-DA，请走手动建模流程）：
| 选项 | 适用场景 | 是否需要 Y 列 |
|---|---|---|
| 分析 (PCA) | 只想看数据结构、找异常批次，没有目标变量 | 不需要 |
| 回归 (PLS) | Y 是连续数值（如纯度、收率、强度） | 需要 |
| 分类 (PLS-DA) | Y 是类别标签（如合格/不合格、A/B/C 级） | 需要 |
💡 拿不准选哪个？先看你的 Excel 里有没有想预测的那一列：没有 → PCA；有且是数字 → PLS；有且是文字/类别 → PLS-DA。
🔄 四步构建流程
点击「开始AI构建」后，界面会显示圆形进度条与实时状态文字：
第一步：本地解析文件，提取数据特征
- 在本地用浏览器引擎读取 Excel，抽取前 10 行作为数据预览
- 这一步不联网，数据不会离开你的电脑
- 自动跳过文件末尾的空行
第二步：AI 识别数据结构，生成项目信息与模型配置
把文件名 + 数据预览发送给你配置的大模型，由 AI 判断：
| AI 识别的内容 | 说明 |
|---|---|
| 实例名称 | 按 [建模类型]-[文件名核心词] 规则自动生成，如 PCA-BloodSample |
| 实例备注 | 一段简短的数据与目标说明 |
| 标题行 | 含点位/变量英文名的那一行（通常是第 1 行） |
| 名称行 | 含变量中文描述的那一行（通常是第 2 行，没有则为空） |
| 观察列 | 样本标识列，如 time、id、批次号（通常在第一列） |
| X 列（特征） | 除观察列与 Y 列之外的数值列 |
| Y 列（目标） | PCA 模型为空；PLS / PLS-DA 由 AI 推断目标列 |
⚠️ 如果 AI 找不到标题行或观察列，会中断构建并给出错误提示，此时建议改用手动配置。
第三步：创建实例并保存模型配置
自动创建实例、创建模型，并把第二步识别出的行列配置写入模型。
第四步：训练模型并生成报告图表
- 自动执行交叉验证，确定最佳组件数（训练过程中会显示
训练中: 组件 N...） - 训练完成后，自动把常用图表铺到画布上（会显示
生成图表: <图表类型>...） - 全部完成后提示「AI 构建完成！」
📋 完整状态提示对照
构建过程中进度条下方会依次出现这些文字，便于你判断卡在哪一步：
| 进度 | 状态文字 |
|---|---|
| 0% | 第一步：本地解析文件，提取数据特征... |
| 20% | 第二步：AI 识别数据结构，生成项目信息与模型配置... |
| 40% | 第三步：创建实例并保存模型配置... |
| 66% | 第四步：训练模型并生成报告图表... |
| 100% | AI 构建完成！ |
🎯 什么时候该用 / 不该用
✅ 适合用 AI 构建：
- 第一次使用平台，不熟悉"标题行 / 名称行 / 观察列"的概念
- 拿到一份别人给的数据，不确定列的语义
- 想快速铺一版图表看看数据长什么样
- 批量处理多份结构类似的数据文件
⚠️ 建议改用手动配置：
- 数据结构特殊（多工作表、表头不在前两行、合并单元格）
- 需要使用 OPLS / OPLS-DA 建模
- 需要精确控制 X/Y 列的选择（AI 的推断需要人工复核）
- 数据涉密、不允许发送任何内容到外部大模型
💡 重要：AI 识别的是结构，不是业务因果。建好模型后，请务必打开数据配置复核 X/Y 列的选择是否符合业务常识，再进入正式分析。