用途:该技能面向 Boxyard 的日常使用,而非开发。Boxyard 是受管文件夹,包含 DATA、元数据、同步配置、分组以及本地/rclone 存储。所有随附路径均从技能目录解析,无需检出源码。
主要能力:发现、选择与检查(which、list、checkout-roots、path、box-status、owner、yard-status、doctor);生命周期操作(new、include、exclude、copy、relocate、rename、delete、force-push、分组与父子编辑);同步(sync、multi-sync、sync-missing-meta、sync-name);所有权(claim、release、discard-local);以及 plain/restic 转换。
使用方式:以已安装 CLI 为准,如 boxyard --help、boxyard <command> --help、boxyard --version;在开发检出中优先用 uv run boxyard ...;非默认配置用 boxyard --config /path/to/config.toml ...。示例命令:boxyard which --path /some/path --json、boxyard list --output-format json、boxyard path --box INDEX_NAME、boxyard doctor --no-remote。选择用 --box INDEX_NAME 或 --box-id BOX_ID;delete、rename、copy、force-push、sync-name 需显式选择器。
限制与安全:修改本地或远程状态前须获批准,包括 init、new、sync、include、exclude、delete、rename、copy、force-push、claim、release、discard-local 及非 dry-run 的 convert;只读查询、--help、doctor、convert --dry-run 可无需确认。不要在 ~/dev 创建临时文件夹/克隆/工作树。new --from PATH 默认移动,除非加 --copy;exclude 会先同步再删除本地 DATA。excludes 是替换而非追加,conf/.rclone_exclude 会整体替换默认列表;.rclone_include 与 .rclone_filters 当前被拒绝。使用 restic 需各机器 Boxyard >=0.7.0、restic 及密码。状态异常时运行 doctor,不要自行修复。具体配置键、布局与详细示例见随附参考文档。