桌面托盘客户端donghaoran123/DSH-Desktop

DSH Desktop（DeepSeek Harness 桌面端）

用 C# + WebView2 把 DeepSeek Harness（DSH）打包成 Windows 桌面应用：独立窗口加载本地 DSH Web UI，托盘管理服务器，可选捆绑 node 运行时实现免依赖分发。

仓库地址：

🚀 快速开始（下载即用，无需安装任何东西）

1. 下载

打开  → 右侧 Releases → 点 v0.1.0 → 展开 Assets → 下载 DSH-Desktop-v0.1.0-windows-x64.zip（约 111 MB）。

2. 解压

右键 zip → 全部解压缩（或 7-Zip 解压）。解压后是一个文件夹，里面有 DSH-Desktop.exe 和一个 runtime 文件夹（不要删 runtime，它是内置的服务器运行时）。

3. 运行

双击 DSH-Desktop.exe → 稍等几秒 → 弹出独立应用窗口，加载 DeepSeek Harness 界面（服务器会自动在后台启动）。

4. 日常管理

- 关闭窗口 = 最小化到右下角托盘（鲸鱼图标），服务器继续在后台运行；
- 停止：右键托盘鲸鱼 → 停止服务器并退出（一键关服务器 + 退出程序）；
- 重新打开：再双击 DSH-Desktop.exe 即可。

要求：Windows 10 / 11。无需安装 Node.js，无需任何依赖（运行时已打包；WebView2 内核与 .NET Framework 是 Win10/11 自带的）。

✨ 功能

- 独立桌面窗口（内嵌 WebView2，无需浏览器标签页）
- 自动后台启动 DSH 服务器（隐藏窗口）
- 系统托盘鲸鱼图标：显示窗口 / 停止服务器并退出
- 关闭窗口 = 最小化到托盘，服务器继续运行
- 可选捆绑 node 运行时（build.ps1 -BundleRuntime），自包含可分发
- 工作目录可配置，源码中不含任何本机硬编码路径

🛠 从源码构建（开发者）

前置：Windows 10/11 + Node.js（含 npm）+ git

git clone https://github.com/donghaoran123/DSH-Desktop.git
cd DSH-Desktop
.\build.ps1                # 编译（自动从 NuGet 下载 WebView2 SDK）
.\build.ps1 -BundleRuntime # 需要自包含版时再加这条（下载 DSH 依赖树，需几分钟）

产物在 app\DSH-Desktop.exe（-BundleRuntime 后带 runtime\，即自包含版）。

- 不带 -BundleRuntime 时，应用会尝试使用 PATH 中的 node（或已捆绑的 runtime\node.exe）。
- -BundleRuntime 首次运行需要几分钟（下载 DSH 依赖树），请耐心等待 build OK 输出。

🎯 工作目录（Workspace）

解析顺序（无需配置即可运行，默认用应用所在目录）：

1. --ws  命令行参数
2. DSH_WORKSPACE 环境变量
3. 应用所在目录

⚙️ 隐藏参数（测试/脚本用）

| 参数 | 说明 |
|---|---|
| --ws  | 指定工作目录 |
| --port  | 指定端口（默认 3080） |
| --hidden | 隐藏窗口启动（自动化测试用） |

📦 项目结构

DSH-Desktop/
├─ DesktopApp.cs      # 主程序（窗口 / 托盘 / 服务器管理）
├─ build.ps1          # 一键构建脚本
├─ assets/            # 图标与工具（DSH-Web.ico、pack-ico.ps1、render-icon.js）
├─ app/               # 构建产物（.gitignore 排除）
└─ libs/              # 下载的 WebView2 SDK（.gitignore 排除）

❓ 常见问题

| 问题 | 答案 |
|---|---|
| 双击没反应 / 提示"未知发布者" | Windows SmartScreen 对未签名程序会警告，点 "更多信息 → 仍要运行"；首次启动稍慢 |
| 用什么端口 | 默认 3080；已被占用时会直接打开已有页面，不会重复启动 |
| 想换工作目录 | 设置环境变量 DSH_WORKSPACE（指向你的项目目录），或用启动参数 --ws 目录 |
| 服务器在哪停 | 托盘右键"停止服务器并退出"，或任务管理器结束 node.exe |
| 为什么包这么大 / 文件这么多 | 自包含版捆绑了 DSH 的 542 个 npm 依赖包（node_modules），这是"下载即用"的代价；构建版（方式二）则只有几 MB 源码 |
| 换图标 / 改行为 | 源码在 DesktopApp.cs，改完 .\build.ps1 重新编译 |

致谢

- DeepSeek Harness（MIT）—— 底层 Agent 框架
- 应用图标为 DeepSeek 品牌鲸鱼素材
- WebView2 SDK —— Microsoft

许可

MIT License，见 LICENSE。