Windows 桌面客户端 ding7015869-alt/dsh-web-desktop

双击即用：把 DeepSeek Harness Web UI 装进原生 Windows 窗口。
English · 简体中文

下载 DSH-Web.exe
· 快速开始
· 常见问题

[!IMPORTANT]
DSH-Web Desktop 是独立的社区包装器，并非 DeepSeek 官方产品。DeepSeek Harness 当前仍处于开发者预览阶段，上游更新可能带来兼容性变化。

它解决了什么问题？

在 Windows 上使用 DeepSeek Harness 源码版，通常需要打开终端、手动启动 dsh web、保持终端窗口常驻，并在退出时自行管理后台进程。DSH-Web Desktop 把这一套操作变成真正的桌面体验：

- 双击启动：静默拉起本地网关，并在一个窗口中直接打开界面。
- 无需 Git 的首次引导：显示进度下载 DeepSeek Harness 官方 ZIP，自动解压并安装依赖。
- 失败可恢复：下载失败时可自动回退 Git；缺少 Node.js 会打开官网引导，安装后直接重试，无需重启程序。
- 完整 Web UI：使用 Edge WebView2，保留插件、设置、链接与下载能力。
- 系统托盘：最小化或关闭窗口后继续后台运行，双击鲸鱼图标即可恢复。
- 干净退出：使用 Windows Job Object 管理子进程，退出时不留残余服务。
- 端口复用：目标端口已有服务时直接连接，不重复启动。
- 纯本地包装器：本项目本身没有遥测或数据上传代码。

界面展示

展示图由真实 Windows 截图制作；次要窗口中的私人会话标题已替换为中性占位条。

Windows 实机截图

托盘驻留桌面图标

以上素材来自用户提供的 v1.3.x Windows 实机截图。上游仍在快速迭代，内嵌 Web UI 可能变化。

启动体验

本地网关启动期间会显示动态鲸鱼和进度文字。首次启动根据机器性能和依赖状态，可能需要 20–60 秒。

快速开始

环境要求

| 依赖 | 说明 |
| Windows | Windows 10/11 x64 |
| WebView2 | Windows 11 自带；Windows 10 可从微软官网下载 |
| Node.js | 18+，需加入 PATH，也可在配置中指定 nodeExe |
| DeepSeek Harness | 启动前可以完全没有；v1.3.2 会自动下载并安装官方源码 |

最快使用方式

1. 下载 DSH-Web.exe。
2. 直接双击运行——电脑里可以完全没有 DeepSeek Harness。
3. 检测到未安装时，选择【是】并选一个目录，客户端会自动下载并安装。

v1.3.2 真实首次运行截图：启动前电脑里没有 DeepSeek Harness，客户端正在自动下载官方源码包。

如果没有检测到有效源码目录，首次引导会提供三种选择：

1. 【是】自动安装：检查 Node.js，选择安装位置，显示进度下载官方 ZIP，自动解压并安装依赖；不要求预装 Git。若下载失败且电脑已有 Git，会自动回退到浅克隆。
2. 【否】我已安装：扫描固定磁盘，列出兼容的源码目录供你选择。
3. 【取消】：不做修改，直接退出。

手动安装 DeepSeek Harness

请以官方仓库的最新说明为准：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build

完成后，把 DSH-Web.exe 复制到该目录并双击运行。上游兼容性变化请关注 DeepSeek Harness 官方仓库。

配置文件

将 dsh-web.config.json.example 复制为 EXE 同目录下的 dsh-web.config.json：

{
"port": 3080,
"workDir": "D:\\DeepSeek-Harness",
"nodeExe": "C:\\Program Files\\nodejs\\node.exe"
}

| 字段 | 说明 | 默认值 |
| port | 本地 Web UI 端口；命令行 --port 优先 | 3080 |
| workDir | DeepSeek Harness 源码根目录 | EXE 所在目录 |
| nodeExe | node.exe 的绝对路径 | PATH 中第一个 node.exe |

命令行示例：

./DSH-Web.exe --port 3090

工作原理

flowchart LR
A["双击 DSH-Web.exe"] --> B{"目标端口已监听?"}
B -- 是 --> E["连接已有本地界面"]
B -- 否 --> C["后台静默启动 dsh web"]
C --> D["等待 127.0.0.1:端口"]
D --> E
E --> F["WebView2 原生窗口渲染"]
F --> G["托盘驻留 / 浏览器备用入口"]
G --> H["退出时清理子进程"]

从源码构建

安装 .NET SDK 9.0：

cd src
dotnet restore
dotnet publish DSHWebApp.csproj -c Release -o ./out

产物是 Windows x64 自包含单文件 EXE，不要求目标机器安装 .NET。仓库中的 GitHub Actions 会在每次推送和 Pull Request 时自动构建。

隐私、安全与校验

- 包装器本身不包含遥测或统计代码。
- 程序打开的服务地址固定为 127.0.0.1。
- 日志写入 EXE 同目录：dsh-web.out.log、dsh-web.err.log、dsh-web.crash.log。
- 只有用户主动选择“自动安装”后，程序才会下载官方上游源码包并安装 npm 依赖；Git 仅在官方下载失败且电脑已有 Git 时作为回退。
- 每个 Release 都附带 SHA256SUMS.txt，建议下载后核对。
- 安全问题请按 SECURITY.md 中的方式报告。

常见问题

提示“未找到 dsh 源码入口”

把 EXE 放到 DeepSeek Harness 仓库根目录，使用首次运行引导，或在 dsh-web.config.json 中设置 workDir。

提示“未找到 Node.js”

安装 Node.js 18+ 并加入 PATH，或在配置文件中填写 nodeExe 的绝对路径。

最小化后窗口不见了

程序已经进入 Windows 系统托盘。双击鲸鱼图标恢复；右键菜单包含“显示窗口”“在浏览器中打开”和“退出”。

端口被占用为什么没有报错？

如果目标端口已在监听，DSH-Web 会认为已有兼容的本地服务运行，并直接连接，避免重复启动。

致谢与许可

- DeepSeek Harness 由 DeepSeek AI 开发，并以其自身 MIT 许可发布。
- app.ico 来自 DeepSeek Harness 仓库，版权归原作者所有。
- 本社区包装器以 MIT License 开源。

如果这个客户端让你的 DeepSeek Harness 更顺手，欢迎点一个 ⭐ 支持持续更新。