dsh-desktop-linux

本项目为独立社区项目。不是 DeepSeek 官方产品，与 DeepSeek 无隶属关系。

把 DeepSeek Harness 官方桌面端（apps/desktop 的 Electron 应用）的打包流水线移植到 Linux，产出 AppImage / deb / rpm / Arch 包。

上游目前明确不支持 Linux（apps/desktop/README.md："Linux is not a supported Desktop release target."）。本项目补的就是这一块：让官方打包流水线认得 linux-x64 并产出安装包。当前验证范围见验证状态。

DeepSeek Harness 桌面端界面

项目产物

本项目的产物是官方 Electron 应用本身：

渲染走自己的 dsh-app:// 协议，而不是去连一个本地 Web 服务；
内置 Node / pnpm / Python 运行时，不依赖系统 Node；
独占 $DSH_HOME/profiles/desktop，不占用 web profile。

代价是构建重得多：要拉上游 monorepo、跑 pnpm workspace 构建、再用 electron-builder 打包。

安装

发行版	格式	安装方式
通用	AppImage	从 Releases 下载，`chmod +x` 后直接运行
Debian / Ubuntu	deb	`sudo apt install ./deepseek-harness-*.deb`
Fedora / RHEL	rpm	`sudo dnf install ./deepseek-harness-*.rpm`
Arch Linux	PKGBUILD	仓库自带，本地 `makepkg` 构建（未发布到 AUR），见 Arch 包

产物是 unsigned 构建（文件名里带 -unsigned）。安装后 dsh:// 链接会交给它处理。

从源码构建

依赖：Node 22.19+ 或 24+、pnpm 11、git。打 rpm 还需要系统有 rpmbuild。

git clone https://github.com/ffyfox/dsh-desktop-linux
cd dsh-desktop-linux

./scripts/fetch-upstream.sh      # 拉上游源码（默认用 PKGBUILD 里钉的 tag）
./scripts/apply-patches.sh       # 打补丁
./scripts/build.sh --all         # AppImage + deb + rpm
./scripts/verify.sh --runtime    # 验证矩阵

build.sh 的参数：--dir（只出未打包目录，最快）、--appimage（默认）、--deb、--rpm、--all。整条流水线（build:official → release:pack → prepare:* → package）才是耗时大头，多打一种格式只多一次 fpm/AppImage 打包，所以分开跑更快，也更容易定位失败。

产物落在 upstream/apps/desktop/.desktop-build/targets/linux-x64/unsigned-artifacts/。

deb / rpm 的 Maintainer: / Homepage: 来自 upstream/apps/desktop/.env.linux。build.sh 首次运行就从仓库里的 .env.linux.example 生成，值已经填好。要换成你自己的，改那个文件即可： 同名环境变量会被上游整个滤掉，DSH_DESKTOP_LINUX_MAINTAINER=… build.sh --deb 静默无效。

硬性前提

必须用 pnpm 11。 上游仓库声明 packageManager: pnpm@11.7.0，pnpm 11 会自己切到该版本； pnpm 9 会在 pnpm install 报 ERR_PNPM_LOCKFILE_CONFIG_MISMATCH。

Arch 包

PKGBUILD 直接吃上游的 release 源码包，不依赖 ./upstream 检出：

./scripts/pkgbuild-dir.sh     # 摊平成 ./pkgbuild
cd pkgbuild && makepkg -si

本项目不发布到 AUR，PKGBUILD 只用于本地构建。

Arch 包只出未打包目录装进 /opt/deepseek-harness-desktop，/usr/bin/deepseek-harness 是符号链接。

它是怎么工作的

官方 Electron 壳（apps/desktop）
├── 渲染进程 ──── dsh-app:// 协议 ──── 应用 UI
└── Host 进程 ─── primary-runtime 自带的真 Node ─── 捆绑的 dsh 运行时
                       └── $DSH_HOME/profiles/desktop

三个值得知道的设计点：

