前言¶
在 DeepSeek Harness (DSH) 的使用过程中，通过截图分享上下文是高频需求。原生方案通常依赖浏览器的屏幕共享 API (getDisplayMedia)，流程繁琐，且往往受限于系统级选择器（如只能选一个屏幕）。dsh-capture 插件通过提供原生应用般的浮层体验，实现了框选、标注并直接投递图片到输入框的能力，将截图操作集成到 DSH 的工作流中。
插件定位¶
名称: max-null/dsh-capture
作者: Max-Null
许可: MIT
类型: 客户端插件
该插件属于 @max-null/* 插件系列的一部分，旨在为思灵桌面体验（SSID）提供高效的截图辅助能力。它支持双引擎运行，能根据环境自动切换底层捕获逻辑。
安装¶
通过 npm 安装插件：
npm install @max-null/dsh-capture
安装后，插件会根据环境自动探测是否运行在思灵壳（SSID）内，并选择对应的引擎逻辑。
核心功能¶
- 框选与捕获: 在屏幕上框选任意区域，支持多显示器环境下的像素级 1:1 抓取。
- 标注工具: 提供矩形、椭圆、箭头和文字标注，支持 8 种颜色选择（默认红色）。
- 智能投递: 截图完成后，图片自动进入当前会话的输入框附件草稿区，支持追加文字后发送。
- 原图预览编辑: 点击任意图片（截图或历史消息）的缩略图，可进入编辑模式进行整图标注，编辑后自动投递。
- 操作回退: 支持右键或
Esc键逐级回退（撤销标注 → 重选 → 退出）。
使用方法¶
思灵壳 (SSID) 内¶
- 打开任意 DSH 会话（无会话时截图会被静默丢弃）。
- 触发方式：
- 点击托盘菜单中的「截图引用」。
- 使用全局快捷键（默认
Ctrl+Shift+A，可在设置中修改）。
- 操作流程：
- 屏幕出现冻结帧 + 十字准星。
- 左键拖拽 框选区域 → 选区定格后出现工具条。
- 在工具条中选择颜色和工具（箭头拖拽绘制，文字点一下输入）。
- 按
回车、双击或点击「完成」确认发送。 - 右键 / Esc 逐级回退操作。
- 隐藏窗口设置: 默认开启「截图时隐藏思灵窗口」，此时冻结帧中不包含 DSH 自身窗口。关闭该选项后，冻结帧将包含思灵窗口，可框选对话内容。
纯 DSH (浏览器环境)¶
- 打开任意 DSH 会话。
- 点击输入框左侧的相机按钮（位于润色按钮旁）。
- 浏览器弹出「选择要共享的屏幕」对话框，选择一个屏幕。
- 捕获一帧后自动停止共享，进入全屏遮罩的框选与标注模式，后续操作同上。
原图预览编辑¶
- 点击任意图片（草稿或历史消息）的缩略图，打开官方「原图预览」对话框。
- 点击右上角的 ✎ 编辑按钮。
- 对整图进行标注（工具与截图一致），完成后点击「完成」。
- 系统会自动投递编辑后的图片到输入框，预览窗口关闭。
配置项¶
在 DSH 的「插件」页面对应 dsh-capture 卡片中：
* 截图时隐藏思灵窗口: 控制思灵壳模式下，冻结帧是否包含 DSH 自身窗口。
* 截图全局快捷键: 支持 Electron accelerator 语法（如 Control+Alt+B），修改后立即生效。
注意事项¶
- 双图投递: 当画面存在标注时，插件会同时投递「原图」和「编辑图」两张图片，原图保持原始内容，编辑图承载标注内容。
- 纯 DSH 限制: 纯浏览器模式下，只能选择一个屏幕；无法隐藏宿主窗口；无法使用全局快捷键。
- 原图预览编辑: 在预览编辑模式下，投递的是编辑图（原图已在对话历史中）。
- 无会话丢弃: 若未打开任何会话直接截图，截图操作会被静默丢弃，浮层会提示「先打开一个会话」。
