数据管线概述
Fink Framework 内置了一套 自动化、高扩展、安全稳定 的数据驱动管线，用于将 Excel 配置表转换为运行时可读取的强类型数据。
框架支持从 Excel (.xlsx) 自动生成：
- C# 强类型数据类
- JSON 数据文件
- Binary（二进制 可选是否加密）文件
并根据 运行时数据源模式（JSON/Binary） 自动选择导出路径与最终加载方案。
关于 运行时数据源和加密开关等全局设置详细阅读安装与初始化界面中全局配置说明板块。
1. 核心工作流
整个数据管线的设计遵循 "配置 -> 生成 -> 导出 -> 使用" 的标准流程：
① 配置（Config）
策划在 Excel 中填写游戏数值，第一行为变量名，第二行变量类型， 第三行注释，第四行起为实际数据。 详情请看 Excel 配表规则。
② 生成（Generate）
工具自动解析 Excel，生成 C# 数据结构类与容器类，保证所有数据均为强类型结构。
③ 导出（Export）
生成的数据将序列化为 JSON 与 Binary 文件。 最终导出的路径根据 “运行时数据源模式” 自动决定。
④ 使用（Use）
运行时通过统一的 API 加载强类型数据，框架会自动选择 JSON 或 Binary 源并执行反序列化。
2. 核心特性
① 全自动代码生成
根据 Excel 表头自动生成 C# 数据结构。- 支持int / float / bool / string等数十种基础类型
- 支持 Vector2/3/4 / Color / List / Dictionary 等常用扩展类型
- 支持 自定义类和嵌套类数组/字典/列表/多层容器 等复杂类型
② 智能 QA 校验
生成阶段自动执行多项验证，最大化降低脏数据进入游戏的风险。- 字段级非空与合法性检查
- 字段中变量名重复检查
- 数据行解析测试检查（逐格解析）
- 对每张表统计 汇总全局 QA 结果
③ 高度可扩展
数据管线中有多个环节可自定义拓展更多内容。- 生成的代码数据模板可编辑
- 支持自定义 Converter 解析
- 自动修正非标准 JSON/对中文符号自动清洗
注意: AutoGen/ 目录中的代码由工具自动维护，请勿手动修改；否则下次生成时可能被覆盖。
现在你已经了解数据管线的整体流程，建议继续阅读下一章节：