桌面启动器linuxlemon256/dsh-desktop

dsh-desktop 🖥️🐋

「我就想双击一下」版 DeepSeek Harness 桌面客户端。

不用终端、不用 dsh web、不用担心「这台机器怎么连 Node.js 都没有」——
dsh-desktop 把一切都打包好了，自动拉起服务，关窗时还会乖乖收拾残局。

License: MIT
Electron
Platform

为什么需要它？🤔

DeepSeek Harness 以 CLI 形式分发，界面藏在 dsh web 后面——这意味着你需要
终端、浏览器标签页，外加几秒钟的「服务到底还活着没」的焦虑。

如果你更想双击一个东西而不是敲一行命令——有任务栏图标，关窗自动清理——
这个项目就是来补这块缺口的。

功能特性 ✨

- 一键启动 —— dsh web 服务没在运行时自动拉起
- 复用已有服务 —— 服务已经在跑就直接连上，绝不误杀它没拉起的进程（它很有素质）
- 零环境依赖 —— Node.js、dsh CLI、pnpm 全部打进安装包，你的机器保持「素颜」
- 生命周期干净 —— 退出时终止自己拉起的进程树。没有僵尸、没有孤儿、没有「到底谁在吃我内存」
- 单实例保护 —— 重复启动只聚焦已有窗口，不会出现两个服务抢一个端口
- 端口可配置 —— 设 DSH_PORT（默认 3080），说改就改
- 端口设置界面 —— 在 dsh 设置页「Web UI 插件」栏目里直接改服务端口、扫描端口占用；启动时若端口被其他程序占用，会提供空闲端口
- 跨平台 —— Windows / macOS / Linux，任君挑选

环境要求 📦

安装包什么都不需要。 Node.js、dsh、pnpm —— 全在里面。
安装 → 双击 → 完事。就这么简单，趁这功夫去泡杯咖啡。

只有从源码跑的人（懂，我们都懂）才需要：

- Node.js >= 22.12
- 全局安装 dsh CLI：

npm install -g @deepseek-ai/dsh

快速开始 🚀

git clone https://github.com/linuxlemon256/dsh-desktop.git
cd dsh-desktop
npm install
npm start

配置项 🎛️

| 环境变量 | 默认值 | 说明 |
| --- | --- | --- |
| DSH_PORT | 3080 | dsh web 服务的 TCP 端口（设置后以 dsh web --port 传递） |
| DSH_SKIP_PLUGIN_INSTALL | 未设置 | 设为 1 跳过 IDE 工作台的自动安装 |

扩展 UI（社区插件）🧩

dsh web profile 支持第三方插件，给 harness 界面加 IDE 级功能。
应用会在首次启动时自动装好下面的 IDE 工作台（当 web profile 里没有时）——
拉下来启动就能用，无需手动配置。想保持「原味」就设 DSH_SKIP_PLUGIN_INSTALL=1。
首次启动因为要装插件会稍慢，就当是它预支了你的耐心。

1. IDE 工作台：dsh-better-sidebar（推荐，自动安装）🛠️

在 harness 里直接获得完整工作台，不用再开一个 IDE。真的：

- 文件工作台：懒加载目录树 + CodeMirror 编辑器
- 真实终端：xterm.js + node-pty
- Git 面板：VSCode 式 diff（暂存/提交/还原）
- 内嵌浏览器、后台任务页、可拆分分栏布局

手动安装（和应用自动装的效果一样，适合手痒党）：

dsh plugin --profile web add dsh-better-sidebar

详见 dsh-better-sidebar（MIT）。

2. 文件树 + 预览面板：@linxin666/dsh-web-ui-all

一条命令装齐（Apache-2.0）：

- 资源管理器面板：文件树、文件名搜索、git 变更（暂存/取消/丢弃）
- 预览面板：10+ 格式多标签预览（markdown、代码、pdf、office、图片等）
- 任务看板、git 图、皮肤中心、实时统计 等

npm install -g pnpm
dsh plugin --profile web add @linxin666/dsh-web-ui-all

pnpm ≥ 11 有点多疑：原生依赖（ssh2、node-pty）默认被拦，可能报
ERR_PNPM_IGNORED_BUILDS。遇到就打开
~/.dsh/profiles/web/pnpm-workspace.yaml，把 allowBuilds 各项设为
true，然后重新执行一次 dsh plugin ... add——必须成功退出（退出码 0）
插件才会写进 dsh.profile.bundles 并生效。

装完重启应用，打开项目会话（带工作目录的会话）就能看到效果。
面板有点害羞——得有项目在才肯露面。

构建安装包 🔨

npm run prepare:resources  # 把 node + dsh + pnpm 打进 resources/（构建前必跑）
npm run build:win          # Windows：NSIS 安装包
npm run build:mac          # macOS：DMG（需要 macOS 机器）
npm run build:linux        # Linux：AppImage（需要 Linux 机器）

产物输出到 dist/ 目录。发布官方多平台产物时，推送 v* 标签即可触发
release 工作流，GitHub Actions 会在三个平台
分别构建并把文件（含 SHA256SUMS.txt）自动挂到 Release 上。
重活交给 CI，你只负责打标签。

工作原理 🧠

1. 启动时探测 http://127.0.0.1:3080 是否有 dsh web 服务在运行。
2. 1.5 秒内无响应，就用内置运行时拉起 dsh web（没有内置时才退回 PATH），设置了 DSH_PORT 时附加 --port 参数。
3. 轮询端口直到服务就绪（60 秒超时），然后在 Electron 窗口中加载界面。启动期间崩溃会自动重试（最多 3 次），并弹一个明确的错误框，绝不挂白屏。
4. 关闭窗口时终止子进程树——仅当服务是本应用拉起的。外部已运行的服务保持不动，各回各家。

完整的架构说明和与 DeepSeek Harness 的派生关系见
docs/deepseek-harness-integration.md（二次开发说明文档）。

项目结构 🗂️

dsh-desktop/
├── .github/               # Issue 与 PR 模板
├── docs/                  # DeepSeek Harness 集成说明（二次开发文档）
├── scripts/               # prepare-resources.mjs —— 打包运行时
├── src/main.js            # Electron 主进程（整个应用就这一个文件）
├── package.json
├── LICENSE                # MIT
└── THIRD_PARTY_NOTICES.md # 上游版权声明

路线图 🗺️

- [x] 窗口打开期间 dsh web 崩溃时自动重启 —— 已在 2.0.3 完成
- [x] 设置界面（端口） —— 已在 2.0.3 完成：dsh 设置页「Web UI 插件」栏目里有端口卡片（改端口、扫描占用）
- [ ] 设置界面（开机自启）
- [x] 安装提速 —— 已在 2.0.x 完成：裁剪内置运行时（去掉 .d.ts/.map/源码/文档/测试），NSIS 改用 useZip（直接解压、无临时暂存），安装耗时缩短约 3.5 倍

参与贡献 🤝

欢迎提交贡献！请先阅读 CONTRIBUTING.md；上报安全问题前请阅读 SECURITY.md。

许可证 📄

MIT —— 详见 LICENSE。

本项目是对 DeepSeek Harness
（MIT，© 2026 DeepSeek）的二次开发，版权归属说明见
THIRD_PARTY_NOTICES.md。