前言¶
在 DeepSeek Harness（DSH）里和模型对话时，经常要把界面上的报错、配置片段或设计稿发给会话。常见做法是切到系统截图工具，截完再回到浏览器粘贴或拖拽。步骤多，也容易打断输入节奏。
dsh-screenshot-button 是社区维护的 DSH 客户端插件（维护者 SiriusWJ，分类：客户端）。它在 composer 工具行（输入面板下方）增加一个相机按钮：点击后由 DSH 宿主进程调起操作系统自带的截图工具，截图进入系统剪贴板后，在输入框用 Ctrl+V（macOS 为 ⌘V）粘贴为图片附件。插件本身不截屏、不读屏、不上传画面，截图过程由系统工具完成。
下面介绍插件能做什么、如何安装，以及使用时的边界与注意点。
这是什么¶
dsh-screenshot-button（npm 包名 dsh-screenshot-button，当前资料中版本为 0.1.0）通过 DSH 的 bundle 与客户端注入，在 conversation 输入区左侧工具行 注册相机图标按钮（位于 + 与「完全权限」等控件一侧）。
宿主侧提供 HTTP 路由，在通过本机回环 Host 校验后，以 detached 子进程方式启动各平台默认截图入口；浏览器端只负责展示按钮与发起请求。许可证为 MIT。
核心功能¶
| 能力 | 说明 |
|---|---|
| 一键唤起系统截图 | Windows 使用 ms-screenclip:；macOS 使用 /usr/sbin/screencapture -i -c；Linux 依次尝试 gnome-screenshot、spectacle、scrot，并结合 wl-copy/xclip |
| 主题与文案 | 按钮样式使用 DSH 主题 token（--dsw-alias-*），亮暗色跟随；中英文案随页面 html lang 切换 |
| 防连点 | 800ms 节流，避免连续打开多个截图窗口 |
| 安全边界 | 仅接受本机回环 Host 的 POST，拒绝跨站请求；手机或局域网访问页面时无法在本机弹窗截图 |
README 中平台状态：Windows 10/11 已实测；macOS、Linux 按 API 实现，维护者标注为未实机验证。不支持的平台返回 unsupported-platform，按钮提示当前系统没有可用的截图工具。
安装与启用¶
安装后需重启 DSH（客户端 bundle 在启动时扫描），输入框工具行会出现相机按钮。
从 GitHub 安装（推荐）¶
将 <你的 profile> 换成实际 profile，例如桌面版使用 desktop：
dsh plugin --profile <你的 profile> add github:SiriusWJ/dsh-screenshot-button
示例：
dsh plugin --profile desktop add github:SiriusWJ/dsh-screenshot-button
本地目录开发¶
若已在本地拥有插件目录，可将路径指向仓库根目录安装（资料中的方式，非本文推荐的常规安装路径）：
dsh plugin --profile desktop add ./dsh-screenshot-button
也可在 DSH 插件管理器中通过 plugin_manager → install_bundle，target 指向仓库根目录。
插件以当前 DSH 进程权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
典型用法¶
- 打开任意会话，光标放在输入框。
- 点击输入框左下角（工具行）的相机按钮。
- 系统截图工具弹出，完成框选或标注；结果由系统写入剪贴板。
- 回到输入框按 Ctrl+V（macOS ⌘V），截图变为图片附件，可继续输入文字后发送。
界面成功调起后，客户端会 toast 提示「已打开截图工具，Ctrl+V 粘贴」。粘贴行为依赖 DSH 官方输入框的图片粘贴能力，与拖拽发图一致。
排查时，宿主提供 GET /dsh-screenshot/health，可查看当前平台与可用截图入口；调起截图使用 POST /dsh-screenshot/capture。
适用场景与注意¶
适合谁： 本机运行 DSH、需要频繁把屏幕内容以图片形式附在对话里的开发者或日常用户；希望少切窗口、仍使用系统自带截图与标注能力的人。
需要知道的限制：
- 当前版本不会自动把剪贴板图片插入输入框，以避免额外权限与隐私问题；截完后需手动粘贴。
- 通过非本机回环地址访问 DSH 页面时，按钮可能仍可见，但请求会被拒绝，提示截图按钮只在本机 DSH 页面可用。
- macOS、Linux 在 README 中未标注实机验证，若在对应环境异常，可在仓库 issues 反馈。
工作原理（简述）： 浏览器点击按钮 → POST 本机路由 → 宿主校验 Host 与同源 → spawn 系统截图工具；约 300ms 内无 error 即视为调起成功。插件不持有画面数据。
结尾¶
dsh-screenshot-button 把「打开系统截图」收成输入面板旁一次点击，截图与剪贴板仍完全由操作系统处理，适合在本机 DSH 里快速附图对话。
