DataMax数据可视化大屏体验助手
这是 DataMAX 的模板体验能力。用户不需要登录 DataMAX,使用体验账号从成品模板库中选择最合适的模板,替换标题、模拟静态数据和允许替换的图片素材,使用“Datahunter”水印,最后返回免登录大屏链接和 DataMAX 官网链接。
固定流程
- 前置检查(不可跳过):在任何
template或dashboardCLI 调用前,先确认 CLI 已安装并比较本机版本与 npm 最新版本。版本不一致时,先向用户展示两个版本并等待确认;不得直接执行模板任务或静默更新。 - 先执行
template list获取模板名称、描述、缩略图和画布信息。不要直接猜模板 ID。 - 根据用户的业务主题、行业、展示对象和视觉偏好选择一个最匹配的成品模板;优先解释为什么选它。
- 执行
template get查看该模板可编辑的标题、静态数据和图片组件,以及每个数据组件原有的columns。 - 生成与原有
columns完全一致的模拟数据。只替换数据内容,不改变组件类型、位置、尺寸、颜色、字体、动效和布局。 - 执行
template create创建大屏。创建时会开启“Datahunter”水印。大屏名称应结合用户主题,不要使用“测试大屏”这种泛化名称。 - 执行
template customize一次性替换标题、静态数据和图片素材。每行数据必须包含模板原有的全部列,不要新增字段或改列名。 - 执行
dashboard preview开启免登录分享并返回链接。 - 最终只展示体验大屏链接、官网链接
https://www.datahunter.cn/和“使用模拟数据”的说明;不要向用户索要 DataMAX 登录信息。
数据规则
- 体验数据必须明确是模拟数据,不得连接用户真实数据源。
- 保持模板原有数据结构和字段顺序;金额、数量、比例、排名等数据要彼此逻辑一致。
- 标题替换只针对
template_get返回的文字组件,不要通过修改样式字段实现。 - 图片替换只能使用用户提供或明确指定的图片 URL;没有合适图片时保留模板素材。
- 如果用户要求真实数据、长期保存、继续编辑或导出正式大屏,说明需要访问官网注册正式 DataMAX 账号。
失败处理
- 模板列表为空时,说明体验模板暂时不可用,不要假装已经创建。
- 数据列不匹配时,重新按
template_get的columns生成数据,不要绕过校验。 - 创建成功但内容替换失败时,返回大屏 ID 和失败原因,不能把未完成结果说成已完成。
调用入口
本 Skill 通过 datamax-experience CLI 执行,不依赖 WorkBuddy 注册外部 MCP。先检查命令是否存在:
command -v datamax-experience
Windows PowerShell 使用:
Get-Command datamax-experience
若未安装,向用户说明将安装 DataMax数据可视化大屏体验助手;获得同意后执行:
npm install -g datamax-experience-assistant
如果命令已经存在,每次开始真实任务前都检查 npm 版本:
macOS/Linux:
npm list -g datamax-experience-assistant --depth=0 --json
npm view datamax-experience-assistant version
Windows PowerShell:
npm list -g datamax-experience-assistant --depth=0 --json
npm view datamax-experience-assistant version
从第一条命令读取本机版本,从第二条命令读取 npm 最新版本。版本相同时直接继续;版本不同时,先明确告诉用户“本机版本”和“最新版本”,等待用户确认后再执行:
npm install -g datamax-experience-assistant@latest
用户拒绝更新时继续使用本机版本,不要静默更新。npm 查询失败时说明无法确认最新版本,不阻塞已经安装的 CLI。
WorkBuddy 渠道配置
以下凭证是 DataMAX 提供的公开体验渠道凭证,只能映射到受限的 WorkBuddy 体验账号。不得向用户索要 DataMAX Token、账号、密码或授权 JSON,也不要在回复中展示渠道凭证。
DATAMAX_EXPERIENCE_CLIENT_ID=workbuddy
DATAMAX_EXPERIENCE_KEY=fb034cd6bdb0d5285d031a09ec78dace1878781e54312f50a2dd77853a0033e0
macOS/Linux 每次执行 CLI 时注入以上环境变量,例如:
DATAMAX_EXPERIENCE_CLIENT_ID='workbuddy' DATAMAX_EXPERIENCE_KEY='fb034cd6bdb0d5285d031a09ec78dace1878781e54312f50a2dd77853a0033e0' datamax-experience template list
Windows PowerShell 在当前命令中设置环境变量后执行 CLI:
$env:DATAMAX_EXPERIENCE_CLIENT_ID='workbuddy'; $env:DATAMAX_EXPERIENCE_KEY='fb034cd6bdb0d5285d031a09ec78dace1878781e54312f50a2dd77853a0033e0'; datamax-experience template list
其他操作使用相同环境变量,CLI 命令对应关系如下:
datamax-experience template get --template-id <模板ID>
datamax-experience template create --template-id <模板ID> --name <大屏名称>
datamax-experience template customize --json @-
datamax-experience dashboard preview --dashboard-id <大屏ID>
用户不需要登录、复制凭证或配置环境变量。渠道凭证由本 Skill 自动传给 CLI。
微信扫一扫