DeepSeek HarnessHub
Submit plugin

ReachGa0/dsh-desktop ↗★ 0

dsh-desktop-windows

DeepSeek Harness 桌面版（Windows）· Electron desktop shell for DeepSeek Harness — 双击即用 / double-click to run · 支持选区截图提问、系统托盘、会话管理 / region screenshot, system tray, session manager

AI Analysis

核心用途是为 Windows 用户提供开箱即用的 DSH 桌面客户端体验。适合不习惯使用命令行启动 Web 服务的普通用户。提供了截图提问等便捷的系统级集成功能。

VisionInterfaceProductivity
Package
dsh-desktop-windows
Version
0.2.8
License
MIT
Last updated
Aug 17, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

README

Read the full README ↗

dsh-desktop

中文 | English

License: MIT Electron dsh Platform Build awesome-dsh-plugin

English summary · An Electron desktop shell for DeepSeek Harness (dsh web) on Windows — double-click to run the harness in a standalone window. Region screenshot to ask AI, system tray, session manager, auto environment setup. Full English docs: README.en.md

DeepSeek Harness 的 Electron 桌面壳：双击图标，一个独立窗口运行 dsh web —— 不用开终端、不用敲命令、不用切浏览器。

纯壳，不改动 dsh 本身。服务端复用全局安装的 @deepseek-ai/dsh。

✨ 特性

  • 📸 选区截图提问：一键截屏 → 全屏遮罩实时框选（GPU 加速、8 方向手柄微调）→ 自动粘贴到聊天框 → AI 直接看图回答；截图时自动隐藏聊天窗口
  • 🗂️ 会话管理：Alt → 文件 → 会话管理… 列出所有会话，一键删除（永久清理聊天记录）
  • 🪟 独立窗口：原生桌面窗口加载 Harness Web UI，可最小化到任务栏
  • 🍱 系统托盘：关窗口最小化到托盘常驻，右键菜单可随时显示/退出
  • 🔄 便捷刷新：F5 / Ctrl+R / 右下角悬浮按钮，加载新插件不用重启窗口
  • 🧭 环境自动引导：首次启动自动检测 Node.js / dsh，缺失时引导一键安装，小白也能搞定
  • 🔧 可换端口：npm start -- --port 3081 解决端口占用
  • 🧠 智能复用：检测到已有的 dsh 服务就直接复用，不重复启动
  • 🧹 干净退出：关窗口只杀自己启动的 dsh 进程，绝不误杀外部服务
  • 🔒 单实例锁：防止双开冲突
  • 🎨 安全加固：contextIsolation + sandbox + 禁用 Node 集成，外部链接走系统浏览器
  • 📦 一键安装包：npm run dist 生成 NSIS 安装程序

原理

  1. 启动时探测 127.0.0.1:3080 是否已有 dsh 服务；
  2. 没有 → 自动执行 dsh web --port 3080（日志在 %APPDATA%/DeepSeek Harness Desktop/dsh.log）；
  3. 就绪后打开 Electron 窗口加载 Web UI；
  4. 关窗口 → 自动杀掉由本壳启动的 dsh 进程树（手动起的外部服务不会被误杀）。

📸 选区截图提问

  1. 点右下角 📸（聊天窗口自动隐藏）
  2. 全屏遮罩上拖动框选区域（实时显示，画完可拖 8 个手柄微调）
  3. 点 ✔ 确定（或双击 / 回车）→ 聊天窗口恢复
  4. 截图自动进入聊天框 → 输入问题 → AI 看图回答

配合 ModLens 等识图插件，DeepSeek 文本模型也能看懂图片。

前提

  • Node.js ≥ 22（v24 验证通过）
  • 全局安装 dsh：npm i -g @deepseek-ai/dsh（0.1.0-rc.6 验证通过）
  • 如需覆盖 dsh 路径，设置环境变量 DSH_BIN（例如指向源码构建的 apps/cli/src/bin.ts）

安装与运行

cd Desktop\deepseek_work\dsh-desktop
npm install
npm start

国内网络下 Electron 二进制下载可能很慢或失败，用镜像：

set "ELECTRON_MIRROR=https://cdn.npmmirror.com/binaries/electron/"
npm install

换端口（3080 被占用时）：

npm start -- --port 3081

首次打开后：设置 → 模型 → 填入 DeepSeek API Key，然后选择工作区即可使用。

打包成安装程序

npm run dist

产物在 release/ 下：dsh-desktop--setup.exe（NSIS 安装包）。

自定义图标：放一个 assets/icon.ico（≥256×256），并在 package.json 的 build.win 里加 "icon": "assets/icon.ico"。

常见问题

  • 启动失败弹窗：看 %APPDATA%/DeepSeek Harness Desktop/dsh.log；确认 dsh --version 可用。
  • 端口被占：用 npm start -- --port 换一个端口即可。
  • 改了 dsh 版本：重新 npm i -g @deepseek-ai/dsh 即可，壳无需改动。
  • 截图没进聊天框：点一下输入框按 Ctrl+V（截图已在剪贴板）。
  • 关闭窗口后应用还在：正常！它最小化到托盘了，右键托盘图标选"退出"。

贡献

欢迎提 Issue 和 PR！项目很小，代码都在 src/ 里，容易上手。

License

MIT