前言¶
在 DeepSeek Harness（DSH）里讨论界面问题、报错截图或设计稿时，常见做法是：先用系统或第三方工具截屏，保存或复制后再粘贴到输入框。多一步切换，也容易在「全屏预览」和真实桌面状态之间产生偏差。下面介绍社区插件 dsh-plugin-live-shot：在 Windows 官方 DSH 桌面客户端中，从选区到标注再到写入当前对话草稿，尽量在同一套流程里完成。
这是什么¶
dsh-plugin-live-shot 由维护者 TangerineSplendor 发布，在 DSH 生态中归类为客户端插件。它面向 Windows 10/11 x64 的官方 DSH 桌面应用：支持全局热键、窗口识别、自定义选区、标注，以及将结果直接插入 Composer 草稿。统一对外名称为 dsh-plugin-live-shot；安装/卸载命令仍可使用简称 dsh-shot，旧配置与数据目录在升级安装时会尽量保留兼容。
当前公开测试版为 0.7.0-beta.6。README 明确说明：不支持 macOS、Linux、仅浏览器版 DSH 与远程 Host；需在开发者本机隔离配置下验证，其他环境兼容性仍依赖社区反馈。
核心功能¶
以下能力均来自项目 README 的 Use 与 Limits 章节。
- 实时桌面选区：点击 Composer 中的相机图标，或在任意程序中按 Ctrl+Shift+X。选区过程中桌面保持「 live 」状态，不会在选区前先做全屏静态预览。
- 窗口与区域：悬停窗口后单击可选整窗；也可拖拽自定义区域。松手后用方向键 ↔ 移动选区，或通过八个控制点调整大小；若改动选区，会在新区域上完成捕获。
- 标注与导出：矩形、椭圆、箭头、画笔、马赛克、文字、撤销；可保存 PNG。Enter / 双击 / Done 插入当前 DSH 输入框；Ctrl+C 仅复制；右键 取消。编辑器内 Esc 可用；游戏预框选阶段 Esc 在本 beta 仍有已知问题，README 建议暂用右键退出。
- 隐藏 DSH：「隐藏 DSH」可记住截图时是否隐藏 DSH 窗口；Shift + 相机 可单次反转该选项。完成或取消后会恢复被隐藏的窗口。
- 快捷键设置：通过 ⚙ 修改全局快捷键；冲突或保存失败时保留原绑定。
限制方面：单次选区对应一块显示器，不支持跨屏拼接或滚动长页捕获；窗口识别针对顶层窗口；受保护视频与 UAC 安全桌面遵循 Windows 自身限制。插件注册全局热键、读取指针/窗口几何并在本地捕获选区；仅在用户请求时写入剪贴板或 PNG，README 声明不上传截图、不读取账号密钥。
安装与启用¶
安装前请先安装并至少打开过一次官方 Windows DSH 桌面应用，安装过程中保持 DSH 运行，以便安装器定位 DeepSeek Harness.exe。安装无需管理员权限；ZIP 方式不需要额外 Node.js；npm 方式需要 Node 与网络。辅助运行时从本机 DSH 复制，首次约需数百 MB 空间，不修改 DSH 程序目录。DSH 升级后需重新运行安装器。
方式一：ZIP（无需 Node.js）
从 Release v0.7.0-beta.6 下载 dsh-plugin-live-shot-0.7.0-beta.6-windows-x64.zip，完整解压后运行 install.bat。安装器应输出 Installed 0.7.0-beta.6。若提示，手动选择已安装的 DeepSeek Harness.exe。从托盘完全退出 DSH 后再重新打开。勿复用已下架的 beta.2 ZIP 或其解压目录中的安装器。
方式二：npm（已安装 Node.js 时）
npx --yes --package=dsh-plugin-live-shot@0.7.0-beta.6 dsh-shot install
也可下载 Release 的 TGZ，在其目录下执行：
npx --yes --package=./dsh-plugin-live-shot-0.7.0-beta.6.tgz dsh-shot install
自动检测失败时可指定 DSH 路径：
dsh-shot install -DshExe "C:\Apps\DeepSeek Harness\DeepSeek Harness.exe"
-ProfileDir、-DshHome、-DataDir 用于非默认安装路径。安装完成后同样需完全退出并重启 DSH。
ZIP、npm 与标准 bundle 安装均使用 dsh-plugin-live-shot 作为安装目录、Loader 入口与 Client 模块 ID；安装器会迁移旧的 @local/dsh-shot 条目并保留设置。若曾用 beta.2 ZIP 且相机/插图无法加载，需用当前版安装器升级并完全重启 DSH。
典型用法¶
- 在 DSH 对话界面点击相机，或在外部程序按 Ctrl+Shift+X，进入选区。
- 点选窗口或拖选区域；必要时用方向键与控制点微调，再进入标注界面。
- 添加矩形、箭头、文字等标注后，按 Enter（或双击 / Done）将图片插入当前 Composer；若只需复制到剪贴板，用 Ctrl+C。
- 需要截图时不露出 DSH 窗口时，开启「隐藏 DSH」；单次例外可用 Shift + 相机。
README 提供的重启后三步验收可作为冒烟检查：
- 分别用相机与全局热键，在走动时钟或视频上方选区，确认桌面仍为实时而非静态全屏图。
- 选窗口、调整区域并标注；开启「隐藏 DSH」后取消一次，确认 DSH 恢复显示。
- 确认 Enter 插入、Ctrl+C 仅复制，且热键/隐藏偏好经完全重启后仍保留。
卸载可运行 uninstall.bat，或：
npx --yes --package=dsh-plugin-live-shot@0.7.0-beta.6 dsh-shot uninstall
然后完全重启 DSH。默认卸载保留设置与本地运行时；可选 -RemoveData 删除专用数据目录（含 captures 中保存的图片）。非默认配置需传入安装时相同的 -ProfileDir。
适用场景与注意¶
适合：在 Windows 官方 DSH 桌面客户端中，需要快速把「当前桌面真实画面」截入对话、并做简单标注的开发者或日常用户。
不适合或需知：非 Windows x64、无官方桌面 DSH、远程桌面/RDP 与多显示器跨屏拼接等场景，README 已列限制或未保证兼容。本 beta 在游戏预框选 Esc、部分游戏焦点行为上仍有已知问题；⚙ 中的「管理员游戏兼容」为试验入口，README 说明不能视为已修复 Esc 问题。
插件以当前 DSH 进程权限运行，使用全局热键与本地进程间通信；安装前建议在 GitHub 查看源码与 MIT 许可证，并阅读 THIRD_PARTY_NOTICES.md。DSH 社区插件目录（如 SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-plugin-live-shot 把 Windows 下的实时选区、标注与 Composer 插入收拢到一条链路，减少截屏工具与 DSH 之间的来回切换。当前测试版 0.7.0-beta.6 可通过 ZIP 或 dsh-shot install 安装，使用前请按 README 完全重启 DSH 并完成验收步骤。
