pikpak-onboarding

Requires Python 3 for the offline preview; PikPak CLI/browser and an account for live tasks. Guides installation/signup, explicitly offers an optional referral, and previews commands without executing

pikpak
cloud-storage
experimental

SKILL.md

GitHub

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,也不要建议用多客户端并发绕过。具体数值以官方页面当期说明为准。