Playwright 录制复用 · SkillHub 体验版
技能根目录：${CODEBUDDY_SKILL_DIR}
本包为轻量上传版（无预置 node_modules/浏览器，文件数远小于 200）。
首次使用由你（WorkBuddy）用国内镜像自动准备环境，再录制/重放。
对用户怎么说
大白话，一次一事：
- 「我先帮你准备环境（国内镜像），然后打开录制窗口」
- 「需要登录就在窗口里登一次；下次同名流程会尽量免登录」
- 「学会了。下次说：把某某再跑一遍」
每次任务开头（必须）
cd "${CODEBUDDY_SKILL_DIR}"
检查是否已有便携 Node + playwright：
- Windows:
tools/node/node.exe且node_modules/playwright - macOS:
tools/node/bin/node且node_modules/playwright
若缺失 → 先准备环境，再做别的。
准备环境（国内镜像）
Windows：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/bootstrap.ps1
macOS / Linux：
bash scripts/bootstrap.sh
镜像：
- Node →
npmmirror.com/mirrors/node - npm →
registry.npmmirror.com - Chromium →
npmmirror.com/mirrors/playwright
然后：
node scripts/doctor.mjs
录制
node scripts/record.mjs --name <流程名> --url <网址>
体验可用：https://layui.p2hp.com/web/demo/form.html
录完必须自检：
node scripts/check-recording.mjs --name <流程名>
PASS→ 告诉用户可以下次复用FAIL→ 你先小修或请用户重录关键步
重放与登录判断（你自己决定）
先看 recordings/<名>.meta.json、profiles/<名>/、auth/<名>.json：
| 情况 | 动作 |
|---|---|
| 有 profile + 曾登录 | 直接 run，不要先刷登录 |
| 无档案 / 首次 | record 时让用户登录一次 |
| run 又出扫码/验证码 | --refresh-auth，不重录整段 |
| 用户要换账号 | --refresh-auth |
node scripts/run.mjs --name <流程名>
node scripts/record.mjs --name <流程名> --url <网址> --refresh-auth
改脚本（防改坏）
node scripts/backup-recording.mjs --name <流程名>- 只改报错相关一两行，禁止整篇重写
check+run；更差立刻还原.bak- 连改无效 → 请用户重录那一小段
登录问题优先 --refresh-auth，别靠乱改脚本绕登录。
隐私
profiles/、auth/ 含 Cookie，只留本机，不要打包上传分享。
禁止
- 不要让用户双击 bat / 自己去官网装 Node
- 不要用外网官方源装依赖（必须走 bootstrap 国内镜像）
- 不要把本机
profiles/、auth/打进分享包