Host 跑在真 Node 上，不是 Electron 的 node 模式。 Electron 的 node 模式下 sharp 解码会段错误，所以 Linux 的 Host 改走 primary-runtime 自带的 Node。连带地，Linux 产物的 dsh 目录树不放进 asar （真 Node 读不了归档），这是 linux-unpacked 体积偏大的原因。
profile 是独占的。 桌面端用 $DSH_HOME/profiles/desktop，CLI 连参数层面都拒绝这个 profile （error: profile "desktop" is managed exclusively by the Electron application）。会话、设置、凭据仍在 $DSH_HOME 根上，与 CLI 共享。
沙箱。 内核支持非特权 user namespace 时走 namespace 沙箱（渲染进程在独立 user namespace + seccomp）；不支持才退回 setuid chrome-sandbox。AppImage 交给 AppRun 自己探测，deb / rpm / Arch 包在 postinst 里做同样的判断。

关窗、托盘与退出

关窗不是退出——这是上游的设计。 上游 main.ts 拦截主窗口的 close 并改为隐藏：Host 继续跑、正在跑的任务不中断，会话写锁也不释放（每个会话一把内核 flock，且刻意没有过期机制）。所以关窗之后，另一个 DSH 实例（比如终端里的 dsh web）打开同一个会话时，会看到官方提示「当前会话已被占用，可能是其他正在运行的 DSH 导致的……请退出其他正在运行的 DSH 后重试」。

上游给「回到隐藏窗口」准备了两条路，但文档里写到的只有 Windows 的托盘和 macOS 的 Dock， Linux 原本一条都没有。补丁 0013 把托盘补上：图标常驻，带托盘菜单。托盘菜单「退出」走与窗口菜单栏 Quit、Ctrl+Q 相同的确认流程（Host 有在跑的任务或定时任务时会先问一次）。

托盘菜单：右键点图标弹出。
真正退出：托盘右键菜单的「退出」、菜单栏 Application → Quit、或 Ctrl+Q。
找回窗口：再启动一次即可（第二次启动只聚焦已有实例）。

验证状态

当前实测环境较少，后续会尽可能拓展。 下面两张表随反馈更新——欢迎在 Issues 报告你的结果，能用和不能用都欢迎。

环境

环境	状态
Arch Linux · KDE Plasma 6 · Wayland · x86_64	已实测，正常
Ubuntu 26.04 LTS · GNOME 50 · Wayland · x86_64	已实测，正常（托盘宿主 Ubuntu 自带）
Debian 13 · GNOME 48 · Wayland · x86_64	已实测，正常（托盘要装扩展并重登，见已知限制）
X11（任意发行版 / 桌面环境）	未验证
其他桌面环境（Hyprland 等）	未验证
Fedora / RHEL	未验证
aarch64	未构建、未验证

产物

产物	状态
AppImage	已实测：构建并起窗口
`linux-unpacked`	已实测：`verify.sh --runtime` 活体矩阵
deb	已实测：`apt install` → 启动 → 托盘、关窗 → 退出
rpm	只核对过 `rpm -qip` 字段，未在 Fedora / RHEL 上安装运行
Arch 包	已实测：`makepkg` → `pacman -U` 安装 → 启动、沙箱、卸载

已知限制

GNOME 默认看不到托盘，要自己装扩展。 托盘走 freedesktop 的 StatusNotifierItem，GNOME 本体不提供宿主，装 gnome-shell-extension-appindicator 才有（Ubuntu 默认已装，Debian 要自己 apt install）。装完还有两个坑：扩展 UUID 是 ubuntu-appindicators@ubuntu.com（Debian 13 的 59-4 就是这个名字，旧文档里的 appindicatorsupport@rgcjonas.gmail.com 已废弃），而且新装的扩展不会热加载，得注销重登才生效。没有托盘宿主时图标不会出现，关窗后就只能靠二次启动把窗口找回——也就是「关窗即静默消失」那个老问题会回来。
Electron 版本比上游 lockfile 钉的高（44.4.5）。 上游 apps/desktop/package.json 写的是 ^44.0.0，caret 本来就允许；但它的 lockfile 把解析钉死在 44.0.0，而那个版本的托盘项在 KDE 与 GNOME 下都注册不上（上游回归 electron#53213，修复 electron#53214 直到 2026-08-26 才合并，而 44.0.0 发布于 08-25）。补丁 0014 把 lockfile 解到 44.4.5，代价是 Linux 产物自带的 Chromium 比上游发布的桌面端更新一点。
没有自动更新。 上游的强制更新策略通道只认 desktop-win / desktop-mac 客户端身份， Linux 产物也没有更新通道，所以 Linux 版不嵌入策略、不轮询、不会自己更新。
不签名。 产物是 unsigned 构建。
Platform 侧会把 Linux 客户端认成 macOS。 上游的客户端身份映射是 platform === 'win32' ? 'desktop-win' : 'desktop-mac'，Linux 落到 desktop-mac。这是上游类型联合 'darwin' | 'win32' | null 的结果，不是本项目引入的；同一个请求里的 device_model 又是 linux-x64。
linux-unpacked 约 1.1G。 asar 关闭后是小文件目录树，AppImage 压成 squashfs 后 339M，但首次启动的文件读取比 asar 多。
只做 x86_64。

