用qyqy-1109的桌面殼在Windows上雙擊啓動DeepSeek Harness

DeepSeek Harness 插件 DeepSeek DSH 桌面應用 主題與外觀 Windows 2026-08-18 113 閱讀

前言

DeepSeek Harness（簡稱 dsh）是 DeepSeek AI 開源的智能體運行時，目前仍處於 developer preview。官方頁面把原則寫成一句話：Everything is a plugin——模型、工具、技能、會話、沙箱、存儲、調度和界面，都做成可替換的插件。官方啓動網頁界面的路徑也很直接：先裝 Node.js，再執行 npx @deepseek-ai/dsh web，瀏覽器訪問 http://127.0.0.1:3080。

這條路徑對已經在用 CLI 的人足夠。在 Windows 上把 Harness 交給不打算裝 Node、也不想記命令的同事時，就會卡在環境上：終端、npx、瀏覽器三個窗口來回切，關窗口還容易把還在跑的 dsh web 弄丟。

社區裏因此出現了一批桌面殼。本文只寫 qyqy-1109/deepseek-harness-desktop。GitHub 上同名倉庫不少，安裝命令、是否內置運行時、平臺範圍都不一樣，不要按名字混用。

本文用到的 DeepSeek Harness 插件庫 是社區站點，和 DeepSeek / 幻方沒有官方從屬關係。目錄裏的安裝命令可以抄，源碼和許可證還是要自己打開倉庫覈對。下面按目錄詳情頁、倉庫 README、package.json、GitHub Releases 交叉覈對後的內容介紹它。

這是什麼

deepseek-harness-desktop 由 qyqy-1109 維護，目錄分類爲主題與外觀。倉庫內部 npm 包名是 dsh-codex-desktop，安裝後的產品名是 DeepSeek Harness Desktop。主要語言 JavaScript，當前發佈版本 v0.1.8（2026-08-17）。截至 2026-08-18，目錄頁與 GitHub 倉庫均顯示 9 顆星；目錄收錄日期是 2026-08-15。

一句話定位：這是一個 Windows 上的 Electron 桌面殼，雙擊後自動拉起（或複用）官方 dsh web，把網頁界面裝進獨立窗口；安裝包內置 dsh CLI、Node 運行時和一組社區插件。倉庫裏另外附帶兩個 Web 端主題插件：Codex 風味點綴（dsh-codex-flavor）和背景圖庫（dsh-background）。目錄把它放進「主題與外觀」，主要就是因爲這兩塊。

README 文末寫明採用 MIT 許可。倉庫根目錄目前沒有被 GitHub 識別到的 LICENSE 文件，安裝前仍應自行打開 README 與源碼覈對。

它不是 DeepSeek 官方桌面客戶端，也不另做一套仿製界面。殼負責窗口、托盤、啓動和打包；Harness 本體仍是官方 dsh web。

核心功能

倉庫 README 與目錄簡介一致的能力，可以分成下面幾塊。

1、獨立窗口承載官方 Web GUI。不再手開瀏覽器、也不用記 dsh web。默認探測 http://127.0.0.1:3080：已經有服務在跑就直接複用；沒有則自動解析並拉起 dsh web（優先用安裝包內 vendor/ 副本，其次 PATH 上的 dsh，再其次 npm 全局安裝）。

2、關窗口最小化到托盤。點右上角 × 不會退出，應用駐留在系統托盤。完全退出要托盤右鍵「退出」。驗證清單寫明：如果這次服務是應用自己拉起的，退出應用時會一併停掉；複用外部已有實例時，不會誤殺別人的進程。

3、自包含運行時。README 寫安裝包內置完整 dsh CLI 和 Node 運行時（Electron 43 / Node 24），最終用戶不需要先裝 Node.js 或 dsh。package.json 的 extraResources 會把 vendor/ 裏的 @deepseek-ai/dsh、vendor-node/node.exe、內置插件和 pnpm 打進安裝包。v0.1.8 的 Release 說明補充：安裝包內置自包含 pnpm，啓動時加入服務進程 PATH，讓插件市場在沒有本機 Node 的機器上也能裝卸載插件。

4、首次啓動自動播種插件。README 稱安裝包附帶 6 個插件，裝進全新 web profile：背景圖庫、Codex 風味、dshmarket、dsh-difyctl、super-injector、mode-boost。當前倉庫 vendor-plugins/package.json 能直接覈對到的依賴是 dshmarket、dsh-codex-flavor、dsh-background、dsh-difyctl、@dsh-external/dsh-mode-boost。v0.1.5 的 Release 說明還寫過 @dsh-external/dsh-super-injector。具體清單以你下載的安裝包版本爲準。v0.1.7 起還會內置 router-standard / router-spec 兩個思維模式預設。

5、應用圖標可更換。托盤菜單 →「應用圖標」：經典藍色鯨魚、黑色鯨魚，或上傳自定義圖片。上傳後會裁成方形並適配多檔桌面圖標尺寸，窗口、托盤和桌面快捷方式同步更新。運行時圖標寫到 %APPDATA%\dsh-codex-desktop\icons\。

