# comfyui_ctrlscripts

**Repository Path**: qiufengruge/comfyui_ctrlscripts

## Basic Information

- **Project Name**: comfyui_ctrlscripts
- **Description**: comfyui集成工具。安装comfyui如此之简单

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gitee分包文件下载和安装工具

## 📋 功能概述

这是一个自动化工具，用于从Gitee下载分包文件，合并后自动安装。主要用于下载和安装大型exe文件的分包版本。

## ✨ 主要特性

- 🔄 **自动下载**：从Gitee自动下载分包文件
- 🔗 **智能合并**：根据配置文件自动合并分包文件
- 🚀 **静默安装**：支持静默安装模式，无需用户交互
- 🧹 **自动清理**：合并完成后自动删除临时下载文件
- 📁 **路径管理**：保持项目工作目录干净，文件存储在上级目录

## 📁 目录结构

```
D:\AI\comfyui_scripts\                    # 项目根目录
├── download_and_install.bat              # 批处理启动文件
└── py_scripts\tools\
    ├── download_and_install.py           # Python主脚本
    └── README.md                         # 本文档

D:\AI\                                    # 上级目录（自动创建）
├── split_exes\                          # 临时下载目录（自动清理）
└── tools\                               # 合并后的exe文件目录
```

## 🚀 使用方法

### 方法一：使用批处理文件（推荐）

1. 在项目根目录运行：
   ```bash
   download_and_install.bat
   ```

### 方法二：直接运行Python脚本

1. 切换到项目根目录
2. 运行Python脚本：
   ```bash
   python py_scripts\tools\download_and_install.py
   ```

## ⚙️ 配置说明

### 路径配置

脚本会自动计算以下路径：

- **当前脚本位置：** `py_scripts/tools/download_and_install.py`
- **项目根目录：** `D:\AI\comfyui_scripts\`
- **上级目录：** `D:\AI\`
- **下载目录：** `D:\AI\split_exes\`（临时，自动清理）
- **工具目录：** `D:\AI\tools\`（合并后的exe文件）

### 源地址配置

```python
BASE_URL = "https://gitee.com/qiufengruge/comfyui_ctrlscripts/raw/master/split_exes"
```

## 📋 工作流程

### 1. 下载阶段
- 下载 `config.json` 配置文件
- 根据配置下载所有分包文件
- 文件保存到临时目录：`D:\AI\split_exes\`

### 2. 合并阶段
- 读取每个分包的 `info.json` 元数据
- 按顺序合并所有分包文件
- 生成完整的exe文件
- 保存到：`D:\AI\tools\`

### 3. 清理阶段
- 自动删除临时下载目录
- 保持项目工作目录干净

### 4. 安装阶段
- 扫描 `D:\AI\tools\` 目录中的exe文件
- 尝试静默安装（`/S` 参数）
- 如果静默安装失败，切换到普通安装模式

## 🔧 技术细节

### 依赖库
- `requests`：HTTP下载
- `json`：配置文件解析
- `pathlib`：路径处理
- `subprocess`：进程管理
- `shutil`：文件操作
- `time`：请求延迟

### 错误处理
- 网络连接失败重试
- 文件下载失败提示
- 安装失败回退机制
- 异常情况详细日志

### 安全特性
- 请求延迟避免服务器压力
- 文件完整性检查
- 安装超时保护
- 异常捕获和处理

## 📝 日志输出

脚本运行时会显示详细的进度信息：

```
============================================================
        Gitee分包文件下载和安装工具
============================================================
源地址: https://gitee.com/qiufengruge/comfyui_ctrlscripts/raw/master/split_exes

步骤1: 下载config.json
✅ 下载成功: D:\AI\split_exes\config.json

步骤2: 下载所有分包文件
需要下载 12 个文件
✅ 下载成功: D:\AI\split_exes\Git-2.50.0.2-64-bit\info.json
...

步骤3: 合并分包文件
✅ 合并完成: D:\AI\tools\Git-2.50.0.2-64-bit.exe
✅ 所有文件合并完成!

清理下载的分包文件...
✅ 已删除下载目录: D:\AI\split_exes

步骤4: 安装exe文件
✅ Git-2.50.0.2-64-bit.exe 静默安装完成
✅ 安装完成!

============================================================
✅ 所有操作完成!
============================================================
```

## 🐛 故障排除

### 常见问题

1. **Python未找到**
   - 确保系统已安装Python
   - 或确保项目根目录下有 `python\python.exe`

2. **下载失败**
   - 检查网络连接
   - 确认Gitee源地址可访问
   - 检查防火墙设置

3. **合并失败**
   - 确认所有分包文件下载完整
   - 检查磁盘空间是否充足

4. **安装失败**
   - 确认有管理员权限
   - 检查目标目录是否可写
   - 确认exe文件完整性

### 调试模式

如需调试，可以直接运行Python脚本查看详细错误信息：

```bash
python py_scripts\tools\download_and_install.py
```

## 📄 许可证

本项目遵循开源许可证，具体请参考项目根目录的LICENSE文件。

## 🤝 贡献

欢迎提交Issue和Pull Request来改进这个工具！

---

**最后更新：** 2025年7月3日
**版本：** 1.0.0