ReachGa0/dsh-desktop#plugin

DeepSeek Harness 桌面版（Windows）：双击即用，选区截图直接问 AI · 系统托盘、会话管理 · Featured in awesome-dsh-plugin

Bundle verified MIT JavaScript v0.3.0
Bundle verified

Listed

0

Ui

Bundle verified

★ 0 View on GitHub
Versionv0.3.0
LanguageJavaScript
LicenseMIT
View on GitHub

Preview

Preview 1 of 2: ReachGa0/dsh-desktop#plugin
Preview 2 of 2: ReachGa0/dsh-desktop#plugin

What it does

DSH plugin (dsh-desktop-launcher) that launches the dsh-desktop Windows Electron shell from the conversation: double-click to run the DSH web in a standalone window, region screenshot with GPU-accelerated selection that auto-pastes into the chat (works with vision bridges), system tray, session manager, auto environment setup, configurable port, single-instance lock.

Best for

  • Windows users who want to run DSH Web in a standalone Electron window without opening a terminal.
  • People who frequently capture screen regions and paste them into DSH conversations.
  • Users who want tray access, session management, configurable ports, and reuse of an existing DSH service.
  • Workflows using a vision bridge to answer questions about captured screen content.

Not ideal for

  • macOS, Linux, or other non-Windows environments.
  • Machines without Node.js 22 or a globally installed DSH command, unless the required environment is installed first.
  • Users who do not need region capture, tray behavior, or a separate Electron shell.
  • Workflows expecting screenshots alone to give a text-only model vision capability; a compatible vision bridge is still needed.

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 / 右下角悬浮按钮，重新加载 Web UI——前端类插件（皮肤、布局、增强）装完刷新即生效，无需重启应用
  • 🧭 环境自动引导：首次启动自动检测 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 进程树（手动起的外部服务不会被误杀）。

📸 选区截图提问

选区截图直接问 AI 演示

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

配合 ModLens 等识图插件，DeepSeek 文本模型也能看懂图片。 截图同时自动保存到 ~/.dsh/screenshots/（托盘右键可打开目录）。

前提

  • 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

Frequently Asked QuestionsFAQ

Use the verified command dsh plugin --profile default add github:ReachGa0/dsh-desktop#path:/plugin in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.

zhu1090093659/dsh-web-ui#packages/dsh-web-ui-all★ 4,306

Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.

Apache-2.0
omdsh-dev/DSH-better-sidebar★ 2,046

Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.

MIT
ccch1mneyyy/dsh-TUI★ 1,892

Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.

MIT
omdsh-dev/dsh-at-file★ 354

Codex-style `@file` mentions: search workspace files in the composer and attach their contents to prompts.

MIT