DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-screenshot

j

dsh-screenshot

Manifest valid

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 ope

UI (client)hasBundlePatch

截图 · dsh-screenshot

给 DeepSeek Harness 的输入框加一个截图按钮:框选 / 窗口 / 整屏。截图可以作为草稿附件随消息发送,也可以保存到磁盘。

一个 Composer toolbar 插件,采集层调用系统原生截图能力;窗口列表、悬停缩略图、图片预览和设置页都沿用 Harness 的界面规范。

A composer-toolbar screenshot plugin for DeepSeek Harness: capture a region, a window, or the whole screen, then attach it to the draft or save it to disk.


功能

  • 一个按钮,三种模式:点输入框工具栏的相机图标,在菜单里选「框选截图 / 窗口截图 / 整屏截图」;菜单支持 ↑/↓/Home/End + Enter 键盘操作。
  • 截图快捷键:默认 ⌃⇧S(Windows 为 Ctrl+Shift+S),按下直接整屏截图,不经过菜单;键位可以在设置页修改,也可以在 Harness 自己的快捷键页面修改。
  • 框选:
    • 调起系统原生遮罩拖出一块区域;
    • 截图前自动隐藏 Harness 窗口,便于框选被它遮挡的内容;截图结束(确认 / 取消 / 失败)后窗口自动恢复(可在设置里关闭);
    • 松开鼠标后先弹确认框:Enter 确认入草稿、Esc 取消、点遮罩空白取消;确认框里也可以直接保存到磁盘(没有打开的会话时只有「保存 / 取消」)。
  • 窗口:
    • 列出当前屏幕上所有可见窗口(前台在前),悬停时显示该窗口的实时缩略图,预览跟随当前行移动;小于 100×80 的辅助窗口会被过滤;
    • 点一行截取整窗;对窗口快照读回纯色图的场景(例如部分 GPU 渲染窗口)会做空图检测(颜色跨度 + 标准差):未被遮挡时按窗口矩形从屏幕合成中截取,被遮挡时提示先切到前台,不会返回黑图或纯色图。
  • 整屏:直接截取整个桌面,无遮罩。
  • 保存到磁盘:
    • 框选确认框里有「保存」,图片预览里也有「保存」;
    • 默认保存到桌面,可在「设置 › 截图」里改成任意文件夹;
    • 文件名为 screenshot-YYYYMMDD-HHMMSS.png,重名自动追加 -2、-3;
    • 保存成功的提示带完整路径和「显示」,可直接在 Finder / 资源管理器中定位;提示 3 秒后自动消失,点击也能关闭;
    • 窗口 / 整屏截图不弹确认框,直接进草稿,同样可以在预览里保存。
  • 设置页:「设置 › 截图」(左下角设置 → 截图;插件管理器里该行的「配置」打开同一页面):
    • 截图快捷键:点「修改」后按下新组合键即生效,冲突或保留键会当场提示;「恢复默认」回到 ⌃⇧S;
    • 保存位置:可手输路径,也可点「选择…」使用系统文件夹选择器;「恢复默认」回到桌面;
    • 框选时自动隐藏窗口:关闭后框选期间不再隐藏 Harness 窗口;
    • 改动立即生效,不需要重启插件。目录与开关保存在 $DSH_HOME/dsh-screenshot/settings.json(默认 ~/.dsh/dsh-screenshot/settings.json),快捷键绑定沿用 Harness 自己的 keybindings 存储。
  • 图片预览:点草稿里的截图缩略图打开预览层,单张截图同样适用:
    • 整屏深色遮罩 + 背景模糊,图片居中显示;
    • 顶部工具栏:缩小 · 百分比 · 放大 · 保存,点百分比回到 100%;
    • 鼠标滚轮直接缩放(上滚放大、下滚缩小),范围 25% – 400%,100% 为整张图刚好放得下的尺寸;
    • 放大后按住图片可拖动平移,缩放时视口自动对准图片中心;
    • 键盘:← / → 翻页,+ / - 缩放,0 回到 100%,Esc 关闭;
    • 多张图片时顶部显示进度(如 2 / 5),底部缩略图条可点击跳转;
    • 「保存」把当前图片写入设置的目录,然后退出预览。
  • 权限提示:没有屏幕录制权限时给出说明和「打开设置」按钮,直接跳转到系统设置的对应面板。

平台支持

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

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

