Windows 托盘控制器 qingtan-labs/deepseek-harness-windows

适用于 Windows 的 DeepSeek Harness

一个原生、一键式的 DeepSeek Harness Windows 控制器。

独立社区项目。它与 DeepSeek 无关联，未获得其认可，也不由其提供支持。DeepSeek 名称和徽标归其各自所有者所有。

想同时了解两个桌面平台？请访问 DeepSeek Harness Desktop 统一项目主页。

下载

| 推荐下载 | 校验 |
| DeepSeek-Harness-1.0.0-Windows.zip | SHA-256 |

解压 ZIP 并双击 DeepSeekHarnessSetup.exe。默认的按用户安装无需管理员权限。

产品预览

预览仅使用演示内容，并聚焦于控制器自有的 Windows 交互。

系统托盘命令中心

DeepSeek Harness Windows 系统托盘菜单

右键单击托盘鲸鱼图标，可选择默认打开方式、重启或停止服务，并手动检查控制器或 Harness 更新。

任务栏与系统托盘，协同工作

DeepSeek Harness Windows 任务栏与托盘控制器

默认浏览器：聚焦现有标签页

DeepSeek Harness 复用现有浏览器标签页

首次打开会创建一个浏览器标签页。之后的打开会聚焦并复用该标签页，而不会创建重复标签页。

可选的应用内窗口

DeepSeek Harness 可选的 Windows 应用内窗口

WebView2 窗口保持一个本地会话。关闭它会隐藏窗口，但不会退出托盘控制器或停止 Harness。

一键首次运行

DeepSeek Harness 首次运行安装

为什么会有这个项目

DeepSeek Harness 是一个通过 npm 分发的本地开发者工具。此控制器将其安装和生命周期转变为常规的 Windows 体验：
- 一个快捷方式即可启动服务，并以保存的演示模式打开 http://127.0.0.1:3080/；
- 首次启动仅在需要时安装私有且经过验证的运行时；
- 默认使用浏览器，同时可选择使用一次性的单个应用内窗口，或将其保存为默认方式；
- 精致的原生托盘菜单可管理演示、服务、更新、登录时启动、日志和诊断；
- 英语或简体中文会跟随 Windows 显示语言；
- 支持浅色、深色和 Windows 高对比度主题；
- 支持 x64 和 ARM64 Windows。

v1.0.0 测试基线为 Node.js 22.21.1 和 @deepseek-ai/dsh 0.1.1-rc.2。DSH 仍是开发者预览版依赖项，因此运行时更新始终需要用户明确确认。

安全的首次运行安装

控制器不会修改全局 Node.js、npm 配置或 PATH。

- 如果 PC 上已存在 Node.js 或 DSH，则保持原样不变。
- 控制器仍使用自己的私有运行时，因此每次启动都是可复现的。
- 如果另一个健康的 Harness 已占用端口 3080，控制器会在打开它之前询问，并且绝不会接管或停止该进程。
- 如果无关程序占用端口 3080，控制器会报告冲突并让其继续运行。
- 中断的安装会被恢复；激活失败会回滚到上一个经过验证的运行时。

Node.js 下载会根据官方 SHA-256 清单进行校验。DSH 从嵌入式、经过测试的 npm 锁定依赖图安装，其包 URL 和完整性值会在发布前验证。

要求

- Windows 10 22H2 或 Windows 11；
- x64 或 ARM64；
- .NET Framework 4.8，随受支持的 Windows 版本提供；
- 首次启动以及手动检查更新时需要互联网访问；
- 本地 TCP 端口 3080。

可选的应用内窗口使用自动维护的 Microsoft Edge WebView2 Runtime。它已存在于大多数受支持的 Windows 系统中。如果缺失，控制器会在下载并运行 Microsoft 签名的 Evergreen 安装程序之前询问；选择“否”仍可完全使用浏览器模式。

安装

1. 从 GitHub Releases 下载 ZIP 和 .sha256 文件。
2. 验证它：

Get-FileHash .\DeepSeek-Harness-1.0.0-Windows.zip -Algorithm SHA256
Get-Content .\DeepSeek-Harness-1.0.0-Windows.zip.sha256

3. 解压 ZIP 并运行 DeepSeekHarnessSetup.exe。
4. 选择应用程序文件夹和私有运行时文件夹。
5. 选择 Install。控制器会创建所选快捷方式，并在首次启动时完成运行时设置。

