dsh-comfyui-album

这是 dsh-comfyui-image 的辅助插件。 它自己不出图，只负责把那个插件已经生成在磁盘上的图片收成相册：侧边栏有入口，鼠标悬浮到图片上就能复制图片、复制提示词、导出工作流、加入当前对话、删除。

兼容插件

插件	关系	仓库
`dsh-comfyui-image`	配套（相册的数据来源）：读取它落盘的图片与同名 `<图片>.json` sidecar，以及它配置里的 `outputDir`。不 import 它的任何代码，所以它升级不会把相册拖垮；没装时相册只会是空的。	wbb316/dsh-comfyui-image
`dsh-better-sidebar`	可选（增强入口）：检测到它的 `ctx.betterSidebar` 服务时，把相册注册成一个侧栏页签（`comfyui-album:gallery`），可在其 `+` 菜单或原生右栏里打开。没装时这段注册静默缺席，不影响主侧边栏入口。	omdsh-dev/DSH-better-sidebar

安装

# 从 GitHub 安装（<profile> 换成你的 profile 名，常见的是 desktop 或 web）
dsh plugin --profile <profile> add github:YuChenLiao/dsh-comfyui-album

# 本地开发：直接把目录 link 进 profile
dsh plugin --profile <profile> add link:/path/to/dsh-comfyui-album

装完刷新一下页面（Web GUI 要重新加载客户端 bundle）。已在 DSH 0.2.1-rc.2 上验证；前置是先装好 dsh-comfyui-image，否则相册里没有东西可看。

界面

入口

左侧栏的相册入口，以及 better-sidebar 新建菜单里的相册页签

左侧栏「相册」一项就是主入口，点开后在中央面板显示相册。同一套页面也会注册进 dsh-better-sidebar，所以在它的起始页页签列表里能看到「相册」（截图右侧）。中央主面板顶部另有「在侧边栏打开」按钮，用于就地跳到侧栏页签；没装该插件时按钮会给出提示，而不是静默失败。

相册面板

相册面板：顶部工具栏、缩略图网格、每张图下方的提示词与参数

顶部一行是全套筛选：相册计数、按提示词或文件名搜索、目录下拉、仅生成图 / 含全部图片 切换、重新扫描。下面是缩略图网格，卡片底部直接给出提示词开头与「尺寸 · seed · 模型」。滚动到底部会自动续页，拉完即停。

悬浮操作

鼠标悬浮时出现五个按钮：复制图片、复制提示词、导出工作流、添加到当前对话、删除

鼠标移到任意一张图上，右上角浮出五个按钮，从左到右：复制图片、复制提示词、导出工作流、添加到当前对话、删除。删除会先弹确认框，不会误点就抹掉文件。

图片详情

大图预览与右侧参数栏：尺寸、种子、底模、采样、步数、CFG、模式、生成时间、路径，以及提示词与负向提示词全文

点开任意一张图是大图预览，右侧列出全部可复现参数与提示词全文（含负向提示词），同样的五个操作在这里也能用。

大图本身可以放大与翻页：

滚轮或 + / - 缩放（0.2×–8×），0 回到适应窗口；底部缩放条显示当前百分比，点一下复位。
放大后按住拖动平移，双击在「适应窗口」与 2× 之间切换。
← / → 切换上一张 / 下一张（首尾循环），舞台两侧也有箭头，顶部显示 3 / 184 这样的位置。
翻页只在「已加载」的列表内循环，不会因为切换而触发新的分页请求。

它怎么找图

不建数据库 —— 相册直接扫磁盘上的产物。元数据有两个来源，按顺序取：

同名 sidecar <图片>.json：dsh-comfyui-image 生成时写下的完整记录（writeMetadata 默认开启），带 prompt、负向提示词、seed、尺寸、步数、CFG、模型、采样器和完整 workflow。
PNG 内嵌工作流：ComfyUI 自己 SaveImage 出来的图（例如直接用 ComfyUI 出的角色图）没有 sidecar，但 PNG 的 tEXt 里就有 prompt 工作流。宿主只读文件头 64KB 把它解析成同样的字段，所以这类图同样能进相册、复制提示词、导出工作流。

