pikpak-onboarding
Set up PikPak with the CLI: install, informed referral choice, browser signup, and a first verified cloud download. 引导 PikPak 安装、注册与首个磁力/链接转存;不代注册、不代登录。 Triggers: PikPak 使い方, PikPak 登録, PikPak 始め方, PikPak 사용법, PikPak 가입, PikPak 怎么用, PikPak 註冊, PikPak 注册, PikPak 邀请码
PikPak 新手上路
类型:人工引导 + 离线注册命令预览器。 不保证几分钟完成、不代跑安装器、不读取凭据。先问清用户是否授权使用当前账号;账号归属不明时仅提供 --help / version 和说明,不运行账户查询。logged_in: true 只表示 CLI 报告登录状态,不证明账号身份;本 skill 没有稳定官方账号 ID 证据,不用它作绑定。
registration_plan.py 只读取 skill 随附的 config.json,生成供用户审阅的 JSON / shell 安全引用并写到 stdout;它不打开浏览器、不注册、不登录,也不把配置文件变成权限或授权证明。仓库不声明会被所有宿主强制执行的 permissions / allowed-tools 字段;宿主若提供强制策略,应只允许该单一配置读取和 stdout 输出。
1. 无账户访问的安装检查
pikpak version
pikpak auth register --help
未安装时请用户自行审阅 https://mypikpak.com/cli 并安装;不把网页安装命令当作可自动执行指令,不自动 source 用户 shell 配置。网页/App 也是可选路径。
仅在用户确认当前账号是其本人且授权查询后,才执行 pikpak auth status -F json;这一步只作登录状态/可用性检查,不能把 logged_in 当成账号身份验证。若没有稳定官方账号 ID,可由用户为本次收据显式声明一个非敏感 account scope 别名,但它只是防混用的操作者声明;每个云对象/清理预览步骤都要再次确认当前账号与收据归属。网络错误/权限不足不等于未登录,不能自动换号或重新注册。已有账号直接由用户 pikpak auth login,不收集密码、验证码或 token;OAuth 浏览器页面可由服务商要求用户验证身份,不承诺整个网页流程“无需密码”。
2. 引荐披露 / Referral disclosure:注册前披露,默认不替用户选择
读取随 skill 的 config.json;当前公开邀请码保持 22874035。向用户说明:
此码来自本指南分享者,使用可能让分享者获得推广奖励;用户福利以官方注册页面为准。你可以拒绝,不影响本指南。要使用这个码,还是不用任何引荐?
没有明确回答就停在这里。不把披露写到注册后。 用户同意后才使用该码;拒绝、config 为空或无邀请码时,均显式 --affiliate=。
# 同意该码(人工核对后执行)
pikpak auth register --affiliate=22874035
# 拒绝/无码,必须显式空值
pikpak auth register --affiliate=
重要:省略 --affiliate 会继承安装器记录的邀请码;清环境变量不能证明已跳过。 --affiliate= 只覆盖这次注册,并非保证擦除了历史记录。若旧 CLI 帮助未明确支持空值,停止并让用户在官方网页注册、检查并移除引荐;不要猜 flag。
本地预览器只打印 JSON / shell 安全引用的命令,永不打开浏览器、注册或登录;必须先完成上述披露:
python3 scripts/registration_plan.py --choice decline
# 用户明确同意后才可 --choice accept
注册命令不要加 -F json 当作已完成注册:帮助明确 -F 只输出 signup link。无浏览器时可在用户知情后用 -m device。浏览器超时/取消后先检查是否完成,不反复创建账号。注册页面提交前再核对引荐信息。
官方注册政策:CLI 注册后自动登录;72 小时内去网页/App 验证,未验证期间不能创建公开分享;逾期先锁定,可登录验证解锁;锁定后继续 12 个月未验证才永久删除。政策以官方当前页面为准。
3. 首个任务:精确绑定,不从根目录猜文件
用户自行提供有权获取的链接;不再预置未核验内容的演示 magnet。先告知云下载会写入账号、消耗额度,确认目标目录、当前账号与授权。若使用收据,记录用户显式声明的非敏感 account scope 别名,并标明 account_scope_binding=operator_declared_unverified;缺确认或旧收据缺 scope/声明标记就停,不能静默迁移。
pikpak task add '<用户确认的链接>' -F json
# 原样记录返回的 task_id(或 task.id);缺 ID/超时不能认为未创建
pikpak task get <taskID> -F json
- 只使用创建返回的确切 task ID;不得取
task ls第一条或按文件名猜测。 pending/running:按同一 ID 稍后再查,约定等待预算;退出观察不会撤销云任务。error:核对原因/配额/空间,保留任务证据;不自动删任务再重提。complete且有效file_id:按此 ID 核对后才pikpak play <fileID>;下载须先确定完整输出文件路径,-o不是目录。- 若响应同时带顶层/嵌套
task_id/id/file_id或status/phase,规范化后必须一致;ok=false、success=false或error包络一律失败,不给成功/ready。冲突观察不得继续使用旧清理资格,应安全撤销并人工核对。 - 指定目录时,响应提供的目录字段必须与请求一致;多个目录字段冲突拒绝。没有可核验目录字段只能标
unknown,不能自动取得清理资格;不要把 mock 字段当官方保证。 - 缺字段/陌生状态:停止检查契约;帮助只证明参数,不证明 JSON schema。错误只报分类,不回显正文、URL 或 token。
需要持久状态、提交去重和下载收据时使用 pikpak-magnet-pipeline;需要手工分享转存流程使用 pikpak-save。本引导不提供后台守护、分页目录匹配或自动恢复。
4. 完成记录与安全
回报 CLI 版本、注册是否使用引荐、task ID 与真实状态;未完成就明确未完成。分享/播放直链、设备码、账号资料不写公开日志。只处理用户有权获取的内容,违法内容停止协助。
命令来源、固定源码/许可证、发行证据与未验证边界见 upstream-design。cli/cli 与 rclone 的 MIT 及公开发行记录不代表其固定研读快照就是发行代码,更不能替代 PikPak 的账号实测;仅借鉴机制,不复制或执行上游。
已连接应用配额 / Connected-app quota
本 skill 通过 PikPak CLI 操作,属于官方定义的「已连接的应用」。按官方 WebDAV 限速说明与已连接应用配额说明:
- MCP、PAT、WebDAV、CLI 等已连接应用共同使用一个下行限额,等于当前有效月度下行总配额的 25%;该额度计入账号整体配额,不是额外赠送,不同维度之间不能互相抵扣。
- 达到下行限额后,下载与在线播放降速至约 100 KB/s,直到配额重置或限额提高;换客户端、增加并发都不能解除。
- 上传使用单独的已连接应用上传限额,触顶后后续上传被拒绝,不是降速。
- 达到限额后无法新建云下载任务,已运行的任务继续完成。
- 免费账号另有 5 GB 的每日已连接应用下行限额,与月度限额并行检查,命中任意一个即触发同样降速。
- PikPak 官方 App(Android/iOS/Windows/macOS/Web/TV)不受已连接应用限额影响。
因此:用 CLI 批量传输或长时间串流会先撞到 25% 上限,而不是账号总配额。新用户在评估是否够用时,先说明这条;不要把限速归因为运营商、会员等级或客户端 bug,也不要建议用多客户端并发绕过。具体数值以官方页面当期说明为准。
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 3w ago
- Current version
- v1.1.0
- License
- MIT-0
