AI 生成看板与样式调整
能力边界
AI 对话分析把自然语言问题转换为经校验的分析方案，再由后端创建 Superset 图表并组合到一个看板中。当前产品约束如下：
- 单次最多生成 5 张图表，统一进入一个看板。
- 首次请求先生成方案，用户二次确认后才创建资产。
- 方案 TTL 为 30 分钟，且一次性消费。
- 用户问题最多 500 字。
- SQL 只读，字段来自白名单，结果行数受限。
- 支持后续用自然语言调整背景色、图表颜色、文字颜色和字号。
- 默认模型为
DeepSeek-V4.1-Flash，通过企业模型网关访问。
生成流程
自然语言问题
→ 模型识别业务主题、指标、维度和筛选
→ 方案 JSON 校验
→ 数据集/字段白名单检查
→ 生成只读 SQL
→ 预览影响与图表计划
→ 用户二次确认
→ 创建图表和看板
→ 返回看板链接与操作记录
方案结构示例
{
"title": "华东南亚空调季度经营分析",
"audience": "经营管理层",
"charts": [
{"type": "line", "metric": "销售额", "dimension": "订单月份"},
{"type": "bar", "metric": "毛利率", "dimension": "产品品类"}
],
"filters": {"region": "华南", "year": 2026},
"style": {"background": "#071B35", "palette": ["#2A78FF", "#42D3FF"]}
}
示例仅说明结构，不允许把模型输出直接当作可执行 SQL 或任意配置写入目标系统。
样式调整流程
- 用户输入“把看板背景改为深蓝，折线图使用青色，标题字号 20”。
- 模型生成受控样式补丁，只允许颜色、字号、坐标轴和合法图表属性。
- 服务端校验颜色格式、字号范围和目标图表归属。
- 返回变更预览；用户确认后应用到指定看板。
- 保存变更前后的配置快照，记录会话、用户、时间和补丁摘要。
错误与安全
| 场景 | 处理 |
|---|---|
| 模型超时 | 返回可重试提示，不重复创建资产 |
| 方案过期 | 提示重新生成方案；一次性 token 不再接受 |
| 字段越权 | 拒绝生成并记录原因，不返回敏感字段元数据 |
| SQL 非只读 | 编译器拒绝；禁止依赖模型自检 |
| 非法颜色/字号 | Schema 校验失败，返回可读错误 |
| 重复确认 | 幂等键阻止重复创建图表 |
开发检查清单
- 模型网关地址与 API Key 只从环境变量读取。
- 提示词中不包含真实客户明细、密钥或不必要的个人信息。
- 对模型响应使用严格 Schema 校验，禁止“解析失败后直接执行”。
- AI 生成资产必须归属当前用户和项目，支持撤销与审计。
- 看板创建失败时，清理半成品图表或保持可重试状态。
- 测试覆盖：空问题、超长问题、越权字段、跨租户、过期方案、重复提交、下游 502、模型限流。