支持的图片扩展名：.png .jpg .jpeg .webp .gif .avif .bmp（内嵌解析只对 PNG 生效）。

默认只列能读到元数据的图（sidecar 或内嵌其一）；面板上的「仅生成图 / 含全部图片」可以切换成目录里的所有图片。

扫描根目录：显式配置 → 当前工作目录 → 全部 workspace → dsh-comfyui-image 配置里的 outputDir → 进程 cwd。一轮扫描按目录缓存 4 秒，面板上的刷新按钮会强制重扫。

列表里的缩略图由宿主按需生成（sharp，360px WebP，落盘缓存）。sharp 不可用时静默回退原图，不影响使用。

重复合并

同一次生成常常落两份：ComfyUI 自己 SaveImage 存一份，插件又另存一份（路径与文件名都不同）。相册按「seed + 像素尺寸 + 提示词前 160 字符」判断是不是同一张图，默认只显示一条：

卡片左上角的 ×2 角标表示还有 1 份副本，点开灯箱能看到副本的完整路径。
主项优先取有 sidecar 的那份（元数据更完整），其次路径更短、修改时间更新。
删除是连坐的：删掉一条就把这一组的全部副本一起从磁盘移除，不会留下另一份再顶上来。
工具栏的「合并重复」可以关掉，改看未合并的原始列表。

没有 seed 的图不参与合并 —— 宁多勿错。

五个悬浮操作

操作	行为
复制图片	写进系统剪贴板（非 PNG 会先转 PNG —— 剪贴板只认 PNG）
复制提示词	复制 sidecar 里的正向提示词（没有 sidecar 时用 PNG 内嵌的那份）
导出工作流	下载 `<文件名>.workflow.json`（ComfyUI API 格式，可直接喂 `/prompt`）
添加到当前对话	先切回对话，再以「粘贴图片」的方式把图放进输入框草稿（等你补文字再发）
删除	彻底删除：图片、同名 sidecar、同组副本与缩略图缓存一起从磁盘移除，不进回收站，无法恢复

批量操作

工具栏的「选择」进入选择模式：卡片点击变成勾选，悬浮操作条隐藏，底部浮出一条操作栏。

全选当前已加载的图片，或一键清除。
导出工作流：把所有选中图的工作流打成一个 ZIP（comfyui-album-workflows-<时间戳>.zip）。没有工作流的图会被跳过，提示里会报跳过数量。
删除：二次确认后从磁盘彻底删除所选图片、同名元数据、同组副本与缩略图缓存。部分失败会单独计数，不会整体回滚。

单次批量上限 500 条（防止误选整库）。退出选择模式即清空选择。

配置

在 profile 的 cordis.patch.yml 里给本插件那行加 config：

- id: dsh-comfyui-album
  name: dsh-comfyui-album
  config:
    roots: ['D:\Comfy-Desktop\output']  # 额外纳入相册的目录
    maxDepth: 3        # 扫描深度，0 = 只看根目录本身
    maxItems: 4000     # 单个根目录最多收集多少张图
    cacheMs: 4000      # 列表缓存毫秒数
    includeHidden: false

API

挂在 /comfyui-album/api 下：

GET /roots — 允许读取的根目录
GET /items?root=&q=&offset=&limit=&all=1&refresh=1&dedupe=0 — 相册列表（dedupe=0 关闭重复合并；默认合并）
GET /meta?path= — 单张图片的完整元数据（sidecar 或 PNG 内嵌）
GET /workflow?path= — 工作流下载
GET /file?path=&thumb=1 — 图片字节（thumb=1 取缩略图）
POST /delete?path= — 删除图片与同名 sidecar，返回 { ok, removed }
POST /delete-many — body { paths: [...] }（1–500 条），返回 { ok, removed, failed }，逐条物理删除、部分失败不回滚
POST /workflows — body { paths: [...] }，把所选图片的工作流打成 ZIP 返回（X-Album-Skipped 头给出跳过数量）

