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

## 📋 概述

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

## 🚀 快速开始

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

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

### 方法二：分步部署

1. **安装依赖库**：双击 `安装依赖库.bat`
2. **启动工具**：双击 `启动配置工具.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环境"
**解决**：
1. 下载安装Python：https://www.python.org/downloads/
2. 安装时勾选"Add Python to PATH"
3. 重启电脑后重新运行

### Q2: 依赖库安装失败
**问题**：pandas或openpyxl安装失败
**解决**：
1. 检查网络连接
2. 使用国内镜像源：
   ```bash
   python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pandas openpyxl
   ```
3. 手动安装：
   ```bash
   python -m pip install pandas
   python -m pip install openpyxl
   ```

### Q3: Excel文件无法识别
**问题**：配置表无法预览或导入
**解决**：
1. 确认Excel文件格式正确
2. 检查文件名是否匹配支持列表
3. 确保Excel文件未被其他程序占用

### Q4: 权限问题
**问题**：无法写入JSON文件
**解决**：
1. 以管理员身份运行批处理文件
2. 检查目标目录的写入权限
3. 关闭可能占用文件的其他程序

## 🔧 高级配置

### 添加新的配置表支持

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

```python
'新配置表.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` 中的安装命令，使用其他镜像源：

```batch
# 清华源
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
```

## 📞 技术支持

如遇到其他问题，请联系技术支持并提供以下信息：
1. 操作系统版本
2. Python版本（运行 `python --version` 查看）
3. 错误信息截图
4. 具体操作步骤

---

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