许可

MIT

dsh-desktop-linux

中文 | English

本项目为独立社区项目。不是 DeepSeek 官方产品，与 DeepSeek 无隶属关系。

把 DeepSeek Harness 官方桌面端（apps/desktop 的 Electron 应用）的打包流水线移植到 Linux，产出 AppImage / deb / rpm / Arch 包。

DeepSeek Harness 桌面端界面

项目产物

本项目的产物是官方 Electron 应用本身：

渲染走自己的 dsh-app:// 协议，而不是去连一个本地 Web 服务；
内置 Node / pnpm / Python 运行时，不依赖系统 Node；
独占 $DSH_HOME/profiles/desktop，不占用 web profile。

代价是构建重得多：要拉上游 monorepo、跑 pnpm workspace 构建、再用 electron-builder 打包。

安装

发行版	格式	安装方式
通用	AppImage	从 Releases 下载，`chmod +x` 后直接运行
Debian / Ubuntu	deb	`sudo apt install ./deepseek-harness-*.deb`
Fedora / RHEL	rpm	`sudo dnf install ./deepseek-harness-*.rpm`
Arch Linux	PKGBUILD	仓库自带，本地 `makepkg` 构建（未发布到 AUR），见 Arch 包

产物是 unsigned 构建（文件名里带 -unsigned）。安装后 dsh:// 链接会交给它处理。

从源码构建

依赖：Node 22.19+ 或 24+、pnpm 11、git。打 rpm 还需要系统有 rpmbuild。

git clone https://github.com/ffyfox/dsh-desktop-linux
cd dsh-desktop-linux

./scripts/fetch-upstream.sh      # 拉上游源码（默认用 PKGBUILD 里钉的 tag）
./scripts/apply-patches.sh       # 打补丁
./scripts/build.sh --all         # AppImage + deb + rpm
./scripts/verify.sh --runtime    # 验证矩阵

产物落在 upstream/apps/desktop/.desktop-build/targets/linux-x64/unsigned-artifacts/。

硬性前提

必须用 pnpm 11。 上游仓库声明 packageManager: pnpm@11.7.0，pnpm 11 会自己切到该版本； pnpm 9 会在 pnpm install 报 ERR_PNPM_LOCKFILE_CONFIG_MISMATCH。

Arch 包

PKGBUILD 直接吃上游的 release 源码包，不依赖 ./upstream 检出：

./scripts/pkgbuild-dir.sh     # 摊平成 ./pkgbuild
cd pkgbuild && makepkg -si

本项目不发布到 AUR，PKGBUILD 只用于本地构建。

Arch 包只出未打包目录装进 /opt/deepseek-harness-desktop，/usr/bin/deepseek-harness 是符号链接。

它是怎么工作的

官方 Electron 壳（apps/desktop）
├── 渲染进程 ──── dsh-app:// 协议 ──── 应用 UI
└── Host 进程 ─── primary-runtime 自带的真 Node ─── 捆绑的 dsh 运行时
                       └── $DSH_HOME/profiles/desktop

三个值得知道的设计点：

Host 跑在真 Node 上，不是 Electron 的 node 模式。 Electron 的 node 模式下 sharp 解码会段错误，所以 Linux 的 Host 改走 primary-runtime 自带的 Node。连带地，Linux 产物的 dsh 目录树不放进 asar （真 Node 读不了归档），这是 linux-unpacked 体积偏大的原因。
profile 是独占的。 桌面端用 $DSH_HOME/profiles/desktop，CLI 连参数层面都拒绝这个 profile （error: profile "desktop" is managed exclusively by the Electron application）。会话、设置、凭据仍在 $DSH_HOME 根上，与 CLI 共享。
沙箱。 内核支持非特权 user namespace 时走 namespace 沙箱（渲染进程在独立 user namespace + seccomp）；不支持才退回 setuid chrome-sandbox。AppImage 交给 AppRun 自己探测，deb / rpm / Arch 包在 postinst 里做同样的判断。

