README

DSH Tauri 桌面版


  在桌面上运行 DeepSeek Harness ——
  无需手动安装 Node.js、pnpm 或 Docker；普通安装首次启动可能需要联网初始化。



  
  
  



  
    
  
  
  
  
  
  
  
  



  Download · English · Español · Русский · 한국어 · 文档 · 中文



  
  
  




 功能

- 🪶 原生桌面 — Tauri 2(Electron Runtime) + React 19 + Hero 3，内嵌本地 Harness 界面。
- 📱 远程连接 — Android / iOS 移动端扫码连接电脑上的 DSH，支持局域网与 Cloudflare 公网隧道。
- 🔄 运行时管理 — 安装依赖、选择内核版本，并提供桌面端与内核更新入口。
- 🧩 插件管理 — 12 个内置插件；支持本地路径安装、内置插件停用、社区插件安装、升级、卸载与错误查看。
- 🗂️ 档案配置 — 分别管理插件与设置，支持一键迁移档案数据、备份、克隆；
- 💽 数据目录 — 安装时（Windows）可选择数据存放位置；能在设置里整体迁移与回滚。
- ⌨️ 命令行集成 — 通过托管 shim 提供 dsh / pnpm 命令行工具，不是全局 npm 内核安装。
- 🐾 桌宠 — 由 dsh-pet-lite 预设插件提供，见下方「预设插件」。
- 🎨 个性化 — 8 种配色、本机界面缩放、终端模式，以及可调不透明度与可选磨砂模糊。

 内置插件

随桌面资源分发的一方插件：

- DSH Tauri — 核心插件，桌面端与 Harness 通信、版本适配器、插件依赖管理
- DSH Tauri UI — 桌面设置界面、原生核心组件、主题与配色
- DSH Tauri Worktree — 会话级 Git 工作树与检出
- DSH Tauri Extension — 官方插件管理、插件市场、Skills 与 MCP
- DSH Tauri Archive — 聊天归档与恢复
- DSH Pet Lite — 轻量桌宠预设插件，需在插件页自行安装
- DSH Tauri Rightclick Menu — 会话、工作区与正文右键菜单
- DSH Tauri Model — 模型选择与参数、自动配置模型
- DSH Tauri Remote — SSH 远端 Harness 连接与同步，并把本机 Harness 分享到局域网或公网隧道
- DSH Tauri Notification — 原生级会话通知与交互操作

 可选预设

启动引导提供以下社区插件，可按需安装；

- DSH Better Sidebar — 按会话隔离的右编辑器侧栏
- DSH Office Kit — Office 文档、PDF、演示文稿与表格
- DSH Market — 社区插件市场
- DSH Rewind — 对话回退与工作区备份
- DSH IM — IM 渠道与机器人管理
- DSH OPS — 底层操作工具，减少 Token 消耗与任务耗时
- Billion Context — 上下文压缩与历史恢复

新增或更新预设请提交 Issue；可用版本由清单中的内核兼容规则决定。

 快速开始

从 Releases 下载对应平台与架构的安装包：

| 平台 | 要求 | 安装包 |
| --- | --- | --- |
| Windows | Windows 10+（内置 Chromium 内核） | x64 .exe / .msi |
| macOS | macOS 12+（内置 Chromium 内核） | Intel / Apple Silicon .dmg |
| Linux | 内置 Chromium 内核 | x64 .AppImage / .deb |

macOS 也可通过 Homebrew 安装：

bash
brew install dsh-tauri/desktop/deepseek-harness


Fedora 43+（x64 / ARM64）可通过 Copr 仓库安装，升级随 dnf upgrade 进行，应用内更新已关闭；想跟进预发布版可改装 dsh-tauri-beta（与 dsh-tauri 互斥，用 sudo dnf swap dsh-tauri dsh-tauri-beta 切换）：

bash
sudo dnf copr enable fairyband/dsh-tauri
sudo dnf install dsh-tauri         正式版


- 普通安装包首次启动需联网下载缺失的运行时与内核；Git 功能需要可用的 Git。
- 包含 Bundle 后缀为离线安装包（_Bundle_.exe、_Bundle_.deb、两种 _Bundle_.dmg）。
- 本地运行不等于完全离线：模型服务、插件安装、更新与桌宠预设素材仍可能联网。
- Linux 显示、Wayland、AppImage 与权限问题的处理见安装与故障排查文档。

 桌面代理

- 在配置 → 应用 → 代理地址设置 HTTP、HTTPS、SOCKS5 或 SOCKS5H 代理。
- 仅用于桌面端依赖/内核下载、更新检查及插件元数据，不修改模型请求或插件子进程的网络配置。
- 留空沿用系统/环境代理；保存后对新请求生效，可重试失败的下载。
- SOCKS5H 通过代理解析目标域名；本机回环连接始终直连。

 移动端支持

DSH Mobile 通过局域网或公网隧道访问电脑上的 Harness，不在手机运行内核。

- Android：从 Releases 下载 APK。
- iOS：通过 TestFlight 邀请安装测试版，以审核与名额为准；Release 中的未签名 IPA 需自行签名。

在桌面顶部远程开启分享，手机扫码配对；电脑、Harness 与所用隧道须在线。远程访问并非只读，请勿公开二维码或访问码，详见手机远程访问指南。

移动端仅在官方移动服务推出前维护；开发说明见移动端规范。

 运行方式

Windows 启动失败时会通过原生对话框显示具体错误。若出现 STARTUP_LOW_INTEGRITY：

- 进程低于 Medium 完整性级别，无法写入正常用户数据；更新后的程序可能继承安装目录的 Low 标签。
- 用 icacls 检查目录与程序；将可信安装恢复为 Medium，或重新安装到正常目录。
- 以管理员身份运行不会移除 Low 标签限制；无需删除会话或修改 DSH_HOME。

| 当前基线 | 版本 |
| --- | --- |
| 推荐 Harness 内核 | 0.2.1-rc.4 |
| 支持的内核最低版本 | 0.2.1-rc.4，不保证所有插件兼容 |

更早内核不再支持；旧兼容记录仅保留历史事实，不代表当前支持范围。

- 内核与预设选择遵循资源清单及插件声明的版本范围；不保证任意最新上游版本都兼容。
- 正式版默认启用

Top issues

Discussions

Latest release

   🐞 Bug Fixes

- macos: Allow managed core native addons in signed Electron  -  by @hairyf (5d67e)

     View changes on GitHub

 📦 Artifacts
- macOS (Apple Silicon): 下载 aarch64.dmg
- macOS (Intel): 下载 x64.dmg
- Windows: 下载 .exe
- Linux (x64): 下载 .AppImage 或 .deb（基于 Ubuntu 22.04 构建）
- Linux (ARM64): 下载 aarch64.AppImage 或 arm64.deb（基于 Ubuntu 22.04 构建，GLIBC 符号上限 2.35）
- Android: 桌面端发布后追加 .apk；未配置签名密钥时使用开发证书，仅供评估
- iOS（Testflight）: 打开 TestFlight 邀请链接，通过 beta 测试安装
- iOS（IPA）: 桌面端发布后追加 _unsigned.ipa；需自行签名，不能直接安装

 文件名带 _Bundle 后缀的是离线捆绑包：安装包里已内置 Node.js