下载管理
下载管理负责将搜索结果交给下载器执行，也负责创建、查看、控制已有任务，并在任务完成后按需转移文件入库。
- 使用 YAML 配置下载器名称、接口和认证信息
- 在下载页手动添加
磁力链接、Info Hash、HTTP(S) 种子链接，或上传.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://<容器名称>:<端口>访问。
手动添加
在正在下载页面点击右上角「新增下载任务」，填写以下字段：
| 字段 | 必填 | 说明 |
|---|---|---|
| 下载器 | ✓ | 选择执行本次下载任务的下载器 |
| 保存到 | ✓ | 下载文件的保存路径 |
| URI / 种子文件 | ✓ | 粘贴磁力链接、Info Hash或HTTP(S) 种子链接，或上传.torrent文件 |
| 立即开始 | 勾选后任务提交时立即开始下载，取消勾选则以暂停状态加入队列 | |
| 完成后转移 | 下载完成后将文件转移到指定媒体库，见完成后转移文档 |
下载链接识别
打开新增下载任务弹窗时，浏览器会尝试读取剪贴板中的下载链接；如果链接可识别，会自动填入 URI 输入框。
自动下载
除手动添加任务外，Kaloscope 还支持通过下载计划定时执行搜索工作流，并把结果自动送入下载器。下载计划的配置方式与列表管理，见下载计划文档。