关窗、托盘与退出

托盘菜单：右键点图标弹出。
真正退出：托盘右键菜单的「退出」、菜单栏 Application → Quit、或 Ctrl+Q。
找回窗口：再启动一次即可（第二次启动只聚焦已有实例）。

验证状态

当前实测环境较少，后续会尽可能拓展。 下面两张表随反馈更新——欢迎在 Issues 报告你的结果，能用和不能用都欢迎。

环境

环境	状态
Arch Linux · KDE Plasma 6 · Wayland · x86_64	已实测，正常
Ubuntu 26.04 LTS · GNOME 50 · Wayland · x86_64	已实测，正常（托盘宿主 Ubuntu 自带）
Debian 13 · GNOME 48 · Wayland · x86_64	已实测，正常（托盘要装扩展并重登，见已知限制）
X11（任意发行版 / 桌面环境）	未验证
其他桌面环境（Hyprland 等）	未验证
Fedora / RHEL	未验证
aarch64	未构建、未验证

产物

产物	状态
AppImage	已实测：构建并起窗口
`linux-unpacked`	已实测：`verify.sh --runtime` 活体矩阵
deb	已实测：`apt install` → 启动 → 托盘、关窗 → 退出
rpm	只核对过 `rpm -qip` 字段，未在 Fedora / RHEL 上安装运行
Arch 包	已实测：`makepkg` → `pacman -U` 安装 → 启动、沙箱、卸载

已知限制

GNOME 默认看不到托盘，要自己装扩展。 托盘走 freedesktop 的 StatusNotifierItem，GNOME 本体不提供宿主，装 gnome-shell-extension-appindicator 才有（Ubuntu 默认已装，Debian 要自己 apt install）。装完还有两个坑：扩展 UUID 是 ubuntu-appindicators@ubuntu.com（Debian 13 的 59-4 就是这个名字，旧文档里的 appindicatorsupport@rgcjonas.gmail.com 已废弃），而且新装的扩展不会热加载，得注销重登才生效。没有托盘宿主时图标不会出现，关窗后就只能靠二次启动把窗口找回——也就是「关窗即静默消失」那个老问题会回来。
Electron 版本比上游 lockfile 钉的高（44.4.5）。 上游 apps/desktop/package.json 写的是 ^44.0.0，caret 本来就允许；但它的 lockfile 把解析钉死在 44.0.0，而那个版本的托盘项在 KDE 与 GNOME 下都注册不上（上游回归 electron#53213，修复 electron#53214 直到 2026-08-26 才合并，而 44.0.0 发布于 08-25）。补丁 0014 把 lockfile 解到 44.4.5，代价是 Linux 产物自带的 Chromium 比上游发布的桌面端更新一点。
没有自动更新。 上游的强制更新策略通道只认 desktop-win / desktop-mac 客户端身份， Linux 产物也没有更新通道，所以 Linux 版不嵌入策略、不轮询、不会自己更新。
不签名。 产物是 unsigned 构建。
Platform 侧会把 Linux 客户端认成 macOS。 上游的客户端身份映射是 platform === 'win32' ? 'desktop-win' : 'desktop-mac'，Linux 落到 desktop-mac。这是上游类型联合 'darwin' | 'win32' | null 的结果，不是本项目引入的；同一个请求里的 device_model 又是 linux-x64。
linux-unpacked 约 1.1G。 asar 关闭后是小文件目录树，AppImage 压成 squashfs 后 339M，但首次启动的文件读取比 asar 多。
只做 x86_64。

许可

MIT

ffyfox/dsh-desktop-linux

dsh-desktop-linux

项目产物

安装

从源码构建

硬性前提

Arch 包

它是怎么工作的

关窗、托盘与退出

验证状态

环境

产物

已知限制

许可

Community comments

ffyfox/dsh-desktop-linux

dsh-desktop-linux

项目产物

安装

从源码构建

硬性前提

Arch 包

它是怎么工作的

关窗、托盘与退出

验证状态

环境

产物

已知限制

许可

Community comments