dsh-screenshot
适用于 DeepSeek Harness 编写器的微信风格截图工具：捕获或隐藏 DSH 窗口，拖动选择区域，并将裁剪内容作为原生草稿附件添加。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:XEsx630/dsh-screenshot#bde98171f4ffbd32337dc4fa8b6f6d17d3cddd16
Screenshot 以 dsh-screenshot 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness（DSH）的 Web 输入框加一个「截图」按钮：点一下 → 遮罩框选（或先隐藏 DSH 窗口再截）→ 确认后裁剪好的截图直接出现在输入框的附件栏里，回车就能发。
从 0.2 起，截图走 DSH 自己的草稿附件通道：图片会作为真正的图片附件随消息发送，模型直接看到图；不再往草稿里塞 截图：<路径>，也不再需要 vision MCP。对不支持图片的模型，可以在菜单里切到「以文件路径发送」。
界面示意（演示数据）：遮罩框选后点「确定」，截图会进入输入框的附件栏。
Enter 确认、Esc 取消ctx.conversation.createDrafts + inputActions.addAttachments，由 DSH 渲染附件卡、发送图片字节.hwnd 标记把窗口恢复回来先确认你用的是哪个 profile：桌面端是 desktop，dsh web 命令行一般是 web。
# 桌面端
dsh plugin --profile desktop add github:XEsx630/dsh-screenshot
# 或 dsh web
dsh plugin --profile web add github:XEsx630/dsh-screenshot
# 指定版本
dsh plugin --profile desktop add "github:XEsx630/dsh-screenshot#v0.2.0"
dsh.bundle 清单会自动把插件挂进 profile。重启 DSH 并刷新页面。
dsh plugin --profile desktop add link:E:/path/to/dsh-screenshot
# 然后在 ~/.dsh/profiles/desktop 里 pnpm install，重启
Enter）→ 截图进入输入框上方的附件栏菜单底部可以切换发送方式：
| 方式 | 模型拿到什么 | 适用 |
|---|---|---|
| 以图片附件发送（默认） | 图片内容（DSH 图片附件） | 支持视觉的模型；无需额外工具 |
| 以文件路径发送 | 一段指向只读保存路径的文本 | 纯文本模型 + 本地 vision/OCR 工具；或截图超过 6 MB 时自动降级 |
┌─ 浏览器 ─────────────────────────────────────────────┐
│ 截图按钮 ──POST /capture──▶ 截图预览（GET /preview） │
│ │ │ │
│ └── 遮罩拖拽（只算坐标） │ │
│ └──POST /crop {rect, stage}──▶ 裁剪好的 PNG │
│ │ │
│ 取回 Blob ──▶ new File ──▶ createDrafts + addAttachments
└────────────────────────────────────────┼─────────────┘
▼
输入框附件栏（DSH 原生）
Host 侧：
screenshot.ps1 抓屏（可选先隐藏前台窗口，DPI 感知），写临时 PNGcrop.ps1 按 PNG 真实尺寸换算后的物理像素裁剪GET /file 交给浏览器，随后删除设计取舍：
naturalWidth=0、CSS 缩放带来的 1×1 空图物理 = 显示坐标 × (PNG 宽 / 画布宽)，浏览器缩放和 DPI 缩放都被吸收$DSH_HOME/uploads 路径，也不需要把路径塞进 promptscreenshot.ps1 隐藏前写 <png>.hwnd 标记，正常路径删除；进程被强杀时 Host 读标记调 restore.ps1 恢复所有接口仅限本机回环地址，且要求同源。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/screenshot/capture | body {hideWindow?, allScreens?} → 抓屏到临时 PNG，返回 {id, width, height, url} |
| POST | /api/screenshot/crop | body {id, rect:{x,y,w,h}, stage:{w,h}} → 裁剪，返回 {id, name, bytes, width, height, url} |
| GET | /api/screenshot/preview?id= | 抓屏预览 |
| GET | /api/screenshot/file?id= | 裁剪结果 |
| DELETE | /api/screenshot/preview?id= / file?id= | 删除临时文件 |
Host（127.0.0.0/8、localhost、::1），拒绝 sec-fetch-site: cross-site 和跨源 Originid 必须是 UUID，文件名由 Host 生成，不接受外部路径no-store、nosniff$DSH_HOME/cache/dsh-screenshot（可用 DSH_SCREENSHOT_DIR 重定向），30 分钟 TTLctx.conversation.createDrafts / inputActions.addAttachments 与 fileUpload 服务）System.Drawing / System.Windows.Forms@deepseek-ai/dsh-client-runtime、dsh-client-ui-conversation、dsh-client-file-uploadnode --test # 单元测试 + PowerShell 裁剪测试
npm run check # 语法检查
# 真实抓屏测试（会截当前屏幕）
$env:DSH_SCREENSHOT_LIVE=1; node --test test/powershell.test.js
测试覆盖：坐标换算/边界钳制、PNG 头解析、信任栅栏、路由校验与错误码、crop.ps1 的真实裁剪与越界拒绝。CI 在 windows-latest 上跑 Node 22/24。
| 现象 | 处理 |
|---|---|
| 按钮是灰的 | 当前会话未就绪，或输入框处于命令提交/发送阶段 |
| 「截图失败：无法启动 PowerShell」 | 检查 powershell.exe 是否在 PATH；企业策略可能禁用 Add-Type |
| 图片发送失败 | 模型不支持图片输入，或图片超出部署限制 → 菜单里关掉「以图片附件发送」 |
| 窗口没恢复 | 重新打开 DSH；残留标记会在下次启动时被清扫并恢复窗口 |
MIT