前言¶
在 DeepSeek Harness（DSH）里用智能体生成海报、截图或短视频时，产物往往落在工作区目录里，分散在多次对话对应的文件夹中。要找回上周某张图，常见做法是往回翻聊天记录或自己在文件管理器里搜路径，既慢也容易漏。
下面介绍社区插件 dsh-works-gallery（作品库）：它在 DSH 右侧栏增加一个标签页，按时间聚合展示工作区根目录下扫描到的图片与视频，以缩略图墙形式呈现，最新在前，并支持筛选、搜索、全屏预览与可选的批量删除（移入系统回收站）。
这是什么¶
dsh-works-gallery 是面向 DeepSeek Harness 的客户端插件，仓库由 822376583-hub 维护，许可证 MIT（© Wang Youqing）。官方简介为「Works gallery for DeepSeek Harness」——在右侧栏以缩略图墙展示工作区内产生的图像与视频，默认只读；除用户勾选的删除操作外，不改动磁盘上的其他文件。
依赖 DSH 具备右侧栏能力（@deepseek-ai/dsh-client-ui-sidebar-right），运行环境要求 Node.js >= 20。当前 package 版本为 0.1.0。
核心功能¶
插件采用按需扫描、不做持久索引：在用户请求时遍历配置的工作区根目录，结果缓存约 10 秒。扫描时会跳过 node_modules、.git、.cache、dist、venv、__pycache__ 以及以点开头的目录等常见依赖与构建目录。
支持的媒体扩展名包括：.png、.jpg、.jpeg、.webp、.gif、.avif、.bmp、.svg、.mp4、.webm、.mov、.m4v、.mkv。
展示与交互方面：
- 时间分组：最新在前，分组为 Today、Yesterday，再按普通日期。
- 缩略图墙：图片懒加载；视频显示静音首帧并带播放标识。
- 全屏 lightbox：点击打开；图片原尺寸；视频带控件与 seek。文件路由支持 HTTP
Range（206），便于拖动进度条。 - 筛选与搜索：All / Images / Videos，以及按路径与文件名搜索。
- lightbox 内操作：在系统文件管理器中显示（Show in folder）、复制路径。
- 批量整理：进入 Select，勾选缩略图后 Delete，将文件移入操作系统回收站（可从回收站一键恢复）。非媒体扩展名、以及不在配置根目录内的路径会被宿主拒绝。
列表接口单次最多 5000 条、目录深度 8；批量删除单次最多 300 个路径。所有 /file 与 /api/reveal 请求在解析符号链接后仍必须在配置的 roots 之内，且仅提供媒体扩展名文件。
文件从哪里来¶
默认扫描 DSH 存放工作区的目录：
| OS | 默认根目录 |
|---|---|
| Windows | %USERPROFILE%\Documents\deepseek-harness |
| macOS / Linux | ~/Documents/deepseek-harness |
若上述目录不存在，则回退到 ~/Documents。可用环境变量 DSH_WORKS_GALLERY_ROOTS 覆盖；多个根在 Windows 上用分号 ; 分隔，在其他系统上用冒号 : 分隔。
macOS / Linux 示例：
export DSH_WORKS_GALLERY_ROOTS="$HOME/renders:$HOME/screenshots"
Windows PowerShell 示例：
$env:DSH_WORKS_GALLERY_ROOTS = "D:\renders;D:\screenshots"
安装与启用¶
方式一：DSH 插件市场
在插件市场中搜索 作品库 或 works gallery，安装后重启 DSH。
方式二：手动安装
将本仓库复制到当前 profile 的 node_modules，并在 profile 的 package.json 里把包名加入 dsh.profile.bundles：
// ~/.dsh/profiles/<profile>/package.json
{
"dsh": {
"profile": {
"bundles": ["dsh-works-gallery"]
}
}
}
说明：Host 侧路由在下次 bundle 列表重载时会热应用；右侧栏标签在刷新页面或重启 DSH 后出现。
典型用法¶
- 打开右侧栏 → Guidance / 引导 标签 → 点击 Gallery / 作品库 胶囊；之后该标签会常驻右侧栏标签栏。
- 用顶部的 All / Images / Videos 与文件名搜索缩小范围。
- 点击缩略图进入全屏预览；需要定位文件时用 Show in folder 或复制路径。
- 若要清理误生成或重复的媒体：点 Select，勾选条目，再 Delete（文件进入系统回收站，而非永久删除）。
宿主提供的 HTTP 路由均位于 /dsh-works-gallery 前缀下；其中仅 POST /api/delete 会写磁盘（移入回收站）。只读类接口包括 GET /api/list、GET /file?path=…、GET /api/reveal?path=…，具体字段与限制见仓库 README。
适用场景与注意¶
适合经常在 DSH 工作区里产出图片、短视频，又希望不翻聊天记录就能按时间浏览、预览、定位路径的开发者或创作者。
安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。插件以当前 DSH 进程权限运行，扫描与删除范围受配置的 roots 与宿主校验约束；删除操作虽进回收站，仍应在确认路径无误后再批量执行。
社区插件目录站点（如 SkillHub 上的条目页）与 DeepSeek / 幻方无官方从属关系，DSH 生态本身是「一切皆插件」的扩展方式，本文介绍的是社区维护的客户端插件，而非官方内置功能。
结尾¶
dsh-works-gallery 把分散在工作区里的图像与视频收成一块右侧栏缩略图墙，按日分组、支持筛选与 lightbox 预览，并在需要时用回收站安全的批量删除做整理。若你已在用 DSH 右侧栏，可在插件市场安装或通过 profile bundles 手动启用。
