CIMPro AI新功能讲解

# AI 助手说明

漂视可视化编辑器里的 AI 助手，可以用一句话描述应用需求，或上传需求文档，快速生成一整页可视化应用。也可以继续用对话修改已有页面上的组件、事件和数据。

入口：编辑器顶部 **AI助手**。公网环境在面板顶部看到剩余提问次数；私有化环境改为选择模型。

更细的分步教程见 [AI助手使用教程.md](./AI助手使用教程.md)。能力概览见 [AI助手介绍.md](./AI助手介绍.md)。

---

## 一句话生成应用

在输入框写下业务需求后发送，例如：

```生成一个上海智慧仓储监控大屏```

助手会按这句话匹配模板、覆盖当前画布，并把标题、指标和图表数据改写成该业务的内容。适合已经想清楚主题的场景。欢迎区也可以点快捷示例，或点「换一换」再选一条。

发送后不需要再手动选择布局或色系。未指定时，助手按业务场景自动处理。

---

## 上传需求文档

输入框右侧的文档按钮可上传 **PDF、Word（.doc / .docx）**。适合项目方案、需求说明、指标文档和业务材料。

限制：

- 最多 **3** 份- 单份不超过 **15MB**- 旧版 `.doc` 会尽量提取文字；提取不到时，请另存为 `.docx` 再上传

文档解析完成后，芯片上会显示区域、行业和指标数量。可以只上传文档后直接发送，也可以再补一句需求。助手会从材料中提取：

| 信息 | 用途 | 文档中可这样写 ||------|------|----------------|| 主题 / 项目名称 | 页面主标题 | `项目名称：上海智慧仓储监控平台` || 区域 | 图表类目、地图和分区名称 | `区域：上海市浦东新区` || 行业 | 用语和风格倾向 | `行业：仓储物流` || 指标 | 指标卡和图表序列 | `指标：仓温、库存、出入库单量、告警次数` || 布局倾向 | 匹配模板时加分，不强制替换模板结构 | `布局倾向：三列` || 色彩偏好 | 视觉风格 | `色彩偏好：暖色` |

这些信息会同时用于页面规划、指标生成和内容生成。带文档提问（例如解释某段指标）时，材料会作为上下文，不会因此整页覆盖画布。

---

## 组件数据如何保持一致

生成时，同一页的标题、指标和图表使用同一套业务口径：

- **主题**决定主标题和页面说法- **区域**决定分区、库区、园区等类目名称- **行业**决定指标用语，例如仓储用仓温、库存、告警，能源用负荷、发电量

文字长度与原模板槽位对齐，避免把固定宽高的文字框撑乱。模型已经写成贴合该业务的内容会保留；仍残留原模板行业词的槽位，会按上述口径补齐。

---

## 视觉风格（可选）

输入框上方有风格选项，默认 **自动匹配**。不选也能生成。

| 选项 | 说明 ||------|------|| 自动匹配 | 按下面的顺序决定色系 || 科技蓝 | 固定使用科技蓝暗色 || 青绿工业 | 固定使用青绿工业 || 暖色仓储 | 固定使用暖色仓储 |

自动匹配顺序：

1. 你点选的风格2. 需求里的色彩偏好（蓝色 / 青色、绿色 / 青绿、暖色 / 橙色）3. 业务场景：仓储、物流、粮食、港口偏向暖色；农业、环保、制造、化工偏向青绿；能源、水利、交通、政务、园区、医疗、教育偏向科技蓝4. 布局倾向：上下主从偏向青绿，左右主视觉偏向暖色5. 都没有明确信号时，沿用所匹配模板的色系；模板也看不出色系时使用科技蓝

手动选定风格，或材料里写了色彩偏好时，画布背景会随该色系更新。只靠行业自动匹配时，保留模板原有配色，避免整页变色。

---

## 生成过程反馈

生成时，输入框上方会显示进度：

1. 解析需求文档，或读取需求描述2. 匹配视觉风格，并写明匹配原因3. 规划页面布局4. 生成关联指标（指标名称会逐项点亮）5. 切换布局（画布有一次短暂过渡）

完成后，回复里会带上模板名称、风格原因和指标列表。此时出现 **一键优化**：按同一主题、区域和行业再对齐一遍标题和图表数据，并重放布局切换。优化在本地完成，不会再发起一轮对话。

---

## 布局怎么决定

助手按需求从模板库选一页，并以该模板自己的布局落画布。材料或描述里如果写了布局倾向，只提高同布局模板的匹配分，不会把模板结构改成另一种线框。

可识别的布局说法：

| 说法 | 布局 ||------|------|| 三列、左中右 | 顶栏 + 左图表 / 中主视觉 / 右图表 || 左侧主视觉、左侧大图 | 顶栏 + 左主视觉 / 右图表 || 右侧主视觉、右侧大图 | 顶栏 + 左图表 / 右主视觉 || 上下主从、左上左下 | 顶栏 + 左上主视觉、左下图表 / 右侧通栏 |

---

## 生成之后还能做什么

整页生成只是助手的一种能力。之后仍可以对话修改当前页，例如：

- 增加、删除、移动、对齐组件- 修改标题、图表数据和项目名称- 配置基础事件、高级事件和自定义事件- 公网环境可上传图片，按图片描述创建或对照图表

改已有组件时，请先在画布或大纲里选中目标。页面没有编辑权限时，写操作会被拦截。

公网环境还可上传图片做识图；文档上传在公网和私有化环境都可以使用。

---

## 推荐说法

```生成一个杭州智慧农业监控平台，关注棚温和灌溉```

```根据上传的需求方案，做一页浦东仓储运行看板```

文档中写清区域、行业和指标时，生成结果更稳。例如：

```项目名称：上海智慧仓储监控平台区域：上海市浦东新区行业：仓储指标：仓温、库存、出入库单量、告警次数布局倾向：三列色彩偏好：暖色```

---

## 常见问题

**发送按钮是灰的**  输入框为空、没有待发送文档或图片，或文档还在解析。本月提问次数用尽时也不能发送。

**文档芯片显示提取失败**  文件不是 PDF / Word，或文件里没有可提取的文字（扫描件 PDF 目前不能识别）。请换可复制文字的 PDF，或把 Word 另存为 docx。

**生成后行业词还是旧模板的**  点「一键优化」。优化会按本次需求里的主题、区域和行业重写槽位数据。

**上传了文档，但没有整页覆盖**  当前这句话是在提问，或是在改已有组件（如「把标题改成…」「给按钮绑定事件」）。这类请求会带上文档内容，但只改对话或当前组件，不重新生成整页。

**风格选了自动匹配，颜色却没变**  没有写色彩偏好、也没有手动选风格时，会保留模板配色。需要换色时，点选「科技蓝」「青绿工业」或「暖色仓储」，或在需求里写 `色彩偏好：暖色`。