@sunkeycn

dsh-desktop

Name: dsh-desktop
Availability: InStock
Author: sunkeycn

Native macOS desktop wrapper for DeepSeek Harness with plugin management and FRP remote access

Stars: 1
Language: Swift
Created: Aug 25, 2026
Updated: Aug 25, 2026

Desktop

GitHub repo

Introduction

dsh-desktop

简体中文 · English

DeepSeek Harness 的原生 macOS 桌面包装器。提供独立窗口、运行时自举、插件管理、桌面宠物、代码侧栏，以及面向手机和平板的 FRP 远程访问。

下载最新版 · 手机远程访问 · 从源码构建 · 安全说明

dsh-desktop 主界面

功能

原生 macOS 窗口：使用 AppKit + WKWebView，保留系统窗口按钮并采用沉浸式透明标题栏。
自动准备运行环境：首次启动下载 Node.js 和 @deepseek-ai/dsh，后续可在 App 内检查 Harness 更新。
原生插件管理：查看版本、升级、启用、禁用和移除插件，多项修改可统一重启生效。
内置代码侧栏：使用开源的 dsh-better-sidebar。
内置桌面宠物：使用 dsh-pet，同时提供 VP9-alpha WebM 和 HEVC-alpha MOV，在 Chromium 与 WKWebView 中均可透明显示。
内置 FRP 客户端：安装包自带 frpc 0.71.0 和配置插件，可将本机 DSH 安全转发到自建 frps，通过手机、平板等移动设备的浏览器远程访问。
本地数据优先：FRP Token 保存到 macOS Keychain，网页端无法读取已保存的 Token。

界面预览

插件管理

远程访问

Harness 更新

启动状态

截图中的插件版本可能高于安装包内置版本，因为插件管理器支持独立升级。

安装

从 Releases 下载与你的 Mac 架构匹配的 DMG。
打开 DMG，将 DeepSeek Harness.app 拖入“应用程序”。
首次启动等待 App 自动准备 Node.js、Harness 和内置插件。

当前发布的 DMG 使用 ad-hoc 签名，没有 Apple Developer ID 公证。macOS 若阻止首次打开，请在“系统设置 → 隐私与安全性”中确认打开，或从源码自行构建。

系统要求

macOS 12.0 或更高版本
可访问 npm、GitHub Releases 和 Node.js 下载站点的网络
当前 Release 标注其构建架构；本项目不会把单架构产物标记为 Universal

内置插件

插件	内置版本	用途	来源
`dsh-pet`	`0.1.8`	桌面宠物	PC2005-cloud/dsh-pet
`dsh-better-sidebar`	`0.15.2`	代码与工作区侧栏	omdsh-dev/DSH-better-sidebar
`dsh-frp-remote`	`0.2.0`	FRP 配置与隧道管理	本仓库

内置版本只用于首次安装和缺失修复。安装后可以通过“DeepSeek Harness → 插件管理…”独立检查更新。

FRP 远程访问

dsh-desktop 内置 frpc 0.71.0 和 dsh-frp-remote 插件，不需要在 Mac 上另外安装 FRP 客户端。它会把固定监听在 127.0.0.1:3080 的 DSH Web 服务，通过加密的 FRP 隧道转发到你自己的公网服务器。

flowchart LR
    Mobile[手机 / 平板浏览器] -->|HTTPS + 访问认证| Proxy[公网 Caddy / Nginx]
    Proxy -->|127.0.0.1:远端端口| FRPS[frps]
    FRPS <-->|FRP TLS + Token| FRPC[Mac 上内置 frpc]
    FRPC -->|127.0.0.1:3080| DSH[DeepSeek Harness]

已内置的能力

frpc 0.71.0：随 App 安装到本地运行时，由插件负责启动和重启。
图形化配置：在 DSH 设置页的“远程访问”中配置 Server、TLS、Token、代理名称、远端端口和公网 HTTPS 地址。
固定本地目标：只允许转发 127.0.0.1:3080，网页不能修改成本机其他服务。
凭据保护：FRP Token 存放于 macOS Keychain，不写入 TOML，也不会返回给网页客户端。
本机管理边界：配置 API 只监听 127.0.0.1:3081，写操作还需要可信 Origin 和 CSRF Token；手机等远程设备不能修改 FRP 配置。
Trusted Host：App 会读取公网 HTTPS 地址，并在启动 Harness 时自动加入对应的 --trusted-host。

需要自行准备

一台有公网地址的服务器，并在服务器上运行 frps。
一个指向该服务器的域名，以及 Caddy、Nginx 等 HTTPS 反向代理。
公网访问认证，例如 Basic Auth、OAuth/OIDC 网关或 VPN。FRP 本身不提供网页登录保护。

手机远程访问

以下示例使用 frps.example.com:7000 作为 FRP Server、13080 作为远端端口、https://dsh.example.com 作为手机访问地址。请替换为自己的域名、端口和高强度随机 Token。

1. 在公网服务器部署 frps

下载与服务器架构匹配的 frp Release，创建 frps.toml：

