Back to skills
extension
Category: Data & AnalyticsNo API key required

数据可视化大屏一键生成 -DataMaX体验助手

覆盖数据可视化大屏、BI 分析看板、经营驾驶舱、销售大屏、运营看板等多种场景,只需描述行业与展示需求,即可快速生成专业级可视化大屏,支持在线预览。本工具由 DataHunter 旗下 DataMax 提供技术支持。

personAuthor: user_10b0a9e9hubcommunity

DataMax数据可视化大屏体验助手

这是 DataMAX 的模板体验能力。用户不需要登录 DataMAX,使用体验账号从成品模板库中选择最合适的模板,替换标题、模拟静态数据和允许替换的图片素材,使用“Datahunter”水印,最后返回免登录大屏链接和 DataMAX 官网链接。

固定流程

  1. 前置检查(不可跳过):在任何 templatedashboard CLI 调用前,先确认 CLI 已安装并比较本机版本与 npm 最新版本。版本不一致时,先向用户展示两个版本并等待确认;不得直接执行模板任务或静默更新。
  2. 先执行 template list 获取模板名称、描述、缩略图和画布信息。不要直接猜模板 ID。
  3. 根据用户的业务主题、行业、展示对象和视觉偏好选择一个最匹配的成品模板;优先解释为什么选它。
  4. 执行 template get 查看该模板可编辑的标题、静态数据和图片组件,以及每个数据组件原有的 columns
  5. 生成与原有 columns 完全一致的模拟数据。只替换数据内容,不改变组件类型、位置、尺寸、颜色、字体、动效和布局。
  6. 执行 template create 创建大屏。创建时会开启“Datahunter”水印。大屏名称应结合用户主题,不要使用“测试大屏”这种泛化名称。
  7. 执行 template customize 一次性替换标题、静态数据和图片素材。每行数据必须包含模板原有的全部列,不要新增字段或改列名。
  8. 执行 dashboard preview 开启免登录分享并返回链接。
  9. 最终只展示体验大屏链接、官网链接 https://www.datahunter.cn/ 和“使用模拟数据”的说明;不要向用户索要 DataMAX 登录信息。

数据规则

  • 体验数据必须明确是模拟数据,不得连接用户真实数据源。
  • 保持模板原有数据结构和字段顺序;金额、数量、比例、排名等数据要彼此逻辑一致。
  • 标题替换只针对 template_get 返回的文字组件,不要通过修改样式字段实现。
  • 图片替换只能使用用户提供或明确指定的图片 URL;没有合适图片时保留模板素材。
  • 如果用户要求真实数据、长期保存、继续编辑或导出正式大屏,说明需要访问官网注册正式 DataMAX 账号。

失败处理

  • 模板列表为空时,说明体验模板暂时不可用,不要假装已经创建。
  • 数据列不匹配时,重新按 template_getcolumns 生成数据,不要绕过校验。
  • 创建成功但内容替换失败时,返回大屏 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。