kyorakuyk/dsh-desktop

Desktop桌面端 ⭐ 3 MIT Clients & Launchers客户端与启动器

Project Overview项目介绍

dsh-desktop is a native desktop client built exclusively for DeepSeek Harness, wrapping the official DeepSeek Harness web GUI in a Tauri 2 native window for a desktop-native experience across Windows, macOS, and Linux. Every pre-built release package bundles a full Node.js runtime and the complete @deepseek-ai/dsh distribution, so end users do not need to pre-install any dependencies or runtime environments on their local machine to run the app. To install, users just need to download the matching installer for their operating system from the project’s GitHub Releases page.

This client is designed for users who prefer a native desktop experience over launching DeepSeek Harness via the command line interface. When you first launch the app, it shows a splash screen while it assembles the backend host with roughly 30 plugins, a process that typically takes just a few seconds. After assembly completes, it automatically loads the full DeepSeek Harness graphical interface. You only need to add your DeepSeek API key in the settings menu to start using the app, and all user data is stored in the shared ~/.dsh directory used by the official CLI.

The project is open sourced under the permissive MIT license, and it is a community-maintained project with no official affiliation to DeepSeek. There are a few known limitations: the release package is relatively large at around 100MB because it bundles all dependencies, Linux does not currently offer an AppImage build, and automatic updates are not enabled by default. To build the app from source, you need Node.js 22 or newer, pnpm 11 or newer, and a Rust toolchain version 1.77 or higher.

dsh-desktop 是专为 DeepSeek Harness 打造的原生桌面客户端,基于 Tauri 2 框架将 DeepSeek Harness 的 Web GUI 封装进原生桌面窗口。安装包内置 Node.js 运行时和完整的 @deepseek-ai/dsh 依赖,用户无需在本机预先安装任何运行环境,开箱即可使用。项目支持 Windows、macOS、Linux 三大平台,用户只需从 GitHub Releases 下载对应平台的安装包即可安装使用。

这款客户端适合偏好原生桌面应用体验、不想通过命令行启动 DeepSeek Harness 的用户使用。启动后会先显示闪屏页,等待后端主机装配完成(约30个插件,通常需要数秒),之后就会自动进入完整的 DeepSeek Harness 图形界面。首次启动后,用户只需在图形界面的「设置-模型」中配置好 API Key 就能开始使用,数据默认和 CLI 版共用存放在 ~/.dsh 目录。

本项目采用 MIT 许可证开源,是社区开发的非官方封装,和 DeepSeek 官方没有附属关系。当前已知限制包括:安装包体积较大(约100MB量级),Linux 暂不提供 AppImage 格式安装包,自动更新功能未默认启用。开发构建需要 Node.js ≥22、pnpm ≥11、Rust 工具链 ≥1.77,Linux 还需要额外安装 WebKitGTK 开发依赖。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
  • 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:kyorakuyk/dsh-desktop

把 kyorakuyk/dsh-desktop 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-desktop

DeepSeek Harness 桌面客户端 — 基于 deepseek-harness 的 Tauri 原生窗口封装

Release CI License Topic

Windows · macOS · Linux — 开箱即用,无需安装 Node.js


这是什么

dsh-desktop 把 DeepSeek Harness 的 Web GUI(dsh web)装进原生桌面窗口:

  • Tauri 2 (Rust) 壳负责窗口、主机进程生命周期与打包;
  • **内嵌 Node.js 主机(sidecar)**运行 npm 上发布的 @deepseek-ai/dsh(dsh web --port 0);
  • WebView 直接访问 http://127.0.0.1:<随机端口>,完整复用 harness 的 window.__DSH_BOOT__ 注入、插件 bundle 服务、/api JSON-RPC 与 WebSocket 事件下行——不改动 deepseek-harness 一行代码。

安装包自带 Node 运行时与全部 harness 依赖,用户机器上无需预装任何运行时。

✨ 功能特性

能力 说明
🖥️ 原生窗口 Windows WebView2 / macOS WKWebView / Linux WebKitGTK
📦 零依赖安装 安装包内置 Node 运行时 + @deepseek-ai/dsh 全家桶
🔌 完整 harness 能力 会话、工具调用、插件、模型配置、工作区等与 dsh web 完全一致
🚀 即开即用 启动闪屏 → 主机装配(约 30 个插件行)→ 自动进入 GUI
🤖 模型配置 GUI 内 设置 → 模型 直接配置 API Key
🔄 跨平台发布 GitHub Actions 标签一键构建三平台安装包并发布 Releases
📋 日志落地 主机与壳日志统一输出(tauri-plugin-log)

📥 下载安装

从 Releases 下载对应平台的安装包:

平台 文件 说明
Windows dsh-desktop_<version>_x64-setup.exe NSIS 安装器,双击安装
macOS (Apple Silicon) dsh-desktop_<version>_aarch64.dmg 拖入 Applications 即可
macOS (Intel) dsh-desktop_<version>_x64.dmg 同上
Linux dsh-desktop_<version>_amd64.deb Debian / Ubuntu:sudo dpkg -i
Linux dsh-desktop-<version>-1.x86_64.rpm Fedora / RHEL:sudo rpm -i

首次使用:启动后等待数秒(主机装配),在 设置 → 模型 中配置 API Key 即可开始对话。 数据默认存放在 ~/.dsh(会话、设置、profile;与 dsh CLI 共用)。

🏗️ 架构

┌─────────────────────────────────────────────┐
│ Tauri 窗口 (WebView2 / WKWebView)           │
│  └─ 加载 http://127.0.0.1:<随机端口>         │
├─────────────────────────────────────────────┤
│ Rust 壳 (src-tauri)                         │
│  ├─ 拉起/监控 sidecar,解析 `dsh web:` URL 行│
│  ├─ 工作目录 ~/.dsh/workspace               │
│  ├─ 退出时终止主机进程                       │
│  └─ 日志(tauri-plugin-log)                 │
├─────────────────────────────────────────────┤
│ Sidecar:捆绑 Node 运行时 + @deepseek-ai/dsh│
│  └─ node host/main.mjs → dsh web --port 0   │
│     ├─ __DSH_BOOT__ 注入(dsh-client-modules│
│     │   节点端扫描 dsh.client 声明)          │
│     ├─ /plugins/<id>/client.js 插件 bundle   │
│     ├─ /api JSON-RPC 网关                    │
│     └─ /api/events.mux|host WebSocket 下行   │
└─────────────────────────────────────────────┘

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

← 上一个 Prev dsh-plugin-container 下一个 Next dsh-rp-tools →