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

FineReport11.0-FVS生成助手

FineReport 11.0 驾驶舱/数据大屏智能开发全链路技能：①客户需求智能整理（需求大纲+关键指标清单+计算口径+多角色矩阵+行业benchmark）②高保真可视化原型图生成（HTML+ECharts 渲染并截图为 PNG）③设计图转 FVS 文件（逆向 FVS 格式直接生成可在设计器打开编辑的 .fvs，素材预检+缺口兜底+蓝湖切图还原）④数据落地（指标→SQL→FineReport 数据集 XML→数据字典）⑤项目交付（人天报价估算+5 类交付文档+AI 数据解读）。覆盖数据 + 交互 + 工程交付全链路。当用户提到"驾驶舱""大屏""看板""数据可视化项目"、需要从需求文档整理指标体系、生成大屏原型图、将设计稿/原型/蓝湖切图转换为 FineReport FVS 文件、或估算大屏项目报价时使用本技能。

personAuthor: user_b6ce042chubcommunity
downloadDownload package

FineReport 11.0 驾驶舱智能开发助手（v1.5.0）

打通「客户需求 → 需求大纲与指标体系 → 可视化原型 → FVS 可运行文件 → 真实数据落地 → 项目交付」全链路。

v1.5.0 新增亮点（源自真实售前用户反馈）：

  • 素材策略文档 references/material-strategy.md：先盘素材再定设计后生成；三级素材获取顺序（本地≈0 成本 → 模板市场 → 联网需用户同意）；两阶段定位（蓝图 Demo 阶段样式不重要 / UI 还原阶段 1:1）
  • 素材需求预检 scripts/check_materials.py：BoardSpec 组件需求 vs 本地素材库自动比对，生成前暴露缺口，找不到素材不再空着——降级替代 + 素材需求清单 + 用户决策三选一
  • 蓝湖切图工作流：UI 还原阶段标准姿势——切图全部下载到本地 + 告知路径 + 逐元素细切（相同样式也要逐个切），不让 AI 直接访问蓝湖链接（积分成本高）

v1.4.0 已有能力：数据集 XML 一键生成、BoardSpec 校验器、报价估算、5 类交付文档、AI 解读、自然语言修改工具化、多角色矩阵/行业 benchmark、3 个端到端案例 v1.3.0 已有能力：功能四数据落地（分方言 SQL）、30+ 可视化组件、五态设计、品牌主题提取（WCAG 校验）、多端适配（16:9/9:16/21:9/adaptive）、像素级还原度校验

工作流决策树

用户输入是什么？
├── 客户原始需求（文字/会议纪要/字段表） ───→ 功能一：需求整理
├── 已有需求大纲/指标清单 ──────────────────→ 功能二：原型图生成
├── 已有设计稿图片/原型图 ──────────────────→ 功能三：转 FVS 文件
├── 已有蓝湖 UI 切图（已下载到本地文件夹） ───→ 功能三：蓝湖还原模式
├── 已有指标清单 + 想接真实生产数据 ─────────→ 功能四：数据落地
├── 已有 BoardSpec/指标清单 + 要报价/交付文档 → 功能五：项目交付
└── "从头做一个驾驶舱/大屏" ─────────────────→
        功能一 → 用户确认 → 功能四（可选） → 用户确认 → 功能二 → 用户确认 → 功能三 → 功能五

每个功能节点完成后，向用户呈现产出物并请求确认，确认后再进入下一环节（不静默串联）。 功能节点可独立调用，也可串联通吃。

首次使用引导（功能三/四前置检查）

执行功能三（转 FVS）或功能四（数据落地需要 SQL 校验）前，必须确认 FineReport 工程路径已配置。 运行 python scripts/discover_finereport.py，按输出的 status 分支处理：

  • configured：路径此前已经用户确认，直接使用（可 --check 复查有效性）
  • candidates：向用户逐条展示候选路径（来源+路径），请求确认正确的一个——绝不静默采用自动识别结果
  • none：未找到任何工程，引导用户提供 FineReport 安装根目录

