SuperAPI AI 工具集

olares-knowledge

通用与其它

查看项目

更新于 10-15 17:24

技能介绍

用途:通过 olares-cli knowledge download 命令族,在 Olares 环境中创建与管理下载任务,覆盖 URL、yt-dlp、aria2、torrent、HuggingFace 和 Wise 等来源,并管理下载偏好与下载服务器设置。

主要能力:创建任务(create)并跟踪(info、wait);管理已有任务(list、pause、resume、cancel、remove);探测链接可用画质与提供方(inspect)、读写偏好(prefs get/set);增量同步(unfinished、sync);torrent 相关操作(inspect、stats、peers、files、seed stop/resume、create);文件探测与删除(file exists、file remove);全局下载服务器设置(settings get/set)。可用 olares-cli knowledge download <verb> --help 查看语法。

使用方式:创建 URL 任务可执行 olares-cli knowledge download create <url> -o json,再以 download wait <id> 等待落地;查看当前下载用 download list -o json;拿链接前先探测画质用 download inspect <url> -o json;检查磁盘是否已有资源用 download file exists <path> -o json。

异步语义:create 返回服务端任务 id,命令成功不代表字节已下载或移动完成,需轮询 info <id> 判断状态;waiting_to_move 与 moving 仍属进行中,error 为失败,即使 will_auto_retry 表示可能重试。任务名由链接的 inspect 标题生成,除非用户指定文件名,否则不要加 --name;磁力链接、--torrent 上传和 HuggingFace 仓库不接受该标志。重复提交同一链接总会新建任务,同名落地以 (n) 后缀区分。

限制:全部动词要求 Olares 1.12.7+,因 Settings 下载边缘与提供方均需具备。pause 仅在 waiting 或下载中有效;在 yt-dlp 搬运阶段(waiting_to_move / moving)执行 resume、cancel、remove 会返回 409,需等待重试。inspect 仅供参考,探测失败不代表无法创建。file remove 使用下载服务器资源路径而非本地路径。缺失登录的链接可通过 olares-settings 的 integration cookie 交接 cookies.txt 解决,但需用户自行提供导出文件。任务归属跟随当前活跃配置,不要推断他人任务。执行 create、cancel、remove、seed stop/resume、file remove、写偏好与全局设置前需确认。