用途:这是 Polar 仓库针对任何通过 Web UI(dashboard、checkout、backoffice)触达用户的改动所设的验证协议。栈本身的启停、日志与实例管理交给 local-environment 技能,本技能在其上补充浏览器驱动与登录/支付流程。适用于验证 dashboard、checkout、backoffice 改动,确认登录可用,或端到端证明购买/订阅路径。CLI/API/库改动应使用内置 /verify 而不走本技能。
主要能力:浏览器用 Playwright MCP 驱动,操作优先用 browser_snapshot(可访问性树含 refs),证据用 browser_take_screenshot;后端状态通过 dev docker exec db psql 与 docker logs 读取。覆盖启动栈、登录、Stripe 测试模式端到端支付、结果核验与报告。
使用方式:dev docker ps 分配/检测实例号,dev docker up -d 首次构建并迁移播种;端口以 dev docker up 输出为准(形如 API http://localhost:81NN、Web http://localhost:31NN)。就绪轮询 /healthz 与首页。登录走真实邮箱 OTP:访问 /auth(/login 会 404),输入 admin@polar.sh,从 api 日志读取 6 位验证码。backoffice 与 dashboard 共用 cookie,地址为 http://localhost:81NN/backoffice/,资源未构建时执行 cd server && uv run task backoffice。支付需本地 Stripe 沙箱密钥与 webhook 转发:dev stripe --listen --port <api-port>,或直接 stripe listen 转发到 /v1/integrations/stripe/webhook 与 webhook-connect;密钥变更后须 dev docker up -d api web worker 重建三个服务。结账链接取 checkout_links 的 client_secret(polar_cl_ 值)拼到 /v1/checkout-links/<...>/redirect,表单可用测试卡 4242 4242 4242 4242 等。核验需查 webhook 日志、数据库订单/订阅记录以及 backoffice Orders。报告按内置 /verify 格式,含 Verdict、Claim、Method 与编号步骤。
限制:仅覆盖 Web UI 层验证;不替代 CLI/API 测试。需本地栈、Playwright MCP、Stripe 沙箱与 CLI profile polar-sandbox;CLI 测试密钥每 90 天过期。重启不等于重建,env/密钥变更须 rebuild。部分细节(如具体错误文案、其他测试卡)以官方文档为准。未提供该技能的收费或价格信息。