deepseekbluefish/dsh-screenshot-plugin

README 摘要

dsh-screenshot-plugin DeepSeek Harness 界面内的 微信式一键框选截屏 插件：对话输入框左侧多一个 ✂ 按钮，点一下全屏变暗、拖动框选区域即可截取。 - 松手后 选区保留 ：可拖动移动、拖四角/四边手柄缩放，双击或按 Enter 确认截取 - PNG 自动编号（ 截屏N HHmm.png ）存入指定目录 - 标记 [Shot N HH:mm] 自动写入输入框（发送后 agent 可按标记定位文件读取） - 纯 ASCII 标记，无编码坑 安装 重启 DSH（或对应客户端）后，输入框左侧出现 ✂ 按钮。 使用 1. 点 ✂ → 屏幕变暗 2. 拖动框选区域； 松手后选区保留 ——可拖动选区移动、拖四角/四边手柄缩放 3. 双击选区（或按 Enter）确认截取 ，Esc 取消 4. 输入框自动出现 [Shot N HH:mm] 5. 点发送，把标记发给 agent（配合视觉插件如 ModLens，agent 可直接读取该截图） 配置 截图保存目录默认 /Pictures/DSH-Screenshots ，通过 profile 补丁覆盖： 工作原理 - 客户端 （ 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 H…

分类