Video Download

工作流程

当用户想要下载 PT 资源时：

1. 确认下载信息

   • 从搜索结果中获取 torrent ID
   • 可选：记录搜索关键词和资源名称

2. 下载 torrent 文件

   • 从 BYR 下载 torrent 文件内容
   • 验证文件有效性

3. 添加到 Transmission

   • 将 torrent 内容 base64 编码
   • 通过 Transmission RPC 添加下载任务
   • 获取下载任务 ID 和 hash

4. 返回结果

   • 显示下载任务信息
   • 提示是否重复添加

使用场景

场景1：用户指定 torrent ID 下载

用户请求："下载这个 torrent，ID 是 123456"

执行步骤：

./scripts/byr-download.sh 123456

输出格式：

📥 正在从 BYR 下载 torrent 文件 (ID: 123456)...
✅ Torrent 文件下载成功
🔌 连接 Transmission...
✅ 已连接到 Transmission
⬇️  正在添加下载任务...
✅ 下载任务已添加！
   名称: 电影名称.1080p.中英双字
   Hash: abc123def456...
   ID: 1

📝 下载信息：
   搜索关键词: 盗梦空间
   资源名称: [电影] 盗梦空间

场景2：从搜索结果直接下载

用户请求："下载第3个"（在搜索结果之后）

执行步骤：

1. 从之前的搜索结果中获取第3个资源的 ID
2. 调用下载脚本

输出格式：

⬇️  正在下载：[电影] 盗梦空间 Inception (2010)

📥 正在从 BYR 下载 torrent 文件 (ID: 123456)...
✅ Torrent 文件下载成功
🔌 连接 Transmission...
✅ 已连接到 Transmission
⬇️  正在添加下载任务...
✅ 下载任务已添加！
   名称: 盗梦空间.Inception.2010.1080p.BluRay.x264
   Hash: abc123def456...
   ID: 5

场景3：检查是否已存在

如果 torrent 已存在于 Transmission：

输出格式：

📥 正在从 BYR 下载 torrent 文件 (ID: 123456)...
✅ Torrent 文件下载成功
🔌 连接 Transmission...
✅ 已连接到 Transmission
⬇️  正在添加下载任务...
⚠️  该 torrent 已存在于 Transmission 中
   名称: 电影名称.1080p.中英双字
   Hash: abc123def456...
   ID: 2

错误处理

常见错误及处理方式

错误1：无法下载 torrent 文件

❌ 下载失败：无法获取 torrent 文件
提示：可能是 cookie 过期或 torrent ID 不存在

解决：

• 检查 BYR cookie 是否过期（重新登录获取）
• 检查 torrent ID 是否正确

错误2：无效的 torrent 文件

❌ 下载失败：返回的不是有效的 torrent 文件

解决：

• 检查 BYR session_id 是否配置
• 确认资源在 PT 网站上存在

错误3：无法连接到 Transmission

❌ 无法连接到 Transmission (http://192.168.10.2:9091)

解决：

• 检查 Transmission 服务是否运行
• 检查 host 和 port 配置是否正确
• 检查网络连接

错误4：认证失败

❌ 添加失败： unauthorized

解决：

• 检查 Transmission 的用户名和密码
• 确认 Transmission RPC 访问权限设置

HTTP 请求示例

下载 torrent 文件

curl -s -k \
  -H "Host: byr.pt" \
  -H "Cookie: auth_token=${BYR_COOKIE}" \
  "https://byr.pt/download.php?id=${TORRENT_ID}"

Transmission RPC 添加任务

# 获取 Session ID
SESSION_ID=$(curl -s -I "http://192.168.10.2:9091/transmission/rpc" | \
  grep -i "X-Transmission-Session-Id:" | sed 's/.*: //')

# 添加 torrent
curl -s -X POST \
  -H "X-Transmission-Session-Id: ${SESSION_ID}" \
  -H "Content-Type: application/json" \
  -d '{"method":"torrent-add","arguments":{"metainfo":"<base64_metainfo>"}}' \
  "http://192.168.10.2:9091/transmission/rpc"

脚本说明

byr-download.sh

用法：

./byr-download.sh <torrent_id> [keyword] [name]

参数：

• torrent_id: BYR torrent ID（必填）
• keyword: 搜索关键词（可选，用于记录）
• name: 资源名称（可选，用于记录）

返回：JSON 格式的下载结果

transmission-rpc.sh

用法：

./transmission-rpc.sh <action> [args]

支持的 action：

• add: 添加 torrent（通过 base64 metainfo）
• list: 列出所有 torrent
• remove: 删除 torrent
• session-id: 获取 session ID

示例：

# 添加 torrent
./transmission-rpc.sh add "base64_metainfo" "/path/to/download/dir"

# 列出所有 torrent
./transmission-rpc.sh list

# 删除 torrent
./transmission-rpc.sh remove "hash-string" true

# 获取 session ID
./transmission-rpc.sh session-id

Transmission RPC API 基础

Transmission 使用 JSON-RPC 协议。

端点：POST /transmission/rpc

关键方法：

torrent-add

添加新的下载任务。

参数：

• metainfo: base64 编码的 torrent 内容
• filename: torrent 文件路径或 URL（二选一）
• download-dir: 下载目录（可选）

响应：

{
  "result": "success",
  "arguments": {
    "torrent-added": {
      "id": 1,
      "name": "Torrent名称",
      "hashString": "abc123..."
    }
  }
}

如果已存在：

{
  "result": "success",
  "arguments": {
    "torrent-duplicate": {
      "id": 1,
      "name": "Torrent名称",
      "hashString": "abc123..."
    }
  }
}

torrent-get

获取 torrent 信息。

参数：

• ids: torrent ID 列表（可选，不填则获取所有）
• fields: 需要获取的字段列表

常用字段：

• id: torrent ID
• name: 名称
• hashString: hash 值
• status: 状态（0=停止, 1=等待, 2=下载中, etc.）
• progress: 进度（0-100）
• downloadDir: 下载目录
• sizeWhenDone: 总大小

torrent-remove

删除 torrent。

参数：

• ids: torrent ID 列表
• delete-local-data: 是否同时删除下载的文件（true/false）

注意事项

• BYR cookie 和 session_id 都需要配置
• Transmission RPC 需要处理 Session ID（409 Conflict 响应）
• 如果 Transmission 启用了认证，需要配置用户名和密码
• 添加重复的 torrent 不会报错，但会返回 torrent-duplicate 而不是 torrent-added
• Base64 编码时不要包含换行符（使用 -w 0 参数）

与 video-search skill 配合使用

1. 用户询问"有没有XX电影"
2. video-search skill 先查本地，再查 PT
3. 显示 PT 搜索结果（包含 torrent ID）
4. 用户选择"下载第3个"
5. video-download skill 下载并添加到 Transmission
6. 返回下载任务信息

示例对话流程：

用户：有没有盗梦空间？

助手：❌ 本地没有找到"盗梦空间"

🔍 在 PT 网站找到了以下资源：

📦 [电影] 盗梦空间 Inception (2010)
   大小: 4.37 GB
   完成数: 1523

📦 [电影] 盗梦空间 1080P 中英双字
   大小: 8.12 GB
   完成数: 892

用户：下载第1个

助手：⬇️  正在下载：[电影] 盗梦空间 Inception (2010)

✅ 下载任务已添加！
   名称: 盗梦空间.Inception.2010.1080p.BluRay.x264
   Hash: abc123def456...
   ID: 5