核心用法
BYR CLI 是专为北邮人 PT 站设计的命令行工具,封装了完整的站点交互能力。核心功能覆盖四大场景:
1. 认证管理:支持 Cookie 导入(uid/pass 或 session_id/auth_token 格式)、浏览器自动提取(Chrome/Safari)、状态校验与登出
2. 信息检索:search 关键词/IMDb 搜索、browse 分类浏览、get 单种子详情,均支持分页与筛选参数
3. 元数据查询:站点分类、用户等级、当前用户信息等辅助数据
4. 下载规划:--dry-run 预演模式配合 --json 输出,确保路径与来源确认后再执行实际写入
显著优点
- JSON-first 设计:所有命令支持
--json,便于脚本集成与结构化处理 - 多源认证:Cookie 字符串、浏览器密钥链双通道,降低手动复制门槛
- 安全沙盒:
download强制显式指定--id与--output,且要求 dry-run 预检 - 智能分页:
--limit驱动自动翻页,简化批量数据获取
潜在局限
- 平台依赖:Chrome 解密仅限 macOS,Safari 支持为 best-effort
- 上游耦合:BYR 站点变更可能导致
E_UPSTREAM_*错误 - 非官方工具:由第三方维护(1MoreBuild/tap),非 PT 站官方发布
适合人群
PT 站重度用户、自动化追剧/观影工作流搭建者、偏好终端操作的开发者
常规风险
- 凭证存储:Cookie/Token 需妥善保管,避免泄露导致账号盗用
- 下载合规:需自行确保版权内容符合当地法规与站点规则
- 频率控制:高频调用可能触发站点限流或封禁
- 来源可信度:第三方 tap/npm 包,建议审计后使用