前言¶
DeepSeek Harness（DSH）裏，Agent 每輪執行往往把文件寫到磁盤，但界面默認更習慣在任務末尾才集中列出路徑。中間過程看不到圖、也來不及對照路徑做校驗。市面上常見的「對話圖片查看器」盯的是對話裏的圖片附件，和 Agent 真正落盤的位置不是一回事。
下面介紹社區插件 dsh-gallery（維護者 Hope2023Dcr，GitHub 倉庫 Hope2023Dcr/dsh-gallery）。它在 DSH 右側欄直接掃描你配置的產出根目錄，把磁盤上的圖片和文檔變成可刷新的畫廊；圖片生成後約 5 秒內可見，非圖片文件可一鍵用 DSH 原生側欄預覽。插件分類爲客戶端，當前版本 0.4.0，MIT 許可，零 npm 依賴。
這是什麼¶
一句話：看磁盤上的產出目錄，不是對話框裏的圖。
Host 側掃目錄、解析圖片尺寸與會話日誌；瀏覽器側渲染右側欄 tab、縮略圖與設置。和「只讀對話附件」的方案相比，數據源是 Agent 寫文件的目錄，並支持按「本對話產出」篩選項（通過解析 DSH 會話日誌裏 write / edit / present 等真正產生文件的調用，而不是按時間猜測）。
核心功能¶
圖片畫廊¶
- 自動刷新：每 5 秒輪詢；查看大圖時自動暫停。
- 縮略圖：客戶端 canvas 壓到約 200px 寬，併發閘門 4，進入視口才加載。
- 放大：滾輪縮放（最大 8×），超出面板後可按住鼠標中鍵拖動。
- 退出回位：單擊退出後回到原先那張縮略圖在列表中的位置，而不是跳到頂部。
文件畫廊¶
列文檔、代碼、數據、壓縮包、鏈接、設計類等共 48 種擴展名（不含圖片，圖片只在圖片畫廊裏顯示，避免重複）。
| 操作 | 行爲 |
|---|---|
| 點卡片或「預覽」 | 用 DSH 原生側欄打開（Markdown 渲染、代碼高亮由 DSH 自身提供） |
| 「複製路徑」 | 複製絕對路徑，按鈕短暫顯示已複製反饋 |
| 在資源管理器中定位 | Windows 下 reveal 定位文件；其他平臺會打開所在目錄 |
分類開關¶
面板提供 「全局資產」 與 「當前對話」：
- 全局資產：產出目錄下全部內容，按時間倒序。
- 當前對話：僅顯示本對話真正產出過的文件（依賴會話日誌格式，見下文限制）。
產出根目錄¶
優先級如下：
- 面板內 ⚙ 設置（改完立即生效，無需重啓）
cordis.patch.yml裏配置的root- 自動探測：例如
~/DSH產出、~/Documents/DSH產出等，以及各盤符下的DSH產出（代碼循環盤符，不寫死單盤）
目錄不存在時，面板會提示修改產出根目錄。
Host 配置（改 cordis.patch.yml 後需重啓 DSH）示例：
config:
# root: 'D:/產出' # 不填就走自動探測
windowHours: 24 # 只看最近 N 小時內的產出
maxItems: 60 # 最多顯示多少條
maxDepth: 3 # 向下掃描幾層目錄
skipDirs:
- node_modules
- .git
安裝與啓用¶
前置：已安裝 DSH 桌面版或 Web 版。插件以當前 DSH 進程權限讀盤；安裝前建議瀏覽倉庫源碼並確認 MIT 許可證與行爲是否符合你的環境。
方式一：DSH 插件頁（需能訪問 GitHub）¶
打開 DSH → 插件頁 → 添加插件 → 安裝第三方插件，粘貼：
github:Hope2023Dcr/dsh-gallery
安裝完成後完全退出並重啓 DSH（不是僅刷新頁面）。DSH 的國內鏡像只代理 npm，不代替從 GitHub 拉取插件。
若需鎖定版本，README 給出示例（提交哈希 03c05fb324aeca02cbf0b4bafff9542b013f212b）：
git+https://github.com/Hope2023Dcr/dsh-gallery.git#03c05fb324aeca02cbf0b4bafff9542b013f212b
方式二：一鍵腳本（可離線）¶
下載倉庫 ZIP 解壓後，在解壓目錄內執行：
node install.mjs
腳本會定位 DSH 主目錄（優先 DSH_HOME，否則 ~/.dsh）、選擇 profile、複製到 <profile>/node_modules/dsh-gallery/ 並在 package.json 的 bundles 中註冊，同時備份原 package.json。可選：
node install.mjs --profile desktop
node install.mjs --dry-run
裝完必須重啓 DSH。
打開面板¶
任選入口：
- 左側邊欄腳部的
▦按鈕 - 對話輸入框右側的
▦按鈕 - 右側欄
+→「開始」頁 →「產出畫廊」
首次若目錄未命中，在面板 ⚙ 設置 填入產出目錄絕對路徑即可。
典型用法¶
README 中的典型場景：讓 Agent 批量生成多張圖時，不必等任務結束再逐條點路徑覈對——側欄約每 5 秒刷新，生成即可見；某張不對可以當場停改提示詞。
日常可先開 「當前對話」 只看本會話落盤文件，需要翻歷史產出時再切 「全局資產」。非圖片產物點預覽走 DSH 原生側欄，比複製路徑再在外部編輯器打開更貼 DSH 工作流。
適用場景與注意¶
適合：頻繁讓 Agent 寫圖、寫文檔到固定產出目錄；需要在對話進行中盯盤校驗、快速預覽 Markdown/代碼等。
已知限制（來自 README）：
- 「當前對話」 依賴
~/.dsh/sessions/.../session.v4.jsonl.zstd中tool/call事件格式；DSH 大版本升級後可能需迴歸驗證，其餘功能不受影響。 - 默認掃描深度 3 層，過深的目錄會漏文件。
- 默認 windowHours: 24；調大會拖慢掃描。
- 文件畫廊不顯示圖片擴展名，圖片只在圖片畫廊。
- 資源管理器「定位文件」在 Windows 上爲原生 reveal；其他平臺行爲爲打開所在目錄。
改 index.js（Host）後須重啓 DSH；改 client.js 刷新頁面即可。
結尾¶
dsh-gallery 把 DSH 默認「任務末尾才列路徑」的體驗，改成右側欄對磁盤產出目錄的實時畫廊：圖片自動刷新、48 種非圖文件原生預覽、產出根目錄可配且面板改路徑無需重啓。社區目錄頁：skillhub.cn/plugins/Hope2023Dcr/dsh-gallery；源碼與完整說明：github.com/Hope2023Dcr/dsh-gallery。DSH 生態強調「一切皆插件」；SkillHub 等目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
