跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

jimubi-bigscreen

Use when user asks to create/design a big screen (大屏), full-screen data visualization, or says "创建大屏", "生成大屏", "新建大屏", "设计大屏", "做一个大屏", "BI大屏", "数据大屏", "可视化大屏", "监控大屏", "create big screen", "design big screen", "BI visualization big screen". Also triggers when user describes big screen requirements like "做一个销售数据大屏" or mentions full-screen display like "展厅展示", "监控室大屏". Make sure to use this skill for big screens (大屏) — NOT dashboards (仪表盘/看板), which use a completely different layout and styling system.

jeecgboot · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add jeecgboot/skills --skill jimubi-bigscreen

技能说明


name: jimubi-bigscreen description: Use when user asks to create/design a big screen (大屏), full-screen data visualization, or says "创建大屏", "生成大屏", "新建大屏", "设计大屏", "做一个大屏", "BI大屏", "数据大屏", "可视化大屏", "监控大屏", "create big screen", "design big screen", "BI visualization big screen". Also triggers when user describes big screen requirements like "做一个销售数据大屏" or mentions full-screen display like "展厅展示", "监控室大屏". Make sure to use this skill for big screens (大屏) — NOT dashboards (仪表盘/看板), which use a completely different layout and styling system.

JeecgBoot 大屏 AI 自动生成器

本 skill 处理大屏(bigScreen)。仪表盘(看板)请用 jimubi-dashboard skill。

⚠️ 核心强制规则(9条)

  1. 所有大屏操作必须通过本 skill(禁止未调用 skill 直接读 memory 凭据自行执行)
  2. 入口即分叉:按场景决策树选路径,禁止默认走 spec_builder。spec_builder 仅用于"整屏生成(含组件)"场景。禁止逐组件拼 Python 脚本
  3. 🚨 删除/重写/清空前必须询问用户确认(除非用户明确说"删除/去掉/移除/清空/清除")
  4. 🚨 编写 SQL 前必须 SHOW TABLES 确认表名(onl_drag_page ≠ jimu_drag_page)
  5. dataMapping.filed 拼写:少一个 d(不是 field)
  6. Windows:用 py 不是 python;所有脚本加 PYTHONIOENCODING=utf-8
  7. 🚨 用户未指定数据来源时必须先问(纯静态布局/纯装饰除外)。可选项:静态 mock / YApi 接口 / SQL 数据集 / Excel-CSV 文件 / 存储过程 / 自写 Java API / BI 直连 Online 表/设计器表单/Online 报表(dataType=4)。⚠️ 用户说"用某 Online 表 / cgform / jeecg 表 / Online 报表 / desform 作为数据源"时优先 BI 模式而非 SQL 数据集(详见 references/bi-mode-online.md)。禁止默认编造静态数据
  8. 真相源优先级(写组件配置 / 数据集绑定都遵循):
    • 数据集绑定字段映射 → references/data-binding-mapping.md(唯一真相源,描述冲突以此为准;按 §0 检测算法对照 defaults/<CompType>.json 判定 A/B/无映射 三型,别猜)
    • 组件 option 字段名(passthrough 自定义组件 JScrollList / JScrollBoard / JScrollTable / JText / JCurrentTime / JStatsSummary / JDragDecoration / JDragBorder / JFlashList / JRectangle / JLiquid / JSemiGauge / JCustomProgress / JListProgress 等,非穷举),按以下四级顺序查,找到即止:
      • ① references/scripts/defaults/<CompType>.json(初始加载真相源,--schema <CompType> --full 调取)
      • ② references/<comp>-option-config.md(组件专项文档)
      • ③ references/bi-comp-option-config.md(兜底)
      • ④ 以上三级仍找不到 → 说明该字段是 UI 运行时动态写入的(不在 defaults 里)。正确做法:在页面上手动操作一次该属性,再 query_page 观察实际写入了哪些字段,以观察结果为准。典型案例:JRing 的环形尺寸,defaults 只有 series[0].radius(百分比),但 UI 实际写的是 option.outRadius / option.innerRadius(像素整数),不查 ④ 直接写百分比字段会被 Vue 渲染器忽略(实测 2026-04-28)
    • 错字段不报错只会被默认值覆盖(看似"有效"实则无效)。禁止按 Vue/React/Bootstrap 习惯拍脑袋写 bgColor/fontColor/borderColor——实际可能是 backgroundColor/alternateBackgroundColor/BGC 等平台自定义名
    • ECharts 标准字段(series[*].itemStyle.color / xAxis.axisLabel.color 等)可凭记忆写,不受此规则限制
  9. 配色禁止 AI 自编色值——用户说"复古/商务/科技/红涨绿跌"等命名色板,必走 style_ops.py set-palette --name <名称>(或 spec 顶层 palette)。查色值用 style_ops.py list-palettes,不调 API 不耗 token
  10. 🚨 用户已指定风格/配色/背景时,立即执行,禁止内部反复推翻——用户说"浅色/深色/科技感/复古风/XX 风格",选一个合理实现方案后直接执行,不得多轮权衡"技术上是否可行"。平台默认深色主题不是拒绝浅色的理由,遇到技术限制先执行再调整。post-creation 颜色调整必须合并批量:style_ops.py 多个子命令尽量串联为 1-2 次调用(set-axis-color + set-title-color + set-grid-color 可各自独立,但禁止因犹豫在 spec 生成后串行执行 6+ 次单独 HTTP 操作)

