YottaMeta/deepseek-harness

DeepSeek Harness: Everything is a Plugin.

Project Overview项目介绍

This repository ships a Windows desktop installer for DeepSeek Harness, with no source code published. It is built on Tauri plus the system WebView2 runtime and bundles Node.js v22.20+ together with the official @deepseek-ai/dsh package, producing an offline-ready installer of roughly 106 MB. After launch the wrapper simply runs the upstream dsh web command, so the GUI and data paths stay identical to the official CLI, using the standard ~/.dsh and ~/.agents directories, which can be relocated through the DSH_HOME and DSH_AGENTS_HOME environment variables for multi-disk or migration scenarios.

The intended workflow is to double-click a Start Menu or desktop shortcut instead of opening a terminal, typing dsh web, or pre-installing Node.js. The app enforces single-instance behavior, auto-starts the bundled service, and exposes a system tray with a minimize-to-tray option that keeps the dsh service alive in the background. Routine rc and minor-version updates happen in-app under Settings → Update, which stops the service, swaps the runtime, and restarts the shell; only breaking major-version jumps prompt the user to download a new setup.exe instead of silently upgrading.

Supported platforms are Windows 10 and Windows 11 on 64-bit hardware; WebView2 is usually preinstalled but the installer can fetch it if missing, and at least 500 MB of free disk is recommended for the runtime, cache, and session growth. The first install can run fully offline, but subsequent dsh updates require network access to pull packages from the npm mirror, and uninstalling the desktop shell deliberately preserves the data directories so reinstalls inherit existing chats and configuration. The project is a community-maintained wrapper rather than an official DeepSeek product, so CLI or web bugs should be reported upstream while installer, update flow, and tray issues belong in this repo's Issues tab.

本仓库发布的是 DeepSeek Harness 的 Windows 桌面封装安装包,不提供源代码。它基于 Tauri 与系统 WebView2 构建窗口壳,内置 Node.js v22.20+ 与官方 @deepseek-ai/dsh 运行时,安装包约 106 MB;启动后自动运行官方 dsh web,界面与直接使用官方 CLI 一致,数据落在标准 ~/.dsh 与 ~/.agents 目录,可通过 DSH_HOME、DSH_AGENTS_HOME 自定义位置。

典型用法是双击桌面快捷方式启动应用,无需预先安装 Node、配置 npm 或开启终端。窗口关闭可最小化到系统托盘继续运行 dsh 服务,应用内单实例、自动拉起并提供更新页;日常 rc 与小版本通过「设置 → 更新」一键跟随官方 npm 包,跨大版本时再下载新安装包覆盖升级。适合把 DeepSeek Harness 当作长期主力桌面工具使用的个人或团队。

依赖与限制方面:仅支持 Windows 10/11 64 位,需系统预装或自动补全 WebView2,建议预留 500 MB 以上磁盘空间;首次安装可完全离线,但后续更新 dsh 需联网通过 npm 镜像获取。卸载不会删除用户数据目录,重新安装后可继续使用;本项目为社区封装,非 DeepSeek 官方产品,问题需分别向官方仓库或本仓库 Issues 反馈。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • 14 stars - an early-stage project星标 14,属于早期项目
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:YottaMeta/deepseek-harness

把 YottaMeta/deepseek-harness 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek Harness Desktop

DeepSeek Harness 的 Windows 桌面版 —— 装完就能用,不用配环境,不用开终端。

本仓库发布 安装包(Releases),不提供源码。桌面版基于 Tauri 构建,在原生窗口中运行官方 DeepSeek Harness(dsh web),体验接近独立 App,同时始终跟随官方 npm 包更新 —— 轻壳 + 官方核,而不是再包一层自研 Host。

说明:本项目为社区维护的桌面封装,非 DeepSeek 官方产品。核心能力来自官方 @deepseek-ai/dsh 与 deepseek-harness 仓库。


为什么用桌面版?

痛点 桌面版怎么做
新电脑要装 Node、配 npm、全局装 dsh 安装包内置 Node.js + dsh 运行时,离线也能完成部署
每次都要开终端敲 dsh web 双击图标,自动启动服务并打开界面
浏览器标签容易被误关、和其他网页混在一起 独立窗口 + 系统托盘,关窗口可最小化到托盘继续跑
官方发新版本不知道咋更 设置 → 更新 一键跟随官方 rc 版本,会话和配置不动
大版本不兼容怕把环境搞坏 破坏性更新门控:major 跳变等不会静默强更,会提示下载新安装包

一句话:把 DeepSeek Harness 当正经桌面软件用,而不是当「又一个本地 Web 项目」伺候。


这一套有什么不同?

市面上也有把 Harness 包进桌面 App 的做法。我们的取向很直接:壳要轻,Harness 要正,更新要省心。

更轻:少背一层运行时

  • 基于 Tauri + 系统 WebView2,不内嵌完整 Chromium,内存占用和安装体积都更克制。
  • 完整离线安装包 约 106 MB(含 Node + dsh 运行时);主程序壳本体只有数 MB 量级。

更正:不另起炉灶的 Host

  • 界面加载的是官方 dsh web,不是把 Cordis / Agent 逻辑再封装一遍的「第二套运行时」。
  • 官方 npm 发版,你就跟官方 npm 走 —— 少一层中间商,行为与 CLI 用户看到的一致。
  • 数据落在标准 ~/.dsh / ~/.agents,和直接用 @deepseek-ai/dsh 的用户同一套目录;换电脑、备份、迁移都按官方习惯来,不搞私有数据格式。

更省心:更新在应用里闭环

  • 日常 rc / 小版本:设置 → 更新 → 立即更新,自动停服务、替换运行时、重启应用,不用切出去浏览器找下载页。
  • 更新过程有完整等待界面,失败会尝试恢复服务,数据目录全程不碰。
  • 只有真正不兼容的大版本才提示换安装包 —— 该保守时保守,该一键时一键。

更稳:离线能装,在线能跟

  • 首次安装可把 Node + dsh 运行时一次性打进包,没网也能在新机器上部署完。
  • 后续跟进官方版本走 npm 镜像,国内可用,不必依赖某个第三方下载站是否在线。

如果你已经在用官方 CLI、或希望「桌面化但别改 my Harness 长什么样」——这套就是往这个方向做的。


下载

👉 Releases 页面 下载最新安装包:

文件 说明
DeepSeek Harness Desktop_*_x64-setup.exe 推荐 — NSIS 安装包(含 Node + dsh 运行时,约 106 MB)

也可通过 npm 引导包查看下载说明(不会自动安装桌面程序):

npx @yottameta/dsh-desktop

系统要求

  • 操作系统:Windows 10 / 11,64 位
  • WebView2:多数 Win10/11 已预装;若缺失,安装程序会引导安装
  • 磁盘:建议预留 500 MB+(运行时、缓存与会话数据会随使用增长)
  • 网络:
    • 首次安装:可完全离线(运行时已打包进安装包)
    • 后续更新 dsh:需要联网从 npm 镜像拉取新版本(国内默认可用)

安装与首次启动

  1. 运行 DeepSeek Harness Desktop_*_x64-setup.exe,按向导完成安装。
  2. 从开始菜单或桌面快捷方式启动 DeepSeek Harness Desktop。
  3. 首次启动会看到品牌启动页,随后自动进入官方 GUI(通常 1–2 分钟内就绪,视机器性能而定)。
  4. 若安装过程中断,重新运行安装包即可修复,已有数据不会因此丢失。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev deepseek-harness-whitepaper 下一个 Next dsh-plugin-healthcheck →