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 列表中。
