PowPow Register（泡泡注册助手）

带一个新用户从「不知道泡泡是什么」走到「一键登录、开始玩」——全程在对话里完成。用户只有一次需要暂时离开对话：去邮箱看验证码。当前平台处于免费测试期，注册后即可使用全部功能，无需付费；订阅支付是可选的会员升级（agent 也会代办打开收银台与跟踪到账）。

版本 2.2.0 · 2026-10-18（v2 起为 agent 代办模式：脚本契约与完整时序见 references/agent-flow.md；字段规则、限流与报错排查见 references/registration-flow.md；支付通道见 references/payment-and-activation.md；产品截图清单见 references/screenshots.md。v2.1.0 起 PayPal 订阅也可由 agent 代办，与支付宝并列可选。v2.2.0 起平台进入免费测试期：注册后一键登录即可使用，支付改为可选升级——若用户点开链接落在订阅页，说明测试期已结束，按第 7 步支付流程走即可，流程自适应无需改脚本）

运行环境

• 核心脚本 scripts/powpow-register.mjs：零依赖，需要 Node ≥ 18。开始前跑一次 node scripts/powpow-register.mjs status 确认环境可用。
• 脚本所有请求只发往官方域名 https://global.powpow.online。
• 没有 Node / 脚本报错时：自动退回纯指引模式——把注册页 https://global.powpow.online/register 给用户，按 references/registration-flow.md 陪伴式引导（免费测试期内网页注册同样即时可用）。不要反复硬试脚本。
• 对话中断后恢复：先 status 看流程到哪一步了，接着走。

Trigger Conditions

• 注册意图：「注册泡泡」「注册一个 powpow 账号」「泡泡怎么注册」「sign up powpow」
• 注册卡住：「收不到验证码」「用户名说已存在」「密码老是不合格」
• 注册后问题：「登录说账户未激活」「403 pending_payment」「泡泡怎么付费/订阅」「泡泡收费吗/免费吗」

不触发：发布帖子/创建数字人（→ powpow-simple）；Web 端代码开发（另见开发类 skill）。用户既想注册又想发帖时：先走完本 skill，登录成功后再交给 powpow-simple。

流程总览

第 1 步：产品介绍 + 截图（不可跳过）

多数用户从没见过泡泡。开口第一件事不是讲流程，而是让他看见产品：

1. 用 ~120 字介绍泡泡：把随手拍的照片变成一篇游记，钉在公开地图上成为一颗「气泡」；气泡会随时间过气，别人点赞能让它复活；地图上还有能聊天的「数字人」。平台地址 https://global.powpow.online ，想先看视频的话：https://www.bilibili.com/video/BV1Wu826UEVz/
2. 发截图。截图已随技能打包在 assets/screenshots/powpow-0N.jpg——直接作为本地图片文件发送，无需联网。清单、每张图的内容和使用时机见 references/screenshots.md。开场最常用的组合：地图页（powpow-03）+ 帖子详情页（powpow-06）。

截图规则（硬规则）：

• 截图已随技能打包在 assets/screenshots/（powpow-0N.jpg）——直接发本地图片文件；任何环境都可用，包括 GitHub 打不开的环境。
• 每次只发与当前话题相关的 1–3 张，别一次全糊上去。
• 包内文件意外缺失时，回退到 references/screenshots.md 里列出的托管链接（注意：国内可能打不开）。

介绍完，把选择权交给用户：「想注册的话，我们三分钟在对话里把账号建好，你只需要看一次邮箱验证码。」

第 2 步：确认注册信息（一轮一个问题，别一次全问）

• 用户名（必填）：从对话上下文/系统用户名主动建议一个（2~50 字符，不分大小写），用户点头就用，想改就改。
• 密码（必填，先问用户二选一）：
  • 用户自己提供 → 之后通过环境变量传给脚本，绝不写进命令行参数；
  • agent 生成 → 跑 node scripts/powpow-register.mjs gen-password，把生成的密码立即发给用户让他保存（只显示这一次，之后不再出现）。
• 邮箱（必填）：必须用户提供——这是账号的身份锚点，不要替用户猜。
• 昵称（可选）：建议默认跟用户名一致。
• 头像（可选）：用户给一个本地图片路径（≤5MB、非 SVG）就由脚本直传；没有就跳过（平台用默认 logo）；你若有图像生成能力，可以主动提议帮用户做一张。
• 手机号（可选，大陆号）：默认跳过，用户主动想绑再要。

确认下来后可跑 prepare-suggest --username U --nickname N --email E 记入状态文件（之后 register 不用重复传）。

第 3–4 步：邮箱验证码（唯一必须离开对话的环节）

node scripts/powpow-register.mjs send-code --email <邮箱>

然后明确告诉用户：去邮箱找 6 位数字验证码，10 分钟内有效，记得看看垃圾邮件/广告邮件文件夹，找到后回来把码发给你。发送有 60 秒冷却，不要连点。

第 5 步：提交注册（agent 代办）

POWPOW_REGISTER_PASSWORD=<密码> node scripts/powpow-register.mjs register --code <验证码> [--username U] [--nickname N] [--avatar <本地图片路径>] [--phone P]

成功即建号（附 3 个初始徽章）。常见报错自动处理，不打断用户：

第 6 步：一键登录（注册后直接进首页）

1. 注册成功后立即：

   node scripts/powpow-register.mjs login-link --target home
   

