前言¶
在 DSH（DeepSeek Harness）中处理文档预览时，经常需要把某个局部区域、截图或引用的文字直接放入 composer，而手动截屏再粘贴比较繁琐。dsh-preview-snip 插件把这一过程变成了一键操作：在预览区拖拽矩形，就能把裁剪后的 PNG 或选中的文本插入到对话草稿中。
是什么¶
dsh-preview-snip 是一个客户端插件，由 439436269-ctrl 维护。它为 DSH 的文档预览头部增加了三个操作：圈选、全能圈选（带标注）、引用选中。所有结果最终都作为附件或 Markdown 引用进入 composer，不自动发送。
核心功能¶
圈选 / Snip¶
在预览区拖拽一个矩形，就会把该区域截取为 PNG 并作为附件插入 composer。这个操作只生成图片，不会自动填充问题。
全能圈选 / Annotate¶
在圈选后打开标注编辑器，支持添加矩形框、椭圆/圆形、箭头和文本，可指定颜色，支持撤销、清空、取消和插入。插入的是标注后的 PNG，不是原始裁剪。
引用选中 / Quote selection¶
把当前选中的文本以 Markdown 引用块的形式放入 composer。
适用于多种预览类型¶
- 像素类：
<img>、当前帧的<video>、<canvas>，包括图片、PDF 页面、视频帧和 WebGL 视口（Blender/STL 等第一方查看器会保留绘图缓冲区）。 - DOM 截图：文本、Markdown、代码和 HTML 预览会被序列化为 SVG
foreignObject并在浏览器中栅格化，嵌入当前 pane 的样式，保持外观。 - 引用：任何文本可选择的预览。
侧边栏浏览器中的使用（桌面）¶
在 DSH 右侧浏览器标签页打开网页时，预览头部会出现一个浮动的「圈选 / 全能圈选」分组。该功能通过 Electron 的 webview.capturePage() 捕获整个页面，然后按选区裁剪并标注，最终进入 composer。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile <profile> add dsh-preview-snip
安装后，打开任意文件，在右侧预览头部会看到一个分段按钮组，包含「圈选」「全能圈选」「引用选中」。
典型用法¶
- 打开一个图片、PDF 或代码预览。
- 在预览区拖拽矩形，点击「圈选」快速插入裁剪图。
- 若需要标注，拖拽矩形后点击「全能圈选」，在编辑器中添加框、箭头或文本，选择颜色，确认插入。
- 选中预览中的文字，点击「引用选中」，将文本作为 Markdown 引用块加入 composer。
- 在 composer 中完成问题与补充说明后发送。
适用场景与注意¶
适合需要在 DSH 中快速提取预览局部、添加标注或引用文本的开发者与智能体用户。插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。兼容 DSH 0.2.0-rc.2 和 0.2.1-rc.2。
短结尾¶
dsh-preview-snip 通过统一的圈选与标注流程，把文档预览的局部内容转化为可复用的素材，减少手动截图与剪贴的步骤。插件目录：https://www.skillhub.cn/plugins/439436269-ctrl/dsh-preview-snip，GitHub：https://github.com/439436269-ctrl/dsh-preview-snip
