BYR CLI Skill 是一个专为北京邮电大学（BUPT）内部资源设计的命令行工具，旨在通过终端环境高效完成与 BYR 平台相关的各类操作。它封装了认证、搜索、详情查询以及安全下载等核心功能，所有交互均基于 `byr` 二进制文件执行，并优先采用 JSON 格式输出，确保机器可读性与自动化处理的便利性。该工具适用于需要通过脚本或自动化流程管理种子资源的开发者或高级用户，尤其适合在服务器或无图形界面的环境中运行。其设计遵循严格的边界约束，所有只读命令均为非破坏性操作，且写操作前强制进行干运行（dry-run）检查，以保障数据安全与操作可控。 工具支持多种认证方式，包括直接导入浏览器 Cookie（兼容 Chrome 和 Safari）以及手动输入会话标识符，同时提供完整的状态验证机制。在执行关键操作前，建议先调用 `byr auth status –verify –json` 确认登录有效性，避免因认证失效导致任务失败。对于搜索与浏览功能，`search` 和 `browse` 命令返回分页列表数据，包含匹配总数（matchedTotal）和当前返回条目数（returned），并支持按类别、状态、收藏标记等条件过滤结果。所有命令均强调参数显式化，缺失必要参数时会主动请求用户提供，防止误操作。 此外，BYR CLI Skill 内置本地诊断能力，可通过 `byr doctor` 命令检测系统环境与依赖项是否正常，提升首次使用成功率。下载功能则采用两步策略：先执行 `–dry-run` 预览目标文件路径与元信息，待用户确认后再执行实际写入，有效规避意外覆盖风险。整体而言，该工具将 BYR 平台的复杂 API 封装为简洁、可靠、可审计的命令行接口，是面向技术用户的实用基础设施组件。
核心功能特点
- 支持通过 Cookie 或浏览器自动导入实现 BYR 账户认证，兼容多种会话格式
- 提供只读与写操作分离的命令体系，所有写操作前强制干运行以确保安全
- 搜索结果与浏览列表支持多维度过滤（分类、状态、收藏等），并以结构化 JSON 输出
- 内置本地健康检查（doctor）与认证状态验证，降低运行时错误概率
- 下载功能具备路径预览与字节级写入反馈，保障文件操作透明可控
适用场景
BYR CLI Skill 特别适合需要批量处理种子资源或集成到自动化工作流中的场景。例如，运维人员可以编写定时脚本定期抓取最新发布的学术类资源，并通过脚本自动筛选高种子的合法种子进行离线下载，从而构建私有知识库。研究人员也可利用其按 IMDb ID 精准检索特定影视作品的磁力链接，结合 `byr get` 获取详细信息后，再决定是否加入下载队列，极大提升资源发现效率。 对于 DevOps 工程师而言，该工具可作为 CI/CD 流水线的一部分，用于部署前的依赖预检或内容同步。比如在新服务器初始化阶段，通过 `byr browse –category academic –limit 10` 快速拉取常用课程资料，确保教学环境资源就绪。同时，由于所有操作均以 JSON 输出，便于后续解析、日志记录或与其他系统对接，满足企业级可观测性需求。 在日常个人使用中，用户可通过命令行快速查询某部电影的种子信息（如大小、做种人数），避免打开网页端繁琐的界面操作。尤其适合习惯终端操作的技术爱好者，在 Linux 服务器、Docker 容器或 macOS 终端中无缝使用，无需依赖图形界面即可完成全部 BYR 相关任务。