deepseekplugins

DeepSeek Harness plugin

dsh-screenshot

WeChat-style screenshot for the DeepSeek Harness composer: capture the screen (optionally hiding the DSH window), select a region, and attach the cropped image to the message as a file-card.

Remote & Mobile
Jump to install

Source facts

Repository
XEsx630/dsh-screenshot
Latest update
Aug 16, 2026
Category
Remote & Mobile
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/XEsx630/dsh-screenshot
Plugin: dsh-screenshot
Author: XEsx630

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-screenshot — 对话框截图插件(微信 PC 式)

为 DeepSeek Harness(DSH)Web 对话框提供微信 PC 客户端式截图:点击截图按钮 → 遮罩框选(或先隐藏 DSH 窗口再截)→ 确认后图片卡直接出现在输入框上方,可直接发送;模型拿到图片路径后用本地 vision MCP(或其他读图工具)读取内容。

功能

  • 📷 composer 工具栏新增「截图」按钮,点击弹出两种模式:

- 截取屏幕任意区域:不隐藏窗口,全屏遮罩 + 鼠标拖拽框选(显示选区像素尺寸),可「全选 / 取消 / 确定」 - 隐藏当前窗口后截图:截图瞬间自动隐藏 DSH 浏览器窗口,截取被遮挡内容后自动恢复

  • 确认后由服务端 PowerShell 裁剪(不依赖浏览器 canvas),图片卡出现在输入区上方待发送栏(可删除)
  • 发送时自动注入 截图：<绝对路径> 文本(编辑器内为隐藏引用),模型据此调用 vision 工具读图
  • 发送失败自动还原图片卡与草稿;取消截图不留临时文件

安装

从 GitHub 安装

dsh plugin --profile web add github:XEsx630/dsh-screenshot
# 或指定版本标签
dsh plugin --profile web add "github:XEsx630/dsh-screenshot#v0.1.0"

dsh.bundle manifest 会自动把 dsh-screenshot 行挂进 profile。重启 dsh web 并刷新浏览器。

本地开发安装

把插件源码放到任意目录(如 D:\path\to\dsh-screenshot),以 link: 方式挂载到 web profile:

1. ~/.dsh/profiles/web/package.json: - dependencies 增加 "dsh-screenshot": "link:D:/path/to/dsh-screenshot" - dsh.profile.bundles 增加 "dsh-screenshot" 2. 在 ~/.dsh/profiles/web/ 运行 pnpm install 3. 重启 dsh web 并刷新浏览器

依赖

  • Windows(截图/裁剪脚本用 PowerShell 5.1 + System.Windows.Forms/System.Drawing)
  • DSH 0.1.x web profile

使用

1. 点 composer「截图」→ 选「截取屏幕任意区域」或「隐藏当前窗口后截图」 2. 等遮罩中画面加载完成,按住鼠标拖拽框选区域(微信式暗色遮罩 + 白色选区),松手后确认尺寸 3. 点「确定」→ 图片卡出现在输入框上方;可继续输入文字,点发送 4. 模型收到 截图：C:\...\screenshot-xxx.png` 后调用 mcp__vision__describe_image / mcp__vision__ocr_image` 读取内容

架构

截图按钮 ──POST /capture──▶ PowerShell screenshot.ps1(全屏,可选隐藏窗口)
                               └─▶ 临时 PNG($DSH_HOME/uploads/.screenshot-<uuid>.png)
遮罩预览 ◀──GET /preview──────┘
拖拽框选(纯坐标,无 canvas)
   └─POST /crop {rect, stage}──▶ 服务端换算物理像素(PNG 真实尺寸比例)
                                   └─▶ PowerShell crop.ps1(System.Drawing Clone)
                                        └─▶ 正式 PNG(screenshot-<时间戳>.png)
图片卡进对话框 ──发送──▶ 注入「截图：<路径>」──▶ 模型调 vision MCP 读图

设计要点:

  • 裁剪在服务端完成,浏览器只负责显示与框选坐标,杜绝 canvas 解码时序(naturalWidth=0 → 1×1 空图)等浏览器图像处理问题
  • 坐标换算用 PNG 真实尺寸 × 前端实际渲染尺寸的实时比例,不受 CSS/缩放影响
  • 框选在图片加载完成后才允许;拖动过程使用坐标快照,布局变化不会偏移选区
  • 隐藏引用(source: 'screenshot')与 dsh-file-uploads 的引用通道平行共存,互不干扰

文件结构

dsh-screenshot/
├── package.json        # dsh.bundle + dsh.client 声明
├── cordis.patch.yml    # 插件挂载行
├── README.md
└── lib/
    ├── index.js        # Host: /api/screenshot 路由(capture/crop/preview/delete)
    ├── client.js       # Client: 按钮/菜单/遮罩框选/引用序列化/卡片栏
    ├── screenshot.ps1  # PowerShell 全屏截图(可选隐藏前台窗口、DPI 感知)
    └── crop.ps1        # PowerShell 服务端裁剪(System.Drawing Clone)

HTTP API(Host)

方法路径说明
POST/api/screenshot/capturebody {hideWindow?, allScreens?} → 全屏截图到临时文件,返回 {id, width, height, url}
POST/api/screenshot/cropbody {id, rect:{x,y,w,h}, stage:{w,h}} → 服务端裁剪 → 返回 {file:{name,path,size}} 并清理临时文件
GET/api/screenshot/preview?id=返回临时 PNG(前端预览)
DELETE/api/screenshot/preview?id=删除临时 PNG(取消时清理)

安全

  • 所有路由仅限 loopback + same-origin(参照 DSH 本地插件信任栅栏)
  • 临时文件名 .screenshot-<uuid>.png,id 严格校验 UUID;超过 10 分钟的残留临时文件在下次启动时清扫
  • 截图/裁剪脚本仅在本机执行,不上传任何数据;图片内容仅进入 $DSH_HOME/uploads(可用 DSH_UPLOAD_DIR 重定向到非 C 盘)

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category