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_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)"
}