截图直贴 Alain-Prot0s5/dsh-screenshot

dsh-screenshot

Screenshot-to-input for DeepSeek Harness — 截图自动粘贴到 DSH 输入框

一键截图并直接送入 Harness 输入框：输入框旁的相机按钮、全局快捷键（默认 Alt+A）、以及跟随 DSH Desktop 应用生命周期的监听器。一切均可从插件设置页配置。

一键截图并自动粘贴到 DeepSeek Harness 输入框：输入框旁的相机按钮、全局快捷键（默认 Alt+A）、监听器随 DSH Desktop 生命周期启停。快捷键、自动粘贴、后台跳转均可从设置页配置。

⚠️ 项目性质 / Project nature：这是一个纯 AI 生成的、面向新手的项目（AI-generated, beginner-level code），未经专业安全审计，生产环境使用前请自行审阅代码。欢迎提 Issue / PR 改进。

🖥️ 平台 / Platform：仅支持 Windows 10（1809+）与 Windows 11——依赖系统自带截图工具（ms-screenclip:）与 Win32 API。macOS / Linux / Windows 7/8 不支持。

🧭 建议搭配 / Recommended companion：dsh-vision-router —— 截图自动粘进输入框后，由 vision-router 负责图片的视觉路由，实现「截图 → 提问 → 图片理解」的完整流程。

适用范围与 DSH Desktop 绑定（重要） / Scope & DSH Desktop binding (important)

本插件是 DSH Desktop 专用，与桌面版存在三层绑定：

1. 宿主生命周期 / Host lifecycle：lib/index.js（node ESM 宿主插件）运行在 DSH Desktop 的主机进程内，随应用启动拉起监听器、应用关闭时停止。浏览器版 Web 端没有这个宿主进程，监听器无法自动启停。
2. 看门狗 / Watchdog：监听器始终以 -ExitWhenDshGone 启动，监视 DSH Desktop 进程——检测不到该进程约 8 秒后自动退出。纯 Web 环境下监听器无法常驻。
3. 前台判断 / Foreground detection：热键「是否自动粘贴」取决于 DSH Desktop 窗口是否在前台（Get-Process 'DSH Desktop' + GetForegroundWindow）。Web 端没有该窗口，行为等同「DSH 不在前台」——只截图、不自动粘贴。

Web 端（浏览器版）能用吗？ / What about the Web version?

- 部分可用、未实测、体验不完整。
- 相机按钮（conversation.input.right 槽位）与设置卡片属于客户端 UI，理论上能注入 Web 版输入框，点击走本机 http://127.0.0.1:17890/trigger 触发服务；
- 但触发服务需要监听器在跑——Web 版可改用独立版监听器（dsh-screenshot-script/，默认常驻、可开机自启、不带生命周期绑定）来提供；
- 受上述第 3 条限制，Web 版下自动粘贴判断不生效，截图只会留在剪贴板。

结论 / Conclusion：以 DSH Desktop 使用为主；Web 端场景建议用独立版监听器，并接受行为受限。

Features / 功能

- 🖼️ Camera button in the composer tool row — click, snip, auto-paste 输入框右侧相机按钮：点击 → 系统截图 → 拉框完成自动粘贴
- ⌨️ Global hotkey (default Alt+A, modifier/key configurable)
全局快捷键（默认 Alt+A，修饰键与按键可配置）
- 🔄 Listener bound to the app lifecycle — starts with DSH Desktop, stops when it closes (no OS autostart needed) 监听器随 DSH Desktop 生命周期启停（无需开机自启）
- ⚙️ Settings page — hotkey / auto-paste toggle / background-switch toggle, applied live 设置页：快捷键 / 是否自动粘贴 / 后台是否跳转粘贴，即时生效
- 🧹 Resilient — non-blocking clipboard wait, single-flight debounce, cancel detection, stale SnippingTool cleanup, watchdog fallback 可靠性：非阻塞等待、单飞防抖、取消检测、SnippingTool 卡死自愈、看门狗兜底

Screenshots / 截图

| Screenshots / 截图 | Description / 说明 |
| Screenshot 1 - composer | DSH Desktop composer with the camera button in the tool row / 输入框工具行里的相机按钮 |
| Screenshot 2 - snipping toolbar | System snipping tool (camera highlighted) / 系统截图工具（相机高亮） |
| Screenshot 3 - copied to clipboard | Screenshot copied to clipboard & saved automatically / 截图已复制到剪贴板并自动保存 |
| 截图 4 - 插件设置 | dsh-screenshot 插件设置卡片 / 插件设置卡片 |