path 一律校验必须落在白名单根目录内，越界返回 403；写接口只接受 POST/DELETE，读取接口只接受 GET/HEAD（否则 405）。

自检

npm test

tests/smoke.mjs：起一个临时 HTTP server 跑宿主 API，覆盖列表/筛选/分页越界/元数据/工作流下载头/图片字节/缩略图，以及删除、越权 403、未知路由 404、非 GET 405。
tests/render.mjs：用 react-dom/server 把 Card / Lightbox / Gallery / 删除确认层渲一遍，并用纯函数 planPage 钉住“续页何时停手”的分页决策。

已知限制

「添加到当前对话」走的是宿主自己的粘贴链路（向输入框派发带 File 的 paste 事件），和用户手动 Ctrl+V 完全一致；找不到输入框时会退化成「图片已复制到剪贴板」。
剪贴板写入需要安全上下文（127.0.0.1 满足），浏览器拒绝时会给出明确提示。
删除是 unlink 物理删除：不留回收站、不留索引、不留缩略图缓存，确认框是唯一的防线。合并模式下删除会连带该组的全部副本。
内嵌场景的正负提示词靠 KSampler 的 positive / negative 连线回溯（最多三层）；工作流里找不到这条连线时，退化为“第一个文本当正向、最后一个当负向”，多段拼接的提示词可能被拆开。
内嵌场景的尺寸取 PNG 的 IHDR（真实像素），工作流里 EmptyLatentImage 声明的尺寸只在拿不到 IHDR 时兜底。
缩略图对 GIF 只取首帧；大图预览仍然是原图。

致谢

dsh-comfyui-image：它把 prompt、seed、采样参数和完整 workflow 都写进了图片旁边的 sidecar，并坚持“文件名带时间戳、绝不覆盖”的落盘规则。相册因此不需要自建索引，删掉 sidecar 缓存也能随时重建。
dsh-better-sidebar：开放的 ctx.betterSidebar 注册接口和清楚的接入文档，让一个第三方页面能直接作为页签嵌进它的侧栏，而不用去猜宿主内部结构。
DeepSeek Harness：webServer 路由、sidebar.panellist 与 main 面板这套插槽设计，让相册能以插件方式挂在原生侧边栏上；本地 ComfyUI 则提供了实测出图的真实环境。

许可

MIT

dsh-comfyui-album

这是 dsh-comfyui-image 的辅助插件。 它自己不出图，只负责把那个插件已经生成在磁盘上的图片收成相册：侧边栏有入口，鼠标悬浮到图片上就能复制图片、复制提示词、导出工作流、加入当前对话、删除。

兼容插件

插件	关系	仓库
`dsh-comfyui-image`	配套（相册的数据来源）：读取它落盘的图片与同名 `<图片>.json` sidecar，以及它配置里的 `outputDir`。不 import 它的任何代码，所以它升级不会把相册拖垮；没装时相册只会是空的。	wbb316/dsh-comfyui-image
`dsh-better-sidebar`	可选（增强入口）：检测到它的 `ctx.betterSidebar` 服务时，把相册注册成一个侧栏页签（`comfyui-album:gallery`），可在其 `+` 菜单或原生右栏里打开。没装时这段注册静默缺席，不影响主侧边栏入口。	omdsh-dev/DSH-better-sidebar

安装

# 从 GitHub 安装（<profile> 换成你的 profile 名，常见的是 desktop 或 web）
dsh plugin --profile <profile> add github:YuChenLiao/dsh-comfyui-album

# 本地开发：直接把目录 link 进 profile
dsh plugin --profile <profile> add link:/path/to/dsh-comfyui-album

装完刷新一下页面（Web GUI 要重新加载客户端 bundle）。已在 DSH 0.2.1-rc.2 上验证；前置是先装好 dsh-comfyui-image，否则相册里没有东西可看。

界面

入口

左侧栏的相册入口，以及 better-sidebar 新建菜单里的相册页签

