DSH 的理念是「一切皆插件」。当智能体需要在 WSL 环境下处理本地文件时，通常需要手动调用 ffmpeg、whisper、tesseract 等独立工具。dsh-wsl-media 将这些工具整合为统一的 DSH 插件，提供从媒体探测、音视频处理到 PDF 文本提取、OCR 识别的一站式管线。
插件定位¶
这是一个由用户 173787247 维护的本地媒体/文档处理插件，版本为 0.2.1，采用 MIT 协议开源。
它解决的核心问题是：在 DSH 环境中，让智能体能够直接操作本地文件系统中的多媒体资源，无需在宿主机与 WSL 之间频繁切换工具链。
核心功能¶
该插件集成了以下工具，通过 CLI 命令调用：
- CLI 探测：使用
media_status获取基础状态。 - 媒体探测：通过
media_probe使用ffprobe分析文件信息。 - 抽音轨：使用
media_extract_audio提取音轨。 - 缩略图：使用
media_thumbnail生成媒体文件缩略图。 - PDF 文本：使用
media_pdf_text提取 PDF 文档中的文本内容。 - ASR 识别：使用
media_asr调用whisper进行语音转文字。 - 格式转换：使用
media_pandoc进行文档格式转换。 - OCR 识别：使用
media_ocr调用tesseract进行图像文字识别。 - 元数据提取：使用
media_exif调用exiftool读取图片/文件的元数据。
安装与启用¶
使用官方命令安装该插件。安装后，命令会出现在当前 DSH 配置的插件路径中。
dsh plugin --profile web add github:173787247/dsh-wsl-media
若需要批量链接插件，可以运行 dsh-wsl-kit 套件提供的脚本：
bash dsh-wsl-kit/scripts/link-linux-plugins.sh
配置与注意事项¶
路径限制¶
该插件以当前 DSH 进程的权限运行。因此，目标文件路径必须在 allowRoots 配置允许的范围内。默认允许的路径包括：
- 用户家目录
~/.dsh~/.dsh/im-workspace/tmp/mnt/c或/mnt/d（Windows 挂载盘）
依赖与兼容性¶
- 最低版本：要求 DSH 版本 >= 0.1.2。
- 可选套件：
dsh-wsl-kit是可选的。默认情况下，install.sh不会包含该套件。若需使用其批量链接功能，需手动安装。 - 最新验证：以
dsh-wsl-kit的兼容性文档为准。
总结¶
dsh-wsl-media 将繁杂的命令行工具封装为标准化的 DSH 接口，适合需要在 WSL 中进行视频剪辑辅助、文档数字化处理或语音数据处理的场景。使用前请务必检查文件路径是否在 allowRoots 列表中。
