配置

BCMR 从 ~/.config/bcmr/config.toml（或 config.yaml）读取配置。所有设置均为可选 — 缺省时使用默认值。

完整示例

[progress]
style = "fancy"          # "fancy"（默认）或 "plain"（与 --tui 参数相同）

[progress.theme]
bar_gradient = ["#CABBE9", "#7E6EAC"]   # 进度条的十六进制渐变色
bar_complete_char = "█"
bar_incomplete_char = "░"
text_color = "reset"                     # "reset"、颜色名或 "#RRGGBB"
border_color = "#9E8BCA"
title_color = "#9E8BCA"

[progress.layout]
box_style = "rounded"    # "rounded"（默认）、"double"、"heavy"、"single"

[copy]
reflink = "auto"         # "auto"（默认）、"force" 或 "disable"
sparse = "auto"          # "auto"（默认）、"force" 或 "disable"

update_check = "off"     # "off"（默认，不访问网络）、"quiet" 或 "notify"

[transfer]
fallback_warning = true  # 当 serve 快速路径失败、回退到传统 SSH 时
                         # 在 stderr 打印一行原因（默认开启）

[scp]
parallel_transfers = 4   # 并行 SSH 传输数（默认：4）
compression = "auto"     # "auto"（默认）、"force" 或 "off"

进度设置

`progress.style`

值	说明
`"fancy"`	带渐变进度条、ETA、速度和逐文件进度条的 TUI 界面（默认）
`"plain"`	3 行文本输出，无边框绘制

`progress.theme`

bar_gradient — 十六进制颜色数组，进度条在颜色间插值。默认：["#CABBE9", "#7E6EAC"]（莫兰迪紫）。
bar_complete_char / bar_incomplete_char — 已完成和未完成部分的字符。
text_color — 颜色名（"red"、"green" 等）、十六进制（"#RRGGBB"）或 "reset" 使用终端默认色。
border_color / title_color — 格式同 text_color。

`progress.layout.box_style`

值	预览
`"rounded"`	`╭──╮ ╰──╯`
`"single"`	`┌──┐ └──┘`
`"double"`	`╔══╗ ╚══╝`
`"heavy"`	`┏━━┓ ┗━━┛`

复制设置

`copy.reflink`

控制写时复制（reflink）行为。可通过 --reflink 参数逐命令覆盖。

值	说明
`"auto"`	尝试 reflink，失败则回退到常规复制（默认）
`"force"`	要求使用 reflink；不支持时报错
`"disable"`	从不尝试 reflink

注意： 配置文件中也接受 "never" 作为 "disable" 的别名。

`copy.sparse`

控制稀疏文件检测。可通过 --sparse 参数逐命令覆盖。

值	说明
`"auto"`	检测 ≥ 4KB 的零块并创建空洞（默认）
`"force"`	始终写入稀疏输出，即使源文件非稀疏
`"disable"`	写入所有数据，不检测空洞

注意： 配置文件中也接受 "never" 作为 "disable" 的别名。

SCP 设置

`scp.parallel_transfers`

远程复制时的并行 SSH 传输数。可通过 -P 参数覆盖。

值	说明
`4`	默认 — 4 个并行 SSH 流
`1`	顺序传输（无并行）
`N`	任意正整数

`scp.compression`

控制远程传输时的 SSH 传输层压缩。

值	说明
`"auto"`	智能模式：可压缩字节 >30% 时启用（默认）
`"force"`	始终启用 SSH 压缩（`-o Compression=yes`）
`"off"`	不压缩

auto 模式下，已知压缩格式（.gz、.zip、.mp4、.jpg 等）被视为不可压缩。仅当大部分数据可受益于压缩时才启用。

更新检查

控制 BCMR 是否在每次运行命令时后台检查新版本。

值	说明
`"off"`	完全跳过更新检查（默认）
`"quiet"`	后台检查但不输出任何提示
`"notify"`	检查并在 stderr 输出更新提示

配置文件位置

BCMR 按以下顺序查找配置文件：

