Excel转INI转换工具

这是一个将Excel文件转换为INI格式配置文件的工具，支持多种数据类型（ItemData、SpellData、UnitData等）。

功能特性

• 📊 支持读取Excel文件（.xls和.xlsx格式）
• 🔄 将Excel工作表转换为INI配置文件
• 🎯 自动识别数据类型（通过工作表名称中的 &...& 标记）
• 📁 支持多种数据类型：ItemData、SpellData、UnitData、GameModeData、LevelData、MonsterTeamData
• 🖥️ 提供图形用户界面（GUI）
• 🔧 模块化架构，易于扩展新的数据类型

安装依赖

pip install -r requirements.txt

使用方法

方法1: 图形界面（推荐）

python ui_window.py

在GUI界面中：

1. 选择要转换的Excel文件
2. 选择文件类型（或使用auto模式自动识别）
3. 选择输出文件夹
4. 点击"开始转换"

方法2: 命令行/编程接口

from output_handler import OutputHandler

# 转换Excel文件为INI
result = OutputHandler.export_to_ini(
    excel_file_path="path/to/excel.xlsx",
    output_dir="output_folder",  # 可选，默认为Excel文件所在目录
    file_type="auto"  # 或 "ItemData", "SpellData", "UnitData" 等
)

print(f"成功生成 {len(result['files'])} 个INI文件")

工作表命名规则

工具通过工作表名称中的 &...& 标记来识别数据类型：

• &item& 或 &ItemData& → 使用ItemGenerator
• &skill& 或 &SpellData& → 使用SkillGenerator
• &unit& 或 &UnitData& → 使用UnitGenerator
• &gamemode& 或 &GameModeData& → 使用GameModeGenerator
• &level& 或 &LevelData& → 使用LevelGenerator
• &monsterteam& 或 &MonsterTeamData& → 使用MonsterTeamGenerator

注意：标记是大小写敏感的。

输出文件

根据数据类型，工具会生成相应的INI文件：

• ItemData: ItemData.ini, SpellData.ini
• SpellData: SpellData.ini
• UnitData: UnitData.ini, SpellData.ini
• GameModeData: GameModeData.ini
• LevelData: LevelData.ini
• MonsterTeamData: MonsterTeamData.ini

项目结构

PythonReadAndWriteIni/
├── ui_window.py              # GUI界面
├── output_handler.py         # 输出处理模块
├── excel_reader.py            # Excel读取模块
├── ini_generator.py           # INI生成器（向后兼容层）
├── generators/                # 生成器模块
│   ├── base_generator.py      # 基础生成器类
│   ├── item_generator.py      # 物品生成器
│   ├── skill_generator.py     # 技能生成器
│   ├── unit_generator.py      # 单位生成器
│   ├── gamemode_generator.py  # 游戏模式生成器
│   ├── level_generator.py     # 关卡生成器
│   ├── monsterteam_generator.py # 怪物队伍生成器
│   └── generator_manager.py   # 生成器管理器
└── requirements.txt           # 依赖列表

扩展指南

要添加新的数据类型生成器，请参考 generators/README.md 中的扩展指南。

注意事项

• 需要安装pandas、openpyxl和xlrd库
• 工作表名称必须包含 &...& 标记才能被处理
• 标记是大小写敏感的
• 如果文件损坏或格式不正确，会显示错误信息但不会中断整个转换过程