xiaoyaoPanPan/dsh-media

dsh-media
把挂载目录变成可检索的媒体库DeepSeek Harness（dsh）插件：视频 / 图片自动打标、语义检索，Agent 与 Web UI 都能用

中文 ·
English ·
Issues

10 秒安装（推荐：交给 AI）
复制下面提示词，发给 Cursor / ChatGPT / Claude / DeepSeek Harness 等你正在用的 AI：
请严格按 https://github.com/xiaoyaoPanPan/dsh-media/blob/main/INSTALL.md
把 dsh-media 装进本机 DeepSeek Harness 的 web profile。
硬性顺序（缺一步会失败）：
1) 先确认当前 dsh web 实际使用的 home（环境变量 DSH_HOME，或默认 ~/.dsh / %USERPROFILE%\.dsh），再改对应 profiles/web/pnpm-workspace.yaml：写入 blockExoticSubdeps: false（不要删已有键）。
2) 再执行：dsh plugin --profile web add "github:xiaoyaoPanPan/dsh-media#path:dsh-media-app"
3) 若报 allowBuilds / ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED：把 pnpm 打印的整行键写入同一 pnpm-workspace.yaml，再重跑同一条 add。不要改插件源码。
4) 再执行：pnpm --dir "/profiles/web" exec dsh-media-setup-preset
5) 硬刷新或重启 dsh web，汇报每步成功 / 失败与原始报错。
装完后：确认 dsh web 已开，检查是否已有 supportsVision=true 的模型，并告诉我结果。
- 若有：先问我要不要接到「素材打标」；我同意后，在 Web UI 会话顶栏的 Image & video scan 控件里选用该模型再扫描。
- 若无：按 https://github.com/xiaoyaoPanPan/dsh-media/blob/main/SETUP-VISION.md 教我怎么加一个能看图的自定义模型（不要替我选定某一家平台），加完再问我是否接通。

更细的逐步说明：INSTALL.md。

或自己动手安装
需要：官方 dsh、pnpm、已能打开的 dsh web。
顺序不能反：先改配置，再 add。
1）放开 git 传递依赖（pnpm 11 必需）
打开 web profile 的 pnpm-workspace.yaml：
- 默认：~/.dsh/profiles/web/pnpm-workspace.yaml（Windows：%USERPROFILE%\.dsh\profiles\web\pnpm-workspace.yaml）
- 若启动时设置了 DSH_HOME：用 $DSH_HOME/profiles/web/pnpm-workspace.yaml

合并写入（保留原有内容）：
blockExoticSubdeps: false

不写这一步，常见报错：ERR_PNPM_EXOTIC_SUBDEP。
2）添加插件
dsh plugin --profile web add "github:xiaoyaoPanPan/dsh-media#path:dsh-media-app"

PATH 里没有 dsh 时：

npx -y --package @deepseek-ai/dsh dsh plugin --profile web add "github:xiaoyaoPanPan/dsh-media#path:dsh-media-app"

若报 allowBuilds：把 pnpm 打印的整行写进同一 pnpm-workspace.yaml 的 allowBuilds:，再重跑同一条 add。
3）安装 Agent Preset

pnpm --dir "${DSH_HOME:-$HOME/.dsh}/profiles/web" exec dsh-media-setup-preset
Windows PowerShell（默认 home）：

pnpm --dir "$env:USERPROFILE\.dsh\profiles\web" exec dsh-media-setup-preset

自定义 DSH_HOME 时：
pnpm --dir "$env:DSH_HOME\profiles\web" exec dsh-media-setup-preset

4）刷新
硬刷新或重启 dsh web（Ctrl/Cmd+Shift+R）。打标模型在 Web UI 会话顶栏的 Image & video scan 里选；细节见 SETUP-VISION.md。

怎么用
第一次（只需一次）
1. 安装后重启 dsh web，选择 Agent Preset 「素材检索」（面向挂载素材目录：视觉打标、语义检索、系统打开与资源管理器定位）。
2. 挂载一个含图片 / 视频的目录作为工作区。
3. 在会话顶栏的 Image & video scan 里选一个支持图片输入的模型（打标模型），点扫描：插件会建立索引并给素材打上标签与描述。

日常
1. 在「素材检索」模式的新对话里，直接让 Agent「找一张……的照片 / 某个素材」，它优先用 media_search 检索。
2. 检索结果会在 媒体检索卡片 里展示（最佳匹配 + 其他候选）。
3. 想打开 / 定位到本机文件，让 Agent media_open / media_reveal（系统打开 / 资源管理器定位）。
4. 新素材进来后，回到顶栏 Image & video scan 再扫一次（或明确要求 media_reindex 重建索引）即可。

说明：
- 「素材检索」Preset 之外，默认编码 Preset 不含这些媒体工具；媒体检索卡片是最终答案的可视化。
- 打标用独立视觉模型，Agent 不会对已打标素材重复读图（省 token）。
- 视觉打标是可选能力：不接视觉模型也能用「只传路径」的语义检索 / 打开定位。

卸载

dsh plugin --profile web remove dsh-media-app
rm -rf "${DSH_HOME:-$HOME/.dsh}/.agent-presets/media"

PowerShell：
dsh plugin --profile web remove dsh-media-app
Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\.agent-presets\media" -ErrorAction SilentlyContinue

作者
xiaoyaoPanPan · Issues · MIT

给开发者

- 包：dsh-media / -local / -ui / dsh-tool-media / dsh-media-app（对外只装 app）。
- git / 预构建 lib/：OPENSOURCE.md · AI 安装：INSTALL.md · AI 配视觉：SETUP-VISION.md。
- 本地：dsh plugin --profile web add "file:./dsh-media-app"，再跑 dsh-media-setup-preset。