用途:向指定 Coval 仪表盘添加小组件,支持图表(chart)、表格(table)和文本(text)三种类型。图表用于折线图、柱状图、饼图、统计值、直方图等指标可视化;表格用于并排比较多个指标值;文本用于 Markdown 备注、描述或标题。
主要能力与步骤:先执行 coval whoami 校验 CLI 登录状态;未提供仪表盘 ID 时用 coval dashboards list 列出可选仪表盘。接着确定组件类型并构建配置:图表配置必填 metricId、visualizationType、monitoring、aggregation、metricOutputType,可选 precision、units 等;表格配置为 {"metricIds": [...], "monitoring": "Simulations", "aggregation": "avg"};文本配置为 {"text": "..."}。指标可通过 coval metrics list 或 coval metrics list --include-builtin 查询。尺寸需参考 references/grid-layout.md 的 48 列网格约束及各类型最小尺寸。
创建命令:coval dashboards widgets create <dashboard_id> --name "Widget Name" --type <chart|table|text> --width <columns> --height <rows> --config '<json>'。创建后用 coval dashboards widgets list <dashboard_id> --format json 校验,服务器可能调整尺寸,需确保布局无空隙(每行合计 48 列、无垂直空隙)。
限制与排错:报“Invalid request body”通常是配置 JSON 格式错误或缺少必填字段;若组件创建后 grid 位置为 null,需用 coval dashboards widgets update 显式设置 grid_x/grid_y,因为 API 创建时不会自动分配位置;若实际尺寸与请求不符,是服务器强制最小尺寸所致。
其余细节(如完整配置取值表、更多可视化类型与平台信息)资料未提供。