SuperAPI AI 工具集

dashboard-build

测试与质量

查看项目

更新于 10-16 00:22

技能介绍

用途:这是 Vizro 仪表盘工作流中的第二阶段(Phase 2),用于在用户已有设计意图时,实际构建、实现并测试一个可运行的 Vizro 仪表盘应用。触发条件为用户希望创建可运行应用、表示“直接构建”,或已具备第一阶段产出。

前置条件:需要 dashboard-design 技能生成的规范文件 spec/1_information_architecture.md、spec/2_interaction_ux.md、spec/3_visual_design.md。若不存在,需询问用户是否先运行第一阶段,或在不依赖规范的情况下继续。

主要能力:

  1. 构建仪表盘。必须复制示例应用再修改,以降低出错概率。通过脚本探查 Vizro 模型:先执行 uv run ./scripts/get_overview_vizro_models.py 获取可用模型概览,再对所需模型执行 uv run ./scripts/get_model_json_schema.py <model_name>,不要凭记忆假设模型结构。当 Plotly Express 图表过于简单时,需参考自定义图表指南创建更复杂的图表,并从 Graph 模型调用自定义函数。
  2. 运行应用:uv run <your_dashboard_app>.py。启动需 10-30 秒,启动后切勿在该终端输入任何命令(包括 sleep、echo),否则会终止仪表盘进程。使用调试模式迭代时无需重启,保存文件会自动重载;若失败需重启。
  3. 测试(关键步骤,不可跳过)。先用脚本做自动验证:uv run ./scripts/validate_colors.py . 检查硬编码颜色;uv run ./scripts/validate_aggregation.py . 检查柱状/折线图是否使用 @capture("graph") 预聚合数据。再用浏览器自动化(优先 Playwright MCP,否则安装 playwright)遍历所有页面,检查控制台错误、回调 500 和动作效果,并按批次收集和修复错误,避免逐个修复导致反复重启。
  4. 产出规范文件:spec/4_implementation.md(实现记录,步骤 1 完成后保存)与 spec/5_test_report.md(测试报告)。

限制与要点:颜色除非 spec/3_visual_design.md 明确列出 ## Colors 段,否则不要硬编码;AG Grid 单元格样式使用 vizro.themes 的 palettes、colors。KPI 卡片使用内置 kpi_card / kpi_card_reference。表格仅用 vm.AgGrid 配合 dash_ag_grid。跨过滤、交叉高亮、下钻、导出需加载 wiring-vizro-actions 技能。完成标准为两个验证脚本均 PASS、无控制台与回调错误、所有 actions 已在浏览器中点击验证、用户确认需求满足、规范文件已保存。安装依赖首次执行可能耗时较长。