- name
- bt-download
- description
- BT下载助手，支持 aria2 RPC 模式下载、监控和自动做种
- homepage
- https://aria2.github.io
- metadata
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_aria22. 启动 RPC 服务
bt_start_rpc3. 添加下载
磁力链接:
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": "请确认下载目录：\
1. 使用默认目录: ~/Downloads\
2. 指定其他目录（请回复具体路径）",
"hint": "回复「1」使用默认目录，或回复具体路径指定其他目录"
}系统默认目录：
- Windows:
C:\Users\<用户名>\Downloads - macOS:
/Users/<用户名>/Downloads - Linux:
/home/<用户名>/Downloads
用户回复后，再次调用 bt_download 并指定目录（或 useDefaultDir: true 直接使用默认）。
做种监控
bt_monitor_and_stop 会：
- 检查当前做种任务的做种率
- 达到目标后自动停止该任务
- 在会话中通知用户
- 保持 aria2 RPC 持续运行
示例返回：
{
"checked": 1,
"stopped": 1,
"notify": "✅ 做种任务已完成，已自动停止:\
• example.bin (已上传 xx.xx GB)"
}