🌐 For English readers: the English version is here → README_en.md

🚀 DeepSeek Harness 桌面客户端（Windows）

把 DeepSeek Harness 装进一个原生 Windows 窗口 —— 装完即用，像用普通软件一样简单。

基于 WinUI 3 + WebView2 打造的原生桌面壳，把 DeepSeek Harness 的 Web UI（dsh web）包装成 Windows 应用。它会在本地悄悄拉起一个 dsh web 服务进程，再用 WebView2 把 http://127.0.0.1:<port>/?token=... 的界面嵌进原生窗口；退出应用时自动收尾，不留一丝残留进程。

✨ 亮点速览


🪄 零 CLI 前置	安装包自带 Node.js；首次启动自动联网安装最新版 dsh（多源测速选最快），无需手动装任何东西
🧩 安装即自动绑定	dsh 自动装到独立目录（应用所在盘 `DeepSeek Harness` 文件夹），装完即被定位并复用，升级/重装应用也不受影响
🖥️ 原生体验	现代 WinUI 3 窗口 + WebView2 渲染，拥有独立于系统 Edge 的用户数据目录
🔌 插件市场	多来源（DSH Market / npm / npmmirror）发现并一键安装插件，装完服务自动重启
🩹 崩溃自愈	插件搞崩服务？自动屏蔽 + 安全配置重启，弹窗展示日志，一键恢复
🎛️ 贴心工具栏	后退 / 前进 / 刷新 / 浏览器打开 / 检查更新 / 插件管理 / 设置，一应俱全

📥 安装

双击 artifacts/DshDesktop-Setup-0.7.0.exe，按向导一路「下一步」即可，无需管理员权限。安装时若检测到缺少 WebView2 Runtime 会给出提示。

免安装版：artifacts/win-x64/DshDesktop.exe，解压即用。

🚀 快速开始

配置 API Key：在用户主目录（C:\Users\<你>）创建 .env：
```
DEEPSEEK_API_KEY=sk-xxxx
```
启动应用：双击桌面图标。首次启动需要联网，应用会自动下载安装最新的 @deepseek-ai/dsh（自动选择最快镜像源），安装进度会实时显示在黑底启动日志里；装完立即自动启动 Web UI。之后每次启动都会直接复用已安装的 dsh。

📍 dsh 会被安装到应用所在盘的 DeepSeek Harness 文件夹（例如应用装在 H:\...，则 dsh 装到 H:\DeepSeek Harness），自动创建。如果自动安装失败（如无网络 / 盘根无写权限），应用会阻止启动并提示重试，你也可以在「设置」里手动指定 dsh 路径（dsh.cmd / dsh.exe / bin.js）。
安装插件：点击工具栏「插件」按钮，从 DSH Market / npm 等多来源列表选择安装，完成后服务自动重启。若某插件导致服务崩溃，应用会自动屏蔽并卸载它、弹窗展示报错日志，你可以选择「一键重启」或「恢复该插件」。

🛠️ 从源码构建

构建机环境要求

项目	要求	说明
操作系统	Windows 10 / 11
.NET SDK	8.0+	需 `dotnet` 命令可用
Node.js + npm	18+	需 `node` / `npm` 命令可用（用于生成捆绑的 node/npm 运行时）
Inno Setup	7	需 `iscc` 命令可用（见下方说明）

⚠️ 重要：构建脚本通过 PATH 定位工具

所有构建脚本（build.ps1 / build-all.cmd / build-publish.cmd / prepare-runtime.cmd）都不再写死工具安装路径，而是直接从系统 PATH 解析 dotnet、node、npm、iscc。

构建前请先确认这些命令在终端里可以直接敲出来：
dotnet --version   # 能输出版本号即可
node --version
npm --version
💡 关于 Inno Setup：iscc 默认不在 PATH 里。构建脚本会优先从 PATH 解析，找不到时会自动探测常见安装目录（C:\Program Files\Inno Setup 7\... 等）。想一劳永逸，也可以手动把 ISCC.exe 所在目录加入 PATH。

