ingleav626-art/dsh-native-launcher

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

以“零额外安装”为设计理念:仅通过一个官方插件配合Windows原生机制,即可让DeepSeek Harness Web UI实现桌面应用式的一键启动体验。

Project Overview项目介绍

This is a natively built launcher plugin exclusively for DeepSeek Harness (DSH), designed to turn DSH's existing Web UI into a desktop app-like experience on Windows. It only supports Windows 10 and 11 64-bit systems, and follows a "zero extra installation" design principle. It relies entirely on DSH's official plugin ecosystem and base dependencies, and does not bundle any heavy runtimes like Electron, Python, or WebView2. It adds native desktop capabilities that the web version lacks, including system tray integration, Windows native notifications, and automatic service exit when all DSH windows are closed.

For regular users, the recommended installation method is to install via npm globally, then add the plugin to your DSH profile using the official DSH plugin command. After installation, you just need to restart DSH Web for the plugin to take effect. A desktop shortcut will be created automatically, and a system tray icon will appear in the Windows taskbar after launch. You can double-click the shortcut to open DSH, and if DSH is already running, it will just bring the existing window to the foreground instead of opening a new instance.

This project is released under the open source MIT license, and is currently in maintenance mode, meaning it only receives bug fixes and compatibility updates for new official DSH versions, and no major new features will be added. It includes a one-click uninstall feature that automatically cleans up all generated files, shortcuts, and registry entries, and does not affect DSH's core service or user data. All logs for installation, runtime, and uninstallation are stored in a single dedicated log folder in the user directory, making it easy to troubleshoot any issues that arise.

这是一个专为 DeepSeek Harness (DSH) 开发的原生启动器插件,仅支持 Windows 10/11 x64 系统,设计遵循「零额外安装」原则,完全基于 DSH 官方插件生态和基础依赖构建,不引入 Electron、Python 等额外重型运行时或第三方框架。它为 DSH 的 Web UI 补上了桌面端原生能力,实现类桌面应用的一键启动体验。

安装可通过 npm 全局安装后,使用 DSH 官方插件命令添加到配置文件中,开发者也可克隆源码后本地安装。安装完成重启 DSH 后,会自动生成桌面快捷方式,右下角常驻系统托盘图标,双击快捷方式即可启动,已有运行实例时仅聚焦现有窗口不会重复开启。全部功能支持可视化配置,适合想要把 DSH 作为本地独立桌面应用使用的 Windows 用户。

项目采用 MIT 许可证,目前已进入维护阶段,仅做缺陷修复和官方版本适配,不再新增大型功能。它提供一键卸载功能,可自动清理所有生成文件、快捷方式和注册表项,不会影响 DSH 本身的服务和数据。所有启动、运行、卸载日志统一归档在用户目录的指定日志文件夹中,方便排查问题。

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

把 ingleav626-art/dsh-native-launcher 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

就在今天(2026.9.29)deepseek正式发布了dsh桌面端,我们的插件就此退役,很感谢使用并反馈的人,日后请大家使用桌面端即可获得本插件的所有功能。

dsh-native-launcher

以"零额外安装"为设计原则:本插件基于 DSH 官方插件生态及其官方基础依赖构建,不重复引入其他开源框架或重型运行时,仅凭一个官方插件与 Windows 原生机制,让 DeepSeek Harness Web UI 获得桌面 App 式的一键启动体验。

设计理念

把 dsh 的 WebUI 变成桌面应用,并补上 Web 形态天生缺的原生能力:托盘、原生通知、关窗即退。

  • 桌面化已完成:快捷方式、托盘、独立窗口、任务通知、关窗即退——启动器该有的都有了。它小而稳定,没有报告的问题就不再折腾;后续以缺陷修复与官方版本适配为主。
  • "零额外安装":不引入 Electron / Python / WebView2 等任何重型桌面端或运行时;插件依赖 DSH 官方插件生态及其官方基础依赖,复用官方能力而不重复实现。装进 profile 即用,卸载即干净。
  • 以官方为中心:不魔改、不替换官方 Web UI,一切围绕官方版本做加法;插件本身也只是标准 dsh 插件,官方升级后依然兼容。
  • 维护为主:功能范围已收敛——不再扩展新的大功能,把已有的做实做稳,跟随官方版本做适配与修复。用户的反馈和新需求依然欢迎,会按实际价值评估是否实现。
  • 个人喜好驱动:功能取舍以本人实际使用为准,也欢迎大家反馈使用中的问题。

一句话:让 dsh 在 Windows 上像桌面软件一样工作——启动、驻留、提醒、退出,都在系统里完成。

安装

平台:仅支持 Windows(Windows 10/11,x64)。macOS / Linux 请勿安装本插件。

