BOOTH 商品搜索 Where227-arch/dsh-booth-search

dsh-booth-search

给 DSH 用的 BOOTH 商品搜索插件：做 VRChat 造型/Avatar 时直接搜衣服、改模、着色器、素体、道具，返回商品编号 + 标题 + 店铺 + 价格 + 分类 + 封面图 + 可点链接。

关键词写中文即可（水手服 / 女仆装 / 着色器 / 素体…），插件在宿主侧转成日文再查 BOOTH，接口响应与工具输出都不会带出日文串。英文关键词原样使用。

安装

从 GitHub 装（推荐）：

dsh plugin add github:Where227-arch/dsh-booth-search

或从本地目录装（改代码时用）：

dsh plugin add file:D:/DS/plugins/booth-search

装好后在 DSH 左下角点「热重启 DSH」让宿主路由生效，之后刷新页面即可看到「BOOTH」标签页。

工具

booth_search

| 参数 | 说明 |
| query | 关键词（必填），中文即可，例：水手服、猫耳 配饰 |
| kind | 偏向分类：auto(默认) / clothing 衣装 / shader 着色器 / base_model 素体 / accessory 配饰 / texture 贴图 / animation 动画 / prop 小物 |
| sort | recommended(默认) / newest / price_asc / price_desc |
| minPrice / maxPrice | 价格区间（日元，整数） |
| page | 第几页，从 1 开始 |
| limit | 返回条数 1–12，默认 6 |
| includeCover | 是否附封面图，默认 true（最多 6 张/次） |

结果自带封面图（图片附件）与直达链接；kind 只是附加日文词偏向搜索，不做硬过滤。

booth_item

按商品编号取完整信息：标题、价格区间、店铺、简介摘录、封面图、链接。参数为纯数字编号或商品链接。

BOOTH 独立页

包内 client.js 在会话标题栏的视图排（对话 / 轨迹 / 上下文 / BOOTH / 画廊 / 编队）注册一个独立页面：

- 打开即热销榜（BOOTH 全站 sort=popular 列表），底部翻页，每页 24 件；翻页停在热销榜还是关键词结果，取决于当前搜索状态。
- 搜索框 + 分类/排序筛选，回车即搜，结果同样可翻页；「回热销榜」按钮清空关键词并回到榜单首页。
- 分类可以单独用：搜索框留空、只选分类时，切分类即按该分类词搜索（例如分类选「衣装」= 搜「衣装」），不用先输关键词。
- 点卡片在右侧出详情栏（sticky 吸顶，列表滚动时保持可见）：封面、价格区间、商品编号、简介、直达 BOOTH 的链接。
- 页面数据走宿主同源接口 /api/booth-search/search|item|image；封面由宿主代理转发（绕开防盗链，只允许 booth.pximg.net 与 booth.pm）。
- 挂载期间隐藏会话输入框（composer），切走即恢复。

配置

在 profile 的 cordis.patch.yml 覆盖同名条目（不改也能用）：

- id: dsh-booth-search
config:
proxy: http://127.0.0.1:10090 # 走代理；留空=直连 timeoutMs: 20000 lang: ja # BOOTH 站点语言（ja / en） maxCovers: 6 # 每次最多附带几张封面

环境变量 BOOTH_PROXY 可作为 proxy 的兜底。

注意

- 实时抓取 BOOTH 公开页面，不登录、不下载付费内容。
- 价格是抓取时的页面价，可能只是区间下限（booth_item 给完整区间）。
- 封面图依赖宿主 attachments 服务；没有该服务时仍返回纯文字结果。

结构

index.js 宿主侧：booth_search / booth_item 两个工具 + /api/booth-search 的 search/item/image 路由 client.js 客户端：注册到 conversation.view 的「BOOTH」独立页 cordis.patch.yml bundle patch（insert dsh-booth-search） locale/*.json 中英文案 icon.svg 图标

生效方式

改宿主侧 index.js 后重启一次宿主（左下角「热重启 DSH」）让新路由接管；只改 client.js 刷新页面即可。

更新日志

- 1.5.0 新增「选购台」分步向导（素体 → 服装 → 配饰，按钮行在步骤条下方），BOOTH 页挂载时隐藏会话输入框。
- 1.4.3 清掉包内 BOM、修正文件头注释，README 补 GitHub 安装方式。
- 1.4.2 修客户端模块 id 与包名不一致导致的加载失败。
- 1.4.0 分类可单独搜索（搜索框留空 + 选分类）。
- 1.3.0 首屏改热销榜，榜单与搜索结果都能翻页。
- 1.2.0 中文关键词在宿主侧转日文检索；右侧详情栏；翻页。

License

MIT。非 BOOTH 官方插件；仅抓取公开页面，请遵守 BOOTH 使用条款并控制请求频率。