前言¶
在 DSH（DeepSeek Harness）桌面场景里，开发者往往把划词工具栏、悬浮助手、截图和录屏拆成多个插件或独立运行时维护，配置分散，还要单独处理 Electron 辅助进程与原生能力加载。dsh-desktop-tools 把上述能力收进一个客户端插件：自带 helper、preload、原生功能模块与设置页，直接复用 DSH Desktop 的 Electron 可执行文件，无需再装 dsh-desktop-runtime、dsh-selection-toolbar、dsh-floating-ball 或 dsh-capture。
下面介绍插件定位、能力边界、安装步骤与典型用法；事实以仓库 README 与 package.json 为准。
这是什么¶
dsh-desktop-tools 由维护者 1997liuyh-boop 发布，在 SkillHub 目录中归类为客户端插件。当前仓库版本为 0.4.4，许可证 MIT，GitHub 星标数为 0（以目录页展示为准）。
一句话定位：为官方 DSH Desktop 提供划词工具栏、悬浮助手、截图 / 长截图、录屏的 Electron 原生辅助能力，配置统一写入用户 profile 下的 desktop-tools.json。
核心功能¶
划词工具栏与悬浮助手¶
- 划词工具栏：可在设置中开关、配置目标语言与模型等；默认启用。
- 悬浮助手：可配置头像、会话/背景模型、权限预设、坐标模式与系统权限；默认启用。
截图、长截图与录屏¶
全局快捷键（DSH 在后台时也可触发）打开屏幕顶部工具条，三种模式：Screenshot、Record screen、Long screenshot。默认截图快捷键为 Ctrl/Cmd + Shift + S，录屏为 Ctrl/Cmd + Shift + R；截图与录屏在默认配置下关闭，需在设置中打开。
截图选区后支持矩形/椭圆/线段标注、画笔、箭头、文字与马赛克，以及钉住桌面、撤销/保存/转发等操作。长截图在框选区域内滚轮滚动拼接，最高约 30000 像素；Windows 支持自动滚动，Linux 需手动滚动，macOS 自动滚动需无障碍权限。
录屏可选区域、窗口或全屏；格式 MP4 / GIF / WebM；质量 SD / HD / Original；可混录系统声与麦克风（平台限制见下表）。MP4/WebM 最长 15 分钟或 500 MB，GIF 最长 3 分钟。
| 能力 | Windows | macOS | Linux |
|---|---|---|---|
| 系统声音录屏 | 支持 | macOS 13+，否则仅画面 | 不支持 |
| 长截图自动滚动 | 支持 | 需无障碍权限 | 不支持（手动滚动） |
| 系统分享面板 | Explorer 分享 | macOS 分享菜单 | 不支持 |
与 dsh-vision-router 的配合（可选）¶
对截图/长截图的提取文字、翻译、知识图谱，以及录屏录制成知识图谱，依赖 dsh-vision-router（>=3.2.0），安装后需保持其 tool 开关开启。标注、钉住、保存、转发、录屏、长截图拼接等不依赖 vision-router。
默认 OCR 引擎为 auto：优先本地 Tesseract，否则回退到 vision-router 中配置的视觉模型。仅本地 OCR 时，可将 vision-router 默认 OCR 设为仅 Tesseract。
DSH 插件管理器不能一次性安装两个插件，可任选其一：
- Settings → Desktop tools → Screenshot 前提卡片上点击 Install dsh-vision-router（已装未启则 Enable），按提示重启 DSH；
- 在未安装时使用上述三项能力，结果窗内同样有安装按钮；
- 终端执行：
dsh plugin add dsh-vision-router
环境与版本要求¶
- DSH Desktop：
>=0.2.2-rc.1 <0.3.0-0（package.json中engines.dsh与 README 一致）。 - Node（仅自建插件时需要）：
>=24.9.0。 - 安装不需要 Electron
path.txt，不使用koffi安装脚本；helper 使用 DSH Desktop 自带 Electron，并加载匹配的预编译 Koffi 平台包。
安装与启用¶
- 确认 DSH Desktop 版本落在上述区间。
- 若 profile 中仍保留旧插件，先移除
dsh-selection-toolbar、dsh-floating-ball、dsh-capture、dsh-desktop-runtime，再安装本插件并重启 Host；新插件不导入旧包的独立设置文件。 - 在 DSH 中添加本仓库为插件，安装标签 0.4.4。README 给出的仓库地址为：
https://github.com/1997liuyh-boop/dsh-desktop-tools.git
- 需要 OCR/翻译/知识图谱时，按上一节安装并启用
dsh-vision-router。 - 打开 Settings → Desktop tools，在四个子菜单（划词、悬浮球、截图、录屏）中调整开关与快捷键；每次保存会报告持久化结果与 helper 实际应用状态。若快捷键已被其他程序占用，全局注册会失败，需另选组合。
典型用法¶
截图后走 DSH 会话¶
- 在设置中启用截图并确认快捷键未被占用。
- 按
Ctrl/Cmd + Shift + S进入截图模式，框选区域并完成标注。 - 若已配置 vision-router：在结果窗使用 Extract text、Translate 或 Knowledge graph；翻译与知识图谱会在「Screenshots and recordings」工作区创建 DSH 会话；知识图谱含 Mermaid 图与节点关系列表，可存 Markdown 或导出 PNG。
- Done（Enter）复制到剪贴板，或 Save（
Ctrl/Cmd + S）落盘。
录屏并生成知识图谱¶
- 启用录屏，按
Ctrl/Cmd + Shift + R选择范围与格式/音质。 - 录制中可用 Space 暂停/继续，Enter 停止保存，Esc 丢弃。
- 若开启「录制到知识图谱」且已装 vision-router：录制过程中保留最多 12 个视觉变化明显的关键帧，结束后由帧内文字生成知识图谱（不转写语音）。
从旧四件套迁移¶
移除四个旧插件条目 → 安装 dsh-desktop-tools@0.4.4 → 重启 Host。默认仍启用划词与悬浮球，截图与录屏保持关闭，需在 Desktop tools 中按需打开。
适用场景与注意¶
适合谁：已在用 DSH Desktop、希望在同一插件内管理桌面划词、悬浮助手与截录屏，并愿意按需叠加 dsh-vision-router 做 OCR 与知识图谱的用户。
权限与安全：插件以当前 DSH 进程及 helper 所具备的系统权限运行（悬浮窗、全局快捷键、录屏、麦克风等）。安装前应阅读仓库源码与 MIT 许可证及随附第三方许可说明；社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
生态说明：DSH 奉行「一切皆插件」；本仓库是当前 README 推荐的桌面工具一体化方案，不再依赖已拆分的 runtime 与 capture 系列包。
结尾¶
dsh-desktop-tools 把桌面辅助进程、原生截录屏与划词/悬浮配置收到一处，降低多插件拼装成本；视觉理解与知识图谱能力通过可选的 dsh-vision-router 扩展。查阅目录与源码：
- 目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-desktop-tools
- GitHub：https://github.com/1997liuyh-boop/dsh-desktop-tools
