# Luban 数据格式转换规则

本工具用于把旧版游戏配置表转换为 Luban 风格的表格结构。旧格式可参考根目录 `sample_skill_list_template.csv`，Luban 结构可参考根目录 `luban范例.xlsx`。

## 输入文件

- 支持 `.csv`、`.xlsx`、`.xls`、`.xlsm`、`.ods`。
- CSV 建议使用 UTF-8 编码。
- Excel 中每个非空页签会单独转换成一个 Luban Sheet。

## 导出方式

- `合并 Excel`：把所有转换后的 Sheet 放在同一个 `.xlsx` 文件里。
- `多个 Excel`：每个转换后的 Sheet 单独生成一个 `.xlsx` 文件，并打包成 `.zip`。
- `当前 Sheet`：只导出当前预览的 Sheet 为单个 `.xlsx` 文件。

导出前可以填写文件名前缀或后缀，也可以留空：

- 前缀 `#`：`b.xlsx` 会导出为 `#b.xlsx`。
- 后缀 `#`：`b.xlsx` 会导出为 `b#.xlsx`。
- `多个 Excel` 模式下，前缀/后缀会加在 ZIP 内每个 `.xlsx` 文件名上。

## 旧格式识别

工具会查找以下标记行：

- `COLUMNS::`：英文字段名。
- `TYPES::`：字段类型。
- `COLUMNS::` 上方最近的 `#` 行：中文字段说明。

如果没有找到 `COLUMNS::` 或 `TYPES::`，工具会按原表内容输出，不主动改结构。

## version 字段规则

转换旧格式时，如果 `COLUMNS::` 里有英文字段 `version`，工具会自动无视这一列：

- `##var` 不输出 `version`。
- `##type` 不输出 `version` 对应类型。
- `##` 中文字段行不输出 `version` 对应中文名。
- 数据行、注释行中 `version` 对应位置的值也会同步跳过。

## Luban 输出结构

转换后的前 5 行固定为：

```text
##var    英文字段
##type   字段类型
##group  普通字段默认 c，备注列留空
##var    空
##       中文字段
```

旧格式第 8 行这类中文字段行会转换为 Luban 的 `##` 行。

## 备注列规则

旧格式中，如果中文字段名前面带 `#`，例如：

```csv
# 标题,技能品质,# 技能品质
COLUMNS::,skill_quality,s_deck
TYPES::,ENUM,STRING
```

转换到 Luban 时，这一列会作为策划备注/说明列保留，但不会作为导出字段：

```text
##var    skill_quality
##type   string
##group  c
##var
##       技能品质  技能品质
```

其中 `# 技能品质` 对应的列在 `##var`、`##type`、`##group` 中都会留空。

## 注释行规则

旧格式数据区中，首列以 `#` 开头的行会转换为 Luban 注释行，首列变为 `##`。

例如：

```csv
# 关联表格,,,,skill_prototype_config
```

会转换为：

```text
##,,,,skill_prototype_config
```

如果不想导出这些注释行，可以在工具顶部关闭“注释行”开关。

## 类型转换

常见类型会转换为 Luban 常用小写类型：

- `INT` / `INTEGER` -> `int`
- `LONG` / `long(14)` -> `long`
- `STRING` / `ENUM` / `TIME` -> `string`
- `FLOAT` -> `float`
- `DOUBLE` -> `double`
- `BOOL` / `BOOLEAN` -> `bool`

其他类型会转为小写后保留。
