Zhou-Yujing114514/deepseek-harness-linux · 上手攻略

  • 仓库：Zhou-Yujing114514/deepseek-harness-linux
  • 链接：https://github.com/Zhou-Yujing114514/deepseek-harness-linux
  • 分类：Desktop App / Linux 打包
  • 作者：Jay
  • 更新：2026-10-04

是什么

这是一个社区维护的下游 fork，专注于为 DeepSeek Harness（DeepSeek 官方桌面端）提供一等公民级的 Linux 打包支持。

官方 DeepSeek Harness 桌面端目前只发布 macOS 和 Windows 安装包，Linux 用户要么退而求其次用 Web 版，要么自己从源码编译。本项目填补了这个缺口：以 AppImage / .deb / .tar.gz 三种格式，覆盖 x64（AMD/Intel）和 arm64（树莓派 5、Apple Silicon Linux、ARM 服务器等）双架构，配套原生 CI 自动构建和 AppImage 自动更新。

⚠️ 这是一个下游 fork，不魔改 agent 内核，agent 能力、插件体系、通信协议全部跟随上游（MIT 许可证）。

解决什么问题

  • Linux 用户无法使用 DeepSeek Harness 桌面端，只能用 Web 版或自己编译。
  • 源码编译需要 Node.js 24+、pnpm、FUSE2 等环境配置门槛高。
  • 官方桌面版迭代快，破坏性变更频繁，自己 fork 维护成本大。

本项目用标准化打包格式（AppImage / .deb / .tar.gz）让 Linux 用户直接下载安装，同时通过 CI 自动同步上游更新，不用手动维护 fork。

快速安装

方式一：AppImage（推荐，最简单）

  1. 到 Releases 下载对应架构的 .AppImage 文件。
  2. 安装 FUSE2 运行时依赖（Debian/Ubuntu）： bash sudo apt install libfuse2 # Fedora/RHEL: sudo dnf install fuse2
  3. 赋予执行权限并运行： bash chmod +x deepseek-harness-*-linux-x64.AppImage ./deepseek-harness-*-linux-x64.AppImage

arm64 版文件名示例：deepseek-harness-0.2.0-rc.2-linux-arm64.AppImage

方式二：.deb（Debian / Ubuntu 原生包管理）

sudo dpkg -i deepseek-harness-*-linux-x64.deb
deepseek-harness   # 或直接从应用菜单启动

方式三：.tar.gz（便携解压即用）

tar -xzf deepseek-harness-*-linux-x64.tar.gz
cd deepseek-harness-*-linux-x64
./deepseek-harness

无显示环境运行（服务器 + VNC）

确保已设置 DISPLAY（例如使用 TigerVNC 时设为 :1），桌面会自动拉起：

export DISPLAY=:1
./deepseek-harness-*-linux-x64.AppImage

核心用法

确认版本和架构

安装包按以下规则命名： - 格式：deepseek-harness-{版本号}-linux-{架构}.{格式} - 版本号示例：0.2.0-rc.2（RC 版本请注意上游变更风险） - 架构：x64（Intel/AMD）、arm64（ARM）

校验下载安全性

未签名构建请务必核对 Release 附带 SHA256 校验和：

sha256sum deepseek-harness-*-linux-x64.AppImage
# 与 Release 页面标注的校验和比对

AppImage 自动更新

AppImage 内置 electron-updater，通过 nightly-linux.yml 更新描述符走 HTTPS 更新通道。注意：未签名构建的更新仅依赖 HTTPS 传输 + feed 元数据校验，无代码签名验签——请勿在高信任场景开启自动更新。

构建自己定制的安装包（可选）

构建要求：Node.js 24+、pnpm、libfuse2（在构建主机上，用于 AppImage 组装）

git clone https://github.com/Zhou-Yujing114514/deepseek-harness-linux.git
cd deepseek-harness-linux
pnpm install
# 复制并编辑环境配置（按需填写发布设置）
cp apps/desktop/.env.linux.example apps/desktop/.env.linux
# 构建 x64
pnpm --dir apps/desktop run package:linux:x64
# 构建 arm64
pnpm --dir apps/desktop run package:linux:arm64

CI 在原生 runner（ubuntu-24.04 / ubuntu-24.04-arm）上构建，产物可在 GitHub Actions Artifacts 或 Release 中获取。

典型适用场景

场景 适用方式 说明
Linux 桌面使用 DeepSeek Agent AppImage/.deb 开箱即用，与 macOS/Windows 用户体验一致
CI/CD 环境集成 .tar.gz 便携版 解压即用，无需包管理器
ARM 服务器 / SBC（树莓派5） arm64 AppImage 官方唯一支持 ARM Linux 的打包方式
远程服务器 + VNC AppImage + DISPLAY Linux 服务器无显示环境，VNC 下运行桌面

坑与注意

  1. Office 文档转换暂缺：桌面内嵌的 DOCX/XLSX/PPTX → PDF 转换依赖 LibreOffice Kit 的 Linux 原生绑定，本版本未随包分发，该功能在 Linux 下暂不可用。其余功能（agent、skill、联网、前端）均正常。

  2. 未签名二进制：Linux 构建不带代码签名，是社区构建。分发时请务必在 Release 中核对 SHA256 校验和。

  3. 自动更新无签名验签：AppImage 更新通道未做代码签名验证，仅依赖 HTTPS + feed 元数据。高安全要求场景建议手动下载更新。

  4. 上游 developer preview：官方迭代快、破坏性变更频繁，本项目持续 rebase 上游，可能出现功能不兼容。

  5. Linux Desktop 暂停：官方 Linux 桌面版支持处于暂停状态，本项目是社区维护的补丁方案，不是官方支持。

  6. 无公证 / 无商店上架：不经过任何系统级公证或应用商店流程，需用户自行信任。

  7. 运行前阅读上游 SAFETY.md：https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md

与同类对比

维度 本项目 官方 deepseek-harness 自行编译
平台覆盖 Linux（AppImage/.deb/.tar.gz） macOS/Windows Linux（任意）
门槛 下载即用 下载即用 Node.js 24+ / pnpm / FUSE2
自动更新 AppImage 内置（无签名验签） 官方签名更新 需手动
架构支持 x64 + arm64 x64 + arm64 自选
维护成本 CI 自动同步上游 官方维护 用户自维护

结论：Linux 用户首选本项目打包，而非自己编译。arm64 架构（树莓派、ARM 服务器）是本项目的独特价值点，官方和自行编译都更麻烦。

一句话推荐结论

deepseek-harness-linux 是 DeepSeek Harness 桌面端唯一的 Linux 官方级打包方案，提供 AppImage / .deb / .tar.gz 三格式+x64/arm64 双架构，适合 Linux 桌面用户和 ARM SBC 场景；注意未签名和 Office 转换暂缺的限制，高安全场景手动核对 SHA256。