前言¶
在 DeepSeek Harness（DSH）裏做帶視頻、圖片素材的智能體或內容工作流時，常見做法是自己在工作區裏翻目錄，或在聊天裏粘貼路徑。媒體文件分散、檢索靠文件名、要人工記分類時，會話和素材之間缺少一塊穩定的瀏覽面。dsh-media-library 把當前 DSH 項目登記爲媒體庫：在界面裏掃選定文件夾、網格預覽、播放，併爲條目打標籤；Agent 也可按目錄瀏覽並追加標籤。本文依據倉庫 README 與 package.json（版本 0.1.4）整理能力與用法。
這是什麼¶
dsh-media-library 由維護者 vb2250158 發佈，倉庫地址爲 github.com/vb2250158/dsh-media-library。插件定位是：在顯式指定的 DSH 項目中瀏覽、播放媒體，並編輯標籤；不復制、移動、刪除或改寫原始媒體文件。生態上 DSH 主張「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
- 項目級媒體庫：在左側項目上右鍵選擇「設爲媒體庫」，在「設置」裏逐個添加要掃描的媒體文件夾（可多個，可在工作區內或外）。
- 瀏覽與播放：選中該項目的會話後，媒體庫在聊天旁打開；視頻網格遞歸讀取已選文件夾中的視頻並顯示幀，點選播放。解碼能力由瀏覽器決定，插件不做轉碼。
- 搜索、排序與標籤：按文件名搜索；可切換按更新時間、名稱或文件大小排序。在「設置」中創建標籤分類和標籤；在預覽裏多選標籤並保存，也可直接輸入。影片頁可按不同分類組合篩選；再次點擊已選標籤可取消該分類篩選。未打標籤的條目顯示爲「未分類」。
- Agent 協作：Agent 可瀏覽媒體目錄並追加標籤。
- 入口與狀態：已設置的項目右鍵有「打開媒體庫」「取消媒體庫」；取消僅移除媒體庫登記，原文件、標籤和項目會話保留。無項目時先用 DSH 原有「添加工作區」；插件詳情頁也有「打開媒體庫」。項目菜單的「打開媒體庫」進入項目主面板，「返回聊天」恢復當前會話；切回聊天不改變原會話及模型。
- 數據落盤：項目目錄、標題和身份由官方 Workspace 服務持有；媒體文件夾配置、視頻索引、標籤分類與媒體標籤保存在工作區
.dsh-media-library/。原 DSH Home 中的舊數據保留；添加含舊媒體的文件夾時會遷移對應標籤。視頻網格分頁請求，目錄變化後需刷新；某文件夾讀取失敗時保留已有索引並提示，其他文件夾繼續掃描。 - 安全與範圍（文件接口）：要求 DSH Connection 認證的 owner；非 owner 的 Peer 被拒絕。媒體路徑須在用戶選定文件夾內，拒絕父目錄遍歷、隱藏路徑、Windows ADS/設備名及子級符號鏈接/聯接等。圖片支持常見光柵格式，不提供 HTML/SVG。Range 請求僅支持一個字節區間。當前交付頁面只接本地項目，不讀取網盤憑據或連接雲服務；保留原 OpenList 讀取模塊，本版不接雲服務。
安裝與啓用¶
安裝須通過 DSH 同步器或官方 CLI，安裝本倉庫的固定 Git 提交；插件以已檢查的 JavaScript 源文件運行，無安裝生命週期或額外構建依賴。不要用本地 link 或複製覆蓋安裝目錄代替正規安裝。
首次加載插件是否需要重啓，以宿主官方 lifecycle 的實際結果爲準；後續設置項目與標籤不需要重啓。
運行環境（來自 package.json）：
- Node：
>=24.9.0 - 對等依賴：
@deepseek-ai/dsh-client-ui-primitives、@deepseek-ai/dsh-tools（版本範圍>=0.2.2-rc.1 <0.3.0）
維護者在 README 中說明：npm test 驗證文件與邊界、持久化、認證等；npm run build 檢查運行 JavaScript 語法；npm run test:client -- <當前 DSH 源碼目錄> 用於組件級測試。發佈還需在獨立 DSH Home/端口做真實頁面驗收。README 寫明當前僅驗證維護者 fork 聲明的 Windows 源碼 Web 環境。
許可證：倉庫原創插件代碼與配置爲 MIT。
典型用法¶
下面步驟與 README「使用」一節一致，可按順序操作。
- 在左側項目上右鍵，選擇「設爲媒體庫」。打開媒體庫「設置」，逐個添加需要掃描的媒體文件夾。
- 選中該項目的會話，在聊天旁打開媒體庫，在網格中點選視頻播放。
- 需要歸類時，在「設置」裏建分類與標籤，在預覽中選擇或輸入標籤並保存；在影片頁用標籤組合篩選。
- 若不再把該項目當媒體庫，右鍵「取消媒體庫」即可（文件與會話仍保留）。
會話內若依賴自動媒體標籤，需要當前宿主實際渲染可選右側欄；右側欄未呈現時，仍可從項目菜單打開完整媒體庫。
適用場景與注意¶
適合誰：需要在 DSH 項目內集中查看本地（或工作區外明確添加的）視頻與圖片、並用標籤做簡單分類與篩選的開發者；希望 Agent 在同一套索引與標籤上追加標註的場景。
權限與安全：插件以當前 dsh 進程權限運行；安裝前應自行檢查源碼與 MIT 許可證。勿將攻擊者可寫的目錄選爲掃描路徑——Windows 側路徑檢查並非針對併發惡意換鏈的原子沙箱，僅適用於可信目錄。
平臺：資料中明確寫明的驗證環境爲 Windows 源碼 Web 環境；其他平臺行爲以你本地 DSH 與瀏覽器爲準。
結尾¶
dsh-media-library 把「項目 + 顯式文件夾 + 標籤」綁在一起，在 DSH 裏補上媒體瀏覽與標註，而不動原始文件。進一步瞭解可看社區目錄 skillhub.cn/plugins/vb2250158/dsh-media-library 與 GitHub 倉庫 github.com/vb2250158/dsh-media-library。
