DSH Shot

Windows screenshot and annotation plugin for DeepSeek Harness. Select the live desktop, capture only the selected region after releasing the mouse, then insert the image directly into the conversation draft.

Windows 实时桌面截图插件：全局热键、窗口识别、选区调整、标注，以及直接插入 DSH 输入框。

Download Windows ZIP 0.7.0-beta.4 · Release notes · DSH Market 已确认收录

当前修复版为 0.7.0-beta.4，GitHub ZIP 与 npm 已同步，npm 的 latest / beta 标签均指向此版。存在相机按钮和插图加载缺陷的 beta.2 已从 GitHub Release、标签和 npm 下架；请勿复用本机留存的旧 ZIP 或安装器。

Beta: 0.7.0-beta.4. Windows 10/11 x64, official DSH desktop only. Tested on the developer's machine with isolated profiles; compatibility on other machines still needs feedback. macOS, Linux, browser-only DSH and remote Hosts are unsupported.

Install / 安装

Install and open the official Windows DSH desktop app at least once. Keep DSH running during setup so the installer can find its executable.

ZIP, no additional Node.js required: download dsh-shot-0.7.0-beta.4-windows-x64.zip, extract it completely and run install.bat. The installer must print Installed 0.7.0-beta.4. If prompted, select your installed DeepSeek Harness.exe. Quit DSH completely from its tray menu and reopen it. Do not reuse a beta.2 ZIP or its extracted installer.

npm, for users who already have Node.js:

npx --yes --package=dsh-plugin-live-shot@0.7.0-beta.4 dsh-shot install

Alternatively, download the Release TGZ and use npx --yes --package=./dsh-plugin-live-shot-0.7.0-beta.4.tgz dsh-shot install from its folder. Use dsh-shot install -DshExe "C:\Apps\DeepSeek Harness\DeepSeek Harness.exe" if automatic detection fails. -ProfileDir, -DshHome and -DataDir support non-default installations. Then fully quit and reopen DSH.

ZIP, npm and standard bundle installations all use dsh-plugin-live-shot as the installed directory, Loader entry, manifest name and Client module ID. The installer migrates the old @local/dsh-shot entry while preserving its settings and custom data directory. Beta.2 ZIP installations had a name mismatch that prevented the camera and image delivery from loading; upgrade with this installer and completely restart DSH. Standard bundle installations prepare the local runtime on first startup; if automatic discovery fails, use the explicit installer instead.

安装无需管理员权限。ZIP 安装不需要额外 Node 或网络下载；npm 方式需要 Node 和网络获取插件包。辅助运行时均从你本机的 DSH 复制，首次约需数百 MB 空间，不修改 DSH 程序目录。DSH 升级后重新运行安装器。

Use / 使用

• Click the camera in the composer, or press Ctrl+Shift+X from any program. The desktop remains live while selecting; no full-screen preview is captured.
• Hover a window and click to select it, or drag a custom region. After release, move the selection with ↔ or resize its eight handles. Releasing a changed selection captures the new region.
• Rectangle, ellipse, arrow, pen, mosaic, text, undo and PNG save are available.
• Enter / double-click / Done inserts into the active DSH composer. Ctrl+C copies only. Esc / right-click cancels.
• 隐藏 DSH remembers whether to hide DSH during capture. Shift+camera inverts that choice for one capture. Completion or cancellation restores hidden windows.
• ⚙ changes the global shortcut. A conflict or save failure preserves the previous binding.

Restart acceptance / 重启后三步验收

1. Use the camera and the global hotkey; select over a moving clock or video and confirm the desktop stays live.
2. Select a window, adjust the region and add annotations; enable 隐藏 DSH, cancel and confirm DSH returns.
3. Verify Enter inserts, Ctrl+C copies only, and saved hotkey/hide preferences survive another complete restart.

Uninstall / 卸载

For the explicit installer, run uninstall.bat, or:

npx --yes --package=dsh-plugin-live-shot@0.7.0-beta.4 dsh-shot uninstall

Then completely restart DSH. Default removal retains settings and local runtime. The optional -RemoveData also deletes the dedicated data directory, including images saved in its captures folder. For a non-default profile, pass the same -ProfileDir used to install. If installed as a standard DSH bundle, remove it through that bundle manager instead.

Full path options and troubleshooting: portable_readme.md.

Limits and local access

One monitor per selection; no cross-monitor stitching or scrolling capture. Window detection covers top-level windows. Protected video and UAC secure desktops follow Windows restrictions. Capture occurs after hiding the overlay and waiting for composition, rather than promising the exact video frame at mouse release.

The plugin registers a global hotkey, reads pointer/window geometry, captures the region you select, and writes the clipboard or a PNG only when requested. It uses an authenticated random-token loopback connection between its local processes. The dedicated Electron helper uses --no-sandbox and a local page with context isolation and a network-blocking CSP; it must not load remote pages. The plugin does not upload screenshots or read account keys.

Composer delivery uses DSH's current paste/drop DOM behavior; version changes may require adaptation. Report DSH/Windows versions, monitor scaling, RDP use and the error message in Issues. Do not attach account settings or private screenshots.

Development

No npm dependencies or build step. Runtime files and machine-specific configuration are excluded from public artifacts. On Windows with Node:

node --experimental-vm-modules tests/host_test.mjs
node tests/selection_settings_test.mjs
node tests/client_install_test.mjs
node tests/worker_test.mjs
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build_portable.ps1

The worker test captures a small region locally without writing it to disk. Integration tests require an installed DSH and should use isolated profiles.

MIT license for this plugin. DSH/Electron binaries are not included; see THIRD_PARTY_NOTICES.md. This is an independent community plugin.