dsh-desktop (plugin)
reachga0/dsh-desktop/plugin
대화에서 Windows Electron 셸을 실행하는 DSH 플러그인(dsh-desktop-launcher)입니다. 두 번 클릭하면 DSH Web을 독립 창에서 실행합니다. GPU 가속 영역 선택 스크린샷을 채팅에 자동 붙여넣기(비전 브리지와 호환), 시스템 트레이, 세션 관리자, 자동 환경 설정, 포트 설정, 단일 인스턴스 잠금을 제공합니다.
설치
dsh plugin --profile web add github:reachga0/dsh-desktop이 플러그인은 저장소의 plugin 하위 디렉터리에 있습니다.
README
dsh-desktop
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 直接看图回答;截图时自动隐藏聊天窗口
- 🔌 远程连接(可选):DSH 跑在 NAS / Docker / 内网服务器?在连接页填地址即可;局域网 IP 自动补
http、域名自动补https,服务器离线自动回连接页(可选每 8 秒重试),不影响本机默认体验 - ⬆️ DSH 一键更新(本机模式):托盘「检查 DSH 更新」→ 确认后自动
npm install -g→ 重启托管的 dsh 进程 → 自动重连,全程不用开终端 - 🗂️ 会话管理:
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 安装程序
原理
- 启动时探测
127.0.0.1:3080是否已有 dsh 服务; - 没有 → 自动执行
dsh web --port 3080(日志在%APPDATA%/DeepSeek Harness Desktop/dsh.log); - 就绪后打开 Electron 窗口加载 Web UI;
- 关窗口 → 自动杀掉由本壳启动的 dsh 进程树(手动起的外部服务不会被误杀)。
🔌 远程连接(可选)
DSH 不一定要跑在本机。首次启动会出现连接页:
- 💻 本机连接(默认):完全走上面的本地流程——探测 3080、没有则自动启动 dsh、缺失环境走引导安装
- 远程地址:DSH 跑在 NAS(Docker)、内网服务器等,直接填
https://你的域名或http://192.168.x.x:3080- 局域网 IP / loopback 自动补
http://,域名自动补https:// - 连接地址会被记住(
%APPDATA%/DeepSeek Harness Desktop/config.json),下次自动进入 - 服务器离线时回到连接页,可勾选「每 8 秒自动重试」,恢复后自动进入
- 支持 URL 内嵌 Basic Auth(
https://user:pass@host/)与自签名证书(仅限已配置的主机)
- 局域网 IP / loopback 自动补
- 远程模式下自动隐藏本机管理项(会话管理 / 重启服务 / DSH 更新),托盘显示当前服务器
- 随时切换:托盘右键或
Alt → 文件 → 连接设置… - 临时指定(不覆盖已保存地址):
npm start -- --url https://dsh.example.com
⬆️ DSH 一键更新(本机模式)
托盘右键或 Alt → 文件 → 检查 DSH 更新:
- 静默对比本机
dsh --version与 npm 最新版(支持-rc.N等预发布号比较) - 发现新版 → 弹窗确认 → 自动执行
npm install -g @deepseek-ai/dsh@latest - 自动重启本壳托管的 dsh 进程 → 轮询端口就绪 → 自动重连窗口
仅对由本壳启动的 dsh 生效(启动 3 秒后也会静默检查一次)。 复用了外部服务或远程模式时,请在对应环境手动更新。
📸 选区截图提问

- 点右下角 📸(聊天窗口自动隐藏)
- 全屏遮罩上拖动框选区域(实时显示,画完可拖 8 个手柄微调)
- 点 ✔ 确定(或双击 / 回车)→ 聊天窗口恢复
- 截图自动进入聊天框 → 输入问题 → 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即可,壳无需改动;也可以直接用托盘里的「检查 DSH 更新」一键完成。 - 想连远程/NAS 上的 DSH:托盘右键 → 连接设置…,填远程地址即可;本机功能(会话管理、重启服务、DSH 更新)会自动隐藏。
- 截图没进聊天框:点一下输入框按
Ctrl+V(截图已在剪贴板)。 - 关闭窗口后应用还在:正常!它最小化到托盘了,右键托盘图标选"退出"。
贡献
欢迎提 Issue 和 PR!项目很小,代码都在 src/ 里,容易上手。