Windows 桌面客户端LQing2018/dsh-desktop-client

🐳 适用于 Windows 的 DeepSeek Harness（桌面版）

DeepSeek Harness 的 Windows 桌面客户端 —— 无需安装 Node.js / npm / 任何服务，双击即用。

English · 中文

⚠️ 平台说明：仅支持 Windows
本客户端仅支持 Windows 10/11（64 位），macOS / Linux 无法使用。

💡 Mac 用户替代方案：官方 DSH 本身是跨平台的 -- 终端运行 npx dsh web，浏览器打开 http://127.0.0.1:3080，功能完全相同。

这是什么

DeepSeek Harness 官方提供的是浏览器 Web 版与命令行版；本项目的定位就是它的 Windows 桌面版：同一个 DSH，装进原生 Windows 窗口，把整个运行环境（Node 运行时 + DSH 服务端 + 界面）打包在一起，开箱即用。

把 DeepSeek Harness 的本地 Web UI 装进一个原生 Windows 窗口，并把整个运行环境（Node 运行时 + DSH 服务端 + 界面）打包在一起：

- 普通用户：下载 → 双击 → 填写 API Key → 开始使用，全程不需要碰命令行
- 插件：配套的 @lqing2018/dsh-desktop-client 插件让 agent 能帮你定位、启动桌面客户端

功能特性

| 特性 | 说明 |
|---|---|
| ⚡ 免安装免依赖 | node 运行时、服务端、界面全打包，无需安装 Node.js / npm / 任何服务 |
| 📦 两种形态 | 单文件安装器（推荐）或绿色便携版（U 盘可带） |
| 🔧 服务自管理 | 客户端自动拉起隐藏的后台服务，端口冲突自动规避 |
| 🐳 原生窗口 | WebView2 内核 + 鲸鱼图标，无浏览器边框 |
| 🤖 配套插件 | agent 可通过 desktop_client 工具检测/启动客户端 |

快速开始（2 分钟）

方式 A：单文件安装器（普通用户推荐）

🇨🇳 国内用户：GitHub 可能无法直连，请从 Gitee 镜像下载：
https://gitee.com/fallfeeling/dsh-desktop-client/releases/download/v0.1.0/DeepSeek-Harness-Setup.exe

1. 打开 Releases，下载 DeepSeek-Harness-Setup.exe
2. 双击运行 → 自动解压到 %LOCALAPPDATA%\DeepSeek-Harness-Portable 并启动客户端
3. 首次启动需 30~60 秒初始化本地服务（属正常现象），请稍等
4. 在窗口右上角 设置（齿轮）→ Models 填入你的模型 API Key（如 DeepSeek API）
5. 🎉 开始对话。以后每次启动都是秒开

方式 B：绿色便携版（U 盘 / 免安装）

1. 下载 DeepSeek-Harness-Portable.zip
2. 解压到任意位置（U 盘、移动硬盘都可以）
3. 双击文件夹里的 DeepSeek Harness.exe，步骤同上

环境要求：Windows 10 / 11（64 位），带 WebView2 Runtime（新版 Edge / Win11 自带；缺失时 点此安装）

首次使用详细步骤

1. 下载：见上方「快速开始」
2. 启动：双击后出现鲸鱼图标窗口；首次启动会先初始化本地服务（右下角托盘无窗口时耐心等待，窗口自动出现）
3. 配置密钥：点击窗口右上角 设置（齿轮图标）→ Models，添加模型并填入 API Key（DeepSeek、OpenAI 兼容等均可）
4. 开始使用：在输入框直接对话；支持长任务后台运行、多会话管理

详细图文版见 用户指南

日常使用

| 操作 | 方法 |
|---|---|
| 打开客户端 | 双击桌面快捷方式 / 安装目录下的 DeepSeek Harness.exe |
| 关闭窗口 | 点窗口 ✕ —— 服务会继续在后台运行（长任务不中断） |
| 完全停止服务 | 双击安装目录下的 stop-server.cmd（只结束客户端拉起的服务，不误伤其他程序） |
| 换端口 | 在安装目录新建 client.json，内容 {"port": 1234} |
| 数据在哪 | 会话记录在 dsh-home\sessions，API Key 在 dsh-home 内（请勿分享整个目录） |
| 移动/备份 | 整个文件夹可复制移动；移动后删除一次 dsh-home 即可自动重建 |

配套插件

让 DeepSeek Harness 的 agent 能直接操作桌面客户端（检测 / 启动 / 自动安装 / 升级）：

安装插件（在已运行 dsh web 的机器上）
dsh plugin --profile web add @lqing2018/dsh-desktop-client

安装后，在对话里直接说：

| 你说 | agent 会做什么 |
|---|---|
| "桌面客户端装了吗？" | status：检测安装状态与服务端口 |
| "帮我打开桌面客户端" | launch：启动客户端窗口 |
| "帮我安装桌面客户端" ⭐ | install：自动下载最新 Release 静默安装并启动（全程无需你动手） |
| "客户端有新版本吗？" | version：对比本地版本与 GitHub 最新 Release |
| "升级桌面客户端" | update：自动升级到最新版 |

网络不佳时 install 会优雅失败，并附上手动下载链接。

不想装 npm 插件？ 本仓库还提供文件系统 Skill 形态（免 npm）：

git clone https://github.com/LQing2018/dsh-desktop-client.git
Copy-Item -Recurse dsh-desktop-client\skills\dsh-desktop-client "$env:USERPROFILE\.dsh\skills\"

之后在 DSH 对话里说「启动 dsh-desktop-client skill」即可获得同样的能力。

常见问题

| 问题 | 解决方法 |
|---|---|
| 双击没反应 / 白屏 | 确认已装 WebView2 Runtime；关闭杀毒软件拦截后重试 |
| 首次启动很久 | 正常，首次要初始化本地服务（30~60 秒），之后秒开 |
| 端口被占用 | 按上文「换端口」改 client.json |
| 移动文件夹后启动失败 | 删除一次 dsh-home 文件夹，重新启动会自动重建 |
| 忘了 API Key / 想换账号 | 设置 → Models 重新填写即可 |
| 怎么升级到新版本 | 装了插件直接说「升级桌面客户端」；或重新下载运行 Setup 安装器（自动覆盖安装） |
| 想彻底卸载 | 见下节 |

卸载

- 安装器版：删除 %LOCALAPPDATA%\DeepSeek-Harness-Portable 整个文件夹
- 绿色版：删除解压出来的整个文件夹
- 插件：dsh plugin --profile web remove @lqing2018/dsh-desktop-client

文档索引

| 文档 | 内容 |
|---|---|
| 用户指南 | 安装、配置、日常使用、排查（详细图文步骤） |
| User Guide (English) | 英文版用户指南 |
| PUBLISH.md | 开发者：发布流程（npm / GitHub / 插件市场） |

开发者

从本地 DeepSeek Harness 安装构建便携客户端目录
.\scripts\build-portable.ps1 -Source D:\path\to\deepseek-harness -OutDir .\dist

- plugin/dsh-desktop-client/ — npm 插件源码（纯 ESM，零构建）
- scripts/build-portable.ps1 — 便携目录构建脚本
- 客户端本体（WebView2 C# 源码）在 dist/ 与 client 分支文档 中维护

与官方项目的关系

本项目基于 deepseek-ai/deepseek-harness 构建，官方项目提供核心智能体能力、插件系统与 Web UI；本项目负责 Windows 桌面封装（窗口、本地服务托管、免安装打包）与配套的客户端管理插件。

Star History

许可证

MIT