环境要求

  • 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),发送时才写入附件库;不发送就关闭应用,不会在磁盘上留下文件。
  • 缩略图不落盘:按窗口号实时截取并缩放到 480px,最多内存缓存 16 张,30 秒过期。
  • 入草稿前压缩:长边超过 2560px 的截图会等比缩小,减少 token 与上传体积。
  • 发送后的图片由 Harness 持久化:发送后 Harness 的附件存储会写入 $DSH_HOME/attachments/v1/objects/…(内容哈希去重,默认不自动清理)。此行为由 Harness 提供,与插件无关。
  • 设置文件:$DSH_HOME/dsh-screenshot/settings.json,只包含保存目录与自动隐藏开关两个字段;文件损坏时按默认值处理。
  • 所有 HTTP 路由只放行同源请求(校验 sec-fetch-site),并先经过 Harness 的 connection.requestRejection(Host/Origin 围栏 + 浏览器登录态);保存接口只接受 PNG,文件名会去除路径分隔符。

快捷键

动作键位
整屏截图⌃⇧S / Ctrl+Shift+S(可在设置页修改)
菜单内换行 / 触发 / 关闭↑ ↓ Home End / Enter / Esc
框选确认框:确认 / 取消Enter / Esc
框选确认框(无会话时):保存 / 取消Enter / Esc
预览:翻页 / 缩放 / 重置 / 关闭← → / + − / 0 / 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?, hideShell? } → { ok, id }
GET/api/dsh-screenshot/image/<id>取一次即删的 PNG
GET/api/dsh-screenshot/settings当前设置、生效的保存目录、默认(桌面)目录
POST/api/dsh-screenshot/settings{ saveDir?, hideOnCapture? } → 写入并返回当前设置
POST/api/dsh-screenshot/save?name=<文件名>请求体为 PNG 原始字节 → { path, dir, name }
POST/api/dsh-screenshot/reveal{ path } 在文件管理器中定位(只接受本次写出的文件)
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           采集工具函数(可单测)
lib/settings.js       设置的默认值、校验与 JSON 持久化
client.js             浏览器端:按钮、菜单、确认框、预览、缩略图、设置页
test/util.test.js     采集工具函数单测
test/settings.test.js 设置校验单测
test/host.test.js     Host 路由集成测试(临时目录写盘)
test/client.test.js   客户端冒烟测试(模块加载 / 槽位注册 / 页面渲染)

开发

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

CI 配置在 .github/workflows/test.yml,push 时自动运行测试。

已知限制

  • 依赖 Harness 的若干扩展点(conversation.input.left 槽位、conversation 服务的 createDrafts / releaseDraftAttachment、shortcuts.register)。升级 Harness 后建议把三种模式各点一次;异常通常是静默失效,不会导致界面崩溃。
  • 快捷键只声明桌面端(desktop:*):浏览器中 Ctrl+Shift+S 不是允许的浏览器组合,因此网页版不绑定这条命令,但设置页仍可修改桌面端的绑定。
  • 「框选时自动隐藏窗口」目前在 macOS 生效;Windows 后端不隐藏宿主窗口。
  • 自动隐藏窗口依赖「辅助功能」权限;授权后如果窗口仍不隐藏,重启一次 Harness 再试。
  • Windows 实现未经真机验证,路径与 DPI 行为可能需要调整;失败时接口会通过 detail 返回 PowerShell 的原始报错。
  • 确认框和预览层没有焦点陷阱(鼠标可用;键盘支持 Enter/Esc 与预览的 ←/→)。
  • 设置页的保存目录只校验是否为绝对路径,是否可写要等第一次保存时才知道(失败会提示检查目录)。

License

MIT

Comments

Loading…

Similar plugins

dsh-shot

by loftspire

Windows-only screenshot button for the DSH composer: freezes the desktop and dims it, selects a whole window by hovering or a region by dragging, marks it up with rectangles, ellipses, arrows and pen

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add @loftspire/dsh-shot

by 19north

Composer screenshot control for DeepSeek Harness: box-select and annotate a capture in an in-window overlay, optionally hiding the DSH window while capturing.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 6, 2026

dsh plugin --profile web add dsh-shot

by JackEngineer

One-click DSH screenshot: capture the DeepSeek Harness window (or the whole desktop) and drop the PNG straight into the composer draft

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add dsh-quick-screenshot

by EasySSHCN

Screenshot capture plugin for DeepSeek Harness (DSH): region/window/fullscreen capture with a fullscreen overlay selector, the screenshot tool, the /shot command, a Ctrl+Alt+A global hotkey and a comp

Manifest valid

★ 0

MIT

C#

Nov 4, 2026

dsh plugin --profile web add dsh-shot

by 12138hao

Screenshot directly into the chat composer for DeepSeek Harness — click the scissors, drag a region, the image lands in the input box.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add dsh-snap

by sfunction-guo

Snipping tool for the composer: freeze the screen, drag a region, annotate it, and drop the result into the message box. Windows only; the selector is a bundled WinForms binary (rebuilt from the inclu

UI & ExperienceManifest valid

★ 0

MIT

C#

Oct 30, 2026

dsh plugin --profile web add @sfunction/dsh-screenshot