BT Download (aria2 RPC)

BT 下载助手，支持磁力链接、BT 文件、普通下载链接，支持 RPC 模式和自动做种监控。

功能

• bt_check_aria2 - 检查 aria2 是否已安装
• bt_install_aria2 - 安装 aria2
• bt_get_trackers - 获取最新 BT tracker 列表
• bt_check_dht - 检测 DHT (IPv4/IPv6) 状态
• bt_enable_dht - 开启 DHT 支持
• bt_start_rpc - 启动 aria2 RPC 服务（自动开启 DHT）
• bt_download - 添加下载任务
• bt_get_status - 查询做种状态
• bt_stop_seed - 停止做种任务
• bt_monitor_and_stop - 监控做种并自动停止

快速开始

1. 检查并安装 aria2

bt_check_aria2
bt_install_aria2

2. 启动 RPC 服务

bt_start_rpc

3. 添加下载

磁力链接:

bt_download --url "magnet:?xt=urn:btih:..."

BT 文件:

bt_download --url "/path/to/file.torrent"

普通链接:

bt_download --url "https://example.com/file.ext"

4. 监控做种

bt_get_status
bt_monitor_and_stop --targetRatio 500

参数说明

| 工具 | 参数 | 说明 | |------|------|------| | bt_check_dht | - | 检测 DHT 状态 | | bt_enable_dht | dht | 开启 IPv4 DHT，默认 true | | bt_enable_dht | dht6 | 开启 IPv6 DHT，默认 true | | bt_start_rpc | downloadDir | 下载保存目录 | | bt_start_rpc | seedRatio | 目标做种率，默认 5 | | bt_start_rpc | seedTime | 最大做种时间（分钟），默认 1440 | | bt_start_rpc | enableDht | 自动开启 DHT，默认 true | | bt_download | url | 下载链接、BT 文件路径或磁力链接 | | bt_download | downloadDir | 保存目录（可选，不填则提示确认） | | bt_download | useDefaultDir | 直接使用默认目录，跳过确认 | | bt_download | seedRatio | 目标做种率 | | bt_download | seedTime | 最大做种时间 | | bt_stop_seed | gid | 任务 GID（可选） | | bt_monitor_and_stop | targetRatio | 目标做种率（百分比），默认 500% |

下载确认

当用户调用 bt_download 但未指定 downloadDir 时，会返回确认提示：

{
  "needConfirm": true,
  "defaultDir": "~/Downloads",
  "message": "请确认下载目录：\n1. 使用默认目录: ~/Downloads\n2. 指定其他目录（请回复具体路径）",
  "hint": "回复「1」使用默认目录，或回复具体路径指定其他目录"
}

系统默认目录：

• Windows: C:\Users\<用户名>\Downloads
• macOS: /Users/<用户名>/Downloads
• Linux: /home/<用户名>/Downloads

用户回复后，再次调用 bt_download 并指定目录（或 useDefaultDir: true 直接使用默认）。

做种监控

bt_monitor_and_stop 会：

1. 检查当前做种任务的做种率
2. 达到目标后自动停止该任务
3. 在会话中通知用户
4. 保持 aria2 RPC 持续运行

示例返回：

{
  "checked": 1,
  "stopped": 1,
  "notify": "✅ 做种任务已完成，已自动停止:\n• example.bin (已上传 xx.xx GB)"
}