bindPort = 7000

auth.method = "token"
auth.token = "replace-with-a-strong-random-token"

启动 frps，并允许 Mac 连接服务器的 TCP 7000 端口。生产环境建议使用 systemd 或容器保证服务自动重启。

2. 配置 HTTPS 与访问认证

在公网服务器上把域名反向代理到 FRP 的远端端口。以下是 Caddy 示例：

dsh.example.com {
    basic_auth {
        dsh-user <HASH_FROM_CADDY_HASH_PASSWORD>
    }
    reverse_proxy 127.0.0.1:13080
}

使用 caddy hash-password 生成密码哈希。防火墙应阻止公网直接访问 13080，否则访问者可以绕过 HTTPS 和认证直接进入 DSH。

3. 在 Mac 上配置隧道

打开 DeepSeek Harness，在“设置 → 远程访问”中填写：

配置项	示例值
启用隧道	开启
服务器地址	`frps.example.com`
服务器端口	`7000`
TLS	开启
鉴权方式	Token
Token	与 `frps.toml` 保持一致
代理名称	`dsh-web`
本地服务	`127.0.0.1:3080`（固定、只读）
远端端口	`13080`
公网 HTTPS 地址	`https://dsh.example.com`

先点击“测试连接”，确认 FRP Server 可达，再点击“保存并重启隧道”。如果修改了公网 HTTPS 地址，还需要重新启动 Harness，使新的 Trusted Host 生效。

4. 从手机或平板访问

确保 Mac 没有休眠、Harness 正在运行且隧道状态显示“已连接”，然后在 iPhone、iPad 或 Android 设备的浏览器中打开 https://dsh.example.com，通过公网入口的访问认证后即可使用当前 Mac 上的 DSH。

移动设备只需要现代浏览器，不需要安装 FRP 客户端。远程访问依赖 Mac、公网服务器和网络连接持续在线。

配置字段

DSH 设置页中的“远程访问”支持配置：

FRP Server 地址和端口
TLS 开关
Token 鉴权
代理名称和远端端口
公网 HTTPS 地址

本地服务固定为 127.0.0.1:3080。配置文件位于 ~/.dsh/frp，Token 存放于 macOS Keychain；本地配置 API 仅监听 127.0.0.1:3081，写操作需要可信 Origin 和 CSRF 令牌。

安全说明

FRP 只提供网络隧道，不提供公网 HTTPS、登录认证或访问控制。
将 DSH 暴露到公网前，必须在入口层配置 HTTPS 和可靠的访问认证。
使用防火墙限制 FRP 远端端口，避免绕过反向代理的 HTTPS 和认证。
使用高强度随机 FRP Token，并及时更新 frps、反向代理和 dsh-desktop。
不要把 FRP Token、私钥、Cookie 或其他凭据提交到仓库、Issue 或日志中。
远程页面只能读取脱敏状态，不能读取或修改本机保存的 FRP Token。
插件会在本机 Harness 进程中运行，只安装你信任的插件和版本。

从源码构建

依赖

macOS 12+
Xcode Command Line Tools（Swift、codesign、iconutil）
Node.js / npm
ffmpeg（生成宠物 HEVC-alpha 资源）

构建命令

./build.sh
./build.sh --install
./build.sh --dmg
./build.sh --version 1.0.0 --install --dmg

构建脚本会：

编译 Swift App。
从 npm 获取清单锁定的插件版本。
为宠物动画生成 WKWebView 使用的 HEVC-alpha MOV。
从 frp Release 下载当前架构的 frpc 0.71.0 并校验 SHA-256。
对 App 进行 ad-hoc 签名，并按参数安装或生成 DMG。

可以通过环境变量指定 ffmpeg：

FFMPEG_BIN=/path/to/ffmpeg ./build.sh --dmg

测试

swiftc -swift-version 5 -typecheck \
  -framework Cocoa -framework WebKit \
  main.swift PluginManager.swift

node --test tests/frp-config.test.mjs

项目结构

.
├── main.swift                 # App 生命周期、WKWebView、自举与菜单
├── PluginManager.swift        # 原生插件管理窗口
├── plugin-catalog.json        # 内置插件清单
├── plugins/
│   ├── dsh-frp-remote/        # FRP 宿主插件和网页设置
│   └── dsh-pet/               # HEVC-alpha 转换与补丁
├── scripts/                   # Profile 迁移和种子清理脚本
├── tests/                     # FRP 配置测试
├── icon/                      # App 图标资源
└── build.sh                   # App / DMG 构建脚本

数据目录

App 运行时：~/Library/Application Support/DeepSeek Harness
DSH Profile：~/.dsh/profiles/web
FRP 配置：~/.dsh/frp
启动日志：~/.dsh/launcher.log

退出桌面窗口不会停止已通过 nohup 启动的 Harness 服务。

第三方项目

DeepSeek Harness：MIT
dsh-pet：MIT
DSH-better-sidebar：MIT
frp：Apache-2.0

License

MIT