BYRCLI工具Skill byr-cli

---

name: byr-cli description: 使用BYR CLI进行身份验证、搜索、详情查看以及安全的种子下载规划，支持JSON封装。 metadata: { “openclaw”: { “skillKey”: “byr-cli”, “homepage”: “https://clawhub.ai”, “requires”: { “bins”: [“byr”] }, “install”: [ { “id”: “brew”, “kind”: “brew”, “formula”: “byr-pt-cli”, “tap”: “1MoreBuild/tap”, “bins”: [“byr”], “label”: “安装byr CLI (Homebrew)”, }, { “id”: “node”, “kind”: “node”, “package”: “byr-pt-cli”, “bins”: [“byr”], “label”: “安装byr CLI (npm备用方案)”, }, ], }, }

BYR CLI 技能

使用时机

当任务需要通过CLI执行任何BYR操作时使用此技能：

• 身份验证/检查认证状态
• 使用过滤器搜索种子
• 使用过滤器浏览最新种子
• 查看种子详情
• 规划或执行种子下载
• 获取BYR元数据和用户信息
• 在执行实时调用前运行本地诊断

边界

• 仅通过 byr 二进制文件工作。
• 优先使用 --json 参数以获得机器可读的输出。
• 不要推断缺失的ID/路径或静默修改文件。
• 保持只读命令的非破坏性。

认证说明

• 在 auth import-cookie 中支持两种Cookie格式：
  • uid=...; pass=...
  • session_id=...; auth_token=... (可选的 refresh_token=...)
• 浏览器导入：
  • chrome (macOS路径/解密流程)
  • safari 尽力而为，并提供手动备用方案
• 在执行实时操作前始终检查状态：
  • byr auth status --verify --json

命令 (JSON优先)

只读命令：

• byr check --json
• byr whoami --json
• byr doctor [--verify] --json
• byr browse [--limit <n>] [--category <别名|id>] [--incldead <别名|id>] [--spstate <别名|id>] [--bookmarked <别名|id>] [--page <n>] --json
• byr search --query "<文本>" --limit <n> --json
• byr search --imdb <tt-id> [--category <别名|id>] [--spstate <别名|id>] --json
• byr get --id <种子-id> --json
• byr user info --json
• byr meta categories --json
• byr meta levels --json
• byr auth status [--verify] --json
• byr auth import-cookie --cookie "<cookie-header>" --json
• byr auth import-cookie --from-browser <chrome|safari> [--profile <名称>] --json
• byr auth logout --json

有写入副作用命令：

• 先进行试运行：byr download --id <种子-id> --output <路径> --dry-run --json
• 实际写入：byr download --id <种子-id> --output <路径> --json

搜索/浏览语义

• search 和 browse 返回分页列表数据。
• JSON字段：
  • matchedTotal: 根据BYR分页范围块推断的估计总命中数。
  • returned: 当前有效载荷中返回的项目数。
  • total: returned 的向后兼容别名。
• 如果省略 --page，列表命令会自动获取后续页面，直到达到 --limit。
• 如果提供了 --page，则仅获取该页面。

副作用策略

在执行非试运行的 download 之前：

1. 验证 --id 和 --output 是明确的。
2. 运行试运行并检查 sourceUrl/fileName。
3. 确认输出路径的意图。

如果参数缺失，请要求提供明确的值。

错误处理

• 显示 error.code 和 error.message。
• 对于 E_ARG_*：请求更正标志/参数。
• 对于 E_AUTH_*：提供重新认证指导 (auth import-cookie 或凭证刷新)。
• 对于 E_NOT_FOUND_*：请求不同的查询/种子ID。
• 对于 E_UPSTREAM_*：建议重试并捕获命令/上下文。

响应风格

• 保持结果摘要简短。
• 对于搜索/获取命令，包含关键字段：id, title, size, seeders, leechers。
• 对于列表命令，当存在时同时包含 matchedTotal 和 returned。
• 对于下载命令，包含关键字段：outputPath, sourceUrl, dryRun, bytesWritten。