DeepSeek Harness Desktop - Linux

DeepSeek Harness · Linux 原生桌面客户端

把 DeepSeek Harness Web UI 变成 Linux 原生桌面应用:独立窗口、系统托盘、沉浸式无边框模式, 保留登录状态与完整网页能力,开箱即用。

基于 WebApp Launcher 的定制版本。

界面预览

桌面端主界面	透明背景模式

特性

• 开箱即用:下载即运行,默认连接本机 http://127.0.0.1:3080 的 DeepSeek Harness;首次启动自动写入默认配置并直接进入桌面端
• 独立 WebKit 数据目录,Harness 登录/会话状态持久保存,不会受普通浏览器干扰
• 连接地址/名称/图标可在设置页修改(图标右键菜单、系统托盘或 --config 均可打开设置)
• 可选沉浸模式:无边框透明圆角窗口 + 顶部悬浮控制栏
• Linux 原生体验:桌面集成自动同步(应用名、图标、右键菜单)、可关闭系统托盘、Wayland/X11 均支持
• 窗口透明度可调:支持"仅背景透明"(文字/内容不透明,露出桌面)与"整体半透明"两种观感

下载安装

前往 Releases:

# Debian / Ubuntu
sudo apt install ./DeepSeekHarness_*_amd64.deb

# 其他发行版
chmod +x DeepSeekHarness_*_amd64.AppImage && ./DeepSeekHarness_*_amd64.AppImage

使用前提:本机(或可访问的机器)正在运行 DeepSeek Harness Web 服务; 默认地址 http://127.0.0.1:3080,不同端口可在设置页修改(运行 deepseek-harness --config 打开)。

从源码构建

# Ubuntu / Debian 依赖
sudo apt install -y libwebkit2gtk-4.1-dev libayatana-appindicator3-dev \
  build-essential curl wget file libxdo-dev libssl-dev librsvg2-dev pkg-config

npm ci
npm run dev          # 开发运行
npm run build        # 产物: src-tauri/target/release/bundle/{deb,appimage}/

项目结构

src/                  # 设置页（纯 HTML/CSS/JS）
src-tauri/
├── capabilities/     # 远程页面最小窗口控制权限
├── icons/            # 应用图标（logo 派生）
└── src/
    ├── main.rs       # 入口 / 单实例 / 启动决策（无配置自动写默认值）
    ├── config.rs     # 配置模型与持久化
    ├── desktop.rs    # 桌面入口自动同步（名称/图标/右键菜单）
    ├── icons.rs      # favicon 探测 / 图片处理 / 缓存
    ├── tray.rs       # 可关闭的系统托盘
    ├── window.rs     # 窗口构建与注入脚本（透明/沉浸）
    └── commands.rs   # 设置页 Tauri 命令

系统要求

• Linux x86_64 + WebKitGTK 4.1
• 沉浸/透明模式需要支持透明窗口的合成器

实现细节与踩坑见 docs/maintenance.md。

许可证

MIT。DeepSeek Harness 及其网页内容权利归各自权利人所有。