6、Codex 風味主題。plugin/dsh-codex-flavor/ 是 DSH client 插件：保留 DSH 品牌藍、佈局和圓角，只在深色模式給代碼塊加近黑終端面板（#0f1115）和細邊框，代碼表面改成 Cascadia Code / JetBrains Mono / ui-monospace 等寬棧，成功/狀態強調色微調爲 Codex 終端綠（#3fb950 系）。四檔配置都可以關。

7、背景圖片插件。plugin/dsh-background/ 在「設置 → 通用」增加「背景」行：上傳本地圖片，自動壓縮並保存到圖庫（最多 3 張），透明度和模糊可調，選擇存在 localStorage。背景鋪在主內容區和側邊欄半透明底下，消息等內層表面保持不透明。

安裝與啓用

目錄頁給出的插件命令

社區目錄頁上的安裝命令原文是：

dsh plugin add github:qyqy-1109/deepseek-harness-desktop

插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。裝之前應檢查源代碼倉庫和許可證。若需要可復現安裝，目錄頁建議固定 commit 哈希。當前 main 最新提交爲 02b681e1e0b80a23460bd5ccbb99c5c21fda941e（對應 v0.1.8 前後的源碼）：

dsh plugin add github:qyqy-1109/deepseek-harness-desktop#02b681e1e0b80a23460bd5ccbb99c5c21fda941e

需要先說明：倉庫根目錄的 package.json 是 Electron 應用（main 指向 main/main.js），沒有 DSH 插件清單字段。真正帶 dsh.bundle / dsh.client 聲明的是子目錄裏的 dsh-codex-flavor 和 dsh-background。README 給最終用戶寫的主路徑是下載 Windows 安裝包，而不是把整個桌面殼當普通插件 add 進已有 dsh。已經有 dsh web、只想裝主題的人，請看下文「單獨安裝主題插件」。

最終用戶：安裝包

當前最新安裝包是 GitHub Releases 上的 v0.1.8：DeepSeek.Harness.Desktop.Setup.0.1.8.exe，文件大小 200070926 字節（約 191MB）。下載地址：

https://github.com/qyqy-1109/deepseek-harness-desktop/releases/tag/v0.1.8

README 第 1 節的步驟如下（版本號以 Releases 爲準，不要沿用 README 裏仍寫着的 0.1.5 / 176MB）。

  1. 雙擊安裝包。軟件未購買代碼簽名證書，Windows SmartScreen 可能提示「Windows 已保護你的電腦」，點「更多信息」→「仍要運行」。
  2. 等待進度條完成。README 寫首次安裝 2～10 分鐘都正常（文件數量多，殺毒軟件會逐個掃描）；超過 15 分鐘可以把安裝包目錄加入 Windows Defender 排除項後重試。
  3. 裝完後桌面出現「DeepSeek Harness」快捷方式，應用會自動打開。
  4. 首次啓動約 10～20 秒，會初始化 C:\Users\你的用戶名\.dsh。v0.1.4 起窗口會先顯示「正在啓動 dsh web 服務…」加載頁，服務就緒後再切到主界面。
  5. 窗口打開後，左側 設置（⚙️）→ 模型，填入 DeepSeek API Key（沒有就到 platform.deepseek.com 申請）。
  6. 回到會話頁即可使用。

舊版本（README 寫 0.1.0 之前）存在運行時兼容問題，打開後可能報 Failed to load plugins。請用 v0.1.8。v0.1.2 起內置真實 Node 24，是爲了避開 Electron 運行時和 dsh 原生模塊（目錄選擇器 koffi、sharp、node-pty 等）的 ABI 不一致。

開發者：從源碼運行

環境要求以 README 爲準：Node.js ≥ 22.19（推薦 24 LTS），npm ≥ 10。克隆後：

git clone https://github.com/qyqy-1109/deepseek-harness-desktop.git
cd deepseek-harness-desktop
npm install
npm start

Windows 也可以雙擊 啓動-桌面版.cmd（英文名 launch-desktop.cmd）。若 npm 11 攔截了 electron 的 install 腳本：

npm approve-scripts electron
npm install

打包自包含安裝包：

npm run dist            # dist\DeepSeek Harness Desktop Setup <版本>.exe
npm run dist:portable   # 便攜版（免安裝）

package.json 裏打包目標只有 Windows（NSIS + portable）。國內網絡下 electron-builder 拉 NSIS 組件可能失敗，README 給出的臨時環境變量是：

set ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/
npm run dist

日常使用

README 把日常操作列成一張表：

操作 方法
啓動 雙擊桌面快捷方式
關閉窗口 點右上角 ×，最小化到托盤
完全退出 托盤圖標右鍵 → 退出
重新打開 雙擊托盤圖標或桌面快捷方式
從瀏覽器打開 托盤右鍵 →「在瀏覽器中打開」
更換應用圖標 托盤右鍵 →「應用圖標」

