前言¶
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 / 幻方无官方从属关系。
