# ezcopy

**Repository Path**: yzhcat/ezcopy

## Basic Information

- **Project Name**: ezcopy
- **Description**: EzCopy 是一个使用 aardio 语言开发的 Windows 桌面应用程序，用于本地文件批量复制和同步任务管理。该工具支持多种复制命令（如 fcp 和 robocopy），可以配置多个复制任务并批量执行。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EzCopy

一款基于 aardio 开发的 Windows 桌面文件复制和同步工具，支持批量任务管理和多种复制命令。

## 功能特点

- ? **批量任务管理** - 支持添加、修改、删除多个复制任务
- ? **选择性执行** - 通过复选框选择要执行的任务
- ? **多工具支持** - 内置支持 fcp 和 robocopy 两种复制工具
- ? **配置持久化** - 任务配置自动保存到 INI 文件
- ? **无弹窗模式** - 支持批量执行时跳过确认对话框
- ? **便捷操作** - 支持拖拽文件、剪贴板粘贴、文件夹选择器
- ? **日志输出** - 实时显示任务执行日志

## 界面预览

主界面包含：
- 任务列表（支持复选框）
- 添加/修改/删除/执行按钮
- 无弹窗模式开关
- 日志输出窗口

## 安装使用

### 运行程序

直接运行 `EzCopy.exe` 即可启动程序。

### 基本操作

1. **添加任务**
   - 点击"添加"按钮
   - 选择应用程序（fcp 或 robocopy）
   - 选择复制命令
   - 设置源路径和目标路径
   - 输入任务名称
   - 点击"保存"

2. **修改任务**
   - 在列表中选中要修改的任务
   - 点击"修改"按钮
   - 修改配置后保存

3. **删除任务**
   - 在列表中选中要删除的任务
   - 点击"删除"按钮并确认

4. **执行任务**
   - 勾选要执行的任务（可多选）
   - 点击"执行"按钮
   - 如需批量执行且无需确认，勾选"无弹窗"

## 配置说明

程序配置以GBK编码保存在 `配置文件.ini` 文件中，包含三个部分：

### 全局设置

```ini
[setting]
app=fcp,robocopy
```

### 应用程序配置

#### fcp 配置

```ini
[app_fcp]
path=./fcp.exe
list=diff,noexist_only,update,force_copy,exist_diff,exist_update,sync,sync_update,move,move_noexist,delete
run=/cmd={cmd},{src}*,{dst},{oth}
note=diff:差异（大小/日期）\nnoexist_only:差异（不覆盖）\nupdate:差异（最新日期）\nforce_copy:复制（全覆盖）\nexist_diff:现存（大小/日期）\nexist_update:现存（最新日期）\nsync:同步（大小/日期）\nsync_update:同步（最新日期）\nmove:移动（全覆盖）\nmove_noexist:移动（不覆盖）\ndelete:删除所有
```

#### robocopy 配置

```ini
[app_robocopy]
path=robocopy.exe
list=/MIR,/MOVE
run={cmd},{src},{dst},{oth}
note=/MIR:镜像复制\n/MOVE:移动文件并删除源文件
```

### 任务配置

```ini
[task测试]
app=robocopy
cmd=/MIR
src=D:\Tools\aardio\project\test1
dst=D:\Tools\aardio\project\test12a
oth=
chk=1
```

参数说明：
- `app`: 使用的应用程序名称
- `cmd`: 执行命令
- `src`: 源路径
- `dst`: 目标路径
- `oth`: 补充命令参数
- `chk`: 是否启用（1=启用，0=禁用）

## 支持的复制工具

### fcp

fcp 是一个快速复制工具，支持以下模式：

| 命令 | 说明 |
|------|------|
| `diff` | 差异（大小/日期） |
| `noexist_only` | 差异（不覆盖） |
| `update` | 差异（最新日期） |
| `force_copy` | 复制（全覆盖） |
| `exist_diff` | 现存（大小/日期） |
| `exist_update` | 现存（最新日期） |
| `sync` | 同步（大小/日期） |
| `sync_update` | 同步（最新日期） |
| `move` | 移动（全覆盖） |
| `move_noexist` | 移动（不覆盖） |
| `delete` | 删除所有 |

### robocopy

Windows 内置的强大复制工具：

| 命令 | 说明 |
|------|------|
| `/MIR` | 镜像复制（完全同步） |
| `/MOVE` | 移动文件并删除源文件 |

## 使用示例

### 场景 1：项目双向同步

创建两个任务实现项目在本地和网盘之间的双向同步：

```ini
[task到网盘]
app=robocopy
cmd=/MIR
src=D:\Tools\aardio\project
dst=D:\BaiduSyncdisk\Files\aardio\project
chk=1

[task到本地]
app=robocopy
cmd=/MIR
src=D:\BaiduSyncdisk\Files\aardio\project
dst=D:\Tools\aardio\project
chk=0
```

### 场景 2：增量备份

使用 fcp 的 update 模式进行增量备份：

```ini
[task备份文档]
app=fcp
cmd=update
src=D:\Documents
dst=E:\Backup\Documents
chk=1
```

### 场景 3：镜像复制

使用 robocopy 的 /MIR 模式进行镜像复制：

```ini
[task镜像复制]
app=robocopy
cmd=/MIR
src=D:\Source
dst=E:\Mirror
chk=1
```

## 项目结构

```
EzCopy/
├── main.aardio              # 主程序入口
├── 配置文件.ini              # 应用配置文件
├── lib/                     # 库文件目录
│   ├── config.aardio       # 配置管理模块
│   └── datacfg.aardio      # 数据结构定义
├── dlg/                     # 对话框目录
│   ├── addTask.aardio      # 添加/修改任务对话框
│   └── log_out.aardio      # 日志输出窗口
├── .build/                  # 构建配置目录
└── dist/                    # 编译输出目录
    └── EzCopy.exe          # 可执行文件
```

## 开发环境

- **开发语言**: aardio
- **运行平台**: Windows
- **配置文件**: INI 格式

## 技术特点

- 模块化设计，代码结构清晰
- 支持命令模板，灵活配置参数
- 用户友好的图形界面
- 支持拖拽、剪贴板等便捷操作
- 批量执行，提高工作效率

## 注意事项

1. 确保 可执行文件在配置文件中指定的正确路径下
2. 源路径和目标路径必须是有效的目录
3. 使用 /MOVE 或 delete 命令时请谨慎操作
4. 建议先在小范围测试后再用于重要数据

## 许可证

本项目仅供学习和个人使用。

## 相关链接

- [Gitee 仓库](https://gitee.com/yzhcat/ezcopy)
- [aardio 官网](http://www.aardio.com/)

## 反馈与支持

如有问题或建议，欢迎通过 Gitee 仓库提交 Issue。