微信小店登录态 + 每日好评率巡检（Playwright 人机协作方案）
脚本全部在本技能目录的 scripts/ 下，与技能同处一目录、可整体拷贝到任意机器。
环境前提
- Node.js（WorkBuddy 托管版：
<用户目录>/.workbuddy/binaries/node/versions/<版本>/node.exe） - Playwright 装在
<用户目录>/.workbuddy/binaries/node/workspace/node_modules。脚本内置loadPlaywright()：先常规require('playwright')，失败则按os.homedir()推导托管路径回退，不写死用户名。 - 用
channel: 'chrome'驱动本机 Chrome（或'msedge'），不依赖下载的 Chromium。
关键结论（踩坑总结，勿重蹈覆辙）
- 不要用 URL 判定登录：小店后台是单页应用，登录页是
store.weixin.qq.com/shop/home，登录后 URL 几乎不变。waitForURL('**/shop/**')会在打开登录页瞬间误判成功（登录页 URL 本身就含/shop/）。waitForURL('**/shop/home**')同理必翻车。 - 不要用 biz_ticket cookie 判定：实测登录成功后它仍为空字符串。登录态体现在 biz_token 值更新 + localStorage（登录后 localStorage 从 3 个 key 增到 11 个）。
- 不要用状态快照对比：页面 localStorage 持续被埋点/AEGIS 写入，基准快照永远"不稳定"，必然误判。
- 后台长驻进程必须用 run_in_background：Git Bash 里
nohup node ... &会在工具命令结束时被杀（脚本看似启动，几十秒后悄悄死掉）。 storageState不包含 sessionStorage；auth_*.json含敏感登录凭据，勿外传。
最终可用流程（已验证）
- scripts/save-auth.js（人机协作）：
-chromium.launch({ headless: false, channel: 'chrome' })打开登录页
- 循环：每 2 秒轮询；每 5 次轮询存debug[_店铺名].png截图（取context.pages()最后一个标签页）
- 绝不自动判定退出；只有当脚本目录出现SAVE_NOW[_店铺名]文件时才context.storageState()保存并退出
- 浏览器被手动关闭时报友好错误 - 助手流程：运行脚本（run_in_background）→ 用户扫码并在手机上点选账号确认 → 用户说"进后台了" → 助手 Read 截图确认是后台界面且店铺名与目标一致 → 创建
SAVE_NOW[_店铺名]触发保存 → 任务输出确认 "登录态已成功保存" - 验证（scripts/verify-auth.js）：
newContext({ storageState })无头打开/shop/home，截图确认免登录进入后台首页（能看到店铺名与经营数据）即有效。
页面结构要点（做数据提取必读）
- 小店后台是微前端（micro-app）架构：外层文档只有菜单栏（~106 字符），主体内容渲染在
micro-app自定义元素的 Shadow DOM 里（内容区标签MICRO-APP-BODY）。 - 提取文本必须递归穿透 shadow：收集 document + 所有 shadowRoot（含嵌套），对每个文档查 innerText。用
innerText（可见文本），不要用textContent——shadow 里 STYLE 标签会让 textContent 泄漏数十万字符 CSS。 - 好评率在"店铺体验分"详情（
/shop/setting/rate2）：点击首页"店铺体验分"卡片进入。文本形如商品好评率 86.46% 较前1日-1.71% 超越 62.31% 同行——好评率 = 紧跟关键词后的百分数；后一个 62.31% 是"超越同行"参考值，勿误取。 - 商品级明细：rate2 页点
div.card.green内"商品好评率"→/shop/setting/ratedetail?type=product&key=proValidGoodEvalRatio。表格真实表头：商品信息 | 「挺好的」评价数 | 好评率 | 「不够好」评价数 | 首位「不够好」原因（5 列，别按 6 列硬编码）。 - 日期选择器也是
<table>（表头 日一二三四五六 + 1-30 数字），盲抓table tbody tr会混入日历垃圾 → 必须选表头含"好评/商品"的目标表格，并按表头名动态映射列号。 - 点击 shadow 内元素：page.evaluate 里递归找含目标文本且 innerText 最短的元素再
.click()；Playwright 标准选择器可穿透开放 shadow，但日历干扰/嵌套复杂时用 JS 递归穿透兜底。 - 新店可能无数据：平台要求近 30 天有效支付订单 ≥ 10 单才生成体验分/好评率，否则显示"暂无评分/暂无数据"，点卡片不跳转——属正常，不要当脚本故障。
为什么不用官方 API（已验证，勿重复研究）
- 微信小店官方 API 没有店铺体验分 / 商品好评率 / 品质退款率接口。罗盘商家版（
channels/ec/compass/*）只提供：电商数据概览、店铺人群画像、商品列表与单品数据、带货达人数据、直播数据，且全部为 T+1 成交/退款/流量类指标。 - 官方社区答复原文："目前没有相关接口，商家罗盘 API 那里就是全部了。"
- 因此本技能必须走后台页面抓取。若将来官方开放评价类接口，只需替换
daily-task.js中"进入 rate2 页 → 抓表"这一段，其余（对比/飞书/多店铺/定时）可复用。 - ⚠️ 数据时效：体验分每天中午 12:00 更新且更新需时间。定时任务请安排在 13:00 之后，不要卡在 12:00–12:15，否则易抓到 T-2 旧值，表现为"较昨日 →0.00"。
相关文件与多店铺参数化
scripts/save-auth.js、scripts/daily-task.js、scripts/verify-auth.js、scripts/run-daily.sh、scripts/config.json- 统一入口
scripts/run-daily.sh：运行时自动定位 node（PATH 优先，其次扫~/.workbuddy/binaries/node/versions/*/）并设置NODE_PATH，规避"托管 Node 版本目录变化导致写死的绝对路径失效"问题——定时任务里只写bash run-daily.sh [店铺名]，不要写死 node 绝对路径（实测该目录从22.22.2-2变成过22.22.2-3，写死的任务会全部失败）。bash run-daily.sh --check只检查环境不抓数据。 - 多店铺：
node save-auth.js 店铺B→auth_店铺B.json（截图debug_店铺B.png、触发SAVE_NOW_店铺B）；node daily-task.js 店铺B→ 读auth_店铺B.json，输出goods_rates_店铺B.json；无参数 = 默认店铺（auth.json/goods_rates.json）。若某店铺入口 URL 不同，在daily-task.js顶部SHOP_HOME_URL映射里加。 - 定时巡检建议每家店一条 automation、错开 5 分钟，名称统一
微信小店日报-{店铺名}。注意默认店铺那条不要带参数（否则会去找不存在的auth_店铺名.json）。
飞书通知（daily-task.js）
- Webhook 从
scripts/config.json的feishuWebhook读取（环境变量FEISHU_WEBHOOK_URL优先）；为空则跳过推送、只在控制台打印预览，不要把 webhook 硬编码进脚本。 - 每次运行无论是否预警都发日报；商品列表为空或脚本异常时发"❌ 抓取失败"错误通知。空列表需区分新店暂无评分（正常）与页面加载失败。
- 消息用 msg_type=post 富文本：
content.post.zh_cn.content= 行数组，每行 =[{tag:'text',text}]。post 不支持 Markdown 加粗（**会原样显示），消息文本禁用**。sendFeishuMessage(lines)参数为字符串数组。 - 精简格式：
📊 店名 MM-DD；体验分 4.80 ↑0.02 ｜ 好评率 86.46% ↓0.34%；① 刺梨原液 ￥19.9 85.71% ↓1.29% ⚠️；末尾⚠️ 预警：刺梨原液 85.71% 低于90%（预警行无价格无变化值）。 - 商品简称
shortName()：去[xxx]促销前缀，正则匹配第一个"刺梨+品类词"+ ￥价格；无关键词时 ≤12 字原名、否则前 8 字 +...。 fmtChange(diff, unit)：↑0.02/↓0.31%/→0.00（紧贴无空格）；体验分不带 %、好评率带 %；无历史数据不显示变化。- 体验分在首页卡片/rate2 页匹配"店铺体验分 4.80"形态抓取，存
result.experienceScore。
历史对比（与前一天对比）
- 每天存快照
history/店铺名_YYYY-MM-DD.json（date/shopName/shopScore/overallRate/goodsRates[{name, rate 数字}]），运行时读"昨天"文件做对比。 - ⚠️ 同名商品必须用队列配对：
normName会去掉[T]/[年中慧]等促销前缀，同一店铺的两个"刺梨原液"会归一化成同一 key。若用Map.set建索引会被后者覆盖 → 对比基准取错商品（实测把 85.58% 错配到 100%，得出"↓14.42%"，正确应为 ↓0.13%）。正确做法：prevQueues = Map<key, 数组>，当前商品按出现顺序shift()一一消费；配对后队列剩余总数 = 下架数量。 - 今日有昨日无 → 标（新商品）；昨日有今日无 → 行末提示"较昨日下架 N 个商品"；首日无昨日文件 → "首日记录，无历史对比数据"。
- ⚠️ 对比基准是昨天文件：同一天跑两次不产生对比（当天快照被覆盖）。要测"较昨日"效果需手工造一份昨日文件。