用户确认或提供路径后，运行 python scripts/discover_finereport.py --set <工程根目录>：

  • 输出 saved → 配置完成（保存在脚本同目录 config.json，机器本地文件，勿随技能分发）
  • 输出 invalid（exit 2）→ 告知用户"该路径缺少 webapps/webroot/WEB-INF/reportlets，不是有效工程"，请用户重新提供并再次 --set 校验，直到通过

用户认为自动识别错误时，请用户直接给出正确路径并走 --set 校验流程。配置失效时用 --reset 清除后重新引导。

功能一：客户需求智能整理

读取 references/requirement-analysis.md 获取完整方法论、输出模板与示例。

流程：识别业务场景（行业/角色/决策层级） → 拆解业务目标为可量化目标 → 梳理分析维度（时间/组织/业务） → 提取 KPI（区分结果指标与过程指标） → 定义计算口径（公式、来源表.字段、统计周期、聚合方式） → 数据可行性校验（v1.3.0 增加：字段完整性 + 时效性 + 粒度匹配度 + 历史数据长度评估）。

交付物（写入 Markdown 文件并 present_files）：

  1. 需求大纲（五段式：项目背景 / 建设目标 / 看板整体规划 / 分析维度体系 / 数据来源说明）
  2. 关键指标清单表（9 列标准表 + 4 列质量评估，见 references 中的模板）
  3. 可选的「指标地图」（战略→管理→执行三级树，标注因果/分解关系）
  4. v1.4.0 新增：多角色看板矩阵（references/role-matrix.md）、行业 benchmark 查漏补缺（references/industry-benchmarks.md）、数据权限矩阵、数据质量 5 维评估

质量红线：

  • 计算公式必须可直接映射到 SQL 或 FineReport 数据集
  • 无法确定数据来源的标注"待确认"，并附 references/data-binding.md 中的可行性评估模板
  • 输出格式标准化，供功能二 / 功能四直接消费

可参考 examples/case-sales-cockpit/requirements.md 的五段式样例。

功能二：可视化看板原型图生成（通用组合式设计系统）

读取 references/board-spec.md（核心：三张映射表 + BoardSpec JSON Schema v2 + 领域适配矩阵 + v1.3.0 增强能力 + 质量红线）与 references/prototype-design.md（视觉规范与实现细节）。

通用机制（v1.1.0+ 起覆盖任意业务场景）：业务是无穷的，但底层要素有限——任何指标归入 11 类语义之一（v1.3.0 扩展到 30+ 高级组件），任何布局归入 4 种模式之一，任何风格归入 4 套主题预设 + custom 品牌主题。

v1.3.0 设计系统：

  • 4 套主题预设：tech-blue（默认）/ dark-green（政务能源）/ light-business（汇报）/ warm-orange（制造）
  • 1 套自定义主题：scripts/extract_brand.py 从 Logo 提取主色，WCAG 对比度自检，自动写入 CSS 变量
  • 4 种比例：16:9 / 9:16（mobile-stack 强制）/ 21:9（超宽）/ adaptive
  • 5 态设计：加载/空/异常/hover/active

流程：

  1. 将功能一的指标清单逐条做语义分类（11 类基础 + 30 高级）
  2. 命中领域时用 board-spec.md 第七节的领域适配矩阵提示常用指标（查漏补缺，用户可删）；未命中领域完全不受影响
  3. 组装 BoardSpec JSON（主题、布局、pages[]、每页 components[]、interactions/states/note/dataBinding）
  4. 与用户确认 BoardSpec 后再生成 HTML，避免返工
  5. 基于 assets/dashboard-kit.html v1.3.0 组件库（含 screen4 高级组件 3D/雷达/仪表/箱线/关系/飞线/视频/说明卡）组装高保真原型
  6. 图表配色一律从 CSS 变量读取，涨红跌绿（中国惯例），预警红橙黄，模拟数据须业务合规
  7. 浏览器截图导出 PNG（建议 2x 分辨率）

