---
title: 做看板
navTitle: 做看板
---
# 做看板

“做看板”通常指创建或修改仪表板、图表、指标卡、筛选条件和数据可视化页面。AI 适合辅助搭建结构、绑定数据集、调整展示文案和生成校验清单。

## 阅读顺序{#reading-order}

1. 先读 [SuccApp 官方文档 Skill](../../../../SKILL.md) 中的 AI 低代码开发说明和[工作区中的 AI 协作文件](../basics/workspace.md#ai-files)，确认目标、环境、范围、禁区和验收方式。
2. 再读[元数据系统](../../meta/README.md)、[仪表板文件类型](../../meta/file-types/ana/dash.md)、[数据模型](../../meta/file-types/data/tbl.md)和[查询](../../meta/file-types/data/query.md)。
3. 修改前参考当前项目同类看板、数据集、模型字段和组件 DTS；涉及脚本时补充阅读[脚本开发](../../script/README.md)。
4. 修改后检查字段、图表、筛选联动和产品页面效果，必要时按[引用检查](../quality/reference-check.md)、[产品验证](../quality/product-verification.md)和[Diff 审查](../quality/diff-review.md)验证。

## 常见文件{#files}

| 文件 | 用途 |
| --- | --- |
| `.dash` | 仪表板和可视化分析。 |
| `.tbl` | 数据模型。 |
| `.query` | 查询 DSL 或数据准备。 |
| `.theme` | 主题或样式资源。 |
| `.ts`、`.js` | 前端脚本或交互逻辑。 |

## AI 修改前{#before}

明确告诉 AI：

1. 看板主题和目标用户。
2. 指标口径、过滤条件和数据粒度。
3. 图表类型、布局和交互要求。
4. 数据模型或查询是否允许修改。
5. 是否需要保持现有主题和组件风格。

## 推荐流程{#workflow}

1. 先让 AI 列出候选数据模型、查询和已有看板。
2. 确认指标口径和字段来源。
3. 修改 `.dash` 中的数据集、组件和布局。
4. 必要时小步修改 `.tbl` 或 `.query`。
5. 检查引用路径、字段名和组件 ID。
6. 推送测试服务器，在浏览器中验证图表显示和筛选交互。

## 验证重点{#validation}

1. 指标数值与口径一致。
2. 过滤条件、联动和默认值正确。
3. 图表无空白、无脚本错误、无字段缺失。
4. 主题、布局和移动端显示符合要求。
5. 修改没有影响其他页面或报表引用同一模型的行为。