若某条命令缺失，脚本会给出明确的 xxx_NOT_FOUND 提示，不会静默失败。

一键构建（推荐）

# 全流程：准备捆绑 node/npm 运行时 + publish 自包含 + 拷贝 runtime + Inno Setup 安装器
powershell -ExecutionPolicy Bypass -File scripts/build.ps1
# 或
scripts\build-all.cmd

产物：

artifacts/win-x64/DshDesktop.exe — 免安装直接运行（含捆绑的 node/npm 运行时）
artifacts/DshDesktop-Setup-0.7.0.exe — 安装器

仅需开发调试：

dotnet build DshDesktop/DshDesktop.csproj

📂 目录结构

desktop/
├── DshDesktop/                # WinUI 3 应用（C# / .NET 8）
│   ├── MainWindow.xaml        #   主窗口：一体化标题栏 + WebView2 + 启动日志/状态层
│   ├── Services/
│   │   ├── DshHostProcess.cs  #   dsh web 子进程管理（解析鉴权 URL、崩溃检测、退出清理）
│   │   ├── DshLocator.cs      #   dsh 定位（自动安装目录 → 手动路径 → PATH/npm 全局）
│   │   ├── DshUpdater.cs      #   dsh 安装/升级（多源测速 + npm 安装 + 进度/取消/超时）
│   │   ├── DshPaths.cs        #   路径常量（捆绑 node/npm 与 dsh 安装根）
│   │   ├── PluginManager.cs   #   插件管理（dsh plugin 命令）
│   │   ├── PluginDialog.cs    #   多来源插件市场对话框
│   │   ├── AppSettings.cs     #   用户设置（settings.json）
│   │   └── SettingsDialog.cs  #   设置对话框（手动指定 dsh 路径）
│   ├── Assets/                #   应用图标
│   └── runtime/               #   捆绑的 node/npm/pnpm 运行时（构建时生成，不含 dsh）
├── installer/setup.iss        # Inno Setup 7 安装脚本
├── scripts/
│   ├── build-all.cmd          #   一键全流程构建（prepare-runtime → publish → runtime → 安装器）
│   ├── build-publish.cmd      #   仅 publish + 拷贝 runtime + 安装器（假设运行时已就绪）
│   ├── build.ps1              #   一键构建（PowerShell 版，自动从 PATH 定位工具）
│   ├── prepare-runtime.cmd    #   准备捆绑运行时（node + npm 发行版 + pnpm，不含 dsh）
│   ├── verify-artifacts.cmd   #   验证产物（捆绑 node/npm + 安装器时间戳）
│   └── generate-icon.ps1      #   生成应用图标
└── artifacts/                 # 构建产物（win-x64/ 发布目录 + Setup exe）

分步构建

# 1. 准备捆绑运行时（拷贝 node + 捆绑 npm/pnpm，需 Node.js 联网；不安装 dsh）
scripts\prepare-runtime.cmd

# 2. 构建发布目录与安装器（publish + 拷贝 runtime + Inno Setup）
scripts\build-publish.cmd

# 3. （可选）验证产物：打印捆绑 node 版本、检查安装器与主程序时间戳
scripts\verify-artifacts.cmd

📝 说明：runtime/ 目录（Node.js + npm/pnpm）由 prepare-runtime.cmd 生成，属于构建产物，已通过 .gitignore 排除，不会提交到仓库。dsh 不在此目录——它由应用在最终用户机器上首次启动时自动安装到独立目录。

❓ 常见问题