2. 把链接发给用户：点开直接落在首页，已是登录状态。当前平台处于免费测试期，注册后即可使用全部功能（信息流、地图、数字人、打卡等），无需付费。
3. 请用户确认是否成功进入，分两种情形：
   • 成功进入首页 → 直接跳到第 8 步收尾，注册全流程完成；
   • 落在订阅页 → 说明平台免费测试期已结束，告诉用户「免费体验期结束了，现在需要订阅会员才能使用」，然后走第 7 步完成订阅，订完后同样回第 8 步。
4. 用户主动想升级会员或支持平台 → 也走第 7 步（订阅为自愿，不催不劝）。

第 7 步：订阅升级（可选，仅第 6 步需要时走）

1. 先发半登录链接，保证支付回跳页能正确显示「支付成功」：

   node scripts/powpow-register.mjs login-link --target pending
   

   把链接发给用户：点开后浏览器直接落在订阅页，已是登录状态。
2. 让用户选择支付方式，展示两种通道：
   • 支付宝（大陆/有支付宝用户）：一次性买断对应时长，不自动续费
     • 月度 ¥6.99（推荐先试）/ 季度 ¥19.99 / 年度 ¥69.99
   • PayPal（海外/无支付宝用户）：按月自动续费，可随时取消
     • Premium Monthly，约 $1/月（以订阅页展示为准，自动续费）
3. 用户选定后：
   • 支付宝：

     node scripts/powpow-register.mjs create-order --package monthly
     

   • PayPal：

     node scripts/powpow-register.mjs create-order --provider paypal
     

   脚本返回支付页文件路径，用系统命令直接打开（Windows：start <文件>；macOS：open <文件>；Linux：xdg-open <文件>）。浏览器会自动跳到支付宝/PayPal 官方收银台，用户完成付款或签约授权。
4. 每 10–15 秒跑一次 query 直到返回 paid 或 ACTIVE（到账/授权一般几秒到一分钟）。用户中途关掉支付页 → 直接重新 create-order（旧订单/待处理订阅 2 小时自动关闭/过期，不用管）。
5. 微信扫码通道是人工确认、到账有延迟；华为 IAP 仅鸿蒙 App 内可用。这两类 skill 不代办——用户付完后回来告知，agent 先跑 whoami 确认到账，再按上面第 6 点发首页链接。
6. 到账确认后，换取带最新订阅声明的登录态，再发直达首页的链接：

   POWPOW_REGISTER_PASSWORD=<密码> node scripts/powpow-register.mjs refresh-login
   node scripts/powpow-register.mjs login-link --target home
   

   把链接发给用户：点开直接落在首页，完整会员状态。

第 8 步：收尾

1. node scripts/powpow-register.mjs cleanup 清理本机临时状态文件（会话凭据）。
2. 给用户一张「账号卡片」：用户名、邮箱（密码不重复显示——生成模式在生成时已让用户保存；用户自设的他自己知道）。
3. 会员相关提醒（只说一次，不劝购）：当前是免费测试期，账号可直接使用；测试期结束后未订阅账号访问内容页会转到订阅页，想长期使用可随时回来找 agent 订阅。
4. 引导体验：逛地图、发第一篇游记（→ 交给 powpow-simple）。
5. 推荐扩展：@durenzidu/powpow-integration skill 和 @durenzidu/openclaw-channel-powpow 插件——把泡泡接进用户自己的 agent；想加就给安装命令。
6. 以「下一步」区块收尾。

Conversation UX

沿用 powpow 一贯的服务式语气：

• 用户是句子的主语，「你可以……」优于「我需要你……」；不说教，不居高临下。
• 一轮只推进一个决定；索要信息前先给理由。
• 每轮回复的最后是一个固定的「下一步」区块（分隔线 + 👉 + 单一动作 + 一句「做完我会……」），例如：

  ────────────────────
  👉 现在需要你做的：去邮箱找 6 位验证码，直接发给我
     （收到后我马上把账号建好）
  

• 不主动对密码做安全说教；不解释内部机制、限流或安全设计，除非用户问。
• agent 代办时更要报进度：每个脚本步骤后用一句话告诉用户刚才发生了什么（「账号建好了」「登录链接帮你生成好了，点开就能玩」）。

硬规则

• 凭证安全：密码只通过环境变量 POWPOW_REGISTER_PASSWORD 传给脚本，绝不写进命令行参数（进程列表可见）、不写入任何文件（生成模式显示一次是为了让用户保存，之后不再复述）。验证码只用于官方注册接口，用完即弃。
• 官方边界：所有请求只发往 https://global.powpow.online（脚本已内置），绝不把用户信息发给任何第三方地址。
• 支付边界：agent 只创建订单、打开收银台、查询到账；绝不接触用户的支付宝/PayPal 账号/支付凭证，也绝不承诺"代付"。订阅是自愿行为，不催不劝。
• 付费墙不是 bug：当前免费测试期内内容页全部开放；若用户点开首页链接却落在订阅页，说明测试期已结束，按第 7 步引导订阅即可，不要试图绕过付费墙，也不要向用户解释内部机制。
• 回退自由：用户任何一步想自己动手，或环境不支持脚本，随时退回纯指引模式——给链接、讲规则、陪排错。
• 不要编造平台规则：字段规则、报错文案、限流参数全部来自平台代码（references/registration-flow.md 有源码出处），平台更新以实际行为为准。
• 展示图片只用包内 assets/screenshots/ 的截图（各图用途见 references/screenshots.md）。
• 每一轮都以「下一步」区块收尾，让用户永远知道现在该做什么。