| name | dianping-queue |
| description | 面向中文用户的大众点评取号 skill。用于解析取号页、一次性读取排队桌数、按正常浏览器流程取号，以及在 agent 被定时唤醒后按用户阈值取号或提醒出发。 |
大众点评取号
这个 skill 只处理大众点评排队取号相关任务。触发意图包括：
- 帮我取号、排号、打开点评取号页
- 定时看这家店排了多少桌
- 超过 N 桌再帮我取号
- 取号成功后盯着前面还有几桌，少于 N 桌提醒我出发
核心要求
- 必须完全按照本 skill 的流程和脚本执行，不要自行设计替代流程。
- 全程不要向用户汇报中间步骤。
- 只有遇到需要用户确认的断点、需要短信验证码、浏览器验证、多个候选选择、或脚本错误 / 业务失败时，才向用户汇报并等待用户输入。
- 向用户输出时必须使用“标准回复格式”，不要自由发挥，不要输出脚本 JSON、运行日志、字段清单或多余解释。
标准回复格式
取号成功：
已取号成功：<店名>
桌号：<tableNumDesc>
前方等待：<queueWaitTableNum> 桌
人数：<peopleCount> 人
只看状态：
当前排队：<店名>
状态：<queueStatusText>
总等待：<queue.totalWaitCount 或 queue.queueWaitTableNum> 桌
桌型：
- <tableTypeName>（<tableCapacityDesc>）：<waitCount> 桌
取号后提醒出发：
可以出发了：<店名>
前方等待：<queueWaitTableNum> 桌
多个候选：
找到多个可能的门店，请回复编号：
1. <店名>｜<地址>
2. <店名>｜<地址>
需要短信验证码：
请输入短信验证码。
需要浏览器验证：
请在打开的浏览器页面完成验证，完成后告诉我继续。
需要定时检查频率：
请告诉我多久查一次排队进度。
业务不可用或错误：
无法完成：<原因>
常见业务原因直接使用页面或脚本返回的 reason / blocker / queue.queueStatusText / queue.queueStatusSubText。如果同时有主文案和副文案，格式为：
无法完成：<主文案>：<副文案>
执行边界
- 只使用本 skill 的脚本入口；店名 / 地址解析先走本地缓存，缓存缺失时走
browser-search。
- 搜索、状态读取和取号都必须通过正常浏览器页面流程操作。
- 不要自行拼接口搜索，不要直接调用最终取号请求，不要绕过前端。
- 状态读取脚本只执行一次读取，不常驻轮询。定时唤醒由 agent 所在环境的自动化、定时任务或提醒系统负责。
- 阈值取号和取号后提醒出发场景中，必须先确认用户希望多久查一次排队进度。
- 未达到阈值时静默结束，不要向用户报数。
- 用户未提供人数时默认
2 人。
- 本地用户默认只需配置手机号；浏览器参数由脚本处理。
- 脚本返回
verification_required 时，立刻停止当前流程并向用户索要验证码。用户给出验证码后，原命令追加 --sms-code "<SMS_CODE>" 续跑。
命令
命令中的 <SKILL_DIR> 表示这个 skill 的安装目录。
安装或更新 helper：
python3 "<SKILL_DIR>/scripts/setup_runtime.py"
店名、地址或商场名解析：
python3 "<SKILL_DIR>/scripts/queue_context.py" resolve --target "<店名、地址或缓存别名>"
缓存缺失时走浏览器搜索：
python3 "<SKILL_DIR>/scripts/queue_context.py" browser-search --query "<店名或地址>" --city "<城市>"
确认搜索候选：
python3 "<SKILL_DIR>/scripts/queue_context.py" confirm-search --index "<编号>"
取号：
python3 "<SKILL_DIR>/scripts/queue_context.py" take --target "<店名、缓存别名、candidateId 或取号 URL>" --party-size 2
只读取状态：
python3 "<SKILL_DIR>/scripts/queue_context.py" status --target "<店名、缓存别名、candidateId 或取号 URL>" --party-size 2
分享页入库并取号：
python3 "<SKILL_DIR>/scripts/queue_context.py" from-share --share-url "<大众点评分享链接>" --party-size 2
按订单页 URL 查看前方桌数：
python3 "<SKILL_DIR>/scripts/queue_context.py" status --order-url "<订单页 URL>"
候选和断点
candidates 只有 1 个：直接运行 confirm-search。candidates 有多个：向用户展示候选编号，让用户回复编号后再继续。- 用户回复编号后，不要复用上一页，不要重新搜索；直接用该编号运行
confirm-search --index "<编号>"。
- 如果返回
browser_verification_required，让用户在浏览器页面完成验证；完成后重新运行同一条命令。
- 如果返回
verification_required，让用户提供短信验证码后续跑同一命令并追加 --sms-code "<SMS_CODE>"。
