游戏配置管理工具 - 部署使用说明

📋 概述

本工具用于管理游戏配置数据，支持从Excel表格导入配置到JSON文件。适用于策划人员在不同电脑上快速部署和使用。

🚀 快速开始

方法一：一键部署（推荐）

双击运行 一键部署工具.bat
按任意键 开始自动部署
等待完成 工具会自动检查环境、安装依赖、启动程序

方法二：分步部署

安装依赖库：双击 安装依赖库.bat
启动工具：双击 启动配置工具.bat

📦 系统要求

必需环境

Python 3.7+（如未安装，请访问 https://www.python.org/downloads/）
Windows 操作系统

依赖库

pandas>=1.3.0 - Excel文件读取支持
openpyxl>=3.0.0 - Excel文件写入支持
tkinter - GUI界面（Python内置）

📁 文件说明

excel/
├── config_manager.py          # 主程序文件
├── requirements.txt           # 依赖库列表
├── 启动配置工具.bat           # 启动脚本
├── 安装依赖库.bat             # 依赖安装脚本
├── 一键部署工具.bat           # 一键部署脚本
├── 部署使用说明.md            # 本说明文档
├── 敌人配置表.xlsx            # 示例配置表
├── 技能配置表.xlsx            # 示例配置表
└── 其他配置表...              # 其他Excel配置文件

🛠️ 使用方法

1. 启动工具

运行 一键部署工具.bat 或 启动配置工具.bat
等待GUI界面弹出

2. 选择配置表

在左侧文件列表中勾选要导入的Excel配置表
支持多选，可同时处理多个配置表

3. 预览配置

点击 "预览选中文件" 按钮
在右侧文本区域查看解析结果
确认数据格式正确

4. 导入配置

点击 "导入配置" 按钮
系统自动将Excel数据转换为JSON格式
保存到对应的配置文件中

5. 其他功能

"清除选择"：取消所有文件选择
"备份配置"：备份当前JSON配置文件
"恢复默认"：恢复默认配置值

📊 支持的配置表

配置表名称	输出文件	说明
敌人配置表.xlsx	enemies.json	敌人属性配置
技能配置表.xlsx	skill.json	技能效果配置
方块武器配置表_更新_v2.xlsx	weapons.json	武器属性配置
BallController配置表.xlsx	ballController.json	球体控制参数
关卡配置表_完整版_更新_v2.xlsx	levels/	关卡配置文件

❗ 常见问题

Q1: Python环境问题

问题：提示"未找到Python环境" 解决：

下载安装Python：https://www.python.org/downloads/
安装时勾选"Add Python to PATH"
重启电脑后重新运行

Q2: 依赖库安装失败

问题：pandas或openpyxl安装失败解决：

检查网络连接

使用国内镜像源：

python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pandas openpyxl

手动安装：

python -m pip install pandas
python -m pip install openpyxl

Q3: Excel文件无法识别

问题：配置表无法预览或导入解决：

确认Excel文件格式正确
检查文件名是否匹配支持列表
确保Excel文件未被其他程序占用

Q4: 权限问题

问题：无法写入JSON文件解决：

以管理员身份运行批处理文件
检查目标目录的写入权限
关闭可能占用文件的其他程序

🔧 高级配置

添加新的配置表支持

如需支持新的Excel配置表，请在 config_manager.py 中的 config_mappings 字典添加配置：

'新配置表.xlsx': {
    'json_path': self.project_root / "assets/resources/data/new_config.json",
    'param_types': {
        '参数名1': str,
        '参数名2': int,
        '参数名3': float
    },
    'format_type': 'horizontal'  # 或 'vertical'
}

自定义安装源

如果默认的pip源速度较慢，可以修改 安装依赖库.bat 中的安装命令，使用其他镜像源：

# 清华源
python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pandas openpyxl

# 阿里源
python -m pip install -i https://mirrors.aliyun.com/pypi/simple/ pandas openpyxl

# 豆瓣源
python -m pip install -i https://pypi.douban.com/simple/ pandas openpyxl

📞 技术支持

如遇到其他问题，请联系技术支持并提供以下信息：

操作系统版本
Python版本（运行 python --version 查看）
错误信息截图
具体操作步骤

版本：v1.0
更新日期：2024年
维护者：AI Assistant

部署使用说明.md 4.7 KB Historie Surový