Vai al contenuto principale
J

dsh-screenshot

joythatway/dsh-screenshot

Composer screenshot menu with three modes: region capture that hides the harness window, a window list with live hover previews, and full screen; captures land in the draft, and multi-image drafts open a keyboard gallery. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Installazione

dsh plugin --profile web add github:joythatway/dsh-screenshot

README

截图 · dsh-screenshot

给 DeepSeek Harness 的输入框加一个截图按钮:框选 / 窗口 / 整屏,图片直接变成草稿附件,跟着消息发给模型。

一个 Composer toolbar 插件,用 macOS 原生截图能力实现;窗口列表、悬停缩略图、多图预览都按 Harness 自己的 UI 规范来做。

A composer-toolbar screenshot plugin for DeepSeek Harness: capture a region, a window, or the whole screen, and drop it straight into the draft.


功能

  • 一个按钮,三种模式:点输入框工具栏的相机图标 → 菜单里选「框选截图 / 窗口截图 / 整屏截图」。
  • 框选:
    • 调系统原生遮罩拖一块区域;
    • 和豆包一样,截图前会把 DeepSeek Harness 窗口自动让开,方便直接框选它后面的内容;截图结束(确认 / 取消 / 失败)后窗口自动回来;
    • 松开鼠标后先弹确认框:Enter 确认、Esc 取消、点遮罩空白取消,确认了才进草稿。
  • 窗口:
    • 列出当前屏幕上所有可见窗口(前台在前),鼠标悬停时右侧显示该窗口的实时缩略图,预览图会跟随当前行上下移动;列表会过滤掉小于 100×80 的辅助窗口(截出来只有一片纯色);
    • 点一行截整窗;对 GPU 渲染、窗口快照读回来是纯色图的窗口(例如 Steam),会做空图检测(颜色跨度 + 标准差,低对比的空图也拦得住):未被遮挡时退回按窗口矩形从屏幕合成里截,被遮挡时明确提示「先切到前台」,不会塞一张黑图或纯色图。
  • 整屏:直接截整个桌面,无遮罩;快捷键 ⌃⇧S(macOS)/ Ctrl+Shift+S(Windows)。
  • 草稿多图预览:草稿里有 2 张及以上图片时,点任意缩略图打开画廊:
    • 左右箭头翻页(第一张只显示右箭头,最后一张只显示左箭头);
    • ← / → 键盘翻页,Esc 关闭;
    • 底部缩略图条显示全部图片,点一下直接跳转。
  • 失败有出口:没有屏幕录制权限时给出提示 + 「打开设置」按钮,直接跳到系统设置对应面板。

平台支持

平台框选窗口(列表)整屏状态
macOS原生遮罩CoreGraphics + 悬停缩略图原生截图已实测
Windows—Win32 枚举 + 矩形截图.NET 截全屏代码已写,未实测
Linux———不支持(按钮隐藏)

Windows 没有系统级的框选遮罩,因此不提供「框选截图」,菜单只会出现「窗口 / 整屏」两项。/probe 的 modes 字段会驱动 UI 自动隐藏不支持的模式。

环境要求

  • DeepSeek Harness(桌面版;浏览器里按钮可用,但快捷键只在桌面端绑定)
  • macOS 12+(采集层用到 screencapture、sips、JXA/CoreGraphics)
  • Node.js ≥ 20(仅开发/测试需要)

安装

本插件是 Harness 的 profile bundle(package.json 里带 dsh.bundle.patch + dsh.client)。

方式一:插件管理器安装本地目录

plugin_manager install_bundle /绝对路径/dsh-screenshot

方式二:手动放进 profile

把目录拷到 $DSH_PROFILE_DIR/node_modules/,然后在 profile 的 cordis.patch.yml 里插入一行:

- insert:
    - id: dsh-screenshot
      name: '@joythatway/dsh-screenshot'

安装后重启 Harness(或重新加载插件);浏览器端代码在刷新页面后生效。

权限

权限用途缺失时的行为
屏幕录制截图本身提示 + 「打开设置」按钮,不会先铺遮罩再失败
辅助功能截图时自动隐藏 Harness 窗口截图照常,只是窗口不让开;首次提示一次

插件用 CGPreflightScreenCaptureAccess() 预检屏幕录制权限——只问权限,不抓任何像素。

隐私与存储

  • 截图不落盘:截到的 PNG 只存在宿主进程内存里,页面取走即删除,60 秒未取自动释放。
  • 入草稿不等于保存:图片加入输入框后只存在页面内存(File + blob),点发送才会写入附件库;没发送就关掉 App,这张图不会在磁盘上留下任何文件。
  • 缩略图不落盘:按窗口号实时截、缩到 480px,最多内存缓存 16 张、30 秒过期。
  • 入草稿前会压缩:长边超过 2560px 的截图等比缩小,减少 token 和上传体积。
  • 发送后的图由 Harness 持久化:点发送后,Harness 的附件存储会写入 $DSH_HOME/attachments/v1/objects/…(内容哈希去重,默认不自动清理)。这与插件无关,但需要知情。
  • 所有 HTTP 路由只放行同源请求(校验 sec-fetch-site)。

快捷键

动作键位
整屏截图⌃⇧S / Ctrl+Shift+S
画廊翻页← / →
确认 / 取消截图Enter / Esc

HTTP 接口(同源,供开发调试)

方法路径说明
GET/api/dsh-screenshot/probe平台能力:supported / platform / modes
GET/api/dsh-screenshot/windows可见窗口列表(z 序,带坐标和尺寸)
GET/api/dsh-screenshot/thumbnail?id=<窗口号>480px 窗口缩略图(PNG)
POST/api/dsh-screenshot/capture{ mode: 'region'|'window'|'screen', windowId? } → { ok, id }
GET/api/dsh-screenshot/image/<id>取一次即删的 PNG
POST/api/dsh-screenshot/settings-screen{ pane: 'screen'|'accessibility' } 打开对应设置面板

项目结构

index.js              Host 入口:HTTP 路由 + 内存暂存
capture/index.js      按平台挑采集后端
capture/macos.js      screencapture / sips / JXA(已实测)
capture/windows.js    PowerShell + .NET(未实测)
lib/util.js           纯函数(可单测)
client.js             浏览器端:按钮、菜单、确认框、画廊、缩略图预览
test/util.test.js     单元测试

开发

npm test        # node --test,无第三方依赖

CI 在 .github/workflows/test.yml 中,push 时自动跑单元测试。

已知限制

  • 依赖 Harness 的若干扩展点(conversation.input.left 槽位、conversation 服务的 createDrafts / releaseDraftAttachment、shortcuts.register)。升级 Harness 后建议把三种模式各点一次;出问题通常是静默失效,不会让界面崩溃。
  • 快捷键固定为 ⌃⇧S,没有设置界面。
  • 自动隐藏窗口依赖「辅助功能」权限;授权后如果窗口仍不让开,重启一次 Harness 再试。
  • Windows 实现未经真机验证,路径 / DPI 行为可能需要调整;失败时接口会带 detail 返回 PowerShell 的原始报错。
  • 菜单没有 ↑/↓ 键导航,确认框没有焦点陷阱(鼠标可用,键盘仅 Enter/Esc)。

License

MIT

Plugin correlati