# IntegratedTool 使用文档

## 重要提示

**选择完路径后，下次打开工具会默认选择上次选择的位置。**

## 版本更新说明

**v2.2.0 新特性：**
- ✨ 简化路径配置，只需配置两个基础路径
- 🔧 其他路径自动推导，无需手动选择
- 📁 thrift-related 项目路径使用相对路径

## 路径配置说明

### 只需配置两个基础路径

#### 1. Docs 项目路径
选择您的 Docs 项目根目录，工具将自动推导：
- `Docs/tool/cfg/cfg_txt.json` (配置文件)
- `Docs/config` (Excel 配置文件目录)

#### 2. Unity 主项目路径
选择您的 Unity 主项目根目录（例如：MeowMent_New），工具将自动推导：
- `MeowMent_New/Assets/Scripts/thrift/gen-netstd` (C# 代码目录)
- `MeowMent_New/Assets/Resources/ConfigData` (Bytes 资源目录)
- `MeowMent_New/Assets/GameMain/Scripts/DR_Generated` (DR 生成代码目录)

### 自动推导的路径（无需配置）

以下路径由工具自动确定，无需手动选择：

#### thrift-related 项目相关（相对路径）
- Thrift 编译器: `thrift-related/compiler/exe/thrift.exe`
- Thrift 文件目录: `thrift-related/thrift-files/meowment`
- C# 输出目录: `thrift-related/compiled_output/csharp`
- Bytes 输出目录: `thrift-related/binary_output`

## 执行流程

配置完两个基础路径后，点击 **"刷新路径预览"** 查看所有派生路径。

确认路径无误后，点击 **"开始执行完整流程"** 按钮。

工具将自动完成以下步骤：
1. 编译 Thrift 文件
2. 生成 C# 代码
3. 生成二进制配置文件
4. 复制文件到 Unity 项目
5. 生成 DR 代码

## 故障排查

如果执行过程中出现问题，请查看 **执行日志** 获取详细的错误信息。

### 常见问题

1. **路径不存在错误**
   - 检查 Docs 项目路径是否正确
   - 确认 Docs 项目内包含 `tool/cfg/cfg_txt.json` 和 `config` 目录

2. **Unity 项目路径错误**
   - 确认选择的是 Unity 项目根目录（包含 Assets 文件夹的目录）
   - 检查项目内是否存在所需的目标目录结构

---

**注意：** 确保所有派生路径都存在且可访问，否则流程可能会失败。
