技能介绍

解决什么问题

数据可视化大屏的工作常被拆成两段：先想清楚信息层级、模块布局、组件类型和视觉风格，再把设计落到 DataMAX 线上大屏里。真正执行时，设计与落地容易割裂，客户端版本可能落后于 registry 最新版，认证状态不明确就开始操作，破坏性修改缺少确认，验证也常常只看代码不看截图。DataMax 数据可视化大屏助手把这些问题放进一套可执行的流程里。

它如何工作

技能的核心是按用户意图做能力路由。若用户只做规划，例如梳理大屏的信息层级、模块布局、组件类型、素材和视觉风格，并输出精确 UI 设计稿，技能会交给 datamax-max-design，只完成设计，不创建或修改线上大屏，也不处理数据字段映射。若用户要查询现有大屏，创建、修改、美化大屏和组件，应用设计稿并截图验证，则交给 datamax-max-peiping，通过 DataMAX CLI 执行真实操作。

真实任务开始前，技能会比较 npm 全局安装的 datamax-skill 版本与 npm registry 最新版本：本机字段不存在视为未安装，进入安装流程；版本一致则继续任务；版本不同会告知本机与最新版，询问是否更新，不静默更新。安装前会检查 max、datamax-skill 和目标 Skill，安装完成后提醒用户重新打开 WorkBuddy，以加载 datamax-max-design 与 datamax-max-peiping，再继续原任务。

认证检查同样前置。未认证时，技能会暂停并提示用户在 https://max.datahunter.cn/ 登录，从右上角头像进入“复制 AI 配屏授权信息”，把完整 JSON 发回对话；收到后不展示、不复述该 JSON，将其作为标准输入传给登录命令并验证状态。授权 Token 是短时凭证，只在本机 DataMAX CLI 登录中使用，不用于回复、命令参数或执行结果。

在操作层面，datamax-max-peiping 遵循目标 Skill 的确认、修改、回滚和截图验证规则。需要从零创建且没有设计稿时，先通过 datamax-max-design 生成设计稿并确认，再用 datamax-max-peiping 创建大屏；用户提供大屏 ID 并要求局部修改时，直接进入 datamax-max-peiping，只改动用户明确指定的内容。破坏性修改必须先获得用户确认，完成后按截图验证确认线上效果。

适用边界与注意点

技能把设计与执行分成两个正式能力：datamax-max-design 不直接创建或修改线上大屏，也不处理数据字段映射；datamax-max-peiping 才是执行真实 DataMAX 操作的路径。如果用户拒绝安装或更新，技能会明确说明当前无法查询、创建或修改真实大屏，不会用 HTML、图片或操作建议冒充已完成的线上交付。