默认应用程序文件夹为 %LOCALAPPDATA%\Programs\DeepSeek Harness；默认私有运行时文件夹为 %LOCALAPPDATA%\Qingtan Labs\DeepSeek Harness。两者都可以放在另一个本地驱动器上。请将它们放在不同的文件夹中。

对于脚本化部署：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1
-InstallDir 'D:\Apps\DeepSeek Harness'
-RuntimeDir 'D:\Developer\DeepSeek Harness Runtime'

有关托管部署、升级和卸载的详细信息，请参阅安装。

固定到任务栏或“开始”菜单

Windows 要求固定操作必须由真实的用户手势触发。打开“开始”菜单，搜索 DeepSeek Harness，右键单击它，然后选择 固定到任务栏 或 固定到“开始”屏幕。安装程序会创建正确的“开始”菜单快捷方式，但有意不绕过这条 Windows 安全规则。

日常使用

双击桌面或“开始”菜单快捷方式。后续启动会复用单一控制器实例。浏览器是初始默认方式。托盘菜单可以本次使用应用内窗口，或将其保存为默认方式；关闭该窗口会将其隐藏，而不会退出托盘控制器或停止 Harness。

托盘菜单提供：

- 打开 / 聚焦 Harness，使用已保存的打开方式；
- 本次使用应用内窗口（当应用内窗口是已保存的默认方式时，则改为本次使用浏览器）；
- 已保存的 打开方式 选择，可在浏览器和应用内窗口之间切换；
- 服务的启动、重启和停止；
- 一个明确分隔的 更新 菜单，用于通过 GitHub Releases 手动检查控制器，以及通过官方 npm 注册表检查 Harness (DSH)；
- 恢复经过测试的 Node.js 和 DSH 基线；
- 登录时启动，以及在服务意外退出后重启；
- 快捷方式修复、日志和经过隐私审查的诊断；
- 退出控制器但保留服务，或退出并停止服务。

控制器绝不会执行无人值守的控制器或 Harness 升级。两项检查都只在显式菜单操作后运行，并且打开或安装可用更新都需要确认。已批准的 DSH 版本会在后续启动中保留，而不会被静默降级。

Windows 与 macOS 功能对齐

本项目遵循 DeepSeek Harness for macOS 的产品模型和发布规范。两个版本都提供浏览器和单窗口呈现模式、隔离的已验证运行时、严格的服务所有权、双语 UI、主题、显式更新检查、恢复和诊断工具。

Windows 版本将浏览器保留为无意外默认方式，并且仅将 Microsoft WebView2 用于可选的应用内窗口。外部链接会离开嵌入式本地视图，并在系统浏览器中打开。它创建标准 Windows 快捷方式，而不是 macOS 应用包；按照 Windows 的要求，任务栏/“开始”屏幕固定仍由用户控制。有关完整的平台理由，请参阅架构。

隐私和网络访问

没有分析或控制器遥测。本地状态和日志存储在 %LOCALAPPDATA%\Qingtan Labs\DeepSeek Harness 下；私有运行时可能存储在安装期间选择的自定义文件夹中。

控制器仅联系：

- https://nodejs.org/，用于获取固定版本的 Node.js 归档和官方校验和；
- 用于固定 DSH 包和用户请求的 DSH 更新检查的 https://registry.npmjs.org/；
- 仅在用户请求控制器更新检查时使用 https://api.github.com/；
- 仅在用户批准安装缺失的可选 WebView2 Runtime 后使用 https://go.microsoft.com/。

共享的 WebView2 Runtime 由 Microsoft 维护，并可能根据 Microsoft 的条款建立其自身的 Microsoft 服务连接。嵌入式视图仅限于本地 127.0.0.1:3080 源；外部 HTTP(S) 链接在系统浏览器中打开。其每用户 Web 会话存储在控制器数据文件夹下。

DSH 是一个独立的依赖项。在使用敏感数据之前，请审查其行为和许可证。

构建与发布

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\check-repository.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\build.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-release.ps1 -Version 1.0.0

发布 ZIP、校验和以及发布正文会写入 dist。请参阅发布流程。

发布信任

v1.0.0 发布 SHA-256 校验和，但未进行 Authenticode 签名。Windows SmartScreen 可能会显示未知发布者警告。请验证校验和，并仅从此仓库下载。组织控制的代码签名是 v1.0.0 之后发布加固的首要事项；请参阅安全性。

支持与许可证

在提交问题之前，请阅读用法、故障排除或支持。该控制器在 MIT 许可证下提供；第三方组件和商标在第三方声明中保留其各自的条款。