dsh-screenshot-plugin

August 24, 2026 · View on GitHub

DeepSeek Harness 界面内的微信式一键框选截屏插件：对话输入框左侧多一个 ✂ 按钮，点一下全屏变暗、拖动框选区域即可截取。

  • 松手后选区保留：可拖动移动、拖四角/四边手柄缩放，双击或按 Enter 确认截取
  • PNG 自动编号（截屏N_HHmm.png）存入指定目录
  • 标记 [Shot N HH:mm] 自动写入输入框（发送后 agent 可按标记定位文件读取）
  • 纯 ASCII 标记，无编码坑

多语言简介 / Intro

  • 简体中文：微信式一键框选截屏插件：拖动框选、8 个手柄微调，Enter 确认截取、Esc 取消；PNG 自动编号保存，[Shot N HH:mm] 标记自动填入输入框。已在 DeepSeek Harness Desktop 实测。
  • 繁體中文：微信式一鍵框選截圖外掛：拖曳框選、8 個控點微調，Enter 確認截取、Esc 取消；PNG 自動編號儲存，[Shot N HH:mm] 標記自動填入輸入框。已在 DeepSeek Harness Desktop 實測。
  • English: WeChat-style one-click screenshot plugin: drag to select, fine-tune with 8 resize handles; press Enter to capture (the [Shot N HH:mm] marker is filled into the composer), Esc to cancel. PNGs are auto-numbered. Tested on DeepSeek Harness Desktop.
  • Русский: Плагин скриншотов в стиле WeChat: выделите область перетаскиванием, подправьте с помощью 8 маркеров; Enter — снять скриншот (метка [Shot N HH:mm] подставляется в поле ввода), Esc — отмена. PNG сохраняются с автонумерацией. Проверено на DeepSeek Harness Desktop.
  • Français : Capture d'écran façon WeChat : sélectionnez à la souris, ajustez avec 8 poignées ; Entrée pour capturer (le marqueur [Shot N HH:mm] est inséré dans la zone de saisie), Échap pour annuler. PNG numérotés automatiquement. Testé sur DeepSeek Harness Desktop.
  • Italiano: Plugin di screenshot stile WeChat: seleziona trascinando, regola con 8 maniglie; Invio per catturare (il marcatore [Shot N HH:mm] viene inserito nel campo di input), Esc per annullare. PNG con numerazione automatica. Testato su DeepSeek Harness Desktop.
  • 日本語: WeChat 風のワンクリックスクリーンショットプラグイン：ドラッグで範囲選択、8 つのハンドルで微調整。Enter で撮影（[Shot N HH:mm] マーカーが入力欄に自動挿入）、Esc でキャンセル。PNG は自動連番で保存。DeepSeek Harness Desktop で動作確認済み。
  • 한국어: WeChat 스타일 원클릭 스크린샷 플러그인: 드래그로 영역 선택, 8개 핸들로 미세 조정. Enter로 캡처([Shot N HH:mm] 마커가 입력창에 자동 입력), Esc로 취소. PNG 자동 번호 저장. DeepSeek Harness Desktop에서 테스트 완료.

安装

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

重启 DSH（或对应客户端）后，输入框左侧出现 ✂ 按钮。

使用

  1. 点 ✂ → 屏幕变暗
  2. 拖动框选区域；松手后选区保留——可拖动选区移动、拖四角/四边手柄缩放
  3. 双击选区（或按 Enter）确认截取，Esc 取消
  4. 输入框自动出现 [Shot N HH:mm]
  5. 点发送，把标记发给 agent（配合视觉插件如 ModLens，agent 可直接读取该截图）

配置

截图保存目录默认 ~/Pictures/DSH-Screenshots，通过 profile 补丁覆盖：

# ~/.dsh/profiles/<name>/cordis.patch.yml
- id: screenshot
  config:
    folder: 'D:\MyScreenshots'

工作原理

  • 客户端（client/index.js）：注册到 conversation.input.left slot 的 ✂ 按钮，点击后 POST /api/screenshot/capture
  • 宿主（lib/index.js）：注册 webServer 路由，拉起 PowerShell 全屏框选覆盖层，返回 { ok, file, marker }
  • 截屏脚本（lib/capture.ps1）：WinForms 遮罩层（接收全部输入）+ 点击穿透的顶层绿色框架层（明绿 3px 框线 + 8 个缩放手柄 + 操作提示），CopyFromScreen 区域截取；纯 ASCII 源码（Windows PowerShell 5.1 编码安全）；结果从主流程输出；内置 -SelfTest 几何自检
  • 填入输入框：按优先级走 props.inputActions → sessions.provideInfo(...).props.inputActions → session.prompt(..., 'queue') 兜底，任何失败只弹提示、不影响使用

限制

  • 仅 Windows（依赖 Windows PowerShell / System.Drawing）
  • 宿主侧按钮点击与框选在应用前台进行；多显示器支持虚拟屏整体坐标

常见问题

  • 点了按钮没反应？ 确认在会话输入框左侧能看到 ✂；该按钮走宿主路由，TUI/无 webServer 的部署不会显示。
  • 截图保存了但输入框没标记？ 查看按钮弹出的提示（成功/失败都有提示）。标记是纯 ASCII [Shot N HH:mm]，可手动发送。
  • agent 怎么读截图？ 发送标记后，配了视觉引擎的 agent（如 ModLens）可按编号与时间定位 截屏N_HHmm.png。
  • 文件名为什么带"截屏"而标记是 ASCII？ 文件名便于在文件夹中辨认；标记用 ASCII 是为了避免聊天输入/传输中的编码问题。

License

MIT