前言¶
在用 DeepSeek Harness（DSH）写智能体或调试时，经常需要把桌面窗口、错误弹窗、应用界面截下来贴进对话。如果用系统截图工具再手动粘贴，流程冗长；如果依赖浏览器截图，往往只能截到当前页面，且页面里会残留一张预览图。
dsh-snip 是一款为 DSH 适配的轻量级截图标注插件，交互与 Snipaste 一致：按 F1 整屏定格压暗、框选区域、画红框与文字，合成 PNG 直接回填到输入框，不产生页面里的截图预览。
这是什么¶
- 插件名称：dsh-snip
- 维护者：XXP-AI-SPACE
- 分类：客户端
- 核心价值：在 DSH 内直接完成「全屏截图 → 标注 → 回填」的闭环，减少跨应用切换，不干扰当前对话。
核心功能¶
截图与标注流程¶
- 进入截图：点击输入框工具行的剪刀图标，或按下
F1（宿主侧全局热键）。 - 整屏定格压暗，拖动鼠标框选目标区域。松手后选区恢复亮度，可拖边角微调或拖框内移动。
- 选区下方弹出工具条：
- Box：在选区里拖出红色方框外框，可画多个。
- Text：在选区里点一下就地输入文字（回车确认），滚轮调整字号（8–200 px）。
- Size N：显示当前字号，滚轮实时变化。
- Done：合成并投递。
- Cancel：取消。 - 快捷键：
-Enter确认（尚未框选时先按 = 整屏）。
-Esc退出截图（正在写字时先取消这条文字）。
- 双击选区内确认。 - 完成后：标注图按原分辨率合成为 PNG，自动作为附件放进当前输入框，同时写入剪贴板。
技术实现¶
- 浮层由宿主侧拉起的系统级全屏窗口（TopMost），不依赖页面内 DOM。
- 截取浮层出现前那一帧，不会把浮层本身截入结果。
- 结果以
-Out旁的<png>.meta.json交付，宿主读取文件而非 stdout，避免跨进程管道开销。 - 支持多显示器（按虚拟屏幕整体覆盖，含负坐标屏）。
安装与启用¶
官方安装命令（从市场或 GitHub）：
# npm（收录进市场后，市场里点安装也是这条）
dsh plugin --profile desktop add dsh-snip
# 直接从 GitHub 装
dsh plugin --profile desktop add github:XXP-AI-SPACE/dsh-snip
# 本地开发（link 到源码）
dsh plugin --profile desktop add "link:F:\工作之后\3-DSH\plugins\dsh-snip"
安装后需要冷启动桌面端（宿主半），浏览器半刷新页面即可生效。
典型用法¶
- 在 DSH 对话中，点击输入框工具行的剪刀图标，或直接按
F1。 - 框选需要标注的区域，选区下方出现工具条。
- 点击 Box 画红色外框，或点击 Text 输入说明文字（滚轮调整字号）。
- 双击选区或按
Enter完成合成，图片直接作为附件进入输入框，无需再粘贴。
适用场景与注意¶
- 适合需要频繁把桌面界面、应用窗口、错误弹窗贴进 DSH 对话的开发者与智能体创作者。
- 插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证（MIT）。
- 仅支持 Windows 10/11（依赖 Windows PowerShell + WinForms）。
F1为默认全局热键，若已被占用可在lib/index.js顶部修改HOTKEY_KEY。
短结尾¶
dsh-snip 把 Snipaste 式的截图标注流程集成进 DeepSeek Harness，减少跨应用切换，不干扰页面。想了解更多或下载源码，可访问插件目录页或 GitHub 仓库。
参考资料¶
- 插件目录页：https://www.skillhub.cn/plugins/XXP-AI-SPACE/dsh-snip
- GitHub：https://github.com/XXP-AI-SPACE/dsh-snip
