前言¶

在 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