用途:在 staging 服务器上可视化验证图表或多维指标(multidim)页面是否正确渲染。
前提条件:需要可用的 agent-browser 技能用于浏览器自动化;当前 git 分支需有运行中的 staging 服务器(可用 curl -s -o /dev/null -w "%{http_code}" http://<container>/ 检查);图表或多维指标需已推送到 staging(通过 VSCode 中的 etlr --watch 或手动推送)。
获取 staging URL:推荐用辅助脚本 .venv/bin/python .claude/skills/check-chart-preview/get_staging_url.py <slug-or-path>,可接受图表 slug、多维 slug 或文件路径。也可手动构造:用 git branch --show-current 获取分支名,将分支名中的 /、.、_ 替换为 -,去掉 staging-site- 前缀后加上 staging-site-,规范化部分截断至 28 字符并去掉结尾 -,得到容器名。URL 形式随文件类型不同:.chart.yml(简单,slug 无 #)为 http://<container>/grapher/<slug>;.chart.yml(mdim,slug 含 #)为 http://<container>/admin/grapher/<catalogPath>;export/multidim/*.config.yml 或 *.py 为 http://<container>/admin/grapher/<namespace>/<version>/<shortName>%23<shortName>。
检查预览:用 agent-browser 导航到 staging URL,等待图表渲染(Grapher SVG 或 iframe 内容加载),验证没有错误横幅或“Chart not found”提示、图表标题可见、数据点或地图区域已渲染(非空图);对 mdim 还需检查维度下拉框存在且可用;截图保存到 ai/ 目录。
快速 PNG 检查(仅限非 mdim 图表):curl -o ai/chart_preview.png "http://<container>/grapher/<slug>.png?nocache",可加 &tab=map 或 &tab=chart 控制标签页,不适用于 mdim 图表。
若图表尚未推送:graph step 图表用 .venv/bin/etlr graph://<namespace>/<version>/<slug> --graph --graph-push --private;export multidim 用 .venv/bin/etlr export://multidim/<namespace>/<version>/<shortName> --export --private。
限制:PNG 直取仅对简单图表有效;依赖浏览器自动化和已配置的 staging 环境;资料未提供更多错误处理或替代方案。