前言¶
在 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 进行多模态开发或调试的用户,它提供了必要的文件读写能力。