前言¶
在本地開發項目中，圖片、視頻和音頻素材通常直接存放在項目目錄下。資源管理器可以提供縮略圖，但無法提供標籤、備註、批量標註或語義檢索能力，且 AI 助手無法直接訪問這些本地文件。
dsh-asset-library 是一個 DeepSeek Harness 插件，它將項目文件夾裏的媒體文件變成一塊可瀏覽、可篩選、可標註的素材面板，並提供 Agent 工具，讓 AI 助手能通過語義檢索這些素材並獲取絕對路徑。
核心功能¶
插件提供以下功能：
- 瀏覽與展示：網格視圖與放大卡片。支持縮略圖填充切換（cover/contain）。
- 標註與篩選：標籤與備註、合集、批量打標。
- 批量操作：批量複製路徑。
- 輔助功能：參照圖釘、目錄漸進收窄、鍵盤友好、尺寸探測。
Agent 工具¶
插件註冊了三個 Agent 工具，供模型調用：
asset_library_overview：獲取掃描目錄概覽。asset_library_list：檢索素材，支持按類型、關鍵詞、標籤、子目錄過濾。asset_library_get：獲取單條素材的元數據（含探測到的分辨率）及絕對路徑。
安裝¶
在終端中執行以下命令安裝插件：
& 'D:\deepseek\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add 'G:\工作\dsh\dsh-asset-library'
工作原理與限制¶
- 零依賴：不使用 ffmpeg，素材保留在原項目目錄，插件只做索引與展示。
- 目錄過濾：默認跳過
.git、.dsh-assets、node_modules等目錄。 - 權限控制：默認 Agent 權限爲只讀。需顯式配置
allowAgentAnnotate: true才能允許 Agent 進行標註。 - 安全特性：包含路徑包含檢查，媒體端點僅服務資產擴展名。
典型用法¶
- 瀏覽素材：把項目目錄裏的圖片、視頻、音頻變成可瀏覽、可篩選的面板。
- AI 檢索：讓 AI 助手用語義檢索素材並獲取絕對路徑。
- 批量操作：選中 N 個資產批量複製相對路徑到剪貼板。
- 調整視圖：在工具欄切換縮略圖的填充模式。
適用場景與注意¶
此插件適合需要在 DeepSeek Harness 中統一管理本地媒體資產、需要 AI 助手輔助檢索素材或批量獲取素材路徑的場景。
- 許可證：MIT
- 維護者：Hnqhj
- GitHub：https://github.com/Hnqhj/dsh-asset-library
