BT Download (aria2 RPC)

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

功能

• - btcheckaria2 - 检查 aria2 是否已安装
• btinstallaria2 - 安装 aria2
• btgettrackers - 获取最新 BT tracker 列表
• btcheckdht - 检测 DHT (IPv4/IPv6) 状态
• btenabledht - 开启 DHT 支持
• btstartrpc - 启动 aria2 RPC 服务（自动开启 DHT）
• btdownload - 添加下载任务
• btgetstatus - 查询做种状态
• btstopseed - 停止做种任务
• btmonitorandstop - 监控做种并自动停止

快速开始

1. 检查并安装 aria2

bash
btcheckaria2
btinstallaria2

2. 启动 RPC 服务

bash
btstartrpc

3. 添加下载

磁力链接:
bash
bt_download --url magnet:?xt=urn:btih:...

BT 文件:
bash
bt_download --url /path/to/file.torrent

普通链接:
bash
bt_download --url https://example.com/file.ext

4. 监控做种

bash
btgetstatus
btmonitorand_stop --targetRatio 500

参数说明

下载确认

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

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

系统默认目录：

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

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

做种监控

btmonitorand_stop 会：

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

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