WebView2 启动器 FionaFaust/dsh-web-launcher

Euporiandra 的 DeepSeek Harness Web 启动器

DeepSeek Harness 的内嵌浏览器启动器 —— 无浏览器 UI 的 WebView2 (Chromium) 客户端，单文件运行。

- 把 DeepSeek Harness 的 WebUI（http://127.0.0.1:3080，或自行配置）封装进自带窗口的小程序里。
- 是我因为不耐烦 DSH 繁琐的启动流程（雾）愤而设计的便携式小程序（实则并不繁琐）
- 基于 C# 编译，入口文件为 src/App.cs，均使用系统自带工具，无第三方构建依赖。
- 因为我并不是很精通 C# 语言，所以部分内容为 AI 生成，但均经过实机运行测试无严重漏洞后才合入
- 如果有 BUG，请优先向我的邮箱（xzy567123@outlook.com）与 QQ 号（1796057371）留言，提交的 issue 我不一定能看到。

功能特性

- 内嵌浏览器：基于 Microsoft Edge WebView2（Chromium 内核）编译，页面直接渲染在程序窗口内，不唤起外部浏览器
- 无浏览器 UI：只有极简导航条与状态栏，没有浏览器外壳，更简约
- 两种渲染模式：
- 跟随窗口（推荐）：页面按窗口实际尺寸+系统设置渲染
- 固定分辨率：锁定渲染分辨率（如 3840×2160 4K / 2560×1600），窗口只是缩放取景框，调整窗口大小不影响页面视口
- F11 全屏 / Esc 退出：一键进入沉浸式全屏，再按 Esc 可恢复窗口
- 自动拉起服务：目标端口未就绪时，自动隐藏调用配置的启动脚本并等待就绪
- 单文件绿色运行：exe 内嵌 WebView2 托管程序集，首次运行自动释放原生 Loader，无需安装
- JSON 配置：标题、URL、端口、启动脚本、窗口比例、分辨率档位全部可配置

运行环境

| 依赖 | 说明 |
| Windows 10 / 11 | x64 |
| Microsoft Edge WebView2 Runtime | Win11 自带；Win10 可在 Microsoft 官网 获取 |
| .NET Framework 4.8 | Win10/11 系统自带 |

快速开始

1. 点击上方徽章或 Releases 页面 下载 DSHWebLauncher.exe（单文件，当前最新版 v1.1.2.0）
2. 在 exe 同目录创建 launcher.config.json 进行配置，见下文（可跳过）
3. 双击运行。若目标服务未启动且配置了 startScript，程序会自动拉起并等待就绪，然后加载页面

提示：exe 首次运行时会在同目录生成 WebView2Loader.dll（原生组件）与 json 配置文件，属正常行为，请勿删除。

配置

程序以 UTF-8 编码的格式读取 exe 同目录的 launcher.config.json。文件不存在或字段缺失时则使用默认值。完整示例见 launcher.config.example.json。

{
"title": "Euporiandra's DeepSeek Harness Web Launcher", // 窗口标题（默认 "Euporiandra's DeepSeek Harness Web Launcher"） "url": "http://127.0.0.1:3080", // 目标页面地址，DSH端默认的本地映射端口为3080，若经自行配置或服务端部署，则填入对应的IP:端口 "port": 3080, // 端口就绪检测端口（与url中的映射端口对应） "startScript": "", // 可选：服务未运行时隐藏调用的启动脚本 // （如 start-dsh.cmd；留空则不自动拉起） "waitSeconds": 40, // 等待服务就绪的超时秒数 "windowScale": 0.72, // 初始窗口 = 屏幕尺寸 × 该比例（0.1~1.0）
"resolutions": [[3840, 2160], [2560, 1600]] // 固定分辨率档位（导航条下拉可选）
}

示例（自动拉起自建脚本 + 3840x2160 档位）：

{
"title": "My DSH",
"url": "http://127.0.0.1:3080",
"port": 3080,
"startScript": "D:\\scripts\\start-dsh.cmd",
"waitSeconds": 60,
"windowScale": 0.8,
"resolutions": [[3840, 2160], [2560, 1600], [1920, 1080]]
}

快捷键

| 按键 | 功能 |
| F11 | 进入全屏（隐藏导航条/状态栏，覆盖所在显示器） |
| Esc | 退出全屏（恢复原窗口大小与位置） |

从源码构建

需要：Windows + .NET Framework 4.8 SDK（csc.exe，系统自带）。

git clone https://github.com/FionaFaust/dsh-web-launcher.git
cd dsh-web-launcher
build.cmd

产物输出到 dist\DSHWebLauncher.exe。

WebView2 SDK 说明

vendor/ 下已内置编译所需的 WebView2 SDK 程序集（MIT 许可，来源：Microsoft.Web.WebView2 NuGet 包 v1.0.2535.41）：

| 文件 | 用途 |
| Microsoft.Web.WebView2.Core.dll | WebView2 托管 API（运行时从 exe 资源加载） |
| Microsoft.Web.WebView2.WinForms.dll | WinForms 控件（运行时从 exe 资源加载） |
| WebView2Loader.dll | 原生加载器（首次运行自动释放到 exe 目录） |

自定义图标

- 默认使用 assets/whale.ico（DeepSeek Harness 官方鲸鱼图标，SVG 源见 assets/favicon.svg）
- 如需替换：在 exe 同目录放一个 app.ico，程序会优先使用它（无需重新编译）

目录结构

dsh-web-launcher/
├── src/
│ ├── App.cs # 主程序（配置加载 / 窗口 / WebView2） │ ├── app.manifest # DPI 感知清单 │ └── IconBuilder.cs # ICO 生成工具（assets 用，可选） ├── assets/ │ ├── whale.ico # 默认鲸鱼图标（多尺寸 16/32/48/256） │ └── favicon.svg # 图标 SVG 源（来自 DSH Web 官方） ├── vendor/ # WebView2 SDK 程序集（MIT） ├── launcher.config.example.json ├── build.cmd └── LICENSE # BSD-2-Clause

常见问题

Q：页面打不开 / 一直"等待服务启动" A：确认服务正确启动并检查内置IP:端口指向；检查 launcher.config.json 的 url/port；若配置了 startScript，检查脚本路径与脚本本身是否能正常拉起服务。

Q：提示"无法初始化内嵌浏览器" A：确认系统已安装 WebView2 Runtime（一般情况下Win11会自带）。错误信息中会包含具体原因。

Q：调整窗口大小后页面布局变了 A：当前是"跟随窗口"模式（推荐，清晰）。若想锁定布局，请在导航条下拉中选择"固定分辨率"档位。

Q：exe 目录下多了一个 WebView2Loader.dll A：程序首次运行自动释放的原生组件，属于正常行为；删除后下次运行会自动重新释放。（OS:不过我觉得应该并不会有人去管这个突然出现的dll文件吧，应该吧）

致谢

- DeepSeek Harness —— 本项目服务的对象
- Microsoft Edge WebView2 —— 内嵌浏览器内核
- 鲸鱼图标来自 DeepSeek Harness Web 官方资源
- 青木 特别致谢，为我提供了很多关于项目构想的启发，以及贯穿始终的测试参与与反馈
- KSR 特别致谢，为我提供了丰厚的资金支持以维持生活与项目开发，是我的金主朋友
- Titr和伞中荥 致谢，为我提供了资金上的支持,以及长久以来的精神鼓励与宝贵建议

许可证

BSD 2-Clause License

Copyright © 2026 艾珀莉亚 (FionaFaust)