~/.config/bcmr/config.toml
~/.config/bcmr/config.yaml
平台特定的配置目录（通过 directories crate）：
- macOS： ~/Library/Application Support/com.bcmr.bcmr/
- Windows： %APPDATA%\bcmr\bcmr\

路径书签

冗长且反复输入的远程目标很烦人。[paths] 表把简短的 @别名 映射为完整的 host:path 字符串；bcmr 在启动时完成替换，下游所有代码路径看到的都是解析后的目标。

[paths]
proj   = "lab:/data/projects/myrepo/"
backup = "nas:/backups/"
logs   = "archive:/var/log/myapp/"

bcmr copy ./project/  @proj           # → lab:/data/projects/myrepo/
bcmr copy db.gz       @proj/backups/  # → lab:/data/projects/myrepo/backups/
bcmr copy report.pdf  @backup/today/  # → nas:/backups/today/

规则：

别名必须匹配 [A-Za-z_][A-Za-z0-9_-]*，非法名称在使用时报错。
配置目标的末尾斜杠在裸别名形式下原样保留（@proj 原样返回目标），在带后缀形式下做归一化（@proj/foo 之间恰好以一个 / 连接）。
未知的 @alias 会报错并给出基于 Levenshtein 距离的 did you mean ...? 建议，同时列出所有已知别名。bcmr 不会静默回退到字面量文件查找。
要复制名字以 @ 开头的字面量文件，请加 ./ 前缀 — 例如 bcmr copy ./@weird-filename ./dst/。

别名可用于所有接受路径的位置：源列表、目标、bcmr check、bcmr remove。

按主机默认参数

当传输涉及某个特定主机时，自动附加一组固定参数：

[host."lab"]
default_args = ["-p", "--compress", "zstd", "--reflink", "force"]

[host."nas"]
default_args = ["--direct", "direct"]

bcmr copy ./project/ lab:dst/
# 解析为：bcmr copy -p --compress zstd --reflink force ./project/ lab:dst/

匹配的主机名取自任意源或目标参数中 host: 的部分（第一个命中者生效）。显式的 CLI 参数排在注入的默认参数之后，因此用户输入的 --compress none 会覆盖主机的 default_args = ["--compress", "zstd"]。

配置方案（Profiles）

通过 --profile <name> 或 BCMR_PROFILE=<name> 激活的命名参数包：

[profile.work]
default_args = ["-p", "-V"]

[profile.home]
default_args = ["-p"]

bcmr --profile work copy ./report.pdf host:dst/
# 解析为：bcmr copy -p -V ./report.pdf host:dst/

BCMR_PROFILE=home bcmr copy ./report.pdf host:dst/
# 解析为：bcmr copy -p ./report.pdf host:dst/

优先级（左侧胜出）： 显式用户参数 > 主机默认 > profile 默认 > 内置默认。注入顺序为 profile、host、用户参数，全部从左到右；clap 后解析的参数覆盖先解析的，因此用户参数胜出。

未知的 --profile <name>（没有对应的 [profile.<name>] 表）是静默 no-op — 命令其余部分照常执行。

环境变量

变量	默认值	说明
`BCMR_CAS_DIR`	`$XDG_DATA_HOME/bcmr/cas`	覆盖远程去重使用的内容寻址存储位置。集成测试也使用它指向 tempdir 做隔离。
`BCMR_CAS_CAP_MB`	`1024`（1 GiB）	CAS 的软上限（字节数），每次开启去重的 PUT 前通过 LRU 驱逐来维持。设为 `0` 禁用上限，让仓库无限增长。值以 MiB 为单位。

未设置 BCMR_CAS_DIR 时的 CAS 路径：

Linux：~/.local/share/bcmr/cas/
macOS：~/Library/Application Support/bcmr/cas/
Windows：%APPDATA%\bcmr\cas\

块文件放在两级十六进制前缀下（<aa>/<bb>/<rest>.blk），这样在常见 workload 下单目录不会超过约 6.5w 条。清理仓库是安全的：rm -rf 掉 cas 目录，下次开启去重的 PUT 会从线路重新构建。