前言¶
在本地开发项目中，图片、视频和音频素材通常直接存放在项目目录下。资源管理器可以提供缩略图，但无法提供标签、备注、批量标注或语义检索能力，且 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
