文件
文件保留原有结构。
结果、日志与素材，按原有相对路径取回。
查看文件示例
results/metrics.csvrun.log
01 / 一次完整交付
Bundle 将文件与上下文
一同交付。
必填的交接备注说明文件用途与下一步；交接历史保留在工作区，方便之后追溯。
上下文
交接备注让下一步更清楚。
用途与下一步随文件保留，下次取回时，可以接着做。
“实验 B，seed 42。先与基线对比，再决定是否重跑。”
历史
每次交接都留下记录。
之后仍可查看交付内容、发送人、来源设备与时间。
查看历史示例
- 09:10已交出 · 工作站
- 18:30请求拉取 · 笔记本
Bundle 示例 · 文件随附交接备注，历史保留在工作区。
02 / Agent 与工作流
Agent 通过 CLI + Skills
完成文件交接。
CLI 接入脚本，Skills 指引 Agent；需要合作时，也能邀请组员共享工作区。
CLI 接入现有脚本。
用命令交出和拉取 Bundle，用 JSON 读取结果。
CLI 配置与演示Skills 指引 Agent 操作。
Relay Skill 指引支持 Skills 的 Agent 发送、接收和追溯交接。
了解 Relay Skill小组也能共享工作区。
组员用各自账号共享 Bundle 与 Notes，由 owner 管理访问。
了解小组协作个人多设备交接 · 小组协作测试中 · 暂无端到端加密
内测开放后
- 一个可用的服务地址
- 对应平台的安装命令
- 第一次交接的快速开始指南
常见问题
开始使用4
它和 rsync、Git LFS 或网盘有什么区别？
这三者都假定了一些 Relay 不需要的前提。rsync 和 scp 要求两端同时可达，而且你得知道目标路径。Git LFS 把大文件绑在 commit 上，一次运行的产物会变成永久的仓库历史。网盘假定两台机器长期存在相同的文件夹。Relay 面向的是异步交接，另一端不需要有人在等。
支持哪些平台？
只要能运行 Node.js 20.x，Windows、Linux、macOS 都可以。目前没有手机端。
机器上没有 Node.js 怎么办？
需要先安装 —— Node.js 20.x 是唯一的硬性前提。这是 setup 脚本无法替你跳过的一步。
CLI 和 Web UI 是同一个账号吗？
是。两者是同一账号、同一设备、同一 workspace 的入口，所以一侧推送的 Bundle 另一侧能看到。
文件交接6
传出去之后能撤回吗？
Owner 和 FULL 成员可把 Bundle 移到回收站，30 天内仍可恢复；PUSH 成员不能删除。已下载的本地副本仍在接收端，已经签发的下载链接也可能继续有效，最长一小时。
拉取会覆盖我已有的文件吗？
不会。拉取不会覆盖已有文件，并会按原样还原目录结构，不会静默替换任何内容。
传到一半断线了会怎样？
大文件按分片上传。续传时只补发缺失的分片，不会把整个文件重传一遍。
接收端怎么知道有东西到了？
CLI 用 relay bundle inbox 查询这台设备未读的 Bundle，再按需拉取。Web UI 连接时可显示实时更新；Relay 不会自动把文件下载到你的机器。
同一个 Bundle 被两台设备拉取会怎样？
每台设备各自记录读取状态，因此可以独立拉取，互相看不到对方的本地副本。
权限和符号链接会保留吗？
目录结构与相对路径会如实还原。空文件夹不会被传输，因为只有文件会被记录。
隐私、存储与访问7
有端到端加密吗？
还没有。流量走 HTTPS、对象静态加密，但我们在技术上仍可访问已存储的对象。请不要用 alpha 传输高度敏感的数据。
Relay 会保存我的哪些文件信息？
为了在接收端重建文件树，Relay 必须保存文件名、相对路径，以及你填写的备注。备注以明文保存 —— 它不是附带信息，而是告诉接收方这些文件为什么会出现。
可以自托管吗？
暂时还不行，也没有确定时间。当前 alpha 只提供托管云服务。
能发给同事吗，还是只能给自己的机器？
两种都支持：自己的多台设备沿用同一账号；协作测试环境也支持邀请同事用各自账号加入工作区，由 owner 管理访问。公开开放安排会另行公布。
能用多少容量？
内测期间存储免费，正式开放时会公布定价。容量按 owner 账号计算，覆盖其所有自有工作区；组员上传也使用 owner 的额度。总额度由服务配置决定，目前单文件上限为 5 GiB。
如果服务停止运营，我的数据怎么办？
Workspace owner 可用 relay export 将工作区记录保存为 JSON，其中不含文件内容，需要另行下载文件。成员可拉取有权限访问的文件，但工作区导出仅限 owner。
内测什么时候开放？
还没有 —— 我们仍在和一小批用户测试。在上方申请内测资格，开放时你会收到服务地址。