FineReport 11.0 驾驶舱智能开发助手

打通「客户需求 → 需求大纲与指标体系 → 可视化原型 → FVS 可运行文件」全链路。三个功能既可串联使用，也可独立调用。

工作流决策树

用户输入是什么？
├── 客户原始需求（文字/会议纪要/字段表）──→ 功能一：需求整理
├── 已有需求大纲/指标清单 ────────────────→ 功能二：原型图生成
├── 已有设计稿图片/原型图 ────────────────→ 功能三：转 FVS 文件
└── "从头做一个驾驶舱/大屏" ─────────────→ 功能一 → 确认 → 功能二 → 确认 → 功能三

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

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

执行功能三（转 FVS）前，必须确认 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（区分结果指标与过程指标）→ 定义计算口径（公式、来源表.字段、统计周期、聚合方式）→ 数据可行性校验。

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

需求大纲（五段式：项目背景/建设目标/看板整体规划/分析维度体系/数据来源说明）
关键指标清单表（9 列标准表，见 references 中的模板）

质量红线：计算公式必须可直接映射到 SQL 或 FineReport 数据集；无法确定数据来源的标注"待确认"；输出格式标准化，供功能二直接消费。

功能二：可视化看板原型图生成

读取 references/prototype-design.md 获取布局规划、图表类型匹配表、视觉规范与实现细节。

流程：按指标数量确定页面数（>12 个核心组件自动拆多页，按业务主题分页）→ 规划网格布局（顶部标题区+筛选区+中央核心指标区+底部明细区）→ 按「分析诉求→图表类型」匹配表选型 → 基于 assets/dashboard-template.html 骨架生成高保真 HTML 原型（ECharts + 深色科技主题，模拟数据须符合业务逻辑）→ 用浏览器截图导出 PNG。

交付物：

高保真 HTML 原型（present_files 预览，作为视觉基准与功能三的输入）
PNG 截图，命名 看板名称_序号_页面主题.png（1920×1080，建议 2x 分辨率）

功能三：设计图转 FVS 文件

读取 references/fvs-format.md 获取 FVS 文件格式逆向知识、引用闭环规则、素材库获取方式。

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

流程：解析设计图（画布尺寸、区域划分、组件类型/坐标/尺寸、配色、文字内容）→ 获取收割素材（本地扫描 --materials → 帆软官方模板市场 app.fanruan.com/templates → 全网搜索，详见 references）→ 用 scripts/build_fvs_template.py 组装 FVS（骨架 + 收割图表 + PIL 背景图 + store.json/editor.tpl/precompute 打包）→ 执行 9 项结构校验 → 输出还原度校验报告。

交付物：

.fvs 文件保存至 FineReport 工程 reportlets 目录
还原度校验报告（组件清单、还原情况、差异项）

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

关键约束（全局）

严格遵循 FineReport 11.0 FVS 格式规范，不使用不支持的组件或属性
所有文本、组件命名、数据集配置完美支持中文
设计图含无法识别的组件时，明确提示并给出替代方案，不静默失败
对已生成 FVS 支持增量修改（只改 store.json 不够，editor.tpl 内嵌 store 必须同步修改）

资源清单

| 资源 | 用途 | |---|---| | references/requirement-analysis.md | 功能一方法论、输出模板、指标清单示例 | | references/prototype-design.md | 功能二布局/图表选型/视觉规范、HTML 实现与截图导出 | | references/fvs-format.md | 功能三 FVS 格式逆向知识、引用闭环、收割流程、校验清单 | | scripts/discover_finereport.py | 工程路径自动发现/确认/校验（--set/--check/--reset/--materials）、素材库图表统计 | | scripts/build_fvs_template.py | FVS 组装打包脚本（工程路径自动解析，CONFIG 区配置后运行） | | assets/dashboard-template.html | 深色科技风大屏原型 HTML 骨架（ECharts） |