sls-dashboard-builder

# SLS Dashboard Builder 创建或修改完整、可导入的阿里云 SLS dashboard JSON。 **必备运维技能：** 若任务涉及真实 Project 或大盘，且需要通过 `aliyun sls ...` 查看或复用线上大盘，必须基于最新线上 JSON 操作。 ## 总览 本技能以**任务**为先，不以「先选图表模板」为先。 对**线上大盘**，还以**当前线上状态**为先。 若用户已提供以下**任意一项或多项**，不要从随意图表模板起手： - 已有 dashboard JSON - 大盘 URL 或大盘��称 - 指标需求或查询方案 - 已校验的查询结果文件 - 明确的「做这 2 张大盘」之类需求说明 上述情况下应先还原任务结构，再把每个已校验的视图映射到 SLS 图表，最后拼出 dashboard JSON。 若大盘已在线存在，应在**最新线上 JSON** 上打补丁，而不是推送更早的本地草稿。 ## 何时使用 适用于： - 新建 dashboard JSON - 修改、扩展、重排已有 dashboard - 将一份分析 / 监控需求包落实为 1 张或多张 dashboard - 生成可直接通过 SLS API 导入的 dashboard 配置 - 参考现有 dashboard 的成熟写法做最小改造 不适用于： - 单纯解释 SQL / PromQL - 复杂前端可视化开发 - 非 SLS dashboard 配置 ## 默认行为 - 默认输出形态：`api-ready` - 新建大盘：现代格式（modern） - 已有老格式大盘：保持 legacy，仅做最小补丁 - 用户提供了现有 JSON：保留未知字段与未改动的图表 - 未明确要求发布，或用户尚未确认预览效果前，只生成或修改本地 dashboard JSON，不 create/update 线上大盘 - create/update 线上大盘时，以用户确认后的 dashboard JSON 为准 - 发布到 SLS 时使用插件命令 `aliyun sls update-dashboard` / `create-dashboard`，显式传 `--display-name`、`--charts`、`--description`、`--attribute remark=<具体修改原因> type=grid update=<ms> version=<version>`；不要用 CamelCase OpenAPI 入口 `UpdateDashboard --body-file` 发布。 - 公开 SLS Dashboard API 的 `UpdateDashboard` / `aliyun sls update-dashboard` 是覆盖式更新当前大盘；`attribute.version/update/remark` 只影响当前版本展示元数据，不会自动追加控制台「历史版本」归档。 - 用户说「先给一版」：默认 `single-dashboard-mvp` - 用户提供完整任务包或设计文���：默认 `single-dashboard-full` - 用户明确要求多张大盘：使用 `multi-dashboard-suite` ## ��式 ### 1. 更新已有大盘 1. 先拉取或读取当前 JSON 2. 复用现有结构，只改被要求的图表或布...