CAS

CAS 秒传功能

CAS（Cloud Auto Save）秒传是天翼云盘的一种快速文件传输方式，通过文件特征码实现"秒传"，无需实际上传文件数据。

---

1. 什么是 CAS 秒传

CAS 秒传利用天翼云盘的文件去重机制，通过文件的哈希特征码直接在云端创建文件副本，实现：

• 秒级传输：无需上传实际文件数据
• 节省带宽：不消耗上传流量
• 跨账号分享：通过分享特征码实现资源传递

---

2. CAS 文件格式

CAS 文件是包含文件元数据的小文件，格式包括：

Base64 格式（传统）

# 文件后缀: .cas
# 内容: Base64编码的文件元数据

JSON 格式（推荐）

{
  "name": "视频文件名.mkv",
  "size": 1234567890,
  "md5": "文件MD5哈希",
  "sliceMd5": "分片MD5"
}

---

3. 秒传恢复

通过 Web 界面恢复

1. 进入"秒传"页面
2. 选择天翼云盘账号
3. 粘贴 CAS 存根内容
4. 选择目标保存目录
5. 点击"恢复文件"

通过 API 恢复

curl -X POST http://localhost:3000/api/cas/restore \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "accountId": 1,
    "folderId": "目标文件夹ID",
    "casContent": "CAS存根内容",
    "fileName": "可选自定义文件名"
  }'

---

4. 秒传生成

系统支持为已上传的文件生成 CAS 存根：

1. 在"文件管理"中选择文件
2. 点击"生成秒传"
3. 复制生成的 CAS 内容分享给他人

---

5. 家庭云中转

功能说明

家庭云中转功能可以在个人云和家庭云之间自动转存文件，解决：

• 跨空间文件传输
• 家庭成员间资源共享

配置选项

选项	说明
启用家庭中转	开启后自动使用家庭云作为中转站
优先家庭中转	优先使用家庭云而非个人云
恢复后删除CAS	秒传成功后自动删除CAS存根文件
生成后删除源文件	生成CAS后自动删除原文件

---

6. 自动恢复

系统支持监控目录自动恢复 CAS 文件：

1. 在"媒体设置" -> "CAS配置"中开启"自动恢复"
2. 系统会自动扫描指定目录的 .cas 文件
3. 发现 CAS 文件后自动执行恢复操作

---

💡 使用建议

• 大文件首选：CAS 秒传特别适合大文件传输
• 批量操作：支持批量粘贴多个 CAS 存根
• 备份存根：建议保存重要文件的 CAS 存根作为备份