用途
show-gallery 是一个通用媒体浏览器(Universal Media Browser),用于浏览任意本地文件夹中生成的图片与视频。它可在所有生成类项目中重复使用,主要帮助学生/用户查看生成结果、放大预览、复制路径以便后续处理。
主要能力
- 浏览图片与视频:识别 png、jpg、jpeg、webp、gif 图片格式,以及 mp4、webm、mov 视频格式。
- 点击放大:在模态框中放大查看图片,视频支持播放。
- 复制路径:卡片和模态框中均可复制文件的绝对路径到剪贴板。
- 网格布局:支持 2、3、4 列切换。
- 类型筛选:支持 All / IMG / VID 筛选。
- 字幕关联:如存在与媒体同名的 .txt 文件,会读取其内容(截取前 200 字符)作为说明显示。
- 统计显示:显示当前筛选数量与总数,以及图片、视频数量。
使用方式
- 指定文件夹:如果提供了 path 则直接使用;未提供则询问是哪个文件夹,或使用最近一次生成的文件夹。
- 生成 gallery.html:将模板写入目标文件夹,并把 GALLERY_ROOT 改为目标文件夹的绝对路径(使用正斜杠 /,而非反斜杠 \)。
- 打开预览:检查 .claude/launch.json 是否已有服务该文件夹的 server;若无则新增配置(使用下一个端口,如 8125、8126 等)。执行 preview_start,再通过 preview_eval 将 window.location.href 指向 '/gallery.html',等待 1-2 秒后 preview_screenshot 展示结果。
- 交互:从 gallery 页面复制路径并粘贴到对话中,说明要对图片或视频做什么操作。
适用场景
- 生成角色图片后查看结果(配合 /gen-character-image)。
- 使用 Kie.ai 生成后查看(配合 /kie-ai)。
- 使用 fal.ai 生成后查看(配合 /fal-ai)。
- 使用 ComfyUI 生成后查看(配合 /comfyui-user)。
- 对图库中选中的图片进行进一步分析(配合 /image-analysis)。
浏览文件夹模式
当指示为“browse folder”或“ดู folder”且未指定路径时:列出包含媒体文件的输出文件夹,供选择文件夹,然后按正常流程生成 gallery。
限制
- GALLERY_ROOT 需手动改为目标文件夹的绝对路径,路径需使用正斜杠。
- 依赖 .claude/launch.json 中的预览 server 配置。
- 若截图超时,可改用 preview_snapshot,并提示在 Preview 面板中查看。
- 具体收费、平台信息暂未提供。