前言¶
在 DeepSeek Harness (DSH) 的开发流程中，通过截图说明逻辑或标注代码片段是常见需求。dsh-shot 插件将截图能力直接集成到 Composer 编辑器中，允许用户在窗口内的覆盖层上进行框选、标注，并支持在捕获时隐藏 DSH 窗口。
它是什么¶
dsh-shot 是一个由 19north 维护的客户端插件。它通过在 Composer 编辑器中添加相机按钮，为用户提供一个窗口内的截图与标注工作流。捕获结果会以图片附件的形式放入当前对话的草稿中。
核心功能¶
- 框选与调整：在打开的覆盖层中拖拽矩形选区，支持通过边缘手柄调整大小或拖拽内部移动位置。
- 标注工具：支持矩形框、箭头、文本三种标注方式，并提供 8 色调色板。
- 隐藏窗口捕获：提供“Hide this window”选项，在捕获前隐藏 DSH 窗口，捕获后恢复原状。
- 交互微调：支持使用方向键微调选区（Shift 键精确移动 10 像素），并支持撤销操作。
安装与启用¶
安装该插件需要指定 DSH 的 Profile。
dsh plugin --profile <profile> add dsh-shot
安装后，插件会自动追加到 dsh.profile.bundles，需重启 DSH 应用使插件生效。
使用方法¶
- 启动捕获：点击编辑器中
＋旁边的相机按钮，从菜单中选择“Direct capture”（直接捕获）或“Hide this window”（隐藏窗口捕获）。 - 选择区域：在窗口内的覆盖层上拖拽鼠标框选需要捕获的区域。
- 调整选区：
- 拖拽选区边缘的八个手柄（角落和边中点）调整大小。
- 拖拽选区内部移动位置。
- 使用方向键微调选区，按住 Shift 精确移动 10 像素。
- 右键或再次点击选区以重置选区。
- 添加标注：使用矩形、箭头或文本工具进行标注。文本工具点击位置输入，Enter 确认，Esc 取消。
- 确认：确认（或按 Enter）后，截图将作为图片附件放入草稿。
注意事项¶
- 平台限制：仅支持 Windows 平台。
- 覆盖层机制：覆盖层位于 DSH 窗口内而非全屏，捕获画面会缩放适配窗口，可能产生黑边。
- 窗口隐藏：在“Hide this window”模式下，DSH 窗口会短暂消失（约 0.3-1.2 秒）。
- 空帧问题：捕获脚本偶尔可能返回空帧，需要手动重试。
- 版本要求：需要 DeepSeek Harness 0.1.7 或更高版本。
总结¶
dsh-shot 为 DSH 用户提供了一个轻量级的截图与标注方案，无需切换到外部截图工具。对于需要频繁在对话中插入截图说明的开发者，该插件能有效提升沟通效率。更多细节与源码可查阅其 GitHub 仓库。
