# BCMR (Better Copy Move Remove)
让文件操作更简单、更现代！BCMR 是一个用 Rust 编写的命令行工具，它让你能以优雅的方式复制、移动和删除文件。
## 安装
### 用 Homebrew
```bash
brew tap Bengerthelorf/tap
brew install bcmr
```
### 使用安装脚本
鸿蒙星河版地址：
```bash
### 使用 Cargo
```bash
cargo install bcmr
```
### 源码编译
```bash
git clone https://github.com/Bengerthelorf/bcmr
cd bcmr
cargo build --release
```
编译后的二进制文件位于 `target/release/bcmr`。
## 详细使用指南
### Shell 集成
BCMR 提供类似 zoxide 的灵活 Shell 集成。你可以使用前缀自定义命令名称，甚至替换原生命令。
基本语法：
```bash
bcmr init [shell] [options]
```
可用选项：
- `--cmd <prefix>`: 设置命令前缀 (例如 'b' 会创建 bcp, bmv, brm)
- `--no-cmd`: 不创建命令别名
- `--path <path>`: 将目录添加到 PATH
示例：
```bash
# 添加到你的 ~/.bashrc 或 ~/.zshrc:
# 使用自定义前缀 (创建 testcp, testmv, testrm)
eval "$(bcmr init zsh --cmd test)"
# 替换原生命令 (创建 cp, mv, rm)
eval "$(bcmr init zsh --cmd '')"
# 使用 'b' 前缀 (创建 bcp, bmv, brm)
eval "$(bcmr init bash --cmd b)"
```
支持的 Shell:
- Bash
- Zsh
- Fish
### Copy 命令 (复制)
基本语法：
```bash
bcmr copy [OPTIONS] <SOURCES>... <DESTINATION>
```
Arguments:
```bash
<SOURCES>... 源文件/目录
<DESTINATION> 目标目录
```
Options:
- `-r, --recursive`: 递归复制目录
- `-p, --preserve`: 保留文件属性
- `-f, --force`: 覆盖已存在的文件
- `-y, --yes`: 跳过覆盖确认
- `-e, --exclude <PATTERN>`: 排除匹配正则的文件/目录
- `-t, --tui`: 使用纯文本模式
- `-V, --verify`: 复制后校验文件完整性
- `-C, --resume`: 断点续传 (检查大小和修改时间)
- `-s, --strict`: 对续传启用严格哈希校验
- `-a, --append`: 追加到现有文件 (忽略 mtime/哈希)
- `-n, --dry-run`: 试运行 (不产生更改)
- `--reflink <MODE>`: 控制 copy-on-write 行为 (auto/force/disable)
- `-h, --help`: 打印帮助信息
示例：
```bash
# 复制单个文件
bcmr copy document.txt backup/
# 复制多个文件 (支持 Shell 通配符!)
bcmr copy *.txt *.md backup/
# 递归复制目录
bcmr copy -r projects/ backup/
# Dry run (预览将要被复制的内容)
bcmr copy -r -n projects/ backup/
# 保留属性复制
bcmr copy --preserve important.conf /etc/
# 强制覆盖且不提示
bcmr copy -f -y source.txt destination.txt
# 使用正则排除复制 (排除 .git 文件夹和 .tmp 文件)
bcmr copy -r --exclude="\.git","\.tmp$" src/ dest/
# 复制并校验
bcmr copy --verify critical_data.db /backup/
```
### Move 命令 (移动)
基本语法：
```bash
bcmr move [options] <source>... <destination>
```
可用选项：
- `-r, --recursive`: 递归移动目录
- `-p, --preserve`: 保留文件属性
- `-f, --force`: 强制覆盖现有文件
- `-y, --yes`: 跳过覆盖确认
- `-n, --dry-run`: 预览操作而不进行实际更改
- `-e, --exclude=<pattern>`: 排除匹配正则表达式的文件
- `-t, --tui`: 使用纯文本模式
- `-V, --verify`: 移动后校验文件完整性
- `-C, --resume`: 断点续传 (仅限跨设备移动回退时)
- `-s, --strict`: 对续传启用严格哈希校验
- `-a, --append`: 追加到现有文件 (忽略 mtime/哈希)
示例：
```bash
# 移动单个文件
bcmr move old_file.txt new_location/
# 移动多个文件
bcmr move file1.txt file2.txt new_location/
# 递归移动目录
bcmr move -r old_project/ new_location/
# Dry run
bcmr move -n old_project/ new_location/
# 使用正则排除移动
bcmr move -r --exclude="^node_modules","\.log$" project/ new_place/
```
### Remove 命令 (删除)
基本语法：
```bash
bcmr remove [options] <path>...
```
可用选项：
- `-r, --recursive`: 递归删除目录
- `-f, --force`: 强制删除且不确认
- `-i, --interactive`: 删除每个文件前进行提示
- `-v, --verbose`: 显示详细删除过程
- `-d, --dir`: 删除空目录
- `-n, --dry-run`: 预览操作而不进行实际更改
- `-e, --exclude=<pattern>`: 排除匹配正则表达式的文件
- `-t, --tui`: 使用纯文本模式
示例：
```bash
# 删除单个文件
bcmr remove unnecessary.txt
# 删除多个文件 (通配符)
bcmr remove *.log
# 递归删除目录
bcmr remove -r old_project/
# Dry run (安全检查)
bcmr remove -r -n potentially_important_folder/
# 交互式删除多个文件
bcmr remove -i file1.txt file2.txt file3.txt
# 使用正则排除删除
bcmr remove -r --exclude="\.important$","\.backup$" trash/
```
### 进度显示模式
BCMR 提供两种进度显示模式：
**fancy 模式 (默认)** 和 **纯文本模式** (使用 `--tui` 或 `-t` 开启)。
#### 配置
你可以通过创建配置文件 `~/.config/bcmr/config.toml` 来完全自定义进度条：
```toml
[progress]
style = "fancy" # "fancy" (default), "plain" (same as --tui)
[progress.theme]
# 定义进度条渐变 (十六进制颜色) - 默认为莫兰迪紫色渐变
bar_gradient = ["#CABBE9", "#7E6EAC"]
bar_complete_char = "█"
bar_incomplete_char = "░"
text_color = "reset" # "reset" (default), "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", or Hex "#RRGGBB"
border_color = "#9E8BCA"
title_color = "#9E8BCA"
[progress.layout]
box_style = "rounded" # "rounded" (default), "double", "heavy", "single"
[copy]
reflink = "auto" # "auto" (default), "never" (从不使用 reflink)
```
## 许可证
GPL-3.0 © [Zane Leong](https://github.com/Bengerthelorf)