dsh-screencapture
适用于 DSH 聊天窗口的 WeChat 风格截图工具：支持配置快捷键、区域选择、窗口吸附、标注、复制到剪贴板和保存为 PNG。仅支持 Windows。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:windsor8890/dsh-screencapture#f87560ac2619c851eeae48b4f43b3ebc14e5c29b
Screencapture 以 dsh-screencapture 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 里复刻「电脑版微信」的截图体验
WeChat-style screenshot & annotation plugin for the DSH Web UI.
简体中文 | English
按一下快捷键 → 冻结当前桌面 → 在 DSH 窗口里拖拽框选 → 标注 → 复制到剪贴板（或保存 PNG）。
整个交互都渲染在 DSH 窗口内部，截图完成后直接在输入框 Ctrl + V 粘贴发送。
本项目是社区插件，与腾讯 / 微信官方无关；「微信截图」仅指交互风格。
| 框选与标注 | 窗口吸附 |
|---|---|
| 框选与标注 | 窗口吸附 |
Ctrl + Shift + S，可在「设置 → 截图」中重新录制。
组合键需包含 Ctrl / Alt / Meta，且为 Host 可注册的按键。Enter、双击或 ✓ 把「裁剪 + 标注」后的图片写入剪贴板；
Ctrl + S 或下载按钮保存 PNG（默认 图片\DSH Screenshots，可自定义目录）。| 平台 | 状态 |
|---|---|
| Windows 10 / 11（DSH Desktop，Electron） | ✅ 完整支持（本机测试于 DSH Desktop 0.2.1-rc.2） |
| Windows + 其它 DSH 运行方式 | ✅ Host 半可用（PowerShell 5.1 为系统自带） |
| macOS / Linux | ⚠️ 仅能加载插件外壳；截图 / 剪贴板 / 全局热键路由返回 unsupported-platform |
原生实现依赖 Windows 的 System.Drawing、System.Windows.Forms、RegisterHotKey 与 DWM
窗口边界 API；其它平台需要独立的原生适配层，欢迎 PR。
前置条件：Windows 10/11 上的 DeepSeek Harness 桌面版（或可运行 Host 插件与 Web UI 的环境）。
在 DSH 的「设置 → 插件 → 安装 bundle」中填入本仓库的 pnpm 安装 spec：
github:windsor8890/dsh-screencapture
安装完成后启用名为「截图 / Screenshot」的插件即可（默认快捷键 Ctrl + Shift + S）。
git clone https://github.com/windsor8890/dsh-screencapture.git
然后在 DSH 插件管理中选择该目录作为本地 bundle 安装。修改源码后：
# 浏览器半：重建 lib/client.js，已打开的 DSH 页面会在约 0.5s 内热替换插件
node build.mjs
Host 半（host/）修改后，在 设置 → 插件 中关闭再启用该插件，或重启 DSH 即生效。
安装方式遵循 DSH 的 bundle 安装机制；不同 DSH 版本的插件管理入口文案可能略有差异。
| 操作 | 说明 |
|---|---|
Ctrl + Shift + S | 开始截图（可在设置里修改；全局快捷键开启时窗口未聚焦也有效） |
| 拖拽 | 选择截图区域 |
| 鼠标悬停窗口 + 单击 | 吸附选中整个窗口（高亮边框显示窗口标题 / 尺寸） |
| 拖动已选区域内部（未激活标注工具时） | 移动整个选区 |
| 单击空白桌面 | 选中整个屏幕 |
| 选中区域后拖拽内部 | 使用当前工具绘制标注；拖动 8 个控制柄可缩放选框 |
Enter / 双击 / ✓ 按钮 | 复制选区（含标注）到剪贴板并关闭浮层 |
Ctrl + S / 下载按钮 | 保存 PNG（不关闭浮层，可继续编辑） |
Ctrl + Z / Ctrl + Shift + Z | 撤销 / 重做标注 |
Esc / ✕ 按钮 | 取消，不产生任何输出 |
| 设置 → 截图 | 修改快捷键、全局快捷键、自动保存、保存目录、测试截图 |
Ctrl / Alt / Meta，
Esc 取消录制，「恢复默认」回到 Ctrl + Shift + S。%USERPROFILE%\Pictures\DSH Screenshots；可填任意绝对路径。┌────────────────────── 浏览器半（lib/client.js，Client 插件） ──────────────────────┐
│ settings.section「截图」 conversation.input.left 截图按钮 shell.overlay 浮层 │
│ canvas 框选 + 标注（选区/标注均存截图原始像素坐标）→ 裁剪 + 压平 → PNG data URL │
└───────────────────────────────────┬────────────────────────────────────────────────┘
│ fetch /api/dsh-screencapture/*
┌───────────────────────────────────▼────────────────────────────────────────────────┐
│ Host 半（host/index.js，Cordis 插件，ESM，仅 Node 内置模块） │
│ /status /capture /clipboard /save /reveal /events(SSE) /last-capture /config │
│ /overlay-window │
│ capture.js ── 常驻 powershell.exe -STA 助手 ── Graphics.CopyFromScreen / 剪贴板 │
└─────────────────────────────────────────────────────────────────────────────────────┘
getDisplayMedia，因此截图与剪贴板都在 Host 半完成；
Host 进程运行在 ELECTRON_RUN_AS_NODE=1 的 Node 模式，没有 Electron API，于是通过
host/capture-helper.ps1 常驻助手调用 .NET 的 System.Drawing / System.Windows.Forms。Host 头；不做任何远程上传。Ctrl + Shift + S；若组合键被 DSH 自身或其它软件占用（例如 DSH 的「归档会话」
占用 Ctrl + Shift + A、微信占用 Alt + A），可换一个组合键，或依赖全局快捷键。# 构建浏览器半（把 src/client/*.js 拼成 lib/client.js）
node build.mjs
# 跨平台客户端测试（CI 会跑）：几何/坐标/按键映射 + 中英字典对齐
node tests/client-math-test.mjs
node tests/client-locale-test.mjs
# Host 半测试（Windows 交互式桌面）：真实截屏、剪贴板跨进程回读、保存、路由校验（17 项）
node tests/host-test.mjs
# 全局热键 / SSE / config / overlay-window 测试（20 项，会短暂注册 F12 探针）
node tests/hotkey-test.mjs
测试会真实使用屏幕与剪贴板，并短暂创建测试窗口，请在可交互的 Windows 桌面会话中运行。
dsh-screencapture/
├─ package.json # bundle manifest（dsh.bundle.patch + dsh.client）
├─ cordis.patch.yml # 插入一行插件
├─ icon.svg # 插件图标（原创）
├─ locale/{en,zh}.json # 插件管理与设置里的标题 / 描述
├─ host/
│ ├─ index.js # Cordis 插件：注册路由、生命周期、全局热键接线
│ ├─ routes.js # 9 条路由表（含 SSE / config / overlay-window）
│ ├─ capture.js # 常驻截屏 PowerShell 助手管理
│ ├─ hotkey.js # 全局热键管理（RegisterHotKey、持久化、重注册）
│ ├─ global-flow.js # 全局截屏流程 + SSE 事件中心
│ ├─ fence.js # loopback 请求校验
│ ├─ capture-helper.ps1 # 截屏 / 剪贴板 / 激活窗口
│ └─ hotkey-helper.ps1 # 系统级热键注册（隐藏 WinForms 窗口）
├─ src/client/*.js # 浏览器半源码（共享层 / 浮层 / 设置页 / 入口）
├─ build.mjs # 把 src/client 拼成 lib/client.js
├─ lib/client.js # 生成的浏览器 bundle（勿手改）
└─ tests/
├─ host-test.mjs # Host 半真实环境测试（17 项）
└─ hotkey-test.mjs # 全局热键 / SSE / config 测试（20 项）
欢迎 Issue 与 PR：
node build.mjs 与相关测试（客户端测试跨平台，Host 两套需 Windows 交互式桌面）；详细流程见 CONTRIBUTING.md；安全问题请按 SECURITY.md 私下报告， 不要开公开 Issue。
MIT © 2026 joe