相册面板

相册面板：顶部工具栏、缩略图网格、每张图下方的提示词与参数

悬浮操作

鼠标悬浮时出现五个按钮：复制图片、复制提示词、导出工作流、添加到当前对话、删除

图片详情

大图预览与右侧参数栏：尺寸、种子、底模、采样、步数、CFG、模式、生成时间、路径，以及提示词与负向提示词全文

点开任意一张图是大图预览，右侧列出全部可复现参数与提示词全文（含负向提示词），同样的五个操作在这里也能用。

大图本身可以放大与翻页：

滚轮或 + / - 缩放（0.2×–8×），0 回到适应窗口；底部缩放条显示当前百分比，点一下复位。
放大后按住拖动平移，双击在「适应窗口」与 2× 之间切换。
← / → 切换上一张 / 下一张（首尾循环），舞台两侧也有箭头，顶部显示 3 / 184 这样的位置。
翻页只在「已加载」的列表内循环，不会因为切换而触发新的分页请求。

它怎么找图

不建数据库 —— 相册直接扫磁盘上的产物。元数据有两个来源，按顺序取：

同名 sidecar <图片>.json：dsh-comfyui-image 生成时写下的完整记录（writeMetadata 默认开启），带 prompt、负向提示词、seed、尺寸、步数、CFG、模型、采样器和完整 workflow。
PNG 内嵌工作流：ComfyUI 自己 SaveImage 出来的图（例如直接用 ComfyUI 出的角色图）没有 sidecar，但 PNG 的 tEXt 里就有 prompt 工作流。宿主只读文件头 64KB 把它解析成同样的字段，所以这类图同样能进相册、复制提示词、导出工作流。

支持的图片扩展名：.png .jpg .jpeg .webp .gif .avif .bmp（内嵌解析只对 PNG 生效）。

默认只列能读到元数据的图（sidecar 或内嵌其一）；面板上的「仅生成图 / 含全部图片」可以切换成目录里的所有图片。

列表里的缩略图由宿主按需生成（sharp，360px WebP，落盘缓存）。sharp 不可用时静默回退原图，不影响使用。

重复合并

卡片左上角的 ×2 角标表示还有 1 份副本，点开灯箱能看到副本的完整路径。
主项优先取有 sidecar 的那份（元数据更完整），其次路径更短、修改时间更新。
删除是连坐的：删掉一条就把这一组的全部副本一起从磁盘移除，不会留下另一份再顶上来。
工具栏的「合并重复」可以关掉，改看未合并的原始列表。

没有 seed 的图不参与合并 —— 宁多勿错。

五个悬浮操作

操作	行为
复制图片	写进系统剪贴板（非 PNG 会先转 PNG —— 剪贴板只认 PNG）
复制提示词	复制 sidecar 里的正向提示词（没有 sidecar 时用 PNG 内嵌的那份）
导出工作流	下载 `<文件名>.workflow.json`（ComfyUI API 格式，可直接喂 `/prompt`）
添加到当前对话	先切回对话，再以「粘贴图片」的方式把图放进输入框草稿（等你补文字再发）
删除	彻底删除：图片、同名 sidecar、同组副本与缩略图缓存一起从磁盘移除，不进回收站，无法恢复

批量操作

工具栏的「选择」进入选择模式：卡片点击变成勾选，悬浮操作条隐藏，底部浮出一条操作栏。

全选当前已加载的图片，或一键清除。
导出工作流：把所有选中图的工作流打成一个 ZIP（comfyui-album-workflows-<时间戳>.zip）。没有工作流的图会被跳过，提示里会报跳过数量。
删除：二次确认后从磁盘彻底删除所选图片、同名元数据、同组副本与缩略图缓存。部分失败会单独计数，不会整体回滚。

单次批量上限 500 条（防止误选整库）。退出选择模式即清空选择。

配置

在 profile 的 cordis.patch.yml 里给本插件那行加 config：

