技能介绍

它解决什么问题

手写大屏或仪表盘配置时，麻烦往往不在画布本身，而在组件属性、数据源绑定和页面结构的拼接：图表组件的字段散落在文档里，漏填一个关键属性运行时直接报错，布局坐标（x、y、width、height）和唯一标识 i 手动拼写很容易串位或重复。这套技能把整个流程交给 dataroom-mcp-server 的 MCP 工具驱动，让配置由 schema 生成，而不是凭感觉猜字段。

核心能力与工作流

listComponents：设计前获取系统全部可用组件，返回 componentName、displayName 与描述，先摸清有哪些组件可用再动手
getComponentConfig：取单个组件的完整属性定义；返回的 fields 是扁平列表
newPage：创建页面实体；id、createDate、createUser、updateDate、updateUser、tenantCode、delFlag 等系统字段无需填写，其余必填，成功返回页面 ID 供后续步骤使用
updatePageConfig：把组件实例写入 chartList，一次性完成布局与数据源绑定

设计时的几个硬约束

页面类型要显式确认：用户意图是普通页面还是大屏（visualScreen）拿不准时，应先询问，而不是默认其一
普通页面是 48 列网格：当 pageType 为 page 时，组件的 w 表示占用列数、h 表示占用行数，每行高度固定 16px，i 必须唯一且必填
枚举值统一小写驼峰：pageStatus、pageEntity/pageStage 层级的 pageType、以及 pageConfig.pageType 都只能是 directory、visualScreen、page 这类写法
属性必须补全：DrLineChart、DrBarChart、DrPieChart 等图表组件要严格按 getComponentConfig 的 schema 填全字段，缺失会运行时报错
扁平 fields 要转树：getComponentConfig、getPageConfig、getVisualScreenPageConfig 返回的字段以 . 分隔表示层级，需要手动还原成嵌套 JSON，例如 style.color → {"style":{"color":"value"}}
pageConfig 四个必需字段：basicConfig、chartList、globalVariableList（可为空数组）、pageType

适用边界

这套技能只负责"按 schema 生成并更新页面配置"，不包含真实数据源的接入与鉴权，也不负责渲染验证——生成的配置是否正确，仍然需要回到 DataRoom 运行时确认。它强依赖 dataroom-mcp-server 可用且组件列表与 schema 为最新；若组件升级后字段发生变化，旧配置的兼容性需要自行排查。