可選環境變量（全部可選，開發或排障時用）：

變量 默認 作用
DSH_DESKTOP_PORT / DSH_PORT 3080 dsh web 監聽端口
DSH_WEB_URL http://127.0.0.1:<port> 直接指定 GUI 地址，跳過探測
DSH_BIN 自動解析 顯式指定 dsh 可執行文件路徑
DSH_DESKTOP_TRAY 1 設爲 0：關窗口直接退出，不駐留托盤
DSH_HOME ~/.dsh dsh web 的工作目錄

v0.1.6 起啓動日誌在 %APPDATA%\dsh-codex-desktop\startup.log，記錄播種、啓動和錯誤事件。

單獨安裝主題插件

已經有 dsh web、只想加 Codex 風味或背景圖的人，不必裝整個桌面殼。前置是 pnpm 可用（corepack enable 或加入 PATH），並且要裝進 web profile。

Codex 風味：

cd plugin/dsh-codex-flavor
corepack enable
dsh plugin --profile web add .
dsh --profile web --dump-config | findstr codex

插件集合變化必須重啓 dsh web，再刷新頁面。patch 行默認配置：

config:
  enabled: true          # 總開關
  codexCodeBlocks: true  # 終端面板質感代碼塊
  codexFont: true        # 代碼等寬字體棧
  codexAccent: true      # 成功綠微調

卸載：

dsh plugin --profile web remove dsh-codex-flavor

背景圖庫（README 強調 -w 必需，因爲 profile 是 pnpm workspace 根）：

cd plugin/dsh-background
dsh plugin --profile web add -w <本目錄絕對路徑>

同樣需要重啓 dsh web。驗證 Codex 插件時，瀏覽器開發者工具 Network 應能看到 /plugins/dsh-codex-flavor/client.js?rev=... 返回 200。

適用場景與注意事項

適合這幾類人：Windows 上想雙擊打開官方 dsh 網頁界面、不想先裝 Node 和 CLI 的最終用戶；需要把 Harness 交給同事、又希望開箱帶上主題和插件市場的人；已經有 dsh web、只想給深色模式代碼塊加一點終端質感或換背景圖的開發者。

它目前只打包 Windows。README 和 electron-builder 配置都沒有 macOS / Linux 安裝包。需要那些平臺時，應去看其他維護者的桌面殼，不要假設這份倉庫能跨平臺。

使用前建議覈對這幾條：

  1. 插件以當前 dsh 進程權限運行，安裝時可能執行代碼。桌面殼還會在本機拉起 dsh web，權限等同你自己在終端裏跑 Harness。安裝前檢查源碼和許可證，只裝自己信任的來源。
  2. 這是社區項目，不是官方應用商店裏的官方客戶端。社區目錄 https://deepseek-harness-plugin.com 與 DeepSeek / 幻方沒有官方從屬關係。Harness 仍在 developer preview，接口可能不兼容。
  3. 安裝包未代碼簽名，SmartScreen 警告是 README 寫明的預期現象，不是安裝成功的證明。下載請走 GitHub Releases，並覈對本機文件大小是否接近 191MB（v0.1.8）。
  4. 調用模型仍要能訪問 DeepSeek API，並在設置裏填 Key。README 寫配置 API 本身不需要梯子，國內可直接訪問 DeepSeek API；這隻覆蓋「填 Key、調官方接口」這一段，不代表所有社區插件的下載源都暢通。
  5. 關掉窗口不等於退出。任務欄裏找不到時，先看托盤。需要徹底退出時用托盤菜單。
  6. GitHub 上存在多個 deepseek-harness-desktop / dsh-desktop 倉庫。本文對應的安裝命令和維護者是 qyqy-1109，目錄頁 slug 是 deepseek-harness-desktop-qyqy-1109。

小結

qyqy-1109 的 deepseek-harness-desktop 把官方 dsh web 裝進 Windows 獨立窗口：自動拉起或複用本地服務、關窗進托盤、安裝包內置 CLI 與 Node 運行時。目錄分類落在主題與外觀，是因爲同一倉庫還帶了剋制的 Codex 風味主題和背景圖庫。它解決的是「Windows 上雙擊打開 Harness」這件事，並不替代官方 CLI，也不是 DeepSeek 官方桌面版。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-qyqy-1109/

GitHub：https://github.com/qyqy-1109/deepseek-harness-desktop

相關文章

Windows10安裝Linux子系統Ubuntu 2017-05-14 TensorFlow的安裝 2018-07-08 使用 dsh-gitbash-preset 在 Windows 上啓用 DeepSeek Harness 極簡模式 2026-08-17 用 deepseek-harness-desktop 把完整 DSH 網頁界面裝進 Windows 2026-08-17 Windows 也能跑 DSH 極簡模式：dsh-gitbash-preset 工作流插件 2026-08-25
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