frankfika/dsh-desktop-macos

适用于 macOS 和 Windows 的 DSH Desktop

中文说明 · 下载 · 报告问题

一个原生桌面外壳，用于在 macOS 和 Windows 上运行官方
DeepSeek Harness Web UI。它会启动和停止本地 dsh 服务，在
macOS 上使用 WKWebView、在 Windows 上使用 Microsoft Edge WebView2 嵌入 UI，并将运行时日志和常用控件
集中在一个窗口中。

这是一个独立的社区项目。它不是 DeepSeek 的官方产品，
与 DeepSeek 无关联，也未获得其认可。DeepSeek Harness 需从官方 @deepseek-ai/dsh npm 包单独安装。

macOS Quick Install / macOS 快速安装

Install Node.js 22.19+ or 24+, then run this command in Terminal：
先安装 Node.js 22.19+ 或 24+，再在终端运行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/frankfika/dsh-desktop-macos/main/install.sh)"

The open-source installer verifies the GitHub Release SHA-256 before installing and
removes quarantine only from the verified DSH Desktop bundle. It also installs the
official @deepseek-ai/dsh runtime and launches the app.

开源安装器会先校验 GitHub Release 的 SHA-256，再安装应用；它只解除校验通过的 DSH
Desktop 应用隔离属性，同时安装官方 @deepseek-ai/dsh 运行时并启动应用。

Windows Download / Windows 下载

Download the appropriate portable ZIP from
the latest Release:

- DSH-Desktop-Windows-win-x64-.zip for most Intel/AMD Windows computers
- DSH-Desktop-Windows-win-arm64-.zip for Windows on ARM

Extract the ZIP and run DSH Desktop.exe. The Windows build is self-contained, so .NET
does not need to be installed. Node.js 22.19+ or 24+ is still required. If DSH is missing,
click Install official DSH runtime inside the app; it installs the official npm package
to %USERPROFILE%\.dsh\app and starts the service automatically.

从最新 Release 下载对应的 Windows 便携 ZIP，解压后运行 DSH Desktop.exe。大多数
电脑选择 win-x64，Windows ARM 设备选择 win-arm64。应用已包含 .NET 运行时；仍需
Node.js 22.19+ 或 24+。如果没有 DSH，在应用中点击 Install official DSH runtime
即可安装官方 npm 包并自动启动。

Features

- Native SwiftUI + WebKit app with no third-party app dependencies
- Universal binary for Apple Silicon and Intel Macs
- Native Windows 10/11 app using WinForms and Microsoft Edge WebView2
- Self-contained Windows x64 and ARM64 builds with no separate .NET requirement
- Detects an existing healthy dsh web process or starts one automatically
- Start, stop, restart, open in browser, launch at login, and live logs
- Pair a phone by QR code, control the desktop runtime, and use the complete DSH Web UI
through an authenticated local proxy (macOS)
- Detects Homebrew, npm, nvm, WorkBuddy, and the recommended local installation path
- Offers one-click installation of the official @deepseek-ai/dsh runtime when missing
- 在确认本地 HTTP 端点状态异常后，清理无响应的 dsh 进程

要求

- macOS 13 Ventura 或更高版本
- Node.js 22.19+ 或 24+
- 官方 @deepseek-ai/dsh 包

DeepSeek Harness 目前处于开发者预览阶段。它可以运行读取或修改你所选工作区的工具。请从一次性项目开始，使用受限的凭据，并审查审批请求。

安装

先安装 Node.js，然后使用经过验证的社区安装器：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/frankfika/dsh-desktop-macos/main/install.sh)"

安装器会从 GitHub Releases 下载最新的 ZIP，验证其 SHA-256 校验和，安装应用，仅从该应用包中移除隔离属性，安装官方 @deepseek-ai/dsh 运行时，并启动 DSH Desktop。如果你愿意，可以在运行前查看 install.sh。

如果应用是手动安装的且找不到 DSH，其首次运行界面会提供一个 Install official DSH runtime 按钮。该应用会直接调用 npm 而不经过 shell，并将官方包安装到 ~/.dsh/app，然后自动启动服务。

你也可以从 GitHub Releases 下载通用 .dmg 并手动安装。由于该项目尚未拥有 Apple Developer ID 证书，社区构建采用临时签名。手动首次启动时，在 Finder 中按住 Control 键点按该应用，选择 Open，然后确认 Open。

从源码构建

Xcode Command Line Tools 就足够了：

git clone https://github.com/frankfika/dsh-desktop-macos.git
cd dsh-desktop-macos
./build.sh
open ".build/DSH Desktop.app"

从手机控制 DSH（macOS）

1. 打开 DSH Desktop，然后点击工具栏中的 Phone / 手机。
2. 开启移动端远程控制。保持 Mac 和手机连接到同一 Wi-Fi 网络。
3. 用手机扫描二维码。该一次性链接会在手机浏览器中存储一个受保护的配对会话，并立即从地址栏中移除令牌。
4. 移动端仪表板可以启动、停止或重启 DSH 进程。点击 Open complete DeepSeek Harness 即可从手机使用常规的 Harness UI。在 iPhone 上，Safari 的 Add to Home Screen 可使其表现得像一个轻量级配套应用。

