前言¶
在 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 手動啓用。
