前言¶
在 DSH 里做图片理解或补充说明时，常见路径是先打开系统截图工具，框选内容，再切换回 DSH 输入框手动粘贴。dsh-screenshot 把这个过程接到 DSH composer：输入框旁提供相机按钮，也提供全局快捷键，并把监听器的启停绑定到 DSH Desktop 生命周期。下面介绍它的能力、安装方式和注意事项。
这是什么¶
dsh-screenshot 是 DSH 客户端插件，由 Alain-Prot0s5 维护，采用 MIT 许可。它面向 Windows 10 (1809+) 和 Windows 11，主要解决“截图后快速进入 DSH 输入框”的问题：系统截图完成后，插件把图片自动粘贴到 composer，减少手动复制与窗口切换。
这个插件是 DSH Desktop 专用。宿主生命周期、DSH Desktop 进程看门狗、前台检测都依赖 DSH Desktop，因此 Web 端只能作为受限场景使用。
核心功能¶
下面列出已核实的能力。
- 相机按钮：位于 composer tool row，点击后触发系统截图，框选完成后可自动粘贴。
- 全局快捷键：默认
Alt+A，修饰键和按键可配置。 - 监听器生命周期：监听器随
DSH Desktop启动而启动，随DSH Desktop关闭而停止。 - 设置页：可配置全局快捷键、是否自动粘贴、后台是否跳转粘贴，修改后即时生效。
- 可靠性处理：非阻塞等待剪贴板、单飞防抖、取消检测、旧
SnippingTool清理、看门狗兜底。
安装与启用¶
先确认环境：系统为 Windows 10 (1809+) 或 Windows 11，并且使用 DSH Desktop 的 desktop profile。该插件依赖系统 Snipping Tool（ms-screenclip:）和 Win32 APIs，PowerShell 5.1 预期已存在。
从 GitHub 安装：
dsh plugin --profile desktop add github:alain-prot0s5/dsh-screenshot
从 npm 安装：
dsh plugin add @alain-prot0s5/dsh-screenshot
在 DSH Desktop >= 2.0.2 的兼容性说明中，需要使用完整 scoped package name @alain-prot0s5/dsh-screenshot。
经过上面的步骤后，重启 DSH Desktop。启动后可在输入框旁看到相机按钮，也可以直接按全局快捷键开始截图。
典型用法¶
- 在
DSH Desktop中打开需要输入截图的会话。 - 点击 composer 旁的相机按钮，或按下默认快捷键
Alt+A。 - 使用系统截图工具框选区域。
- 截图完成后，插件按设置执行自动粘贴；如果关闭自动粘贴，图片会留在剪贴板。
- 如果
DSH Desktop在后台，且设置页开启了后台跳转粘贴，插件会切到前台并粘贴。
Web 端如果需要使用触发服务，可使用独立版监听器 dsh-screenshot-script/。受前台判断限制，Web 端的自动粘贴检测会受限，截图通常会留在剪贴板。
也可以按需搭配 dsh-vision-router，形成 screenshot -> question -> image understanding 的流程。
适用场景与注意¶
适合在 DSH Desktop 中频繁处理截图、需要快速把图片送入输入框的 Windows 用户。尤其是截图说明、图片理解、视觉调试等场景。
使用前需要注意：
- 只支持
Windows 10 (1809+)和Windows 11；不支持macOS、Linux、Windows 7/8。 - 插件是
DSH Desktop专用，Web 端能力受限，建议以桌面端为主。 - 项目说明其为 AI-generated、beginner-level code，且未做专业安全审计。由于插件运行在 DSH 的宿主/客户端环境中，并以当前
dsh进程权限执行，生产环境使用前应审阅源码、检查依赖和许可证。 - 许可证为
MIT。
结尾¶
dsh-screenshot 的价值在于把 Windows 截图和 DSH 输入框之间的复制、切换、粘贴步骤合并成一次触发，适合日常在 DSH Desktop 中用截图补充上下文。社区目录页可按插件名 dsh-screenshot 查找；该目录是独立站点，不等同于 DeepSeek 或幻方的官方应用商店。GitHub 仓库见：
https://github.com/Alain-Prot0s5/dsh-screenshot
