前言¶
在 DeepSeek Harness (DSH) 環境中進行智能體開發時,多模態交互是一個常見需求。當運行環境爲 WSL 時,從 Windows 端獲取圖像(如剪貼板截圖)並傳遞給智能體進行解析,往往需要額外的文件轉換步驟。dsh-wsl-shot 插件直接解決了這一痛點,它通過工具調用,將 Windows 剪貼板中的圖像保存爲 WSL 文件,使智能體能夠方便地讀取和處理這些圖像。
插件定位¶
dsh-wsl-shot 是一個 DeepSeek Harness 插件,由用戶 173787247 維護。它是 dsh-wsl-kit 套件的一部分,核心作用是將 Windows 剪貼板圖像保存爲 WSL 文件,從而支持智能體在多模態對話中附加圖像。
核心功能¶
該插件提供了以下具體能力:
1. 剪貼板轉文件:直接讀取 Windows 剪貼板中的圖像,將其保存爲 WSL 可識別的文件格式。
2. 智能體集成:啓用智能體通過工具調用 win_shot 來附加圖像。
3. 工具名稱:對外暴露的工具名稱爲 win_shot。
安裝與啓用¶
安裝插件需要使用 DSH 的插件管理命令。請確保你的 DSH 版本大於等於 0.1.2。
dsh plugin --profile web add github:173787247/dsh-wsl-shot
安裝完成後,必須重啓 dsh web 服務,並打開一個新的會話,插件功能纔會生效。
依賴與配置¶
- DSH 版本:插件要求 DSH 版本 >= 0.1.2。
- 所屬套件:它是
dsh-wsl-kit套件的一部分。安裝時可以選擇KIT_SET=daily、llm、github或full,也可以單獨安裝該插件。 - 模型配置:插件本身不會配置 Cloud Flash 模型 ID。若需使用多模態功能,需在
~/.dsh/settings.yaml或llm-deepseek配置中手動設置模型 ID 爲deepseek-flash。 - Agent Teams:這是上游實驗性功能,此處非必需。
典型用法¶
安裝並重啓服務後,在智能體的對話流程中,當需要處理圖像時,智能體會調用 win_shot 工具。該工具會將當前 Windows 剪貼板中的圖像保存到 WSL 文件系統中,智能體隨後可以讀取該文件進行視覺分析或內容提取。
注意事項¶
該插件運行在 DSH 進程的權限上下文中,請確保在安裝前檢查源碼與許可證。它僅提供文件保存功能,不包含模型推理或 Agent Teams 的配置。
總結¶
dsh-wsl-shot 是連接 Windows 剪貼板與 WSL 文件系統的工具。對於需要在 Windows 上利用 DSH 進行多模態開發或調試的用戶,它提供了必要的文件讀寫能力。