首次启动提示「正在自动安装 dsh」后失败：需要联网；若所有 npm 源（官方 + 国内镜像）都不可达，或安装目录（应用所在盘根 DeepSeek Harness）无写权限，会安装失败。请检查网络 / 换到有写权限的盘，再点工具栏「重新加载」重试，或在「设置」中手动指定 dsh 路径。
提示「dsh web authentication required」：请升级到 v0.7.0（旧版本未捕获 dsh 0.1.2 的鉴权 token）。若仍出现，多半是安装了过旧的 dsh，可在「检查更新」里升级。
插件安装 / 恢复需要联网：dsh plugin 通过 pnpm 从 npm registry 安装，需联网。
插件导致崩溃被自动屏蔽：应用会卸载报错插件并以安全配置重启。可在「插件」对话框「已屏蔽」分区里选择「恢复」重新安装尝试。
提示缺少 WebView2 Runtime：到 https://developer.microsoft.com/microsoft-edge/webview2/ 安装 Evergreen 版本。
界面空白 / 服务异常：状态栏会显示服务日志摘要；也可点「在系统浏览器中打开」用浏览器访问同一地址排查。

🔬 技术说明

目标框架 net8.0-windows10.0.19041.0，WindowsPackageType=None（unpackaged）
WindowsAppSDKSelfContained=true + --self-contained true：运行时全部随应用分发
捆绑运行时：runtime/node.exe（含 VC++ 运行库）+ runtime/node_modules/npm + pnpm （不含 dsh）
dsh 安装根：Path.GetPathRoot(应用目录) + "DeepSeek Harness"，npm 装到其 node_modules/@deepseek-ai/dsh；启动时先在此定位，找不到且未手动指定则自动安装 latest
dsh 解析顺序：自动安装目录 → 用户设置路径 → PATH / npm 全局
dsh 安装/升级：对 4 个 npm 源（官方 / npmmirror / 腾讯云 / 华为云）并行 ping 选最低延迟，用捆绑 npm 安装，支持实时进度、取消与 15 分钟超时兜底
WebView2 使用独立用户数据目录（%LOCALAPPDATA%\DshDesktop\WebView2），与系统 Edge 互不影响
新窗口（target=_blank）交给系统默认浏览器打开

📄 许可证

MIT

🌐 For English readers: the English version is here → README_en.md

🚀 DeepSeek Harness 桌面客户端（Windows）

把 DeepSeek Harness 装进一个原生 Windows 窗口 —— 装完即用，像用普通软件一样简单。

✨ 亮点速览


🪄 零 CLI 前置	安装包自带 Node.js；首次启动自动联网安装最新版 dsh（多源测速选最快），无需手动装任何东西
🧩 安装即自动绑定	dsh 自动装到独立目录（应用所在盘 `DeepSeek Harness` 文件夹），装完即被定位并复用，升级/重装应用也不受影响
🖥️ 原生体验	现代 WinUI 3 窗口 + WebView2 渲染，拥有独立于系统 Edge 的用户数据目录
🔌 插件市场	多来源（DSH Market / npm / npmmirror）发现并一键安装插件，装完服务自动重启
🩹 崩溃自愈	插件搞崩服务？自动屏蔽 + 安全配置重启，弹窗展示日志，一键恢复
🎛️ 贴心工具栏	后退 / 前进 / 刷新 / 浏览器打开 / 检查更新 / 插件管理 / 设置，一应俱全

📥 安装

双击 artifacts/DshDesktop-Setup-0.7.0.exe，按向导一路「下一步」即可，无需管理员权限。安装时若检测到缺少 WebView2 Runtime 会给出提示。

免安装版：artifacts/win-x64/DshDesktop.exe，解压即用。

🚀 快速开始

配置 API Key：在用户主目录（C:\Users\<你>）创建 .env：
```
DEEPSEEK_API_KEY=sk-xxxx
```
启动应用：双击桌面图标。首次启动需要联网，应用会自动下载安装最新的 @deepseek-ai/dsh（自动选择最快镜像源），安装进度会实时显示在黑底启动日志里；装完立即自动启动 Web UI。之后每次启动都会直接复用已安装的 dsh。

