mcpField
O
olares-knowledge

olares-knowledge

github.com/beclab生产力5.3k98 次安装今天更新
代码仓库

关于 olares-knowledge

olares-knowledge 是一项通过 Olares CLI 管理下载服务任务、资源及偏好设置的技能。它涵盖任务检查与生命周期操作，并强调操作确认、用户配置文件归属和异步状态判断。

主要功能

  1. 01创建并跟踪下载任务
  2. 02检查提供方和媒体画质
  3. 03管理任务与种子状态
  4. 04同步任务变更
  5. 05检查或移除已下载资源
  6. 06读取和修改下载设置

适用场景

  1. 01启动并跟踪 URL 或种子下载
  2. 02下载前查看可用画质
  3. 03暂停、恢复或取消现有任务
  4. 04确认或移除已下载资源

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/beclab/olares --skill olares-knowledge

安装后在 Claude Code 中输入/olares-knowledge确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
olares-knowledge-download-create.md
olares-knowledge-download-files.md
olares-knowledge-download-inspect.md
olares-knowledge-download-manage.md
olares-knowledge-download-settings.md
olares-knowledge-download-sync.md
olares-knowledge-download-torrent.md

详细介绍

knowledge

共享入口： 加载 ../olares-shared/SKILL.md，了解套件路由、活动配置文件选择、平台入口，以及认证继续/停止关卡。只有在确实需要登录、切换配置文件、存储令牌或恢复认证时，才加载其认证参考文档。

使用 olares-cli knowledge download <verb> --help 查看语法。

适用场景

  • 创建和管理 URL、yt-dlp、aria2、torrent、HuggingFace 或 Wise 下载服务任务。
  • 检查提供方/画质、同步任务变更、管理 torrent 状态，或探测/移除已下载资源。
  • 查看或更改下载偏好设置和下载服务设置。

不是顶层的 download（安装程序包：download component / wizard / check）。也不是 files download（拉取 Drive/Sync 文件）——相关内容见 olares-files。

版本要求

所有动词都要求 Olares 1.12.7+，因为必须同时具备 Settings 下载入口和提供方。如果无法确定版本，请先遵循共享配置文件/认证关卡，再判断是否需要升级。

快速入口

任务阅读首条命令
下载 URL，并在文件到达时获知创建任务olares-cli knowledge download create <url> -o json，然后运行 download wait <id>
查看当前正在下载的内容本文件olares-cli knowledge download list -o json
下载前查看链接提供哪些画质检查提供方/画质olares-cli knowledge download inspect <url> -o json
检查某项内容是否已在磁盘上URL 与资源路径的判断olares-cli knowledge download file exists <path> -o json

动词索引

类别动词在对应场景下阅读
启动单个任务create、info、wait创建并跟踪任务
管理现有任务list、pause、resume、cancel、remove列出、暂停和结束任务
探测 + 偏好设置inspect、prefs get、prefs set检查提供方/画质
同步unfinished、sync游标和清空语义
torrenttorrent inspect、stats、peers、files、seed stop/resume；torrent createtorrent 选择和做种
文件工具file exists、file removeURL 与资源路径的判断
设置settings get、settings set全局下载服务设置

任务与异步语义

  • 创建会返回一个服务器端任务 ID；命令成功不代表字节已下载或移动完成。获取 ID 后，每隔几秒轮询一次 info <id>，不要用 create --wait 阻塞当前轮次；该选项是为只想调用一次的脚本准备的。无论哪种方式，状态都是判断任务是否终结的唯一依据：waiting_to_move / moving 仍表示进行中；即使 will_auto_retry 表示服务器扫描可能会再次处理该行，error 也表示失败。
  • 创建任务时会根据 URL 的检查标题为任务命名。除非用户指定了文件名，否则不要使用 --name，也绝不要根据 URL 路径生成名称——创建时提交的名称会永久固定在该行上。磁力链接、--torrent 上传和 HuggingFace 仓库会直接拒绝此标志：名称取自种子元数据或仓库 ID。
  • 重新提交相同 URL 总会创建新任务（不进行身份去重）。目标名称冲突时会添加 (n) 后缀；不会复用或阻止已有行。创建请求仅在 Idempotency-Key 中使用幂等键，以合并同一次尝试的传输重试——并非 URL 去重。
  • 仅当任务处于 waiting 或 downloading 状态时才能暂停（否则返回 400）。任务处于 yt-dlp 移动阶段（waiting_to_move / moving）时，恢复、取消和移除会返回 409——请等待后重试；暂停不适用此规则。
  • 任务所有权取决于当前启用的配置。不要根据 ID 推断任务属于其他用户，也不要尝试使用其他身份。
  • inspect 仅供参考：提供方/质量探测可能失败，但创建仍可能成功。请说明这种不确定性，而不要断言该 URL 无法下载。
  • 同步游标描述的是变更观察情况，而不是任务是否完成。继续增量同步时请保留游标。

安全与升级处理

  • 创建、取消、移除、停止/恢复做种、移除文件、写入偏好设置和写入全局设置前，都要确认。
  • 创建前，请确认目标位置/应用、提供方意图、种子文件选择，以及是否应复用已有的等效任务。使用 list / info 检查；CLI 不会检测或阻止重复任务。
  • file remove 接收下载服务器资源路径，而不是任意本地文件系统路径。
  • 因缺少登录而失败的 URL 并非无解：Cookie 位于 olares-settings 的 settings integration cookie 下。不过交接确实需要用户参与——cookies.txt 是用户从自己的浏览器导出的，因此应向用户索取，而不是自行寻找文件。有关相关信号和完整流程，请参阅提供方/质量检查。
  • 如果 URL/资源路径、任务所有者、重复任务意图、种子选择不明确，或凭据请求超出 Cookie 交接所能处理的范围，请停止。

评论

支持 Markdown