DSH 本身仍然仅监听 127.0.0.1。DSH Desktop 在端口 3081 上运行一个单独的桥接，检查每次安装随机生成的配对令牌，并代理 HTTP 和 WebSocket 流量。你可以从桌面应用更改桥接端口或重置所有已配对的手机。若要在离家时访问，请使用加密的专用网络（如 Tailscale）连接 Mac 和手机；不要从公共路由器直接转发端口 3081，因为本地桥接有意使用 HTTP，并依赖可信的局域网或加密覆盖网络。

原生 iPhone 配套应用
该仓库还包含一个位于 ios/ 的原生 SwiftUI 客户端。它提供相机二维码配对、由 Keychain 支持的凭据、原生状态/控制仪表盘、下拉刷新，以及经过身份验证的应用内 Harness 浏览器。

cd ios
./generate.sh
open DSHMobile.xcodeproj

选择 DSHMobile scheme 和你的 iPhone，在 Signing & Capabilities 下选择你的 Apple 开发团队，然后按 Run。在 DSH Mobile 中，扫描 Mac 应用显示的二维码。部署目标为 iOS 17。

原生 Android 配套应用

原生 Android 客户端位于 android/，支持 Android 8.0（API 26）或更高版本。它使用 Google Code Scanner 实现免权限二维码配对，使用 Android Keystore AES-GCM 处理配对凭据，提供原生状态/控制仪表盘，以及用于完整 Harness UI 的经过身份验证的 WebView。

cd android
./build_and_verify.sh
adb install -r app/build/outputs/apk/debug/app-debug.apk

验证脚本会运行单元测试、构建 debug APK，并要求 Android Lint 通过。对于常规安装，请从最新的 GitHub Release 下载已签名的 DSH-Mobile-Android-*.apk。在手机上，打开 DSH Mobile 并扫描 DSH Desktop 显示的同一个二维码。

build.sh 默认生成一个临时签名的通用应用。若仅针对当前架构构建：

ARCHS="$(uname -m)" ./build.sh

使用以下命令创建本地 ZIP 和 DMG 产物：

./scripts/package.sh

推送诸如 v1.2.0 的标签会运行 GitHub Actions 发布工作流，并将通用 macOS ZIP/DMG、Windows 便携版构建、已签名的 Android APK 和 SHA-256 校验和附加到 GitHub Release。

项目结构

Sources/DSHLauncher.swift  Process lifecycle, SwiftUI window, and embedded Web UI
Resources/remote-bridge.js Authenticated mobile dashboard and HTTP/WebSocket proxy
ios/                       Native DSH Mobile iPhone app and generated Xcode project
android/                   Native DSH Mobile Android app, Gradle wrapper, tests, and APK build
tools/IconGen.swift        Programmatic app icon generator
Info.plist                 macOS bundle metadata
build.sh                   Reproducible universal app build
install.sh                 Verified community installer
script/build_and_run.sh    Local build, launch, and verification entrypoint
scripts/package.sh         ZIP, DMG, and checksum packaging
.github/workflows/         Continuous integration and tagged releases

安全与隐私

DSH Desktop 仅与应用中配置的环回服务地址通信。模型凭据和会话数据归 DeepSeek Harness 所有，而非此启动器。在没有身份验证和 TLS 的情况下，请勿将 DSH Web 服务绑定到公共网络接口。有关报告漏洞的信息，请参阅 SECURITY.md。

许可证

DSH Desktop 在 MIT License 下发布。DeepSeek Harness 是一个单独的项目，在其自己的 MIT 许可证和第三方声明下分发。

中文说明

DSH Desktop 是官方
DeepSeek Harness Web UI 的轻量原生
macOS 桌面壳。它负责启动和停止本机 dsh 服务、把网页界面嵌入桌面窗口，并集中提供
重启、浏览器打开、开机自启和日志查看。

本项目是独立社区项目，不是 DeepSeek 官方产品，也不与 DeepSeek 存在隶属或背书关系；
DeepSeek Harness 运行时始终从官方 npm 包 @deepseek-ai/dsh 单独安装。

安装

先安装 Node.js 22.19+ 或 24+，再在终端运行社区验证安装器：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/frankfika/dsh-desktop-macos/main/install.sh)"

安装器会从 GitHub Release 下载最新版 ZIP、核对 SHA-256、安装应用、仅移除该 App 的
隔离标记、安装官方 @deepseek-ai/dsh 运行时并启动应用。运行前可先查看仓库中的
install.sh 源码。

如果手动安装 App 且本机没有 DSH，首次启动页面会显示“一键安装官方 DSH 运行时”按钮。
应用会直接调用 npm（不经过 shell）将官方包安装到 ~/.dsh/app，完成后自动启动服务。

也可以从 Releases 下载
通用 .dmg 手动安装。目前发布包使用临时签名，因为项目尚无 Apple Developer ID；手动
安装后第一次打开时，请在 Finder 里按住 Control 点击应用，选择“打开”，再次确认。

DeepSeek Harness 仍处于开发者预览阶段，智能体可能读取或修改你选择的工作目录。建议先在
临时项目中使用受限凭据测试，并认真检查每一次权限确认。