📍 dsh 会被安装到应用所在盘的 DeepSeek Harness 文件夹（例如应用装在 H:\...，则 dsh 装到 H:\DeepSeek Harness），自动创建。如果自动安装失败（如无网络 / 盘根无写权限），应用会阻止启动并提示重试，你也可以在「设置」里手动指定 dsh 路径（dsh.cmd / dsh.exe / bin.js）。
安装插件：点击工具栏「插件」按钮，从 DSH Market / npm 等多来源列表选择安装，完成后服务自动重启。若某插件导致服务崩溃，应用会自动屏蔽并卸载它、弹窗展示报错日志，你可以选择「一键重启」或「恢复该插件」。

🛠️ 从源码构建

构建机环境要求

项目	要求	说明
操作系统	Windows 10 / 11
.NET SDK	8.0+	需 `dotnet` 命令可用
Node.js + npm	18+	需 `node` / `npm` 命令可用（用于生成捆绑的 node/npm 运行时）
Inno Setup	7	需 `iscc` 命令可用（见下方说明）

⚠️ 重要：构建脚本通过 PATH 定位工具

所有构建脚本（build.ps1 / build-all.cmd / build-publish.cmd / prepare-runtime.cmd）都不再写死工具安装路径，而是直接从系统 PATH 解析 dotnet、node、npm、iscc。

构建前请先确认这些命令在终端里可以直接敲出来：
dotnet --version   # 能输出版本号即可
node --version
npm --version
💡 关于 Inno Setup：iscc 默认不在 PATH 里。构建脚本会优先从 PATH 解析，找不到时会自动探测常见安装目录（C:\Program Files\Inno Setup 7\... 等）。想一劳永逸，也可以手动把 ISCC.exe 所在目录加入 PATH。

若某条命令缺失，脚本会给出明确的 xxx_NOT_FOUND 提示，不会静默失败。

一键构建（推荐）

# 全流程：准备捆绑 node/npm 运行时 + publish 自包含 + 拷贝 runtime + Inno Setup 安装器
powershell -ExecutionPolicy Bypass -File scripts/build.ps1
# 或
scripts\build-all.cmd

产物：

artifacts/win-x64/DshDesktop.exe — 免安装直接运行（含捆绑的 node/npm 运行时）
artifacts/DshDesktop-Setup-0.7.0.exe — 安装器

仅需开发调试：

dotnet build DshDesktop/DshDesktop.csproj

📂 目录结构

desktop/
├── DshDesktop/                # WinUI 3 应用（C# / .NET 8）
│   ├── MainWindow.xaml        #   主窗口：一体化标题栏 + WebView2 + 启动日志/状态层
│   ├── Services/
│   │   ├── DshHostProcess.cs  #   dsh web 子进程管理（解析鉴权 URL、崩溃检测、退出清理）
│   │   ├── DshLocator.cs      #   dsh 定位（自动安装目录 → 手动路径 → PATH/npm 全局）
│   │   ├── DshUpdater.cs      #   dsh 安装/升级（多源测速 + npm 安装 + 进度/取消/超时）
│   │   ├── DshPaths.cs        #   路径常量（捆绑 node/npm 与 dsh 安装根）
│   │   ├── PluginManager.cs   #   插件管理（dsh plugin 命令）
│   │   ├── PluginDialog.cs    #   多来源插件市场对话框
│   │   ├── AppSettings.cs     #   用户设置（settings.json）
│   │   └── SettingsDialog.cs  #   设置对话框（手动指定 dsh 路径）
│   ├── Assets/                #   应用图标
│   └── runtime/               #   捆绑的 node/npm/pnpm 运行时（构建时生成，不含 dsh）
├── installer/setup.iss        # Inno Setup 7 安装脚本
├── scripts/
│   ├── build-all.cmd          #   一键全流程构建（prepare-runtime → publish → runtime → 安装器）
│   ├── build-publish.cmd      #   仅 publish + 拷贝 runtime + 安装器（假设运行时已就绪）
│   ├── build.ps1              #   一键构建（PowerShell 版，自动从 PATH 定位工具）
│   ├── prepare-runtime.cmd    #   准备捆绑运行时（node + npm 发行版 + pnpm，不含 dsh）
│   ├── verify-artifacts.cmd   #   验证产物（捆绑 node/npm + 安装器时间戳）
│   └── generate-icon.ps1      #   生成应用图标
└── artifacts/                 # 构建产物（win-x64/ 发布目录 + Setup exe）

