下载管理
下载管理负责将搜索结果交给下载器执行，也负责查看和控制已有任务。
- 使用 YAML 配置下载器名称、接口和认证信息
- 在下载页手动添加磁力链接或上传
.torrent文件 - 在下载页查看任务状态，并执行暂停、继续、删除等操作
- 与下载计划联动，把搜索结果自动提交到指定的下载器
创建下载器
在下载器管理页面点击「新增」，选择预设或手动填写 YAML 配置。选择预设后配置会自动填充，通常只需修改地址和认证信息。
| 字段 | 必填 | 说明 |
|---|---|---|
| 预设 | 从内置预设中选择下载器类型，选中后自动填充 YAML 配置模板 | |
| 配置 | ✓ | YAML 格式的下载器配置，包含名称、接口和认证信息等（见下方说明） |
常用配置字段说明：
| 配置键 | 说明 |
|---|---|
name | 下载器的显示名称，全局唯一 |
protocol | 接口协议，http 或 https |
host | 下载器服务的主机地址 |
port | 下载器服务的端口号 |
path | 接口的路径前缀 |
auth.secret | 认证密钥（如不需要认证则留空） |
auth.username | 认证用户名（如不需要认证则留空） |
auth.password | 认证密码（如不需要认证则留空） |
支持的下载器
| 下载器 | 接口方式 | 默认地址 |
|---|---|---|
| aria2 | JSON-RPC | http://127.0.0.1:6800/jsonrpc |
| qBittorrent | WebUI API | http://127.0.0.1:8080/api/v2 |
| Transmission | RPC | http://127.0.0.1:9091/transmission/rpc |
服务地址
Docker 部署时，宿主机上的下载服务可以通过 http://host.docker.internal:<端口> 访问，同一个 Docker 网络内的下载服务可以通过 http://<容器名称>:<端口> 访问。
手动添加
在正在下载页面点击右上角「新增下载任务」，填写以下字段：
| 字段 | 必填 | 说明 |
|---|---|---|
| 下载器 | ✓ | 选择执行本次下载任务的下载器 |
| 保存到 | ✓ | 下载文件的保存路径 |
| 磁力链接 / 种子文件 | ✓ | 粘贴磁力链接，或上传 .torrent 文件 |
| 立即开始 | 勾选后任务提交时立即开始下载，取消勾选则以暂停状态加入队列 | |
| 完成后转移 | 下载完成后将文件转移到指定媒体库，见完成后转移 |
自动下载
除手动添加任务外，Kaloscope 还支持通过下载计划定时执行搜索工作流，并把结果自动送入下载器。下载计划的配置方式与列表管理，见下载计划文档。