前言¶

做 VRChat Avatar 时，衣服、改模、着色器、素体、配饰多半在 BOOTH 上找。平时要在浏览器和对话窗口之间来回切，把商品编号、价格、链接手动贴给模型。DeepSeek Harness（DSH）把能力拆成插件；若会话里能直接检索 BOOTH，并在界面旁开一页浏览榜单与详情，检索和选型会省不少步骤。下面介绍社区插件 dsh-booth-search（维护者 Where227-arch，分类：联网工具）的用途与用法。

这是什么¶

dsh-booth-search 是给 DSH 用的 BOOTH 商品搜索插件：面向 VRChat 造型与 Avatar 相关资产，支持用中文或英文关键词查公开商品，返回商品编号、标题、店铺、价格、分类、封面图与可点链接；同时在会话视图里注册独立的 BOOTH 标签页，不必只靠工具输出里的文字列表。

当前 package 版本为 1.5.0，许可证 MIT。非 BOOTH 官方插件，仅抓取公开页面；使用前请自行查看 GitHub 仓库 源码与许可证。插件以当前 DSH 宿主进程权限运行，安装前建议核对实现与网络行为。

核心功能¶

宿主工具¶

插件在宿主侧注册两个工具。

booth_search：按关键词搜索。中文关键词在宿主侧转成日文再查 BOOTH，接口与工具输出不会带出日文检索串；英文关键词原样使用。主要参数包括：

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

booth_item：按商品编号或商品链接取完整信息（标题、价格区间、店铺、简介摘录、封面、链接）。

BOOTH 独立页¶

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

1. 打开默认展示 BOOTH 全站热销榜（sort=popular），每页 24 件，底部翻页。
2. 搜索框配合分类、排序筛选，回车搜索；结果同样可翻页。「回热销榜」清空关键词回到榜单首页。
3. 搜索框留空、只选分类时，切换分类即按该分类词搜索（例如选「衣装」等价于搜「衣装」）。
4. 点击卡片右侧出现详情栏（sticky）：封面、价格区间、编号、简介、BOOTH 链接。
5. 1.5.0 起提供「选购台」分步向导（素体 → 服装 → 配饰）。页面挂载期间会隐藏会话输入框，切走其他视图后恢复。

页面数据走宿主同源接口 /api/booth-search/search|item|image；封面由宿主代理转发（仅允许 booth.pximg.net 与 booth.pm）。

安装与启用¶

从 GitHub 安装（README 推荐方式）：

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

本地开发时可从目录安装（路径按本机修改）：

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

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

配置¶

可在 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_search，例如查询「水手服」或「着色器」，并按 kind、sort、价格区间分页缩小范围；确定商品后用 booth_item 拉完整价格区间与简介。也可直接打开 BOOTH 页浏览热销榜，或在页面内搜索、按分类筛选后点卡片看详情并跳转 BOOTH。

改宿主侧 index.js 后需「热重启 DSH」；只改 client.js 刷新页面即可。

适用场景与注意¶

适合：在 DSH 里做 VRChat 造型选型、让智能体根据关键词列出 BOOTH 候选并附带链接与封面；需要侧边栏浏览榜单而非纯文本结果时。

务必了解：

• 实时抓取 BOOTH 公开页面，不登录、不下载付费内容；请遵守 BOOTH 使用条款并控制请求频率。
• 列表搜索返回的价格可能是抓取时的页面价或区间下限；完整区间以 booth_item 为准。
• 封面依赖宿主 attachments 服务；无该服务时仍返回纯文字结果。

结尾¶

dsh-booth-search 把 BOOTH 检索和会话旁的浏览页收进 DSH 插件形态：工具侧给结构化商品信息，界面侧给热销榜、搜索与详情栏。目录与源码：

• 社区目录：https://www.skillhub.cn/plugins/Where227-arch/dsh-booth-search
• GitHub：https://github.com/Where227-arch/dsh-booth-search