前言¶
在 DeepSeek Harness（DSH）裏做多工作區、多會話開發時，產物往往散落在各目錄的 out/、outputs/ 裏，上傳文件也可能落在 attachments、incoming 等不同位置。若只靠資源管理器或終端 ls 逐層翻目錄，類型混雜、點文件與 node_modules 穿插其中，查找成本高。下文介紹的 dsh-asset-gallery（維護者 ZyRay233，分類爲客戶端插件）在 DSH Web 會話界面提供只讀「資產庫」面板：按文檔、圖片、音視頻等頁籤瀏覽工作區文件，並單獨聚合「上傳的」「生成的」兩類路徑，適合需要快速複製路徑或 @ 引用、預覽小文本、在瀏覽器打開媒體文件的場景。
這是什麼¶
dsh-asset-gallery 是 DSH 的資產業務向文件管理插件（README 中亦稱 DSH 資產庫）。它在 host 側掛載掃描與 HTTP API，在瀏覽器側通過 DSH client UI slots 注入會話頭部的入口，不寫入、不刪除、不上傳任何文件。插件版本在 package 元數據中爲 0.1.0，許可證 MIT。
社區目錄頁：SkillHub 上的 dsh-assest-gallery。源碼與說明見 GitHub 倉庫；README 與 package 中的安裝地址指向 ZyRay233/file-manager 倉庫，安裝時應以 README 中的命令爲準。
核心功能¶
下面按 README 已寫明的能力歸納，不做超出資料的擴展。
按類型與工作區瀏覽¶
- 頂部頁籤：全部 / 文檔 / 圖片 / 音視頻 / 壓縮包。
- 工作區列表從 DSH 的
workspace.json自動發現；大工作區下子目錄先摺疊爲一行，點開再展開，右上「← 上級」返回上一層。 - 默認隱藏
.dsh、.git、node_modules、__pycache__等系統或緩存路徑。
文件操作菜單¶
每個文件右側「⋮」菜單支持：複製路徑、複製 @ 引用、預覽文本（受 API 大小限制）、在瀏覽器中打開圖片或音視頻。
「上傳的」與「生成的」聚合頁¶
- 上傳的：依次掃描
~/qq_files、$DSH_HOME/attachments/v1/files、~/incoming（目錄存在才掃）。 - 生成的：默認在每個工作區下掃描
out/、outputs/、deliverables/、tmp_frames/、gen/，以及~/tmp_frames，取最近 7 天的圖片與音視頻。 - 可用環境變量覆蓋「生成的」掃描目錄（逗號分隔），例如：
DSH_ASSET_GALLERY_GENERATED_DIRS="/data/outputs,/data/render" dsh web --no-open
HTTP API（只讀）¶
路由掛在 DSH webServer 上，供客戶端面板調用：
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /dsh-ag/api/scan?type=all&ws=<工作區名>&dir=<相對目錄> |
掃描一層，返回文件與子目錄摘要 |
| GET | /dsh-ag/api/collected?which=uploaded\|generated |
聚合頁文件列表 |
| GET | /dsh-ag/api/peek?path=<絕對路徑> |
只讀預覽文本（≤32KB） |
scan 的 dir 不得越出所選工作區；peek 僅允許工作區根或用戶主目錄範圍內的路徑（經 resolve 與前綴校驗）。
環境要求¶
- DSH Web（
dsh web）>= 0.2.0（packageengines.dsh與此一致）。 - 瀏覽器端依賴 DSH 的 client UI slots（
@deepseek-ai/dsh-client-ui-slots）。
安裝與啓用¶
官方 README 給出兩種安裝方式。日常從 GitHub 安裝可使用下面命令（勿自行改寫倉庫 URL）：
dsh plugin --profile web add git+https://github.com/ZyRay233/file-manager.git
本地開發與 link 安裝時，README 要求先克隆 file-manager 倉庫、在插件目錄執行構建，再以 link 方式註冊（具體路徑以你本機克隆目錄爲準）。裝完後需重啓 dsh-web，例如 Linux systemd：
systemctl restart dsh-web
亦可手動重啓正在運行的 dsh web 進程。
典型用法¶
- 打開任意 DSH Web 會話，在會話頭部找到 資產庫 按鈕，點開右側資產庫面板。
- 在頂部選擇文件類型頁籤，在下拉框中切換工作區。
- 需要深入子目錄時點擊摺疊行進入；用「← 上級」返回。
- 對目標文件打開「⋮」菜單，按需複製路徑、
@引用，或預覽、瀏覽器打開媒體。
工作區註冊表默認讀取 $DSH_HOME/storages/workspace.json，按 title / path 展示；若文件不存在則回退到用戶主目錄。
適用場景與注意¶
適合誰：經常在 DSH 裏切換多個工作區、需要按類型篩文件、或要把上傳/生成產物集中看一眼的 Web 端用戶；需要純只讀瀏覽、快速引用路徑到對話裏的場景。
權限與安全：插件以當前 DSH 進程權限讀盤，安裝前應自行審閱源碼與 MIT 許可證。設計上爲純只讀：peek 限制 32KB，無寫入/刪除/上傳接口；隱藏點開頭文件與常見系統目錄。DSH 社區目錄（如 SkillHub）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係，安裝插件屬於信任維護者與倉庫內容的個人選擇。
資料不一致處：目錄頁與線索中的倉庫名爲 dsh-assest-gallery，而 README 安裝與 package repository 指向 file-manager.git；本文安裝步驟以 README 爲準。
結尾¶
dsh-asset-gallery 把「工作區樹狀翻目錄」改成「按類型 + 聚合目錄」的瀏覽方式，並守住只讀邊界，降低在 DSH 會話裏找文件、引文件的摩擦。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub（安裝命令見 README 中的 file-manager 地址）。
