DeepSeek Harness Window（社区版）

把 DeepSeek Harness 的 Web UI 装进 Windows 原生独立窗口（WebView2，即 Edge 内核）的极简启动器。

简体中文 | English

• 没有浏览器标签栏、地址栏；任务栏上是自己的图标和窗口
• 不需要 Electron；精简版整个应用约 256KB（4 个文件）
• 便携版双击即用：自带 Node.js + DSH + Git，无需安装任何环境
• 双击即用：自动检测/启动本地 DSH 服务，就绪后弹窗；关窗即停（服务由它启动时）
• 单实例：重复双击只聚焦已有窗口；记住窗口大小和位置；连不上服务时窗口内一键重试

⚠️ 非官方社区项目，与 DeepSeek 公司无隶属关系。"DeepSeek" 商标归其所有者所有。

快速开始

方式一：DSH 插件（推荐给 DSH 用户）

dsh plugin --profile web add dsh-window

插件自动从 GitHub Releases 安装应用并创建桌面快捷方式「DeepSeek Harness Window」；对话里说"打开桌面应用"即可通过 desktop_launch 工具拉起。详见 plugin/README.md。

方式二：便携版（零门槛，任何人）

1. 从 Releases 下载 DeepSeek-Harness-Window-portable-v*-win-x64.zip
2. 解压到任意目录
3. 双击 DeepSeek Harness Window.exe

首次运行 Windows SmartScreen 可能拦截（exe 未签名）：点「更多信息 → 仍要运行」即可。

方式三：精简版（已有 Node 环境）

1. 下载 DeepSeek-Harness-Window-v*-win-x64.zip 并解压（4 个文件）
2. 前提：Windows 10/11、Node.js 装在默认位置 %LOCALAPPDATA%\Programs\nodejs、npm install -g @deepseek-ai/dsh
3. 双击 DeepSeek Harness Window.exe
4. 想一键安装到系统（开始菜单 + 桌面快捷方式 + 控制面板可卸载）：运行 DeepSeek Harness Window.exe --install，卸载用 --uninstall

三件套全家桶（桌面 + GLM 视觉 + 语音输入）

一条命令装齐「Windows 桌面窗口 + DeepEye 视觉（GLM-4V-Flash）+ 语音输入按钮」：

dsh plugin --profile web add github:ZichengGurrr/dsh-window#path:/kit

GLM 视觉需在 ~/.dsh/.env 配置 DEEPEYE_API_KEY（智谱开放平台）。详见 kit/README.md。

两种形态

同类桌面壳对比

原理

DeepSeek Harness 的图形界面本质是一个本地网页（默认 http://127.0.0.1:3080）。本程序负责起服务（dsh --profile web --host 127.0.0.1 --port 3080），并把"打开浏览器标签页"这一步换成内嵌的 WebView2 窗口。便携版把运行环境（Node、DSH 包、Git）放在程序目录的 runtime\ 下，优先使用，找不到再回退到系统安装。

可选配置

在 exe 同目录放一个 dsh-window.config.json（可省略，全部有默认值）：

{
  "host": "127.0.0.1",
  "port": 3080,
  "waitTimeoutMs": 30000,
  "killServerOnClose": true,
  "permissionMode": "danger-full-access",
  "closeToTray": true,
  "checkUpdates": true,
  "updateRepo": "ZichengGurrr/dsh-window",
  "logFile": true
}

命令行参数

从源码构建

依赖：Windows + PowerShell + .NET Framework 4.x（自带 csc.exe）。构建脚本自动下载 WebView2 SDK（NuGet）。

.\build.ps1                          # 精简版
.\build.ps1 -Portable                # 精简版 + 便携版（自动下载 Node/MinGit、npm 安装 DSH）
.\build.ps1 -Version 1.1.0 -IconPath .\my-icon.ico
.\build.ps1 -Portable -DshVersion 0.1.0-rc.6 -NpmRegistry https://registry.npmmirror.com

