前言¶
在 DeepSeek Harness（DSH）里做智能体时，模型擅长理解自然语言，却往往碰不到你本机硬盘上的音乐和视频。文件名和文件夹结构也很难表达「适合学习的慢爵士」或「室内有人说话的那一段」。常见做法是手动翻目录，或把路径写进提示词，既慢又容易漏。
下面介绍社区插件 songjongdevsecops/dsh-midia（目录名常写作 dsh-midia）。它面向个人影音库做语义检索，对视频结果可带时间码；同时用 guard 拒绝移动、重命名或删除库内媒体，降低智能体误操作的风险。
这是什么¶
dsh-midia 由维护者 songjongdevsecops 发布，在 SkillHub 社区目录中归类为联网工具。官方简介为：
DeepSeek Harness plugin: semantic search over a personal music and video library, with timecodes, plus a guard that refuses to move, rename or delete media.
一句话：在 DSH 里用自然语言搜索本机音乐与视频，检索结果可含时间码；对配置库路径下的媒体文件，插件会拦截移动、重命名和删除类操作。
SkillHub 页面显示当前目录版本为 v0.1.1（近期有更新）。许可证在 dsh.so 插件档案中记为 MIT；GitHub 星标为 0。
核心功能¶
以下能力来自目录简介，以及插件文档在第三方索引页中的说明（原仓库 README 在抓取时不可用，以各来源可核对描述为准）。
-
语义检索个人影音库
用自然语言描述想找的内容（例如学习用的慢爵士、室内有人说话的片段），返回最接近的条目，并给出相关度分数；对切分后的视频片段可返回时间码。 -
智能体工具与斜杠命令
文档记载提供工具 midia_buscar 供智能体调用；面向用户的斜杠命令包括 /midia（语义搜索，并支持在结果向量上做方向调节，例如向「更安静」或「远离鼓点」偏移）、/midia-parecidas（以某一文件为参考找最近邻）、/midia-duplicatas（按 md5、SimHash、嵌入等多层检测重复候选，仅提出建议，不自动删除）。 -
只读取向与 guard
搜索在本地进行，索引留在本机；guard 会拒绝针对已配置库根目录下媒体文件的移动、重命名、删除类工具调用。简介中明确写出「refuses to move, rename or delete media」。 -
配置
文档说明需在插件配置中指定库根路径与嵌入模型；具体字段名以安装后插件包内说明为准（安装前若无法打开 GitHub，可先查看 SkillHub / dsh.so 档案中的版本与来源信息）。
安装与启用¶
DSH 生态里插件安装通常写入指定 profile。dsh.so 对下列命令做过安装规范解析与沙盒安装实测（L4/L5，验证环境含 dsh 0.2.1-rc.2）：
dsh plugin --profile web add github:songjongdevsecops/dsh-midia
若本机未全局安装 dsh，部分 README 写法会使用 npx @deepseek-ai/dsh 前缀，语义与上式相同，仍以你环境中的 DSH 文档为准。
安装前请注意：
- 2026-10-23 对
https://github.com/songjongdevsecops/dsh-midia的访问返回 404；dsh.so 英文页亦提示原仓库可能已删除或设为私有，上述 GitHub 安装源可能暂时无法使用。安装前请自行确认仓库可访问，或从可信镜像 / 已缓存工件获取源码并审阅。 - 第三方文档记载运行环境需 Node.js ^22.19.0 或 >=24.0.0（与 DSH 支持的 Node 范围一致）。作者未在 package.json 中声明强制 dsh 版本下限，但建议在与你一致的 dsh 版本上试装。
- 插件以当前 dsh 进程的用户权限运行，能读写的路径与宿主机用户相同。安装前请阅读源码与 MIT 许可证，确认库路径与嵌入模型配置符合你的隐私与合规要求。
典型用法¶
原 GitHub README 本次未能直接抓取。下列流程整理自公开文档对工具与命令的说明，复现前请先完成安装并配置库根路径与嵌入模型。
-
在对话里用自然语言找媒体
让智能体调用midia_buscar，传入描述性查询。返回列表应包含匹配分数；视频片段应带时间码，便于跳转播放或剪辑。 -
用斜杠命令做同类检索或后处理
-/midia：与工具类似的语义搜索，并可在嵌入空间做方向运算，微调结果气质。
-/midia-parecidas：指定一个已有文件，查找库中与之最接近的条目。
-/midia-duplicatas：扫描重复候选（多层哈希与嵌入），由你决定是否清理，插件不会自动删文件。 -
验证 guard 行为
若智能体或脚本尝试移动、重命名、删除库根下的媒体，应被 guard 拒绝。这符合插件「只检索、不破坏库文件」的设计目标。
具体参数格式与首次建索引步骤，以你安装到的 v0.1.1 包内文档为准。
适用场景与注意¶
适合谁
- 本地积累了大量音乐、视频素材，希望用 DSH 智能体按语义查找片段，而不是死记路径。
- 需要把时间码交给下游步骤（摘要、剪辑指令、播放列表生成等）。
- 担心智能体误删误移媒体，希望默认只读并显式拦截破坏性文件操作。
使用注意
- SkillHub（
skillhub.cn）是社区插件目录，与 DeepSeek / 幻方无官方从属关系；dsh.so 等为生态内的索引与验证站点，信息以各页更新时间为准。 - 语义检索依赖嵌入模型与索引质量，首次使用通常需要为库建立或更新索引，耗时与库大小相关。
- dsh.so 静态扫描曾标记
lib/midia.js中存在execFile调用（shell 相关警告），属自动化启发式结果，不是人工安全审计。是否接受该实现，需结合你自己对源码的审查。 - 仓库可用性变化时，优先以可访问的源码与许可证为准，再决定是否装入生产 profile。
结尾¶
dsh-midia 把「个人影音库」接进 DSH 的插件体系：语义搜索、时间码、相似与重复候选分析，并用 guard 守住媒体文件不被移动、重命名或删除。若你维护本地媒体资产并在 Harness 里做自动化，可在确认 GitHub 源可用后，按官方安装命令装入 web profile 试用。