v1.3.0 新增能力：

  • 自然语言修改：用户口语化描述（如"把左上角的 KPI 卡换成红色预警风格"）→ Agent 解析 → BoardSpec diff/merge → 重新生成（最小变更）
  • 轻交互演示：筛选条可点、Tab 可切、hover 显口径说明

交付物：

  • BoardSpec JSON（供确认与功能三复用）
  • 高保真 HTML 原型（present_files 预览，存为功能三的视觉基准）
  • PNG 截图（1920×1080 或 9:16/21:9 自适应），命名 看板名称_序号_页面主题.png

可参考 examples/case-sales-cockpit/board-spec.json 和 case-finance-risk/board-spec.json。

功能三：设计图转 FVS 文件

读取 references/fvs-format.md 获取 FVS 文件格式逆向知识、引用闭环规则、素材库获取方式。读取 references/component-attrs.md（v1.3.0 新增）获取组件属性全量映射与 FVS 兼容性快速对照。

前置：完成「首次使用引导」确认工程路径。

流程：

  1. 解析设计图（画布尺寸、区域划分、组件类型/坐标/尺寸、配色、文字内容）
  2. v1.5.0 素材需求预检（必做）：python scripts/check_materials.py board-spec.json —— 组件需求 vs 本地素材库自动比对，输出缺口报告；有缺口先与用户确认「降级替代 or 补素材」，禁止找不到素材就空着（策略详见 references/material-strategy.md）
  3. 获取收割素材（本地扫描 --materials 成本≈0 默认 → 帆软官方模板市场 app.fanruan.com/templates 引导用户下载 → 全网搜索成本高需用户同意）
  4. 用 scripts/build_fvs_template.py 组装 FVS（骨架 + 收割图表 + PIL 背景图 + store.json/editor.tpl/precompute 打包）
  5. v1.3.0 增量修改：支持 BoardSpec diff/merge 模式，只更新变更组件，不整体重打包
  6. v1.3.0 数据落地联动：根据 dataMode 选择嵌入式（演示）或 SQL 数据集（生产）；后者按 references/data-binding.md 收割 SQLTableData 样例
  7. 9 项结构校验 + v1.3.0 像素级还原度校验（compare_visual.py）
  8. 输出还原度校验报告（含差异热力图 PNG）

v1.5.0 蓝湖切图还原模式（UI 还原阶段，客户有 UI 设计稿时）：

  • 不让 AI 直接访问蓝湖链接（实测积分消耗极高）；让用户把切图全部下载到本地文件夹并告知路径
  • 切图粒度要求（务必转告 UI）：每个视觉元素单独切，相同样式也不能只切一个——每个组件实例需要独立素材文件，复用会定位错乱；文件夹内附整体效果图作还原基准
  • 按"整图定布局 + 切图贴组件"组装 FVS；两阶段定位见 references/material-strategy.md 第一节（蓝图 Demo 阶段样式不重要，排版布局与指标正确即可）

v1.3.0 增强：

  • 组件属性逐项对齐（不再"大概像"），对照 references/component-attrs.md 22 类组件清单
  • 字体兼容性检查（FVS 中文安全列表：微软雅黑/思源黑体/苹方）
  • 设计器锁定文件检测（避免 PermissionError）
  • 性能与版本兼容检测（组件数预警 / 图片压缩 / SQL EXPLAIN 建议）

交付物：

  • .fvs 文件保存至 FineReport 工程 reportlets 目录
  • 还原度校验报告（组件清单 + 9 项结构 + 像素级 SSIM + 差异热力图）

质量红线：结构合法 ≠ 渲染成功，交付时必须提示用户在设计器中实测打开；设计器打开模板时会锁定文件，写回前先让用户关闭模板。

功能四（v1.3.0 新增）：数据落地 —— 指标 → SQL → 数据集 → 数据字典

