booth-query-display

BOOTH 商品查询展示 Skill — 搜索/热度榜/封面/汉化/格式化输出

本 skill 固化「查询 BOOTH（booth.pm）商品并按固定格式展示」的完整工作流。适用场景：用户要求查 Booth 商品、查 VRChat 素材热度榜、展示商品列表（含封面、人民币价格、热度）。

触发条件

• 「查询 Booth / booth.pm 商品」
• 「Booth 热度前 N」/「Booth 排行」
• 「展示 Booth 商品」/「附封面展示」
• 用户要求查 VRChat 相关素材（avatar/衣装/3D 模型）在 Booth 的售价与热度

BOOTH 缓存交互规则（用户拍板 2026-08-14）

查询 BOOTH 商品时按以下规则决定实时/缓存（不要无脑询问）：

1. 用户明确说要查新的/最新/实时 → get_booth_item 带 forceRefresh: true 强制实时抓取
2. 用户未明确 → 默认走本地缓存（get_booth_history / get_booth_searches 查历史；get_booth_item 缓存命中直接返回 cached:true）
3. 仅当拿不准用户意图时才询问一句（如"要最新的还是查过的？"）

缓存未命中时代码自动实时兜底（get_booth_item 缓存 miss 后直接抓取并落库），无需文档重复。

落库缓存功能（并入本 skill，Issue #28 实现）

BOOTH 查询结果自动落库（本地 SQLite booth_items / booth_search_history 表，旁路缓存——落库失败不影响实时返回）：

工具	说明
search_booth_items	搜索命中即 upsert 商品快照到 booth_items，记录搜索历史
get_booth_item	单品查询命中即落库；缓存命中返回 cached: true（不抓 BOOTH）；forceRefresh: true 强制实时
get_booth_history	查已落库商品快照（按收藏数/更新时间排序，minWishlist 趋势过滤）——"上周查过哪件衣服"
get_booth_searches	查搜索历史（搜索词 + 结果 + 时间）

• 收藏数（wishlistCount）是 BOOTH 唯一公开热度信号，落库后可做趋势跟踪（哪件在涨、接近售罄）
• 重复搜索同词优先走缓存，避免触发 booth.pm 限流
• 服务重启数据仍在（SQLite 持久化）；老库升级自动建表（IF NOT EXISTS 幂等）

浏览器访问流程（重要修正）

优先使用电脑的默认浏览器，而非临时启动的调试实例：

1. 检测默认浏览器（Windows）：

   reg query "HKCU\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice" | grep ProgId
   # MSEdgeHTM → Edge；ChromeHTML → Chrome；FirefoxURL → Firefox
   

2. 用默认浏览器打开目标页（如 Booth 登录页）：

   # 默认浏览器直接打开 URL（Windows 用 start / cmd /c start）
   cmd //c start "" "https://booth.pm/users/sign_in"
   # 或显式指定浏览器路径（Edge 示例）
   "/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe" "https://booth.pm/users/sign_in"
   

3. 需自动化接管时：给默认浏览器附加 CDP 调试端口启动（必须带独立 --user-data-dir，避免与用户日常浏览会话冲突）：

   EDGE="/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe"
   "$EDGE" --remote-debugging-port=9222 --user-data-dir="$LOCALAPPDATA/Temp/edge-debug-profile" --no-first-run "URL"
   # Chrome 同理；CDP 端点 http://127.0.0.1:9222/json
   

4. 手动登录页场景（reCAPTCHA 等无法自动化的）：
   • 优先用默认浏览器打开页面让用户操作，或
   • 用上述 CDP 实例打开——登录窗口会出现在该实例中，提示用户在对应窗口完成登录（可能与你日常浏览窗口并存，注意区分）