DeepSeek-Harness-Desktop README

The project's README from github.com/XinXie-Condex/DeepSeek-Harness-Desktop. As one markdown file: README.md.

DeepSeek Desktop

把 DeepSeek Harness Web UI 打包成原生桌面应用,同时支持 macOS 与 Windows 双平台。 无需浏览器、无需手动配置环境:应用内置 Node 运行时与 dsh 包,双击即用, 自动拉起本地服务,用原生 WebView 承载完整界面。

✨ 特性(双版本一致)

💻 平台支持

平台 技术栈 安装包 系统要求
macOS Swift + SwiftUI + WKWebView .dmg(拖入即装) Apple Silicon,macOS 15+
Windows C# WPF + WebView2 .exe 安装器 / .zip 绿色版 Windows 10/11 x64

⬇️ 下载安装

两个版本都发布在 GitHub Releases: https://github.com/XinXie-Condex/DeepSeek-Harness-Desktop/releases

macOS

  1. 下载最新的 DeepSeek.Harness.dmg
  2. 双击挂载,把 DeepSeek.app 拖入「应用程序」
  3. 首次打开若提示「无法验证开发者」:右键 →「打开」即可(本地 ad-hoc 签名,属正常现象)

Windows

  1. 下载 DeepSeek-Setup-1.0.2.exe(安装向导,推荐)或 DeepSeek-Windows.zip(绿色版)
  2. 安装向导:一路 Next 即可;绿色版:解压后双击 DeepSeek.exe
  3. 需要系统已安装 Microsoft Edge WebView2 Runtime(Windows 10/11 一般已自带)

🚀 使用

🧩 安装插件

桌面版与命令行 dsh 共用 web profile 的插件体系,给 web profile 安装的插件会被桌面版加载。

完整教程见:PLUGINS.md

🛡️ 防篡改

🔧 从源码构建

macOS(本机构建)

./make-icon.sh          # 生成图标(只需一次)
./build.sh              # 编译 + 捆绑运行时 + 签名 + 出 DMG
./build.sh --install    # 并安装到 /Applications

需要:Xcode 命令行工具 + Node.js。

Windows(自动构建 / 本地构建)

windows/ 目录为 Windows 版源码(C# WPF + WebView2),构建已完全自动化:

📁 目录结构

Sources/         macOS 版 Swift 源码
Resources/       macOS 版资源(图标、启动素材)
windows/         Windows 版 C# WPF 源码(详见 windows/README.md)
.github/         GitHub Actions 流水线(自动构建 + 自动发布)

📦 数据

会话、凭据等数据与命令行 dsh 共用:

🤝 参与

DeepSeek-Harness-Desktop (XinXie-Condex/DeepSeek-Harness-Desktop)

Searching Database…

What is this?DeepSeek Desktop packages the DeepSeek Harness Web UI into a native desktop app for macOS and Windows. It bundles its own Node.js runtime and the 'dsh' package, so it starts a local server and opens the full interface in a native WebView without any manual setup.
Is this a browser bookmark or a real native app?It is a real native app: the macOS build uses Swift + SwiftUI + WKWebView, and the Windows build uses C# WPF + WebView2, both wrapping the same DeepSeek Harness web interface.
Do I need to install Node.js myself before running it?No. The app bundles its own Node.js runtime and the dsh package. On Windows you just need the Microsoft Edge WebView2 Runtime, which usually ships with Windows 10/11 already.
Will macOS block it as an unidentified developer app?Yes, since it's locally ad-hoc signed rather than notarized, macOS shows a 'can't verify developer' warning on first launch — right-click and choose Open to get past it.
Does it run on Intel Macs too?No, the macOS build requires Apple Silicon and macOS 15 or later; the Windows build requires Windows 10/11 x64.
Does it check for tampering on startup?Yes, it verifies the SHA256 hashes of key files (app config, icons, launch assets, dsh startup script) and refuses to start if any don't match the original build.
Can I install plugins for it?Yes, it shares the same plugin system as the command-line dsh web profile, so any plugin installed for the web profile is automatically loaded by the desktop app.
Can I change the port it runs on?Yes, it defaults to port 3080 but this can be changed with the DSHDESKTOPPORT environment variable.
What happens if a server is already running when I open it?It detects and reuses the already-running local server instead of starting a duplicate, and when you quit it only cleans up the services it started itself, leaving other processes untouched.
Size
0.2 MB
Stars
235
Age
2mo
Commits · 90 Days