读取 references/data-binding.md（核心：指标 → SQL 六要素映射 + 方言差异速查 + EmbeddedTableData 与 SQLTableData 双模式）。

前置：完成「首次使用引导」，功能一已输出指标清单。

流程：

  1. 用户提供字段表（Excel/DDL/表结构文档）→ Agent 生成 数据字典.md（维度表/事实表识别、字段类型映射、中文别名、四项质量评估）
  2. 用户跑 python scripts/gen_sql.py metrics.json --dialect mysql --out sql_out：
    • 自动生成分方言 SQL 文件（MySQL / Oracle / SQL Server / 达梦）
    • 4 类指标自动适配：aggregate（聚合） / ratio（先聚合后相除）/ yoy（LAG 窗口函数）/ share（占比）
    • 比率/除法必含 NULLIF 防除零
    • 每条 SQL 附 SELECT * FROM (...) preview LIMIT 5 预览建议
    • 生成 数据字典.md + README.md 待确认清单
  3. 用户执行 SQL 验证数据可得、量级合理
  4. 生产模式：收割一个 SQLTableData 样例（用户在设计器中创建并保存）→ 解包 <TableData> XML 块作为结构模板 → 批量生成其余数据集
  5. 数据连接清单：交付 db.xml 风格说明（不含密码，由用户在平台录入）
  6. 图表 .chart XML 中 <Name> CDATA 同步指向新数据集名

v1.3.0 数据模式选择： | 模式 | BoardSpec 字段 | 适用 | 实现 | |---|---|---|---| | embedded | dataMode: "embedded" | 演示、原型确认 | 数据嵌入 editor.tpl 的 <TableDataMap> | | dataset | dataMode: "dataset" | 生产 | SQL + 数据连接引用 + 参数 |

交付物：

  1. sql_out/{dialect}/{i}_{指标名}.sql：每个指标一条 SQL
  2. sql_out/数据字典.md：表结构与质量评估
  3. sql_out/README.md：生成报告 + 待确认清单
  4. 数据连接清单（不含密码）

可参考 examples/case-sales-cockpit/metrics.json（输入格式样例）+ 跑 gen_sql.py 实际生成的 SQL。

v1.4.0 数据集 XML 一键生成：python scripts/gen_dataset.py metrics.json --board board-spec.json --out dataset_out

  • 直接产出 FineReport 数据集 XML：datasets_embedded/（演示用嵌入式）+ datasets_sql/（生产用 SQL 数据集）
  • TableDataMap_snippet.xml：可直接合并进 editor.tpl 的片段
  • 数据连接清单.md（db.xml 风格，不含密码）+ 组件绑定映射.md（图表 → 数据集 → 字段列）
  • 不再完全依赖"收割 SQLTableData 样例"，收割降级为校验手段

功能五（v1.4.0 新增）：项目交付 —— 报价估算 · 交付文档 · AI 解读

前置：功能一（指标清单）与功能二（BoardSpec）已完成。

流程与工具：

  1. BoardSpec 校验：python scripts/check_boardspec.py board-spec.json
    • 交互完整性（声明了 drill/linkage 但目标组件不存在 → 报错）
    • 多页合理性（每页组件数 vs 布局模式上限）、组件属性合法性、必填项缺失警告
    • 功能二/三执行前必跑，全部 ✅ 才进入下一步
  2. 报价估算：python scripts/estimate_project.py board-spec.json --out 项目估算单.md
    • 基于组件数（基础/进阶/高级分档）/页面数/数据源数/交互点数估算人天
    • 输出设计/开发/测试/部署四阶段明细 + 三档报价（基础/进阶/高级）
  3. 交付文档：python scripts/gen_deliverables.py --req requirements.md --board board-spec.json --metrics metrics.json --out deliverables/
    • 自动生成 5 类文档：①需求规格说明书 ②指标口径文档 ③操作手册（含部署挂载步骤）④验收 checklist ⑤培训材料
  4. AI 数据解读：python scripts/ai_insight.py board-spec.json --data 数据快照.json --out insight_out/
    • 生成 LLM prompt 模板 + 解读面板 HTML；Agent 调用自身 LLM 产出 1-3 句自然语言解读（如"本月销售额同比+12%，主要由华东区域贡献"），写入大屏"AI 解读"面板
  5. 自然语言修改：python scripts/ai_modify_boardspec.py board-spec.json --say "把左上角的KPI换成红色预警风格"
    • 口语 → 原子操作（move_component/set_color/replace_type/add_kpi/remove_component）→ diff 输出，用户确认后合并