产物：dist\（精简版目录）、dist-portable\（便携版目录）及仓库根目录下的 zip。

图标是可选的。仓库内不带任何 DeepSeek 官方 logo 素材，请勿在公开分发中使用官方鲸鱼 logo，除非你确认有权使用。

常见问题

便携版为什么这么大？ Node.js 运行时 + 完整 @deepseek-ai/dsh 包 + MinGit。这是"解压即用"的代价；不需要零安装体验就用精简版。

和直接开浏览器有什么区别？ 服务完全一样，会话数据完全共用（~/.dsh）。区别只在窗口形态：独立窗口、独立任务栏图标、关窗即停。

关掉窗口后还能用浏览器访问吗？ 如果服务本来就在外面跑着（比如命令行 dsh web），关窗不影响；服务是这个程序起的且 killServerOnClose 为 true，会一起停。

为什么不是单文件 exe？ WebView2 需要 3 个运行库文件随 exe 分发（含一个原生 DLL）。4 个文件放一个文件夹，体感与单文件无异。

Windows 弹 SmartScreen 警告？ exe 未做代码签名，首次运行会被拦：点「更多信息 → 仍要运行」。签名在 Roadmap 中。

Roadmap

• [x] 作为 DSH 插件分发（dsh plugin add dsh-window，含 desktop_launch 工具与自动安装/升级）
• [x] 托盘常驻与最小化到托盘（closeToTray，点关闭按钮隐藏到托盘）
• [x] 自动检查新版本并在页面内提示（checkUpdates）
• [x] 一键安装/卸载（--install / --uninstall，开始菜单 + 桌面快捷方式 + 控制面板卸载项）
• [ ] 任务完成系统通知（会话 idle 时弹 Toast，可一键唤回窗口）
• [ ] Inno Setup / winget 安装包
• [ ] 代码签名（消除 SmartScreen 警告）

相关链接

• 官方仓库：deepseek-ai/deepseek-harness（MIT，Discussions 开放）
• 官方 npm 包：@deepseek-ai/dsh
• 插件精选列表：awesome-dsh-plugin
• 其他社区桌面壳：RAFOLIE/dsh-desktop-windowos、anywhere-labs/deepseek-harness-desktop、salathleizhang/deepseek-harness-desktop、ChisaAlter/Deepseek-Harness-Desktop

License

MIT（见 LICENSE）

DeepSeek Harness Window (community edition)

A minimal launcher that puts the DeepSeek Harness Web UI into a native standalone Windows window (WebView2 / Edge engine).

• No browser tabs or address bar; its own taskbar icon and window
• No Electron; the slim build is ~256KB (4 files)
• Portable build, double-click and go: bundles Node.js + DSH + Git, no environment required
• Auto-detects/starts the local DSH service and opens the window when ready; closes the service on exit only when it started it
• Single instance: re-launching focuses the existing window; remembers size/position; one-click retry inside the window when the service is unreachable

⚠️ Community project, not affiliated with DeepSeek. The "DeepSeek" trademark belongs to its owners.

Quick start

Option A: DSH plugin (recommended for DSH users)

dsh plugin --profile web add dsh-window

The plugin auto-installs the app from GitHub Releases and creates the desktop shortcut "DeepSeek Harness Window"; say "open the desktop app" in chat to launch it via the desktop_launch tool. See plugin/README.md.

Option B: portable build (anyone, zero prerequisites)

1. Download DeepSeek-Harness-Window-portable-v*-win-x64.zip from Releases
2. Unzip anywhere
3. Double-click DeepSeek Harness Window.exe

First run may hit SmartScreen (the exe is unsigned): click "More info → Run anyway".

Option C: slim build (Node environment already present)

1. Download and unzip DeepSeek-Harness-Window-v*-win-x64.zip (4 files)
2. Prerequisites: Windows 10/11, Node.js at %LOCALAPPDATA%\Programs\nodejs, npm install -g @deepseek-ai/dsh
3. Double-click DeepSeek Harness Window.exe
4. To install system-wide (start menu + desktop shortcut + control-panel uninstaller): run DeepSeek Harness Window.exe --install; remove with --uninstall

