DeepSeek Harness 桌面版

在桌面上一键运行 DeepSeek Harness ——
无需 Node.js、无需 pnpm、无需 Docker，下载即用。

English · Español · 文档 · 中文

• 🧩 插件管理 — 插件面板管理已安装插件，出现异常时提供升级 / 卸载入口，错误详情。
• 🎁 内置插件 — 随安装包内置插件，以及将来引入更多高质量的内置插件。
• 🪶 原生轻量 — Tauri 2 外壳（非 Electron）：更小的安装包、更低的内存占用、原生窗口。
• ⌨️ 命令行集成 — 安装自动注册 dsh 命令，新开终端即用；不覆盖你已有 shell 配置。
• 🧭 启动引导 — 首次启动可选推荐插件，也可在配置中重新选择。
• 🚀 自更新 — 应用内更新，不需要重新下载；
• 🐾 桌宠 — 提供 Pets / Codex 双来源桌宠管理，预设宠物开箱即用（直连远端素材，无需下载）、可导入 Codex .zip 资源包，并根据会话活动显示状态气泡。

预设插件

首次启动引导中提供的插件，按需勾选安装：

• DSH Market — 浏览、搜索并一键安装社区插件（推荐）
• DSH Better Sidebar — 类 VSCode 右侧栏，按会话隔离（推荐）
• DSH Rewind — 同窗口内对话回退，从不新建会话分支；自带轻量工作区备份，回退时可一并还原文件（推荐）
• DSH-IM — 让微信、飞书、钉钉、企业微信、QQ、Slack、Telegram、Discord、WhatsApp、iMessage 等渠道接入本机 Harness，并在左侧栏「IM」面板中统一管理（推荐）

预设插件清单由桌面端维护。为避免不稳定的预设插件导致软件异常，如需新增或更新预设，请在 deepseek-harness-desktop/issues 提起请求。

内置插件

随安装包资源内置的第一方插件：

• DSH Tauri — 提供与 Tauri 2 外壳的通信通道
• DSH Tauri Connection — 让跨源沙箱内嵌 WebView 用上回环宿主：在 connection 服务上覆写桌面载体的两道鉴权闸门
• DSH Model Config — 接管模型设置页，补齐上下文与输出上限、图片输入、思考模式和本地端点兼容选项
• DSH Tauri UI — 为 Tauri 2 外壳提供自定义设置侧边栏
• DSH Tauri Worktree — 为每个会话创建隔离的 Git Worktree，并支持检出到本地分支或归档放弃
• DSH Tauri Panel Extension — Skills/MCP 管理与导入技能仓库，内嵌插件市场面板
• DSH Tauri Panel Scheduler — 创建每天、间隔、工作日或每周的定时任务；在独立 Agent 会话中执行，并保留执行记录
• DSH Tauri Turn Rewind — 按 Agent 回合记录私有 Git 快照、显示文件变更卡片，并在冲突保护下撤销该回合改动
• DSH Tauri Session — 将删除工作区改为归档，并提供支持搜索、排序、分组、项目筛选和取消归档的「已归档聊天」设置页
• DSH Tauri Pet — 管理 Chat / Codex 桌宠、预设宠物下载、资源包导入和会话活动状态
• DSH Tauri Rightclick — 为会话、工作区、正文、链接和输入框补充常用操作
• 更多即将引入的插件...

快速开始

从 Releases 下载对应平台安装包，安装后启动即可。

macOS（Homebrew）： 也可通过 Homebrew 一键安装：

brew install dsh-tauri/desktop/deepseek-harness

首次运行会下载 Node 运行时与 Harness 内核（如已经安装 dsh ，则使用安装版本），随后直接进入 http://127.0.0.1:3080 的 Harness 界面；此后完全本地运行，无需联网。

系统要求： Windows 10+ · macOS 10.15+ · Linux（AppImage / .deb）· 首次运行需要网络 · Harness 内核 0.1.5-rc.2 或更高

Linux Wayland 注意（PikaOS / GNOME Wayland / Ubuntu 22.04+）： AppImage 在 Wayland 下可能因 WebKitGTK 黑屏/崩溃，应用已自动处理常见情形。

若仍黑屏/崩溃：

