前言¶
DeepSeek Harness 插件生态里，很多能力都是以插件形式接入的。桌面窗口也可以是一种插件：DeepSeek Harness Desktop 提供了一个原生 Electron 桌面窗口，用来加载当前 dsh web profile 的界面。
它对使用 DSH 桌面窗口来说解决的问题比较具体：不想每次都只从浏览器打开 dsh web，希望有一个本地窗口入口；同时又希望窗口里加载的是当前 profile 的真实 Web UI，而不是另做一套前端。
下面介绍它的定位、能力、安装方式和日常用法。
插件定位¶
这个仓库的 GitHub 路径是：
https://github.com/Muelsysel/DeepSeek-Harness-Desktop
维护者是 Muelsysel。许可证为 MIT。
它可以理解为 DeepSeek Harness 生态里的一个桌面窗口插件：插件本身负责打开一个原生 Electron 窗口，窗口中加载当前 dsh web profile 的界面。这样，原本在 Web UI 里可用的能力，可以直接在一个本地桌面窗口中使用。
核心功能¶
桌面窗口启动¶
它支持双击启动原生 Electron 桌面窗口，并加载当前 dsh web profile 的真实界面。
启动时会出现鲸鱼进度闪屏，主窗口就绪后完成交接。窗口、任务栏、快捷方式等位置使用官方 DeepSeek 鲸鱼图标。
与 Web UI 配合¶
在 Web UI 中可以使用 /desktop 打开或复用同一后端窗口。
也就是说，桌面窗口不是脱离 dsh web 后端的独立应用，而是和当前后端配合使用。同一个后端窗口可以被打开或复用，避免重复启动多个窗口。
外观与链接行为¶
默认使用白色浅色风格，也可以切换为深色 Codex 皮肤。
外部链接会走系统浏览器打开。
启动入口¶
它支持多种启动入口：
- 桌面快捷方式
- 开始菜单
- 安装目录内启动入口
- Web UI 中通过
/desktop打开
不设置 DSH_DESKTOP_LAUNCH 时，普通 dsh web 保持浏览器优先行为，不会自动弹出桌面窗口。
安装与启用¶
前置要求¶
git clone、zip 便携版和手动安装都需要 Node.js：
Node.js >= 22.19
如果使用 git clone 方式，还需要已安装 git。建议把仓库克隆到无空格路径。
方式一：git clone¶
先在命令行中执行以下命令：
git clone https://github.com/Muelsysel/DeepSeek-Harness-Desktop.git
cd DeepSeek-Harness-Desktop
start.cmd
这一步会进入仓库并启动引导脚本。窗口启动后，就可以直接在当前 dsh web profile 的界面里使用桌面窗口。
方式二：zip 便携版¶
如果使用已经解压好的 zip 便携版，可以进入解压路径后执行：
cd /d "<解压路径>" && start.cmd
这条命令会在指定目录下启动桌面窗口入口。之后日常使用可以从桌面快捷方式、开始菜单或安装目录启动入口进入。
方式三：setup.exe 安装版¶
如果使用 setup.exe 安装版，可以从桌面快捷方式、开始菜单或安装目录中的启动入口启动。
安装版私有数据放在：
%APPDATA%\DeepSeek-Harness-Desktop
它不修改 $DSH_HOME 下的 profile。安装版关窗即退出后端。
方式四：手动注册到已有 profile¶
如果要把插件注册到已有 dsh web profile，可以先执行：
bin\install.cmd
这条命令会把插件注册到：
$DSH_HOME\profiles\web
之后可以使用：
bin\dsh-desktop.cmd
来启动桌面窗口。
如果需要单独补建或重建桌面快捷方式，可以使用：
create-shortcut.cmd
如果需要从 profile 中移除插件，可以使用：
bin\uninstall.cmd
典型用法¶
日常启动¶
完成安装后，可以通过以下方式启动：
- 桌面快捷方式
- 开始菜单
- 安装目录启动入口
bin\dsh-desktop.cmd- Web UI 中的
/desktop
如果使用 bin\dsh-desktop.cmd，可以额外传端口参数：
bin\dsh-desktop.cmd --port 3180
固定端口¶
launcher 默认使用：
--port 0
也就是由系统分配空闲端口，避免和已有端口冲突。
如果需要固定端口，可以设置环境变量：
DSH_DESKTOP_PORT
也可以在启动命令中指定端口：
bin\dsh-desktop.cmd --port 3180
插件配置¶
插件支持以下配置项：
autoOpen
title
width
height
theme
electronArgs
其中：
autoOpen控制启动时是否自动开窗title控制窗口标题width和height控制初始窗口尺寸theme可选择默认浅色风格或 Codex 深色皮肤electronArgs用于附加传给 Electron 的参数
调试日志¶
如果需要查看调试日志，可以设置：
DSH_DESKTOP_DEBUG=1
日志会写入：
%TEMP%\dsh-desktop-debug.log
适用场景与注意¶
适合这些情况：
- 你已经在用 DSH 的
dsh webprofile，但希望有一个本地桌面窗口入口 - 你希望保留 Web UI 的现有能力，同时用桌面窗口方式打开
- 你希望使用桌面快捷方式、开始菜单或
/desktop命令快速进入 - 你想在白色浅色风格和深色 Codex 皮肤之间切换
需要注意几点：
- 它会注册到
$DSH_HOME\profiles\web，会影响当前 profile 的插件配置 - 安装版私有数据放在
%APPDATA%\DeepSeek-Harness-Desktop - 插件以当前
dsh进程权限运行，安装前应检查源码与许可证 - 不设置
DSH_DESKTOP_LAUNCH时，普通dsh web保持浏览器优先行为 - 端口默认使用系统分配空闲端口，如需固定端口应显式设置
DSH_DESKTOP_PORT或传入--port
相关链接¶
- GitHub：https://github.com/Muelsysel/DeepSeek-Harness-Desktop
- 社区目录页：https://www.skillhub.cn/plugins/Muelsysel/DeepSeek-Harness-Desktop
DeepSeek Harness Desktop 的价值在于把 DSH Web UI 放进了一个可直接双击打开的桌面窗口里。它没有重新实现一套前端，而是以插件方式接入当前 dsh web profile，提供桌面快捷方式、开始菜单入口、/desktop 命令、端口参数和主题配置。
