Anestis271/dsh-desktop 预览 preview

Anestis271/dsh-desktop

Desktop桌面端 Native原生 ⭐ 6 MIT Clients & Launchers客户端与启动器

将官方DeepSeek Harness WebUI转变为自然的桌面体验。

Project Overview项目介绍

Anestis271/dsh-desktop is a native plugin built exclusively for DeepSeek Harness (DSH) that wraps the official DSH WebUI in a native desktop shell. It does not recreate the entire DSH client from scratch, nor does it require users to download and install a separate standalone desktop application to use it. Instead, it adds a lightweight native desktop layer on top of the existing official WebUI, preserving all of DSH’s core functionality while delivering a consistent native desktop experience that works across Windows, macOS, and Linux.

Before installation, users must confirm they meet three basic prerequisites: a compatible Node.js version (^22.19.0 or >=24.0.0), a working installation of pnpm that can be called from the terminal, and a working copy of DSH that is also accessible via terminal. After confirming these prerequisites are met, users can install the plugin with a single command: dsh plugin --profile desktop add @anestis271/dsh-desktop, then launch DSH with the desktop profile via dsh --profile desktop. On first launch, the plugin will automatically download and unpack the Electron runtime for the user’s platform, which can take some time depending on network speed.

This plugin is released under the permissive MIT open source license, so it is completely free to use, modify, and distribute for any personal or commercial purpose. It follows a strict design principle that it only handles desktop shell-specific responsibilities, so it does not add duplicate account systems, extra business state, or unnecessary background services to DSH. All core DSH features, including chat sessions, user settings, models, and tools, are still provided by the official WebUI, so the plugin stays consistent with DSH updates without any extra parallel maintenance.

这是一个面向 DeepSeek Harness(DSH)开发的原生插件,作用是为 DSH 官方 WebUI 套上一层原生的桌面外壳,让官方网页端可以像普通桌面应用一样运行。它不是一套独立的新客户端,也不需要单独下载安装独立的桌面程序,仅通过安装一个轻量 npm 插件,就能保留官方 WebUI 的全部能力,同时获得干净原生的桌面体验,支持三大主流桌面系统。

用户需要提前安装好符合版本要求的 Node.js(^22.19.0 或 >=24.0.0)、pnpm 以及可正常运行的 DSH,然后通过 dsh plugin 命令就能完成安装,之后使用 dsh --profile desktop 即可启动。首次启动时插件会自动下载对应平台的 Electron 运行环境,后续启动会直接复用缓存,点击快捷方式就能唤起已有窗口,不会重复创建实例,启动速度更快。

该插件遵循 MIT 开源许可协议,完全免费使用。它仅负责窗口管理和系统集成,不额外添加账号体系、业务状态或后台服务,所有核心功能依然由官方 WebUI 提供。它支持系统托盘收起、原生窗口控制按钮、协调的标题栏、各平台快捷入口创建,遵循只做桌面外壳的设计原则。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
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 desktop add @anestis271/dsh-desktop

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

READMEREADME

DeepSeek Harness Desktop

简体中文 | English

npm version npm downloads license platform

让 DeepSeek Harness 官方 WebUI 自然地成为一个桌面应用。

这不是另一套客户端,也不需要单独下载安装桌面程序。它只是一个轻量的 dsh 插件:保留官方 WebUI 的全部能力,在外面加上一层干净、原生的桌面外壳。

预览

DeepSeek Harness Desktop 界面预览

为什么选择本插件

  • 无需单独安装应用:没有额外的 MSI、DMG 或 AppImage,只需安装一个 npm 插件。
  • 官方 WebUI 是唯一真源:不复制、不分叉、不重新实现界面,dsh 更新后依然保持一致。
  • 足够干净:不增加第二套业务状态、账号体系或后台服务,只负责窗口与系统集成。
  • 像真正的桌面应用:提供系统托盘、原生窗口按钮、协调一致的标题栏和可选快捷入口。
  • 重复启动更快:再次点击快捷方式时直接唤起现有窗口,不重复创建 dsh 和 WebUI 实例。

安装

安装前请确认:

  • Node.js 版本满足 ^22.19.0 或 >=24.0.0
  • 已安装 pnpm,且 pnpm --version 可以在终端中正常执行
  • dsh 已安装,且可以在终端中正常运行

然后执行:

dsh plugin --profile desktop add @anestis271/dsh-desktop
dsh --profile desktop

首次启动时,插件会下载并解压当前平台所需的 Electron 运行环境。下载大小和耗时取决于平台与网络状况,下载进度到达 100% 后仍可能需要等待片刻完成解压,请不要中断进程。准备完成后,后续启动会直接复用 profile 中的 Electron 缓存,启动速度会恢复正常,无需额外配置。

桌面体验

  • 关闭窗口时可收起到系统托盘
  • 托盘菜单支持显示/隐藏、刷新、打开 profile 目录和退出
  • 托盘菜单跟随 dsh 的中英文设置实时切换
  • 保留各平台原生的最小化、最大化和关闭按钮
  • 标题栏颜色与 WebUI 侧边栏协调,形成完整的 L 形视觉
  • 同一 profile 始终只保留一个窗口和一个托盘实例
  • 支持 Windows、macOS 和 Linux 的用户级快捷入口

快捷入口

启动 dsh Desktop 后,可在官方 WebUI 的 设置 → 通用设置 中按需创建桌面快捷方式和应用菜单入口;登录时启动默认关闭,可在同一位置开启。

这些入口仍然只启动 dsh --profile desktop,不会安装另一份 Electron,也不需要管理员权限。macOS 使用系统自带的 osacompile 生成本地 AppleScript 快捷应用,因此从桌面或 Applications 启动时不会额外打开 Terminal。登录启动关闭后,插件只会移除由它自己创建的入口。

macOS 的首次真机验收步骤见 docs/MACOS_SMOKE_TEST.md。

设计原则

dsh-desktop 只做桌面外壳应该做的事。会话、设置、模型、工具和所有业务界面继续由 DeepSeek Harness 官方 WebUI 提供;插件不会建立一套需要额外维护的平行客户端。

许可证

MIT

← 上一个 Prev dsh-meta-orchestrator 下一个 Next dsh-session-cleaner →