dsh-desktop

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-desktop

[中文](README.md) | [English](README.en.md)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Electron](https://img.shields.io/badge/Electron-43-blue)](https://www.electronjs.org/)
[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.6-purple)](https://github.com/deepseek-ai/deepseek-harness)
[![Platform](https://img.shields.io/badge/Platform-Windows-0078D6)]()
[![Build](https://github.com/ReachGa0/dsh-desktop/actions/workflows/build.yml/badge.svg)](https://github.com/ReachGa0/dsh-desktop/actions)
[![awesome-dsh-plugin](https://img.shields.io/badge/awesome--dsh--plugin-listed-8A2BE2)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)

> **English summary** · An [Electron](https://www.electronjs.org/) desktop shell for [DeepSeek Harness](https://github.com/deepseek-ai/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](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 演示](docs/demo/screenshot-ask.gif)

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

> 配合 [ModLens](https://www.npmjs.com/package/@liustack/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`）

## 安装与运行

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

> 国内网络下 Electron 二进制下载可能很慢或失败，用镜像：
> ```sh
> set "ELECTRON_MIRROR=https://cdn.npmmirror.com/binaries/electron/"
> npm install
> ```

**换端口**（3080 被占用时）：

```sh
npm start -- --port 3081
```

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

## 打包成安装程序

```sh
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](LICENSE)