前言¶

在 DSH 里做带图对话或脚本出图时，图往往散落在会话记录、临时目录和各自的路径约定里：想按某次会话回看、对比多张结果，或把「对话里出现过但还没入库」的图归档，常常要在资源管理器和聊天面板之间来回找。右栏若只有通用预览，也难做局部重绘前的蒙版编排和多图参数对照。

下面介绍社区插件 dsh-session-gallery（维护者 lalilulelo3，分类为客户端）。它在 DSH 桌面版右栏提供 会话图片、工作台、图片库 三块能力，并内建 generate_image 出图工具，把 AI 出图、对话中出现的图和手动导入统一落到磁盘目录，用 sidecar JSON 记录元数据。

生态上 DSH 遵循「一切皆插件」；插件目录见 SkillHub 条目，与 DeepSeek / 幻方无官方商店从属关系。源码与说明以 GitHub 仓库 为准，当前 package 版本为 0.1.0，许可证 MIT。

这是什么¶

dsh-session-gallery 是 DSH 桌面版右栏图片管理插件：按会话查看图、在工作台里摆图做对比与蒙版、在图片库里按来源与时间筛选；任意会话都可调用内建出图，结果直接进图片库并出现在「会话图片」里，无需自写脚本或指定输出路径。

会话图片¶

当前会话中的图，对应图片库里 sessionId 匹配的子集。

1. 顶部 未归档区：进过对话但尚未存入图片库的图；点开大图可 存入图片库 或 忽略。
2. 支持多选、收藏、删除、放入工作台。

sessionId 是 sidecar 里认领「会话图片」的唯一依据（见下文数据布局）。

工作台¶

自绘画布：把多张图摆在一起做对比、圈选、涂蒙版。

排版方式包括：自动网格（4 张以内横排）、横排、竖排、重叠对比。

生成改图请求 会导出一张蒙版图和一段请求文本，便于交给 AI 做局部重绘。

图片库¶

扫描配置的图片库根目录（及可选的「旧图目录」），按子目录分组展示。

• 来源筛选（多选）：用户发的 / 工具产物 / 脚本产物 / 手动导入 / 素材库 / 未知。
• 时间筛选：今天、近 7 天、近 30 天、按月。
• 支持按文件名 / 提示词 / 模型搜索，收藏，调节缩略图大小。
• 并排对比：选 2~4 张并排查看，底部参数对照表，滚轮同步缩放、拖动同步平移。
• 删除默认进回收站；永久删除需勾选。

出图与出图日志¶

内建 generate_image¶

• 任何会话都能调用，不需要写脚本、不需要指定输出路径。
• 出图直接落进图片库，同时出现在「会话图片」。
• 支持参考图（垫图）、多张并发、quality 档位、mask 局部重绘。
• 兼容「提交后轮询」的异步中转站（apimart-async）与 OpenAI 兼容的同步接口（openai-compat）。

出图日志¶

每次出图的完整记录（请求、轮询轨迹、响应、失败原因）按天存 JSONL。在图片库工具栏点 出图日志 查看，可按失败筛选、复制原始 JSON。

安装与启用¶

在 PowerShell 中执行官方安装命令：

dsh plugin --profile desktop add dsh-session-gallery

装完后需 完全退出 DSH 再启动（仅关窗口不够）。

从源码接入时：在 ~/.dsh/profiles/desktop/package.json 的 dependencies 中以 link: 方式加入本仓库，在 dsh.profile.bundles 中加上 dsh-session-gallery，执行 npm install && npm run build 后同样完全重启 DSH。本文不展开 git clone 流程。

配置¶

点右栏 设置（⚙）。

图片库¶

出图¶

API Key 二选一：

• 环境变量：setx YOUR_KEY_NAME "sk-..."
• 或写入 ~/.dsh/.credentials.yaml：

YOUR_KEY_NAME: sk-...

密钥不会写入插件配置文件，也不会进入图片库目录。

典型用法¶

1. 安装并重启后，在设置里指定 图片库根目录 和出图中转站、协议、凭据名、默认模型。
2. 在任意会话让 AI 调用 generate_image；生成文件落在图片库（如 脚本产出 子目录），当前会话的「会话图片」会同步显示。
3. 对话里出现但未入库的图，在「未归档区」点开大图后 存入图片库 或 忽略。
4. 需要局部改图时，把相关图 放入工作台，排版后使用 生成改图请求，将蒙版图与文本交给模型；或在出图配置中配合 mask。
5. 在图片库用来源、时间、搜索筛选；选 2~4 张做并排对比，对照底部参数表；出图失败时在 出图日志 中按失败筛选并查看 JSONL 详情。

数据在磁盘上的样子¶

图片库是普通目录，每张图旁有同名 .json sidecar，记录提示词、模型、参数、花费、时间等。示意结构：

<图片库目录>\
├─ 脚本产出\<哈希12>.png + .json          ← generate_image 直出
├─ 会话导入\<会话短id>\<时间>-<哈希12>.png + .json
├─ 手动导入\<时间>-<哈希12>.png + .json
├─ .workbench\                            ← 工作台导出（不参与扫描）
└─ .dshsg-trash\                          ← 删除的图（不参与扫描）

hash 为内容 sha256 的前 12 位，用于去重与收藏。删掉 .json 仍可看图，但大图里不再显示参数。

适用场景与注意¶

适合谁：长期在 DSH 桌面版里做对话出图、脚本 generate_image、或多会话收图对比的开发者；希望右栏完成归档、筛选、工作台蒙版与出图日志排错，而不是自己维护散落路径。

安全与权限：插件随当前 DSH 进程运行，可读写你配置的图片库目录并调用你配置的中转站；安装前请阅读 源码 与 MIT 许可证，自行评估凭据与目录权限。

平台：安装命令使用 --profile desktop，面向 DSH 桌面版右栏客户端插件（dsh.client.platform: web）。

结尾¶

dsh-session-gallery 把会话图、工作台编排和图片库扫描收拢到右栏，并用 sidecar 元数据支撑筛选与对比；内建出图与 JSONL 日志则减少自管路径和排错成本。查阅目录与文档：

• SkillHub：https://www.skillhub.cn/plugins/lalilulelo3/dsh-session-gallery
• GitHub：https://github.com/lalilulelo3/dsh-session-gallery