前言¶
在 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。
