boxyard
基于rclone的跨平台文件夹同步与管理CLI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：boxyard。 它的用途是：基于rclone的跨平台文件夹同步与管理CLI工具 完整的 Skill 内容见：https://321skill.com/skills/boxyard/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我本地有一个项目文件夹`~/projects/experiment`，想把它同步到已配置好的S3存储上，并排除所有的`.log`文件。” 它会指导你先使用`boxyard new --from ~/projects/experiment`创建盒子，然后在盒子的`conf/`目录下创建`.rclone_exclude`文件写入`*.log`，最后执行`boxyard sync --box-name experiment`完成同步。
介绍
Boxyard 是一款专为开发者设计的命令行工具，它解决了在多台设备或本地与云端之间同步和管理项目文件夹的难题。它通过引入“盒子”的概念，将文件夹及其同步规则、元数据打包成一个可追踪的单元，告别了传统同步工具中文件夹与配置分离的混乱状态。
使用Boxyard非常简单。首先通过pip install boxyard安装，并确保已配置好rclone。初始化后，你可以用boxyard new将现有文件夹创建为“盒子”，然后使用boxyard sync命令将其同步到任何rclone支持的远程存储（如S3、SFTP）。每个盒子都包含数据文件夹、元数据文件以及可选的conf/配置文件夹，后者存放rclone过滤规则，确保同步行为随盒子一起移动。
它非常适合需要频繁在个人电脑、服务器和云存储之间切换工作环境的开发者、研究人员或数据工程师。例如，当你需要确保本地开发的项目代码、远程服务器的数据集或实验室的配置文件在多处保持一致，并能精细控制同步内容时。
使用建议是，先利用boxyard doctor命令进行健康检查，确保环境配置无误。对于需要不同同步规则的子项目，可以创建独立的盒子进行管理。需要注意的是，其核心同步能力依赖于rclone，因此用户需提前熟悉并配置好rclone的远程存储连接。
核心特点
与直接使用rclone相比，Boxyard的核心区别在于引入了“盒子”的封装概念，将文件夹、其同步过滤规则（conf/）和元数据（boxmeta.toml）绑定为一个可整体管理和迁移的单元，并内置了同步状态追踪和冲突检测机制。
注意事项
不适合仅需一次性文件传输或对命令行及rclone配置不熟悉的用户。
常见问题
Boxyard和直接用rclone sync有什么区别？
Boxyard在rclone之上增加了“盒子”的元数据管理和生命周期管理，能跟踪同步历史、检测冲突，并将过滤规则与数据绑定，实现更结构化、可追溯的同步。
必须提前安装和配置rclone吗？
是的，Boxyard依赖rclone执行实际的同步操作，使用前需先安装rclone并配置好所需的远程存储后端（如S3、Google Drive等）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/boxyard/raw/index.md 读取 boxyard 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/boxyard/raw/index.md（查看排版版本）