前言¶
DeepSeek Harness 的聊天输入框右侧有一个 + 菜单，用于快速添加附件、表情等。在 Mac 上，通过命令直接截取屏幕并作为图片附件发出去，可以减少打开截图工具和复制粘贴的步骤。dsh-screenshot-chat 就是为此提供的一套插件，把原生 macOS 的区域选择与隐藏前台窗口的能力接入了 DSH 的编辑器。
是什么¶
dsh-screenshot-chat 是一个 DeepSeek Harness 插件，维护者为 xiaoy616。它为聊天输入框的 + 菜单增加一个「Screenshot」入口，点击后通过 macOS 的 screencapture -i 进行区域选择，选中的区域会以图片附件的形式出现在输入框中，随后可像粘贴图片一样发送。插件还提供了「隐藏当前窗口后再截图」的模式，适合在 DSH 窗口本身出现在截图区域时使用。
核心功能¶
- 一键区域捕获：点击
+→ Screenshot 后，调用 macOS 原生选择遮罩（与⇧⌘4相同）。拖动选择区域后，图片以附件形式出现在输入框中。按 Esc 或右键可取消，操作是静默的。 - 隐藏窗口捕获：悬停在「Screenshot」菜单行上，右侧会出现
○ Hide window开关。打开后，点击截图会先隐藏当前前台窗口，再显示选择遮罩；完成或取消后恢复窗口。开关状态保存在 localStorage，页面刷新后保持。 - 平台感知：在非 macOS 平台上，菜单项会自动隐藏。
- 配置：可在 profile patch 中覆盖
timeoutMs（默认 180 秒），控制选择遮罩保持的最长时间。
安装与启用¶
安装命令来自 README：
dsh plugin add dsh-screenshot-chat
安装后重启 DeepSeek Harness（或重新加载网页客户端），插件才会生效。
典型用法¶
-
普通区域截图：
1. 在聊天输入框中点击+→ Screenshot。
2. 在屏幕上拖动选择一个区域。
3. 选区会出现在输入框作为图片附件，发送即可。 -
隐藏窗口截图：
1. 悬停在「Screenshot」菜单行上，打开○ Hide window开关。
2. 点击 Screenshot。
3. 当前前台窗口会先隐藏，然后出现选择遮罩。
4. 完成选择或取消后，窗口会恢复并置顶。
适用场景与注意¶
- 适合需要在对话中直接附上屏幕截图的用户，尤其是 Mac 本地部署的场景。
- 截图执行在 Mac 主机上，而非浏览器所在机器（本地部署时为同一台机器）。
- 需要屏幕录制与自动化权限：
- 屏幕录制：首次截图可能弹出授权提示，或需要在「系统设置 → 隐私与安全性 → 屏幕录制」中授权运行 DSH 的应用。
- 自动化（隐藏窗口模式）：隐藏/恢复窗口依赖 System Events，首次使用时会询问是否允许控制 System Events，可在「系统设置 → 隐私与安全性 → 自动化」中配置。
- 插件依赖 macOS 原生命令，因此仅在 macOS 上可用；其他平台会自动隐藏菜单项。
- 使用前建议阅读源码与许可证（MIT），确认权限请求与行为符合预期后再安装。
短结尾¶
dsh-screenshot-chat 把 macOS 原生截图能力接入到 DSH 聊天输入框，让截图以附件形式直接发送，减少中间步骤。更多详情与源码见目录页与 GitHub 仓库。