使用环境 / 使用环境

- Windows 10（1809+）/ Windows 11 — 使用系统自带截图工具（ms-screenclip:）与 Win32 API（热键注册、剪贴板、前台切换）；PowerShell 5.1 两者均自带。
Windows 10（1809+）与 Windows 11 均支持：依赖系统自带截图工具（ms-screenclip:）与 Win32 API（热键注册、剪贴板、前台切换）， PowerShell 5.1 两者均自带，无需额外安装。
- DeepSeek Harness Desktop（desktop profile）— 需要客户端/宿主插件机制（详见上方「DSH Desktop 绑定」）。
DSH Desktop 应用（desktop profile）：需要客户端/宿主插件机制（绑定关系见上）。
- 不支持 / 不支持：macOS / Linux（PowerShell + Win32 + 系统截图工具均为 Windows 专属）；Windows 7/8（无 ms-screenclip:，且未自带 PowerShell 5.1）。

安装 / 安装

从 GitHub 安装 / 从 GitHub 安装（需机器上有 dsh CLI）：

dsh plugin --profile desktop add github:alain-prot0s5/dsh-screenshot
或 / 或
dsh plugin add https://github.com/alain-prot0s5/dsh-screenshot

从 npm 安装 / 从 npm 安装（DSH Desktop 市场受管安装，走标准插件验证）：

dsh plugin add @alain-prot0s5/dsh-screenshot

手动安装 / 手动安装（Desktop app 无独立 CLI 时）：

1) 将包复制到 profile 的 node_modules 下，使用其完整包名（DSH Desktop >= 2.0.2 强制包身份：文件夹、清单 name、bundle 入口和客户端 id 必须全部为带作用域的名称） New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@alain-prot0s5" Copy-Item -Path '' -Destination "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@alain-prot0s5\dsh-screenshot" -Recurse
2) 将 "@alain-prot0s5/dsh-screenshot" 添加到 profile 的 package.json 中的 dsh.profile.bundles（UTF-8 无 BOM！）
3) 重启 DSH Desktop

DSH Desktop >= 2.0.2 兼容性说明 / 兼容性说明：加载器要求 profile bundle 条目、插件清单 name、cordis.patch.yml 行 name 以及客户端 bundle id 全部为确切的 npm 包名 @alain-prot0s5/dsh-screenshot（不能用裸短名）。本包符合此要求。
DSH Desktop 2.0.2+ 要求 profile 的 bundles 条目、插件 package.json 的 name、 cordis.patch.yml 行 name、客户端 bundle id 全部等于完整包名 @alain-prot0s5/dsh-screenshot（不能用短名）。本包已按此规范发布。

重启后输入框旁出现相机按钮；监听器日志在插件目录 dsh-screenshot.log（启动行含"模式：热键=… 自动粘贴=… 后台跳转粘贴=…"）。

设置项 / 设置项（设置 → 插件 → 可配置插件 → dsh-screenshot）

| 设置 / 设置 | 默认 / 默认 | 说明 / 说明 |
| 全局快捷键 / 全局快捷键 | Alt+A | 修饰键 + 键（A–Z）；修改后自动生效 / 修饰键 + 键（A–Z），修改后自动生效 |
| 自动粘贴到输入框 / 自动粘贴到输入框 | 开 / 开 | 关 = 只截图，图片留在剪贴板 / 关 = 只截图，图片留在剪贴板 |
| 当 DSH 在后台时切换到前台并粘贴 | 关 | 开 = 始终将 DSH 带到前台并粘贴 |

原理

- 客户端：相机按钮（通过 onMouseDown preventDefault 保持编辑器焦点）+ 设置卡片（settingsScope）
- 宿主：启动/停止捆绑的 dsh-screenshot.ps1 -ExitWhenDshGone；注册 dsh-screenshot 设置命名空间，在变更时重启监听器
- 监听器：ms-screenclip: 打开系统截图（无合成按键）→ 等待剪贴板（非阻塞 + 单次执行 + 取消检测）→ Ctrl+V；在 DSH 进程消失后约 8 秒自动退出（看门狗）

文件

- lib/client.js — 相机按钮 + 设置卡片（ModuleLoader 格式，无需构建步骤）
- lib/index.js — 宿主：监听器生命周期 + 设置命名空间
- dsh-screenshot.ps1 — 捆绑的监听器脚本（独立副本与 dsh-screenshot-script/ 保持同步）
- cordis.patch.yml / package.json — 捆绑清单（dsh.bundle.patch + dsh.client）

许可证

MIT