交付物：项目估算单.md + deliverables/ 5 文档 + insight_out/ 解读面板。

可参考 examples/case-finance-risk/（估算单 + 5 交付文档 + AI 解读面板全套样例）。

关键约束（全局）

  • 严格遵循 FineReport 11.0 FVS 格式规范，不使用未经测试支持的组件或属性
  • 所有文本、组件命名、数据集配置完美支持中文
  • 设计图含无法识别的组件时，明确提示并给出降级方案，不静默失败
  • 对已生成 FVS 支持增量修改（只改 store.json 不够，editor.tpl 内嵌 store 必须同步修改）
  • v1.3.0 诚实边界：FVS 落地不了的（如 3D 地球、子弹图、和弦图），用最接近的"降级版本"——禁止为视觉效果强行捏造内部结构

资源清单（v1.5.0）

| 资源 | 用途 | |---|---| | references/requirement-analysis.md | 功能一方法论、输出模板、指标清单示例、v1.4.0 深化入口 | | references/role-matrix.md | v1.4.0 新增：多角色看板矩阵、指标三级分层、数据质量 5 维评估、数据权限矩阵 | | references/industry-benchmarks.md | v1.4.0 新增：12+ 行业常见指标库（零售/制造/财务/物流/医疗/政务等），查漏补缺用 | | references/board-spec.md | 功能二核心：BoardSpec Schema、11 类语义 + 30 高级组件、4 布局、5 主题 + custom、领域适配矩阵、移动端/自适应、自然语言修改、diff/merge | | references/prototype-design.md | 功能二视觉规范、字体白名单、动效、轻交互预览、智能配色、HTML 实现与截图导出 | | references/fvs-format.md | 功能三 FVS 格式逆向知识、引用闭环、收割流程、9 项校验、性能检测、版本兼容、部署挂载、设计器锁定检测、蓝湖切图模式 | | references/material-strategy.md | v1.5.0 新增：素材策略——两阶段定位（蓝图 Demo / UI 还原）、三级获取顺序与成本、缺口兜底（不空着）、蓝湖切图工作流与粒度要求 | | references/data-binding.md | 功能四：指标→SQL 六要素映射、方言差异速查、EmbeddedTableData 与 SQLTableData 双模式、数据字典 | | references/component-attrs.md | 22 类组件属性全量映射 + FVS 兼容性快速对照 | | scripts/discover_finereport.py | 工程路径自动发现/确认/校验（--set/--check/--reset/--materials）、素材库图表统计 | | scripts/build_fvs_template.py | FVS 组装打包脚本（工程路径自动解析，CONFIG 区配置后运行） | | scripts/gen_sql.py | 指标清单 → 分方言 SQL（4 方言）+ 数据字典 Markdown + README | | scripts/gen_dataset.py | v1.4.0 新增：指标+BoardSpec → FineReport 数据集 XML（嵌入式/SQL 双模式）+ 数据连接清单 + 组件绑定映射 | | scripts/check_boardspec.py | v1.4.0 新增：BoardSpec 校验器（交互完整性/多页合理性/属性合法性/必填项） | | scripts/check_materials.py | v1.5.0 新增：素材需求预检（BoardSpec 组件需求 vs 本地素材库 → 缺口报告 + 降级建议 + 模板市场下载清单） | | scripts/estimate_project.py | v1.4.0 新增：BoardSpec → 人天与报价估算单（四阶段明细 + 三档报价） | | scripts/gen_deliverables.py | v1.4.0 新增：自动生成 5 类交付文档（需求规格/指标口径/操作手册/验收 checklist/培训材料） | | scripts/ai_insight.py | v1.4.0 新增：组件数据快照 → LLM 解读 prompt + AI 解读面板 HTML | | scripts/ai_modify_boardspec.py | v1.4.0 新增：自然语言 → BoardSpec 原子操作 diff（确认后合并） | | scripts/extract_brand.py | Logo 图 → 品牌主色 + custom 主题（含 WCAG AA 对比度自检） | | scripts/compare_visual.py | 原型 vs 实际渲染 像素级对比 + 差异热力图 + SSIM 相似度分数 | | assets/dashboard-kit.html | 通用组件库（生成底座）：4 主题 + custom，30+ 组件（含桑基/瀑布/词云/热力/翻牌器/滚动字幕/时间轴/Tab 容器/区域下钻），5 布局模式，五态，轻交互，移动端 | | examples/case-sales-cockpit/ | 销售驾驶舱端到端案例（requirements/metrics/board-spec + SQL + 数据集 XML 全套产出） | | examples/case-finance-risk/ | 财务风险看板端到端案例（交互：钻取/联动/筛选/跳转 + 估算单 + 5 交付文档 + AI 解读面板） | | examples/case-production-monitor/ | v1.4.0 新增：生产监控大屏案例（OEE/良率/稼动率 + 3D + 实时刷新 + 数据集 XML + 交付文档） |

