deepseek-harness-linux
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 57 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
First-class Linux packaging for DeepSeek Harness desktop — AppImage, .deb, .tar.gz for x64/arm64, built by native CI.
DeepSeek Harness · Linux 桌面版
给官方 DeepSeek Harness 桌面端补上一等公民级的 Linux 打包 —— 开箱即用的 AppImage /
.deb/.tar.gz,覆盖 x64 与 arm64 双架构,配套原生 CI 与 AppImage 自动更新。
官方桌面端只发布 macOS 与 Windows;Linux 用户要么退而用 Web 版,要么自己从源码硬编。本项目就是这个缺口的补完:在保留官方桌面全部功能的前提下,把 Linux 当成正式支持平台来打包、测试、分发。
这是什么 / 不是什么
- ✅ 是:一个下游 fork,专注做一件事——让 dsh 桌面端在 Linux 上「能下载、能装、能更新」。
- ❌ 不是:不是官方 DeepSeek 项目,也不魔改 agent 内核。agent 能力、插件体系、通信协议全部跟随上游。
产物一览
每次构建为每种架构产出三种安装包:
| 格式 | 用途 | 典型文件名 |
|---|---|---|
| AppImage | 单文件免安装,支持自动更新 | deepseek-harness-0.2.0-rc.2-linux-x64.AppImage |
| .deb | Debian / Ubuntu 系原生包管理 | deepseek-harness-0.2.0-rc.2-linux-x64.deb |
| .tar.gz | 便携解压即用 | deepseek-harness-0.2.0-rc.2-linux-x64.tar.gz |
支持架构:x64(AMD / Intel)、arm64(树莓派 5、Apple Silicon 上的 Linux、ARM 服务器等)。
快速开始
方式一:AppImage(推荐,支持自动更新)
- 到 Releases 下载对应架构的
.AppImage。 - 安装运行时依赖(AppImage 需要 FUSE 2):
sudo apt install libfuse2 # Debian / Ubuntu # Fedora / RHEL 系: sudo dnf install fuse2 - 赋予执行权限并运行:
chmod +x deepseek-harness-*-linux-x64.AppImage ./deepseek-harness-*-linux-x64.AppImage
方式二:.deb
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(例如 xfce4 + TigerVNC 下的:1),桌面会自动拉起。
从源码构建(开发者)
需要 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 # 按需填写发布设置
pnpm --dir apps/desktop run package:linux:x64 # x64
pnpm --dir apps/desktop run package:linux:arm64 # arm64
Desktop (Linux) 工作流会在原生 runner 上按需构建两种架构(ubuntu-24.04 / ubuntu-24.04-arm),产物可在 Actions Artifacts 或自动发布的 Release 中获取。
自动更新
AppImage 通过 electron-updater 走 AppImage 更新通道,更新描述符为 nightly-linux.yml,全程 HTTPS。未签名构建下,更新仅依赖 HTTPS 传输与 feed 元数据校验,无代码签名验签——请勿用于高信任场景,下载时务必核对 Release 附带的 SHA256。
已知限制
- 未签名:Linux 构建不带代码签名。这是社区构建,分发时请在 Release 中核对校验和。
- Office 文档转换暂缺:桌面内嵌的 DOCX / XLSX / PPTX → PDF 转换依赖 LibreOffice Kit 的 Linux 原生绑定,本版本尚未将其随包分发,该功能在 Linux 下暂不可用。其余桌面功能(agent、skill、联网、前端)均正常。
- 上游处于 developer preview:官方迭代快、破坏性变更频繁,本项目会持续 rebase 上游提交。
- 无公证 / 无商店上架:不走任何系统级公证或应用商店流程。
与上游的关系
- 上游:deepseek-ai/deepseek-harness(MIT,DeepSeek-AI)。
- 本仓库是其下游 fork:agent 内核与官方保持同步,新增内容仅限于 Linux 打包层——CI 工作流、electron-builder 配置、类型声明补全、POSIX launcher 兼容、桌面端打包说明与单元测试用例。
- 计划将 Linux 打包支持以 PR / Discussion 形式回喂上游,让官方原生支持 Linux 桌面。
安全须知
- 运行前请阅读上游 SAFETY.md。
- 未签名二进制存在供应链风险:只从本仓库 Release 下载,并核对 SHA256 校验和。
- 自动更新通道未做代码签名验签,仅依赖 HTTPS + feed 元数据。
许可证
本项目基于上游 MIT 许可证分发。DeepSeek Harness 由 DeepSeek-AI 开发,版权归其所有;Linux 打包层在同一 MIT 许可下新增。详见 LICENSE 与 THIRD_PARTY_NOTICES.md。
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found