DeepSeek Harness Desktop

Unofficial macOS desktop wrapper for the DeepSeek Harness web UI. It runs Harness in a native WebKit window instead of opening a standalone browser.

DeepSeek Harness 的非官方 macOS 桌面套壳应用。它使用原生 WebKit 窗口运行 Harness Web UI，无需单独打开浏览器。

This is an independent community project and is not affiliated with, sponsored, or endorsed by DeepSeek AI.

本项目为独立社区项目，与 DeepSeek AI 没有隶属、赞助或官方认可关系。

English

Features

• Native macOS window for the Harness Web UI
• Supports the official npm package and a local source checkout
• Stops only the server process started by this app when the app closes
• Reuses an already-running Harness server without taking ownership of it
• Includes a reusable build script and app icon

Requirements

• macOS
• Swift and macOS Command Line Tools (only needed to build the wrapper)
• Node.js and npm/npx (for the official package mode), or Node.js and pnpm (for source mode)

This wrapper does not include DeepSeek Harness source code, dependencies, or build outputs. Install or prepare DeepSeek Harness separately using the official installation instructions.

Use

Open /Applications/DeepSeek Harness.app from Applications or Launchpad. On the first launch, choose one of the supported modes:

• Official npm package: runs the official package with npx --yes @deepseek-ai/dsh web.
• Source checkout: choose the Harness source folder; the app runs pnpm dsh web there.

The app checks http://127.0.0.1:3080 and shows the Web UI in its own window. The selection is saved in:

~/Library/Application Support/DeepSeek Harness/config.json

To change the mode or folder later, use Configure Harness... from the app menu.

Source mode runs:

pnpm dsh web

If the app started the server, closing the app also stops that server and its child processes. If Harness was already running, it is left untouched.

Configuration

The app creates the configuration after you choose a mode. You can also create it manually from config.example.json at:

~/Library/Application Support/DeepSeek Harness/config.json

For source mode, set the checkout path. For either mode, set host and port without changing or rebuilding the wrapper:

{
  "launchMode": "sourceCheckout",
  "harnessDirectory": "~/Desktop/code/harness",
  "host": "127.0.0.1",
  "port": 3080
}

Install The App

The repository currently ships the wrapper source and build script rather than a prebuilt .app binary. To install it locally:

1. Install the macOS Command Line Tools and Node.js.
2. Prepare DeepSeek Harness using the official installation instructions.
3. Clone and build this wrapper:

git clone https://github.com/LiuMengxuan04/deepseek-harness-desktop.git
cd deepseek-harness-desktop
./build-app.sh

The script compiles the native wrapper, embeds the app icon, signs it locally, and installs /Applications/DeepSeek Harness.app. Open it from Applications or Launchpad, then choose either the official npm package mode or your local source checkout on first launch.

Build And Install (From An Existing Checkout)

cd /Users/liumengxuan/Desktop/code/deepseek-harness-app
./build-app.sh

The script compiles the wrapper, embeds DeepSeekHarness.icns, signs the app locally, and installs it to /Applications/DeepSeek Harness.app.

中文

功能

• 使用原生 macOS 窗口显示 Harness Web UI
• 支持官方 npm 发布包和本地源码两种方式
• 关闭应用时只停止由本应用启动的服务进程
• 如果 Harness 已经运行，则复用现有服务，不接管也不停止
• 提供可重复执行的构建脚本和应用图标

环境要求

• macOS
• Swift 和 macOS Command Line Tools（仅重新构建套壳应用时需要）
• Node.js 以及 npm/npx（官方发布包模式），或 Node.js 以及 pnpm（源码模式）

本套壳项目不包含 DeepSeek Harness 源码、依赖或构建产物。请先按照 官方安装说明 准备 Harness。

使用方式

在“应用程序”或 Launchpad 中打开 /Applications/DeepSeek Harness.app。首次打开时，请选择一种方式：

• 官方 npm 发布包：执行 npx --yes @deepseek-ai/dsh web。
• 源码目录：选择 Harness 源码目录，应用在该目录执行 pnpm dsh web。

应用会检查 http://127.0.0.1:3080，并在自己的窗口中显示 Web UI。选择结果会保存到：

~/Library/Application Support/DeepSeek Harness/config.json

以后可从应用菜单的“Configure Harness...”重新选择方式或目录。

源码模式执行：

pnpm dsh web

如果服务由本应用启动，关闭应用时也会停止该服务及其子进程；如果 Harness 原本已经在运行，则不会停止它。

配置方式

应用首次选择方式后会自动创建配置文件。也可以参考 config.example.json，手动创建：

~/Library/Application Support/DeepSeek Harness/config.json

源码模式可自定义 Harness 目录；两种模式都可自定义主机和端口：

{
  "launchMode": "sourceCheckout",
  "harnessDirectory": "~/Desktop/code/harness",
  "host": "127.0.0.1",
  "port": 3080
}

安装应用

本仓库目前提供套壳源码和构建脚本，不直接提交预编译的 .app 文件。安装步骤如下：

1. 安装 macOS Command Line Tools 和 Node.js。
2. 按照 官方安装说明 准备 DeepSeek Harness。
3. 克隆并构建套壳应用：

git clone https://github.com/LiuMengxuan04/deepseek-harness-desktop.git
cd deepseek-harness-desktop
./build-app.sh

脚本会编译原生套壳程序、嵌入应用图标、进行本地签名，并安装到 /Applications/DeepSeek Harness.app。之后在“应用程序”或 Launchpad 中打开它，首次启动时选择官方 npm 发布包模式或本地源码模式。

构建与安装（已有仓库目录）

cd /Users/liumengxuan/Desktop/code/deepseek-harness-app
./build-app.sh

脚本会编译套壳程序、嵌入 DeepSeekHarness.icns、进行本地签名，并安装到 /Applications/DeepSeek Harness.app。

License / 许可证

This wrapper is released under the MIT License. The DeepSeek Harness project and its assets remain subject to their respective licenses.

本套壳项目采用 MIT 许可证。DeepSeek Harness 项目及其资源遵循各自的许可证。