关键约束与诚实边界

| 项 | 说明 | |---|---| | FVS 3D 组件（3D 地球/3D 城市） | 原型 HTML 可 demo，FVS 不支持 3D，降级用平面地图/柱图 | | FVS 子弹图 | 原生不支持，用条形图 + markLine 模拟 | | FVS 和弦图 | 不支持，改桑基或关系图 | | FVS 视频嵌入 | 部分支持（设计器 11.0+），用 iframe 或插件 | | 交互（钻取/联动/超链接） | 收割式 落地：用户在设计器配置一处 → diff 得到结构 → 批量应用；禁止凭记忆手写 | | 移动端 FVS | 原生支持自适应缩放；移动端入口按设计器配置（用户实操） | | MySQL 5.7 同比 | 窗口函数不支持，需改自连接（gen_sql.py 已自动警告） |

Pay Skill 上线状态（截至 v1.5.0）

| 项 | 状态 | |---|---| | 1. 技能质量校验（package_skill.py） | ✅ | | 2. 去硬编码路径（discover_finereport.py） | ✅ | | 3. frontmatter metadata（version/tags/pricing） | ✅ | | 4. 端到端案例 | ✅ 3 个（销售 + 财务 + 生产监控） | | 5. 企业认证 / 个人开放 | ⏳ 等待平台开放 | | 6. 用户反馈闭环 | ✅ v1.5.0 首个真实用户反馈已闭环（素材策略 + 蓝湖工作流） |

版本历史

  • v1.5.0（当前）：素材策略文档 + 素材需求预检（check_materials.py，缺口不空着）+ 蓝湖切图还原工作流——源自首个真实售前用户反馈
  • v1.4.0：数据集 XML 一键生成 + BoardSpec 校验器 + 报价估算 + 5 类交付文档 + AI 解读 + 自然语言修改工具化 + 多角色矩阵/行业 benchmark + 第 3 案例（生产监控）+ 组件库扩充（桑基/瀑布/词云/热力/翻牌器等）
  • v1.3.0：新增功能四数据落地 + 30+ 高级组件 + 五态 + 品牌主题 + 移动端 + 2 个案例
  • v1.2.0：升级组合式设计系统（4 布局 / 4 主题 / 11 类组件 / 三态 / 轻交互 / 移动端）
  • v1.1.0：领域适配矩阵
  • v1.0.x：三功能基础能力 + FVS 逆向 + 设计器实测