分步构建

# 1. 准备捆绑运行时（拷贝 node + 捆绑 npm/pnpm，需 Node.js 联网；不安装 dsh）
scripts\prepare-runtime.cmd

# 2. 构建发布目录与安装器（publish + 拷贝 runtime + Inno Setup）
scripts\build-publish.cmd

# 3. （可选）验证产物：打印捆绑 node 版本、检查安装器与主程序时间戳
scripts\verify-artifacts.cmd

📝 说明：runtime/ 目录（Node.js + npm/pnpm）由 prepare-runtime.cmd 生成，属于构建产物，已通过 .gitignore 排除，不会提交到仓库。dsh 不在此目录——它由应用在最终用户机器上首次启动时自动安装到独立目录。

❓ 常见问题

首次启动提示「正在自动安装 dsh」后失败：需要联网；若所有 npm 源（官方 + 国内镜像）都不可达，或安装目录（应用所在盘根 DeepSeek Harness）无写权限，会安装失败。请检查网络 / 换到有写权限的盘，再点工具栏「重新加载」重试，或在「设置」中手动指定 dsh 路径。
提示「dsh web authentication required」：请升级到 v0.7.0（旧版本未捕获 dsh 0.1.2 的鉴权 token）。若仍出现，多半是安装了过旧的 dsh，可在「检查更新」里升级。
插件安装 / 恢复需要联网：dsh plugin 通过 pnpm 从 npm registry 安装，需联网。
插件导致崩溃被自动屏蔽：应用会卸载报错插件并以安全配置重启。可在「插件」对话框「已屏蔽」分区里选择「恢复」重新安装尝试。
提示缺少 WebView2 Runtime：到 https://developer.microsoft.com/microsoft-edge/webview2/ 安装 Evergreen 版本。
界面空白 / 服务异常：状态栏会显示服务日志摘要；也可点「在系统浏览器中打开」用浏览器访问同一地址排查。

🔬 技术说明

目标框架 net8.0-windows10.0.19041.0，WindowsPackageType=None（unpackaged）
WindowsAppSDKSelfContained=true + --self-contained true：运行时全部随应用分发
捆绑运行时：runtime/node.exe（含 VC++ 运行库）+ runtime/node_modules/npm + pnpm （不含 dsh）
dsh 安装根：Path.GetPathRoot(应用目录) + "DeepSeek Harness"，npm 装到其 node_modules/@deepseek-ai/dsh；启动时先在此定位，找不到且未手动指定则自动安装 latest
dsh 解析顺序：自动安装目录 → 用户设置路径 → PATH / npm 全局
dsh 安装/升级：对 4 个 npm 源（官方 / npmmirror / 腾讯云 / 华为云）并行 ping 选最低延迟，用捆绑 npm 安装，支持实时进度、取消与 15 分钟超时兜底
WebView2 使用独立用户数据目录（%LOCALAPPDATA%\DshDesktop\WebView2），与系统 Edge 互不影响
新窗口（target=_blank）交给系统默认浏览器打开

📄 许可证

MIT

having5548/deepseek-harness-desktop

🚀 DeepSeek Harness 桌面客户端（Windows）

✨ 亮点速览

更多细节

📥 安装

🚀 快速开始

🛠️ 从源码构建

构建机环境要求

一键构建（推荐）

📂 目录结构

分步构建

❓ 常见问题

🔬 技术说明

📄 许可证

Community comments

having5548/deepseek-harness-desktop

🚀 DeepSeek Harness 桌面客户端（Windows）

✨ 亮点速览

更多细节

📥 安装

🚀 快速开始

🛠️ 从源码构建

构建机环境要求

一键构建（推荐）

📂 目录结构

分步构建

❓ 常见问题

🔬 技术说明

📄 许可证

Community comments