版本要求:需要 dsh >= 0.1.5-rc.2(已适配 dsh 0.1.7 并以其为真机验证基准;--no-open 参数自 rc.8 起、任务通知所依赖的官方能力自 0.1.5 起)。本插件以该区间为基线持续适配,不再针对更低版本做适配与验证——使用更低版本 dsh 请安装对应的历史插件版本(见下方「版本状态」)。dsh 版本过低时,插件启动会在日志中给出升级提示。

前置要求:dsh plugin 命令依赖 pnpm。若提示 pnpm is not recognized,先安装:

npm install -g pnpm

(或启用 Node 自带的 corepack:corepack enable pnpm)

设置页表单使用 DSH 官方维护的 @deepseek-ai/schemastery,随插件安装声明;它属于 DSH 官方基础依赖,不是额外的社区功能框架。

推荐方式(普通用户):从 npm 安装,再用 DSH 官方的插件添加命令接入——拿到的是已发布的正式版本,不需要 clone 源码。

源码方式(开发者):需要修改代码、或跟进尚未发布的改动时使用。下载源码即视为以开发者身份使用本插件。

# 推荐:npm 安装 + 官方插件添加
npm install -g dsh-native-launcher
dsh plugin --profile web add dsh-native-launcher

# 开发:源码安装(指向本仓库目录)
git clone https://github.com/ingleav626-art/dsh-native-launcher
dsh plugin --profile web add <path-to-repo>
# 重启 dsh web 后生效

安装后重启:桌面出现快捷方式,右下角托盘出现图标。双击快捷方式即用。

安装为应用(推荐,一次性):普通标签页打开 http://127.0.0.1:3080 → 视觉中心出现安装提示框 → 点「安装」→ 弹出浏览器安装提示 → 确认。装完后:

  • 快捷方式自动打开已安装的应用(独立窗口、任务栏独立图标、可固定)
  • 若点安装无反应(浏览器安装抑制期),用 Edge 菜单 ⋯ → 更多工具 → 应用 → 将此站点安装为应用

特性

  • 桌面快捷方式:安装后自动生成桌面快捷方式,双击即可启动或返回 WebUI;支持自定义名称与强制重建。
  • 独立应用窗口:可将 WebUI 安装为桌面应用——拥有独立任务栏图标、无浏览器地址栏;未安装应用时按设置的打开方式回退(独立窗口 / 默认浏览器)。
  • 窗口自动聚焦:WebUI 已在运行时,再次点击快捷方式或托盘仅将现有窗口切换至前台,不会重复开启实例。
  • 系统托盘:常驻托盘图标,提供"打开 WebUI"与"退出"入口,并可发送 Windows 原生通知;可在设置中选择 dsh 停止后托盘是否保留。
  • 任务通知:任务完成、出错、中止、被阻塞、达到上限,以及等待审批 / 回答 / 计划审阅时,通过 Windows 原生通知提醒并进入通知中心;关闭全部页面后由后台补发,确保消息不遗漏。设置页有「发送测试通知」按钮,一键验证「模块 → 通知通道 → 托盘 → 系统」整条链路(排错第一站)。提示音三档可选:系统默认、静音,或自定义音效——在设置页选择本地音频文件(wav / mp3 / wma),改动即时生效,配完紧接着点「发送测试通知」就能试听。
  • 关窗即退:关闭全部窗口且无运行中任务时自动停止服务;存在运行中任务则等待其完成后再停止。防抖时长与二次确认窗口均可调整。
  • 完整设置界面:启动命令、端口、快捷方式名称、打开方式、托盘开关、通知开关、关闭行为参数及各功能模块开关,均在设置页可视化配置并持久化保存。
  • 模块化设计:附加功能以独立模块形式提供,可在设置页单独启用或停用;已使用其他同类插件的用户可关闭对应模块,避免功能冲突。
  • 一键卸载:在设置页完成卸载——自动停止服务、移除桌面快捷方式、清理生成文件与注册表项、从 profile 移除插件条目;可选同时清除全部个人配置。卸载过程记录于独立日志文件。
  • 日志与诊断:启动、运行、卸载全过程均有结构化日志记录,**全部集中在 %USERPROFILE%\.dsh-webui-launcher\logs\ 这一个文件夹里**(含网页端事件——统一汇入主日志,浏览器控制台不留任何东西)。出问题时**把整个 logs 文件夹发过来即可**,不用挑也不用筛选:主日志 native-launcher.log 内容最全,其余是各组件的时间线补充(启动分支、开页面、托盘、通知、应用扫描、卸载)。设置页有「打开日志目录(排错用)」按钮,一键定位。

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

← 上一个 Prev AGENTS.md-Best-Practices 下一个 Next jarvis-index →