dsh-screenshot
Screenshot-to-input for DeepSeek Harness — 截图自动粘贴到 DSH 输入框
One-click screenshot straight into the Harness composer: a camera button next to the input box, a global hotkey (default Alt+A), and a listener that follows the DSH Desktop app lifecycle. Everything is configurable from the plugin settings page.
一键截图并自动粘贴到 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 专用，与桌面版存在三层绑定：
- 宿主生命周期 / Host lifecycle：
lib/index.js（node ESM 宿主插件）运行在 DSH Desktop 的主机进程内，随应用启动拉起监听器、应用关闭时停止。浏览器版 Web 端没有这个宿主进程，监听器无法自动启停。
- 看门狗 / Watchdog：监听器始终以
-ExitWhenDshGone 启动，监视 DSH Desktop 进程——检测不到该进程约 8 秒后自动退出。纯 Web 环境下监听器无法常驻。
- 前台判断 / 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 / 截图
Requirements / 使用环境
- Windows 10（1809+）/ Windows 11 — uses the built-in system Snipping Tool
(
ms-screenclip:) and Win32 APIs（hotkey registration, clipboard, foreground
switching）; PowerShell 5.1 ships with both OSes.
Windows 10（1809+）与 Windows 11 均支持：依赖系统自带截图工具
（ms-screenclip:）与 Win32 API（热键注册、剪贴板、前台切换），
PowerShell 5.1 两者均自带，无需额外安装。
- DeepSeek Harness Desktop（
desktop profile）— requires the client/host
plugin mechanism（详见上方「DSH Desktop 绑定」）。
DSH Desktop 应用（desktop profile）：需要客户端/宿主插件机制（绑定关系见上）。
- Not supported / 不支持：macOS / Linux（PowerShell + Win32 + 系统截图工具
均为 Windows 专属）；Windows 7/8（无
ms-screenclip:，且未自带 PowerShell 5.1）。
Install / 安装
From GitHub / 从 GitHub 安装（需机器上有 dsh CLI）：
dsh plugin --profile desktop add github:alain-prot0s5/dsh-screenshot
# or / 或
dsh plugin add https://github.com/alain-prot0s5/dsh-screenshot
From npm / 从 npm 安装（DSH Desktop 市场受管安装，走标准插件验证）：
dsh plugin add @alain-prot0s5/dsh-screenshot
Manual / 手动安装（Desktop app 无独立 CLI 时）：
# 1) copy the package into the profile's node_modules under its FULL package name
# (DSH Desktop >= 2.0.2 enforces package identity: the folder, the manifest
# `name`, the bundle entry and the client id must all be the scoped name)
New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@alain-prot0s5"
Copy-Item -Path '<this folder>' -Destination "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@alain-prot0s5\dsh-screenshot" -Recurse
# 2) add "@alain-prot0s5/dsh-screenshot" to dsh.profile.bundles in the profile
# package.json (UTF-8 WITHOUT BOM!)
# 3) restart DSH Desktop
DSH Desktop >= 2.0.2 compatibility / 兼容性说明：the loader requires the
profile bundle entry, the plugin manifest name, the cordis.patch.yml row
name and the client bundle id to all be the exact npm package name
@alain-prot0s5/dsh-screenshot (no bare short names). This package complies.
DSH Desktop 2.0.2+ 要求 profile 的 bundles 条目、插件 package.json 的 name、
cordis.patch.yml 行 name、客户端 bundle id 全部等于完整包名
@alain-prot0s5/dsh-screenshot（不能用短名）。本包已按此规范发布。
Restart and you should see the camera button next to the composer; the listener log is dsh-screenshot.log inside the plugin folder (look for 模式：热键=… 自动粘贴=… 后台跳转粘贴=…).
重启后输入框旁出现相机按钮；监听器日志在插件目录 dsh-screenshot.log（启动行含"模式：热键=… 自动粘贴=… 后台跳转粘贴=…"）。
Settings / 设置项（设置 → 插件 → 可配置插件 → dsh-screenshot）
| Setting / 设置 | Default / 默认 | Description / 说明 |
|---|
| Global hotkey / 全局快捷键 | Alt+A | Modifier + key (A–Z); listener restarts automatically / 修饰键 + 键（A–Z），修改后自动生效 |
| Auto-paste to input / 自动粘贴到输入框 | On / 开 | Off = snip only, image stays in clipboard / 关 = 只截图，图片留在剪贴板 |
| Switch to foreground & paste when DSH is in background / 后台跳转粘贴 | Off / 关 | On = always bring DSH to front and paste / 开 = 后台触发时也切到前台并粘贴 |
How it works / 原理
- Client / 客户端：camera button（keeps composer focus via
onMouseDown preventDefault）+ settings card（settingsScope）
- Host / 宿主：starts/stops the bundled
dsh-screenshot.ps1 -ExitWhenDshGone；registers the dsh-screenshot settings namespace，restarts the listener on change
- Listener / 监听器：
ms-screenclip: opens the system snip（no synthetic keystrokes）→ waits for the clipboard（non-blocking + single-flight + cancel detection）→ Ctrl+V；auto-exits ~8 s after the DSH process disappears（watchdog）
Files / 文件
lib/client.js — camera button + settings card（ModuleLoader format，no build step）lib/index.js — host：listener lifecycle + settings namespacedsh-screenshot.ps1 — bundled listener script（standalone copy kept in sync with dsh-screenshot-script/）cordis.patch.yml / package.json — bundle manifest（dsh.bundle.patch + dsh.client）
License
MIT