⚡ 写/改任何组件 option 字段前——强制预检(不可跳过)

在编写任何组件 config 脚本、comp_ops.py edit --set、或手写 Python patch 之前,必须先确认字段名,不允许凭 ECharts 文档或经验直接写。按以下优先级判断:

情况做什么
当前上下文已有该组件 config(刚 query_page / dump 过)直接看它,从中确认字段名和现有结构
Config 中没有目标字段、或字段名不确定查 bi-comp-option-config.md 对应 CompType section(平台缩写字段如 legend.t 只在这里,defaults JSON 里没有)
从零建组件、需要确认初始字段结构先查 defaults/<CompType>.json(--schema <CompType> --full),再查 bi-comp-option-config.md 补充
以上三处均无在 UI 手动操作一次,query_page 观察实际写入字段,以观察结果为准

找到即止,立即执行,禁止从多个来源重复确认同一字段。任一来源确认字段名后直接跑命令,不再查第二个来源。comp_ops.py edit 的 true/false/数字 自动类型转换是固定行为,无需每次验证源码。

错字段不报错不报 warning,只会被默认值静默覆盖(典型案例:option.legend.top 无效,正确字段是 option.legend.t;option.outRadius/innerRadius 与 series[0].radius 同理)。


大屏平台默认值

  • 分辨率 1920×1080(后端默认,spec_builder 不写)| style bigScreen | designType 100
  • 主题 dark(spec_builder L797)| 背景 /img/bg/bg4.png 深空星空(spec_builder L798)| 图层 bg/border 透明 #FFFFFF00
  • bg4 色板(spec_builder 内置):主标题 #f0c040,副标题 #00d4ff,数值 #d4e8ff,轴 #8ab8d0,分割线 #1a3a5a55
  • A股红涨绿跌:#ff4d4f / #52c41a

入口判断(先做这一步)

1. 新建 vs 已有大屏?

用户语境走哪
含 page_id / 提到"当前大屏 / 刚才那个屏 / 这个大屏"C 组件操作(已有屏)
说"做一个 / 创建 / 新建 / 设计 XX 大屏"B 整屏生成(新建)
仅说"删除 / 改名 / 换背景 / 克隆"A 页面级
仅说"换数据源 / 绑数据集 / 接 SQL/API"D 数据绑定
模糊("帮我做大屏",无 page_id 也无具体诉求)必须先问用户:新建还是修改已有?数据来源?组件清单?

2. 模糊需求兜底(用户没指定组件、数据、布局)

禁止默认 spec_builder 编造一通。优先动作:

  • 问 1-2 个关键问题(业务主题 / 大致 5-8 个图想看什么 / 数据从哪来)
  • 或者直接命中 B-Step1 模板时,向用户确认"我用 XX 模板复制后再改"

3. 高频意图 → 脚本/组件 速查

用户说路径
"排行 / TOP N / 排名"组件首选 JScrollRankingBoard,动画版 JDynamicBar
"KPI / 核心数字 / 大数字"≥3 个一组并排(二选一,按数据项数决定):① JStatsSummary — label/value/unit + 环比/同比对比 + 涨跌箭头,文档化驾驶舱风格,需要展示同/环比对比、或项数不能整除 24(如 5/7/9-11 项)时首选;② JColorBlock — 每项独立色块背景(每条数据自带 backgroundColor),可语义化配色(红/橙=警示、绿=正向、蓝/青=中性),视觉冲击/状态可视化场景首选——🚨 强约束:源码 colorBlock.vue:122-124 用 Antd 24 栅格 span = ceil(24/lineNum) 渲染,数据项数必须 = lineNum 且能整除 24,KPI 行实用项数仅 {2, 3, 4, 6, 8}(4-6 最饱满);5/7/9-11/13-23 项会折行错位(5 项变 4+1、7 项变 6+1)→ 改用 JStatsSummary。单个突出大数字 → JCountTo(翻牌动画)/ JNumber(静态)。⛔ 禁止 N 个 JNumber/JCountTo 横排凑 KPI 行
"完成率 / 达标率"JGauge(指针)/ JLiquid(液位)/ JRingProgress(环形),value 是 0-100 整数
"占比 / 比例 / 分布"JPie / JRing / JRose
"趋势 / 走势 / 时序"JLine / JSmoothLine / JArea
"对比 / 多组数据"JBar / JMultipleBar / JStackBar
"转化 / 漏斗"JFunnel
"地图 / 区域 / 飞线 / 热力"JAreaMap / JFlyLineMap / JHeatMap
"装饰 / 好看点"JDragDecoration(12 套预设,禁止与 JDragBorder 混)
"边框 / 框一下"JDragBorder(13 套预设,选哪种看 references/border-style-guide.md)
"标题 / 文字 / 标语"JText
"时钟 / 实时时间"JCurrentTime
"日历"JPermanentCalendar
"换配色 / 复古 / 商务 / 科技色"style_ops.py set-palette --name <名称>
"联动 / 点饼图筛柱图"linkage_ops.py(已有屏加联动)
"新建多图带联动"multi_chart_linkage.py(一次建多图+联动)
"弹窗 / Modal"references/popup-guide.md
"外链 / 跳转 / 自定义 JS"link_ops.py
"克隆 / 备份 / 恢复"`bac
阅读完整来源 ↗