原生桌面外壳 Max179/deepseek-harness-native

DeepSeek Harness Native

An unofficial, ultra-light desktop shell for DeepSeek Harness.
非官方、极简轻量的 DeepSeek Harness 原生桌面外壳。

[!IMPORTANT]
这是一个独立的社区项目，与 DeepSeek AI 无关联，也未获得其认可。DeepSeek Harness 仍是官方运行时和 UI。

为什么做这个项目

官方 DeepSeek Harness 通过 dsh web 在浏览器中运行。它功能完整，但日常使用时需要记住地址、管理后台进程，并在浏览器标签页之间寻找入口。

DeepSeek Harness Native 只补上桌面体验，不重新实现 Harness：

- 1:1 官方体验：直接加载官方本地 Web UI，不复刻、不改版、不引入另一套 Agent。
- 一键启动：双击 App，自动检测服务、启动 dsh web、等待就绪并打开窗口。
- 极简轻量：使用系统原生 WebView；macOS 版基于 WKWebView，不内置 Electron 或 Chromium。
- 智能复用运行时：优先使用本机已有的 Node.js 22+ 和 @deepseek-ai/dsh，避免重复占用空间。
- 不再丢失地址：固定桌面入口，不需要记住 http://127.0.0.1:3080，也不依赖浏览器历史记录。
- 生命周期可控：只复用经过进程身份验证的官方 Harness；如果由 App 启动，则退出时一并清理子进程。
- 升级友好：桌面壳与官方 Harness 解耦，更新官方 npm 包即可获得最新能力。
- 本地优先：窗口只信任本机 Harness 地址；外部链接交给系统浏览器，密钥继续由官方 Harness 管理。

当前状态

| 平台 | 状态 | 渲染引擎 |
| macOS Apple Silicon | 可构建、可运行 | 系统 WKWebView |
| macOS Intel | 可构建、待更多真机测试 | 系统 WKWebView |
| Windows x64 / ARM64 | 设计阶段 | 系统 WebView2 |
| Linux x64 / ARM64 | 设计阶段 | 系统 WebKitGTK |

当前仓库包含 macOS 原生原型。跨平台版本计划使用 Tauri 2，同时保留系统 WebView 和按需运行时策略。

三种发行方案

| 方案 | 安装包 | 用户要求 | 适用场景 |
| System Runtime | 最小 | 已安装 Node.js 22+ 与 dsh | 开发者、极致轻量 |
| Adaptive Runtime | 小 | 缺什么补什么 | 推荐的公开发行方案 |
| Fully Bundled | 较大 | 无 | 离线环境、完全便携 |

完整权衡见 打包方案设计。

macOS 快速开始

前置条件

node --version
npm install --global @deepseek-ai/dsh

当前版本建议使用 Node.js 22。也可以通过环境变量指定路径：

export DSH_NATIVE_NODE=/absolute/path/to/node
export DSH_NATIVE_ENTRY=/absolute/path/to/@deepseek-ai/dsh/lib/bin.js

构建 Universal 2 App

./scripts/build-macos.sh
open ".build/DeepSeek Harness Native.app"

构建脚本生成同时支持 Apple Silicon 与 Intel 的 macOS 13+ Universal 2 应用。
本地构建默认进行 ad-hoc 代码签名并密封 App 内容；发布构建可通过
DEEPSEEK_HARNESS_SIGN_IDENTITY="Developer ID Application: ..." 指定正式签名身份。

工作方式

双击 DeepSeek Harness Native │ ├─ 验证 3080 的监听进程和页面均为官方 Harness → 直接连接 │ └─ 未运行或身份不可信 → 解析并验证 Node.js 22+ 与官方 dsh │ ├─ 在随机回环端口启动 dsh web ├─ 有界健康检查 └─ 在系统 WebView 中打开官方 UI

更多细节见 架构说明 与 路线图。

安全与隐私

- App 不读取、复制或上传 API Key。
- Provider 凭据仍由官方 DeepSeek Harness 的配置机制管理。
- Harness 服务仅通过本机回环地址连接。
- WebView 仅允许当前 Harness 的精确来源；用户点击的 HTTP(S)/邮件链接交给系统应用。
- Node.js 与 dsh 入口会验证版本、包名和文件权限；危险注入环境变量不会传给子进程。
- 日志目录权限为 0700、日志文件权限为 0600。

安全问题请参阅 SECURITY.md。

License

MIT。DeepSeek、DeepSeek Harness 及相关标识归其各自权利人所有。本仓库仅提供非官方桌面启动体验。