前言¶
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 命令、端口參數和主題配置。
