前言¶
在 DeepSeek Harness（DSH）里写提示词、对照日志或把界面片段贴进对话时，经常需要「先截一块屏、再 Ctrl+V」。系统自带截屏或第三方工具能用，但热键、选区和剪贴板往往和 DSH 窗口各管一套。社区插件 dsh-screenshot-hotkey（维护者 Dove222，仓库 dove222/dsh-screenshot-hotkey）把「全局快捷键 → 选区 → 系统剪贴板」收进 DSH 的插件体系：默认 Alt+A 呼出选区，确认后自动复制，也可另存为 PNG/JPG。插件分类为客户端，当前 GitHub 显示 1 个 star；首次公开发布版本为 v1.0.0，仅支持 Windows。
下面按「是什么 → 能做什么 → 怎么装 → 怎么用 → 配置与注意」说明，事实以仓库 README 与 package.json 为准。
这是什么¶
dsh-screenshot-hotkey 是一个给 DSH 用的 纯宿主（Host）插件：没有浏览器端代码，不需要构建，也不靠联网安装依赖。宿主侧拉起 Windows 上的助手脚本，用 Win32 RegisterHotKey 注册全局热键——DSH 窗口不在前台时也能截图。
组合树里插件行 id 为 screenshot，侧边栏插件页显示名与包名一致。许可证为 MIT；运行环境要求 Node >= 20、dsh >= 0.2.0-rc.1，且 package.json 标明操作系统为 win32。
核心功能¶
README 中列出的能力如下，均可对照仓库文档核对：
| 能力 | 说明 |
|---|---|
| 全局快捷键 | 默认 Alt+A，可改为 Ctrl+Shift+S、Alt+Shift+A、F9 等 |
| 可自定义截图区域 | 配置固定尺寸、带初始大小的选区，或从零拖拽后再精修 |
| 自动写入系统剪贴板 | 确认后图片进剪贴板，可在聊天、文档等处 Ctrl+V |
| 可选另存 | 配置 saveDirectory 后每次截图可同时落盘 PNG；覆盖层也可点「另存为」选 PNG/JPG |
| 操作反馈 | 截图后选区可闪烁并提示「已复制到剪贴板」（可配置） |
| 取消 | 覆盖层内 Esc 或鼠标右键退出 |
插件只做一件事：把「截屏 → 剪贴板」变成 DSH 里的一个全局热键流程。
安装与启用¶
本插件是 DSH bundle 包，推荐用官方插件管理器从本地路径安装（路径换成你解压或克隆后的实际目录；README 示例为作者本机路径）：
dsh plugin --profile desktop add "E:\Users\cgy52\Documents\deepseek-harness\default-workspace\dsh-screenshot-hotkey"
安装后必须重启 DSH Desktop：manifest 与组合层在进程内缓存，新增 bundle 不重启不会生效。重启后在侧边栏插件页应能看到 dsh-screenshot-hotkey（行 id：screenshot）。启用后快捷键全局有效。
卸载可在插件页停用或卸载，然后重启；也可用：
dsh plugin --profile desktop remove dsh-screenshot-hotkey
停用后助手进程结束，全局热键会立即释放。
典型用法¶
选区截图（默认流程）¶
- 插件启用后，按 Alt+A。
- 屏幕变暗，进入选区覆盖层。
- 拖拽框选范围；松手后可拖动选区、拖边缘缩放，或用方向键微调（见 README 快捷键表）。
- 选区下方出现 确定 / 取消 / 另存为：
- 确定：写入剪贴板，绿框提示后关闭覆盖层。
- 取消：不截图，等同 Esc / 右键。
- 另存为：打开保存窗口，可预览、改格式（PNG/JPG）、改路径；保存时默认也会写入剪贴板（除非配置copyToClipboard: false）。 - 在目标应用里 Ctrl+V 粘贴。
拖拽过程中按钮条会隐藏，松手后再显示，避免拖动时重排导致卡顿。
三种截图尺寸方式¶
固定大小（mode: fixed）：配置宽高后，按热键不弹选区，以鼠标为中心直接截取该尺寸。
带初始选区（mode: region + width/height）：按热键即出现指定大小的选区，可再拖动或精修。
拖拽精修：width/height 为 0 时从零框选；松手后左上角显示实时宽高，可用 Shift+方向键调到精确像素再 Enter。
示例配置片段（写入用户 patch，见下一节）：
- id: screenshot
name: dsh-screenshot-hotkey
config:
mode: region
width: 1200
height: 800
配置项¶
配置写在 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml，按行 id screenshot 整段覆盖（改一个字段时把这一段需要的字段都写上）。不写则用默认值：
- id: screenshot
name: dsh-screenshot-hotkey
config:
enabled: true
hotkey: Alt+A
mode: region
width: 0
height: 0
copyToClipboard: true
saveDirectory: ''
language: zh
flash: true
confirmOnRelease: false
保存后 patch 会被 boot 事务重读；未生效时可重启 DSH。仅改 assets/screenshot.ps1 时，README 说明助手约每 2 秒自检脚本，语法正确会自动退出并由宿主拉起新版本，一般无需重启 DSH；改 cordis.patch.yml 或 package.json 仍需重启。
适用场景与注意¶
适合谁：在 Windows 上长期使用 DSH Desktop，希望截屏与贴图流程不离开 DSH 插件生态、且需要后台也能触发热键的用户。
平台与权限：插件仅在 Windows 上声明支持；助手为 PowerShell 5.1 + WinForms/WPF，涉及全屏覆盖层、剪贴板与全局热键。插件以当前 DSH 进程权限运行，安装前请自行查看源码与 MIT 许可证，确认符合你的安全策略。DSH 社区插件目录（如 SkillHub 上的条目）是独立生态站点，与 DeepSeek / 幻方无官方从属关系。
常见故障（摘自 README）：热键无反应时查日志是否有 [screenshot] 已就绪 或 hotkey-register-failed（热键被占用则改 hotkey）；部分游戏/播放器独占全屏可能导致黑屏；剪贴板被占用时插件会重试。更多现象与处理见仓库「故障排查」一节。
结尾¶
dsh-screenshot-hotkey 把 Windows 上的全局截屏热键、可配置选区与剪贴板写入接到 DSH bundle 里，适合需要「Alt+A → 框选 → 粘贴」固定动线的开发者。目录页：https://www.skillhub.cn/plugins/Dove222/dsh-screenshot-hotkey；源码与完整说明：https://github.com/Dove222/dsh-screenshot-hotkey。