改用 .deb（已验证 PikaOS 4 Wayland），或手动 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 GDK_BACKEND=x11 ./AppImage。图标不显示时，将应用内 hicolor 图标复制到 ~/.local/share/icons 并运行 update-desktop-database。

Linux 滚动发行版启动即崩（Arch / CachyOS / Fedora 等）： 旧版 AppImage 会随包携带构建镜像（Ubuntu 22.04）的 libwayland-client 等显示栈库，较新的宿主 Mesa 与之 ABI 不匹配会导致 WebKitWebProcess 直接 abort()——表现为双击后没有任何界面、也没有任何日志。构建阶段已剔除这些库（见 .github/workflows/build-linux.yml 与 scripts/fix-appimage-host-libs.sh），请使用修复后发布的版本；仍受影响时可用 .deb，或 LD_PRELOAD=/usr/lib/libwayland-client.so.0 ./AppImage（路径按发行版调整）。

交流

• 加入 Discord 社区

QQ 群

微信群(已满,请先加我微信) ->

个人微信

开发

想参与开发？参见 docs/DEVELOPMENT.zh.md。

工作原理

┌──────────────────────────────────────────────┐
│ Tauri WebView (React)                        │
│   安装状态机 → 下载进度 → iframe              │
│   加载 dsh Web 界面 + 侧边栏控制              │
└──────────────────────┬───────────────────────┘
                       │ invoke 命令 + 事件
┌──────────────────────┴───────────────────────┐
│ Tauri Rust 后端                              │
│   service/download  安装器 + 解压            │
│   service/core      Harness 核心多版本管理   │
│   service/profile   dsh 档案管理             │
│   service/plugin    插件卸载 / 升级          │
│   service/cli       dsh 命令 shim + PATH     │
│   service/update    桌面端自更新             │
│   service/workflow  dsh 进程生命周期         │
│   task              dsh 健康检查             │
└──────┬───────────────────────────┬───────────┘
       │                           │
  runtime/ (Node.js v22.22.0)   dependencies/dsh/ (发行版)
       └─────────────┬─────────────┘
                     ▼
   dsh --profile <档案> --host 127.0.0.1 --port 3080
                     │  DSH_HOME=~/.dsh
                     ▼
        http://127.0.0.1:3080/  ← 内嵌界面

Harness 发行版由 deepseek-harness-pkg 构建发布。每次启动都会对比最新发行版，本地过期时提醒下载更新；GitHub 不可达时保留本地安装。通过 CLI 全局安装的本地核心会被优先使用。

说明

[!WARNING] 开发预览 — 上游 dsh 仍在快速迭代，存在破坏性变更；本项目同步跟随。

[!NOTE] 安全声明 — dsh 具备本地代码执行能力。仅供学习 / 研究 / 测试，请在可信、隔离的环境中使用。

相关项目

• deepseek-harness — 上游 dsh agent 平台
• deepseek-harness-pkg — 预打包 Harness 发行版（本应用下载源）

插件数据源

插件在运行时直接引用的远端素材与上游清单：

• PC2005-cloud/dsh-pet — 预设桌宠素材（WebM 动作、预览 GIF、config.jsonc），preset-pets.json 固定到 e1ff8c1
• dsh-tauri/dsh-pet-mov — macOS HEVC-alpha .mov 镜像（WKWebView 不认 VP9-alpha），固定到 be0f3bb
• hairyf/dsh-pet-component — 桌宠渲染组件（npm dsh-pet-component）

插件子仓库

source/ 下按插件需要克隆的参考仓库，多数不随本仓库提交：

• PC2005-cloud/dsh-pet — 桌宠动作权重、连续播放与气泡样式（子模块）
• Skylarking/dsh-plugin-codex-pets — Codex 宠物图集与会话状态映射（子模块）
• ayangweb/BongoCat — Tauri 桌宠窗口、原生拖动、DPI 与鼠标穿透基准（子模块）
• QCYTSN/dsh-dafeiyu — 桌宠气泡文案与状态优先级参考（子模块）
• Signalight/codex-to-dsh-pet — Codex v2 图集、动作优先级与会话状态映射

License

MIT，附加非商用条款 © deepseek-harness-desktop contributors