Tableau Layout Converter & Design Inspector
在大型项目交付中，向客户解释动辄嵌套数十层的仪表板布局，以及背后错综复杂的数据关系，往往极其耗时且容易出现沟通偏差。这个工具的核心目的，就是通过自动化解析，让 Tableau 的内部结构绝对透明。
工具采用纯前端架构，包含三个核心功能模块：
1. 布局结构的精准解析 Tableau 的 .twb 文件本质上是一个结构复杂的 XML 文件。通过工具中的解析模块（xmlParser.ts 和 tableauParser.ts），程序会自动读取并转换这棵 XML 树。
- 参数提取： 精准提取
<dashboard>和内部各个<zone>标签的属性，包括类型（水平、垂直容器或工作表）、坐标（x, y）、尺寸（宽度、高度）以及内边距（padding）。 - 嵌套还原： 将原本机器友好的扁平 XML 代码，重新构建为符合人类直觉的层级嵌套对象，为后续的可视化奠定事实基础。
2. 1:1 视觉原型与白板协作 解析出坐标后，工具会生成一个与实际仪表板尺寸完全一致的线框图（Layout Visualizer）。
- 直观呈现： 不同的容器类型（如 layout-flow、layout-vertical）被渲染为不同颜色的区块，所有嵌套关系一目了然。
- 无缝协作： 相比于死板的截图，工具支持将整个结构直接导出为 Excalidraw JSON 文件。交付时，可以直接将这份文件导入在线白板，与客户在上面拖拽、修改、批注，极大地降低了需求对齐的沟通成本。
3. 数据模型与关系图谱自动化 数据口径的准确性是业务分析的生命线。工具的 DataModelViewer 模块会自动提取隐藏在文件中的数据层信息。
- 物理与逻辑层展示： 利用有向图算法（Dagre）自动对齐节点，绘制出类似 ER 图的数据模型。直观展示表与表之间的连接条件（Join 逻辑）以及关联的基数（一对多、多对多）。
- 底层逻辑暴露： 自动提取并高亮显示隐藏在数据源中的自定义 SQL（Custom SQL）代码。在与客户核对业务口径时，可以直接对着这份清单确认底层取数逻辑，避免了反复打开 Tableau 软件查看配置的麻烦。
绝对的数据安全
在涉及企业数据的项目中，安全性是第一前提。本工具的设计从物理限制和运行机制上阻断了泄漏风险：
- 纯前端运行： 所有文件读取（
FileReader）和解析全都在用户的本地浏览器中完成，没有任何数据会通过网络传输到后端服务器。 - 阻断数据包： 工具仅支持上传
.twb格式（仅包含 XML 结构说明），从代码层面明确拒绝.twbx（包含实际打包业务数据的格式）文件的上传。
—