用途:在终端以只读方式浏览 PeerTube 联邦视频实例,包括实例统计与身份信息、最新视频、单个视频详情、顶层评论线程、频道与账号信息,以及实例内搜索;仅登录/登出会修改状态。
主要能力:server 查看实例名称、描述与用户/视频/播放计数;videos 浏览实例上传(默认 15 条,start/count 偏移分页,最大 100);search 做实例内搜索(searchTarget=local);video 按 id、uuid 或 shortUUID 查看详情;comments 读取 /videos/{id}/comment-threads;channels、channel、account 查看创作者;me、my-videos 需登录。
使用方式:先设置实例,如 export PEERTUBE_SERVER="https://<INSTANCE_HOST>";浏览、搜索、评论、实例信息均匿名可读。需要账号命令时执行 scripts/peertube login --username <NAME> --prompt,登出用 scripts/peertube logout。全局标志支持 --json、--dry-run、--verbose、--server 覆盖。若要做联邦范围搜索,可将 PEERTUBE_SERVER 指向 https://sepiasearch.org。
限制:实例彼此独立,令牌按服务器 URL 存储,A 实例令牌在 B 实例会 401;分页无 page 参数,只有 start/count;评论路由为 /comment-threads;实例元数据路径为 /server/stats 与 /config/about;生产实例会掩码 client_secret;令牌有效期由实例配置,需读取 expires_in;2FA 需 --otp;默认限流约 50 次/10 秒,429 时按 Retry-After 退避。不适用于 YouTube、Vimeo 等平台,也不用于视频编辑转码或 PeerTube 服务器安装运维。需 Python 3.8+ 与 requests。