All-in-one kit (desktop + GLM vision + voice input)

One command installs the Windows desktop window, DeepEye vision (GLM-4V-Flash), and the voice-input mic button:

dsh plugin --profile web add github:ZichengGurrr/dsh-window#path:/kit

Set DEEPEYE_API_KEY in ~/.dsh/.env (Zhipu open platform) for vision. See kit/README.md.

Builds

How it works

The DeepSeek Harness GUI is a local web page (default http://127.0.0.1:3080). This app starts the service (dsh --profile web --host 127.0.0.1 --port 3080) and replaces the "open a browser tab" step with an embedded WebView2 window. The portable build keeps the runtime (Node, the DSH package, Git) under runtime\ and falls back to the system install when missing.

Optional config

Drop a dsh-window.config.json next to the exe (all keys optional):

{
  "host": "127.0.0.1",
  "port": 3080,
  "waitTimeoutMs": 30000,
  "killServerOnClose": true,
  "permissionMode": "danger-full-access",
  "closeToTray": true,
  "checkUpdates": true,
  "updateRepo": "ZichengGurrr/dsh-window",
  "logFile": true
}

Command-line arguments

Building from source

Prerequisites: Windows + PowerShell + .NET Framework 4.x (bundled csc.exe). The build script downloads the WebView2 SDK (NuGet) automatically.

.\build.ps1                          # slim build
.\build.ps1 -Portable                # slim + portable (downloads Node/MinGit, npm-installs DSH)
.\build.ps1 -Version 1.1.0 -IconPath .\my-icon.ico
.\build.ps1 -Portable -DshVersion 0.1.0-rc.6 -NpmRegistry https://registry.npmmirror.com

Output: dist\ (slim), dist-portable\ (portable), and zips in the repo root.

The icon is optional. This repo ships no DeepSeek logo assets; do not use the official whale logo in public distribution unless you are sure you have the rights.

FAQ

Why is the portable build so big? Node.js runtime + the full @deepseek-ai/dsh package + MinGit. That is the price of unzip-and-go; use the slim build when you already have Node.

How is this different from opening a browser? The service is identical and sessions are fully shared (~/.dsh). The difference is window chrome only: standalone window, own taskbar icon, close-to-stop.

Can I still use the browser after closing the window? Yes, when the service was already running externally (e.g. dsh web in a terminal). When this app started the service and killServerOnClose is true, closing the window stops it.

Why not a single-file exe? WebView2 needs 3 runtime files shipped beside the exe (including a native DLL). Four files in one folder feel the same as a single file.

Windows shows a SmartScreen warning? The exe is not code-signed yet, so the first run is blocked: click "More info → Run anyway". Signing is on the roadmap.

Roadmap

• [x] DSH plugin distribution (dsh plugin add dsh-window, desktop_launch tool, auto-install/upgrade)
• [x] Tray residency and minimize-to-tray (closeToTray, X button hides to tray)
• [x] Automatic update check with an in-page banner (checkUpdates)
• [x] One-click install/uninstall (--install / --uninstall, start-menu + desktop shortcuts, control-panel entry)
• [ ] Task-done system notification (toast when the session goes idle, one click to restore the window)
• [ ] Inno Setup / winget package
• [ ] Code signing (removes the SmartScreen warning)

Links

• Official repo: deepseek-ai/deepseek-harness (MIT, Discussions open)
• Official npm package: @deepseek-ai/dsh
• Curated plugin list: awesome-dsh-plugin
• Other community desktop shells: RAFOLIE/dsh-desktop-windowos, anywhere-labs/deepseek-harness-desktop, salathleizhang/deepseek-harness-desktop, ChisaAlter/Deepseek-Harness-Desktop

License

MIT (see LICENSE)