DeepSeek Harness Hub
← 返回列表

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

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
需源码安装

一键启动本地 Web UI,复用系统 WebView 免装浏览器

暂不能直接安装(需源码编译或环境不满足):仓库缺少 package.json,无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/8/26 · 已提供中文文档

DeepSeek Harness 的非官方超轻量原生桌面外壳——1:1 还原官方 UI、系统 WebView、智能运行时复用、一键启动。

综合分
33.5
GitHub 分
33.5
用户评分
★ Stars
1
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add Max179/deepseek-harness-native
仓库缺少 package.json,无法用 dsh 插件安装命令安装,改用 GitHub 源安装
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包deepseek-harness-native(未发布到 npm,仅可源码安装)
Node 引擎未声明 engines.node
dsh CLI 依赖未声明 dsh 版本约束
入口文件缺少入口声明

仓库缺少 package.json,无法用 dsh 插件安装命令安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 07:10:23

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

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 及相关标识归其各自权利人所有。本仓库仅提供非官方桌面启动体验。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群