dsh-desktop

DeepSeek Harness 的 Windows 桌面启动器:.NET 10 WPF + WebView2,独立进程托管 dsh 服务,托盘管理,标题栏深浅色跟随系统。

特性

• 🪟 WPF + WebView2,HiDPI — PerMonitorV2 感知,多显示器不同缩放比例下自动适配;窗口约 50–150MB,关窗即释放
• ⚙️ 独立进程托管 dsh — dsh 服务由壳用独立进程拉起,不依赖 vbs 等脚本;意外退出自动重启(节流防循环)
• 🖥️ 系统托盘 — 右键托盘菜单可随时 启动 / 重启 / 停止 dsh 服务;关窗隐藏到托盘,服务常驻
• 🎨 原生标题栏深浅色 — 自动跟随 Windows 深浅色主题,无需手动切换
• 🚀 开机自启 — 托盘菜单一键开启(仅当前用户,--minimized 静默启动不弹窗)
• 🔌 自动拉起 — 服务没开时自动启动并等待就绪;就绪后窗口自动加载
• 🔎 环境检测 — 启动时在窗口与日志中显示一行"已安装/未安装":Node.js、npm、dsh;Node.js 缺失时直接提示安装,不再只报笼统的"未能就绪"
• 📋 日志 — %USERPROFILE%\.dsh-desktop.log

安装 / 运行

需要 .NET Desktop Runtime 10(winget install Microsoft.DotNet.DesktopRuntime.10)与 WebView2 Runtime(Windows 10/11 自带)。

dsh 不必全局安装:启动器优先用 PATH 中的 dsh,否则自动回退 npx -y @deepseek-ai/dsh。

换 npm 镜像(可选):npx 回退下载过慢时,设置环境变量 DSH_NPM_REGISTRY 即可免改代码换源:

$env:DSH_NPM_REGISTRY = "https://registry.npmmirror.com"
DshDesktop.exe

从源码构建

git clone https://github.com/mrbbbaixue/dsh-desktop.git
cd dsh-desktop
dotnet test                        # 单元测试(ShellLogic 策略)
./scripts/publish.ps1              # 打包:zip + SHA256(框架依赖单文件,约 2.3MB)
./scripts/publish.ps1 -SelfContained   # 自包含单文件(内置 .NET 运行时,约 175MB,免装运行时)

单文件发布配置已固化在 DshDesktop.csproj(WebView2Loader.dll 与托管依赖一并嵌入,发布目录只有一个 exe)。产物在 dist\:

• dsh-desktop-<版本>-win-x64-framework-dependent.zip — 默认,需 .NET Desktop Runtime 10
• dsh-desktop-<版本>-win-x64-self-contained.zip — 免装运行时,仅需 WebView2 Runtime(Windows 10/11 自带)

常见问题

Q:双击没反应? 查看日志 %USERPROFILE%\.dsh-desktop.log,确认 Node.js 已安装。

Q:提示缺少 .NET Desktop Runtime? 执行 winget install Microsoft.DotNet.DesktopRuntime.10 后重试。

Q:窗口一直显示"正在启动 dsh 服务…"? 等待页下方有一行环境检测(如 Node.js 已安装 (v22.14.0) · npm 已安装 · dsh 未安装(将自动用 npx 启动))。若显示 Node.js 未安装,请先安装 Node.js 后从托盘菜单重试。服务 90 秒内未就绪(常见于 npx 首次下载慢)时,壳会在后台继续等待,下载完成会自动加载页面;也可设置 DSH_NPM_REGISTRY 镜像后,托盘菜单「重启 dsh 服务」。

Q:网页里"选择目录"报 directory picker failed: spawn C:\Program Files\nodejs\node.exe ENOENT? 通常是残留的旧 dsh 进程占着 3080 端口(例如升级 Node.js 前的 32 位旧服务,spawn 位数不匹配的新 node.exe 会报 ENOENT)。托盘菜单「重启 dsh 服务」即可:壳会结束占用端口的残留 dsh 进程并重新拉起(仅清理命令行确认是 dsh 的进程,其它占用端口的进程会跳过并记入日志,避免误杀)。确认 Node.js 已安装后重试。

环境变量

变量	作用
DSH_WEB_URL	覆盖目标地址(默认 http://127.0.0.1:3080);设置后视为外部托管服务,壳不再自动拉起/停止 dsh
DSH_NPM_REGISTRY	指定 npm 镜像源(仅 npx 回退路径生效,如 https://registry.npmmirror.com)

免责声明

本仓库是独立的第三方工具,与 DeepSeek / DeepSeek AI 官方无关。DeepSeek Harness(dsh)是官方项目(MIT)。窗口图标使用了 DeepSeek 品牌标识,版权归 DeepSeek 所有,如构成侵权请联系我删除。

许可证

MIT © mrbbbaixue

---

English

A Windows desktop launcher for DeepSeek Harness: .NET 10 WPF + WebView2, dsh hosted in a managed child process with a system-tray controller, and the native title bar follows the system dark/light theme.

Features

• 🪟 WPF + WebView2, HiDPI — PerMonitorV2-aware, adapts across monitors with mixed scaling; window ~50–150MB, freed on close
• ⚙️ Managed child process — dsh runs as an independent process (no VBS or other script files); auto-restarts on unexpected exit (throttled)
• 🖥️ System tray — right-click to start / restart / stop the dsh service; closing the window hides to tray, the service keeps running
• 🎨 Native title bar theme — automatically follows the Windows dark/light mode
• 🚀 Autostart — one click in the tray menu (current user only, --minimized starts silently)
• 🔌 Auto-launch — starts the service if not running and waits until ready
• 📋 Logging — %USERPROFILE%\.dsh-desktop.log

Requirements

.NET Desktop Runtime 10 and WebView2 Runtime (built into Windows 10/11). Node.js 18+ is required for the dsh service. A global dsh install is optional — the launcher falls back to npx -y @deepseek-ai/dsh automatically; set DSH_NPM_REGISTRY (e.g. https://registry.npmmirror.com) to use a faster npm registry.

Disclaimer & License

Independent third-party tool, not affiliated with DeepSeek / DeepSeek AI. The app icon uses the DeepSeek brand mark, whose copyright belongs to DeepSeek; if this constitutes infringement, please contact me to have it removed. MIT © mrbbbaixue.