- id: dsh-comfyui-album
  name: dsh-comfyui-album
  config:
    roots: ['D:\Comfy-Desktop\output']  # 额外纳入相册的目录
    maxDepth: 3        # 扫描深度，0 = 只看根目录本身
    maxItems: 4000     # 单个根目录最多收集多少张图
    cacheMs: 4000      # 列表缓存毫秒数
    includeHidden: false

API

挂在 /comfyui-album/api 下：

GET /roots — 允许读取的根目录
GET /items?root=&q=&offset=&limit=&all=1&refresh=1&dedupe=0 — 相册列表（dedupe=0 关闭重复合并；默认合并）
GET /meta?path= — 单张图片的完整元数据（sidecar 或 PNG 内嵌）
GET /workflow?path= — 工作流下载
GET /file?path=&thumb=1 — 图片字节（thumb=1 取缩略图）
POST /delete?path= — 删除图片与同名 sidecar，返回 { ok, removed }
POST /delete-many — body { paths: [...] }（1–500 条），返回 { ok, removed, failed }，逐条物理删除、部分失败不回滚
POST /workflows — body { paths: [...] }，把所选图片的工作流打成 ZIP 返回（X-Album-Skipped 头给出跳过数量）

path 一律校验必须落在白名单根目录内，越界返回 403；写接口只接受 POST/DELETE，读取接口只接受 GET/HEAD（否则 405）。

自检

npm test

tests/smoke.mjs：起一个临时 HTTP server 跑宿主 API，覆盖列表/筛选/分页越界/元数据/工作流下载头/图片字节/缩略图，以及删除、越权 403、未知路由 404、非 GET 405。
tests/render.mjs：用 react-dom/server 把 Card / Lightbox / Gallery / 删除确认层渲一遍，并用纯函数 planPage 钉住“续页何时停手”的分页决策。

已知限制

「添加到当前对话」走的是宿主自己的粘贴链路（向输入框派发带 File 的 paste 事件），和用户手动 Ctrl+V 完全一致；找不到输入框时会退化成「图片已复制到剪贴板」。
剪贴板写入需要安全上下文（127.0.0.1 满足），浏览器拒绝时会给出明确提示。
删除是 unlink 物理删除：不留回收站、不留索引、不留缩略图缓存，确认框是唯一的防线。合并模式下删除会连带该组的全部副本。
内嵌场景的正负提示词靠 KSampler 的 positive / negative 连线回溯（最多三层）；工作流里找不到这条连线时，退化为“第一个文本当正向、最后一个当负向”，多段拼接的提示词可能被拆开。
内嵌场景的尺寸取 PNG 的 IHDR（真实像素），工作流里 EmptyLatentImage 声明的尺寸只在拿不到 IHDR 时兜底。
缩略图对 GIF 只取首帧；大图预览仍然是原图。

致谢

dsh-comfyui-image：它把 prompt、seed、采样参数和完整 workflow 都写进了图片旁边的 sidecar，并坚持“文件名带时间戳、绝不覆盖”的落盘规则。相册因此不需要自建索引，删掉 sidecar 缓存也能随时重建。
dsh-better-sidebar：开放的 ctx.betterSidebar 注册接口和清楚的接入文档，让一个第三方页面能直接作为页签嵌进它的侧栏，而不用去猜宿主内部结构。
DeepSeek Harness：webServer 路由、sidebar.panellist 与 main 面板这套插槽设计，让相册能以插件方式挂在原生侧边栏上；本地 ComfyUI 则提供了实测出图的真实环境。

许可

MIT

YuChenLiao/dsh-comfyui-album

dsh-comfyui-album

兼容插件

安装

界面

入口

相册面板

悬浮操作

图片详情

它怎么找图

重复合并

五个悬浮操作

批量操作

配置

API

自检

已知限制

致谢

许可

Community comments

YuChenLiao/dsh-comfyui-album

dsh-comfyui-album

兼容插件

安装

界面

入口

相册面板

悬浮操作

图片详情

它怎么找图

重复合并

五个悬浮操作

批量操作

配置

API

自检

已知限制

致谢

许可

Community comments