为什么？

功能

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

内置插件

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

• DSH Tauri — 核心插件，桌面端与 Harness 通信、版本适配器、插件依赖管理
• DSH Tauri UI — 桌面设置界面、原生核心组件、主题与配色
• DSH Tauri Mobile UI — 触屏布局与移动端偏好设置
• DSH Tauri Worktree — 会话级 Git 工作树与检出
• DSH Tauri Extension — 官方插件管理、插件市场、Skills 与 MCP
• DSH Tauri Scheduler — 定时任务与执行记录
• DSH Tauri Archive — 聊天归档与恢复
• DSH Tauri Pet — 桌宠与活动状态设置
• DSH Tauri Rightclick Menu — 会话、工作区与正文右键菜单
• DSH Tauri Model — 模型选择与参数、自动配置模型
• DSH Tauri Remote — SSH 远端 Harness 连接与同步，并把本机 Harness 分享到局域网或公网隧道
• DSH Tauri Notification — 原生级会话通知与交互操作

可选预设

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

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

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

快速开始

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

平台	要求	安装包
Windows	Windows 10+、WebView2	x64 .exe / .msi
macOS	macOS 12+；Web 界面需 Safari 17.4+ 能力	Intel / Apple Silicon .dmg
Linux	WebKit2GTK 4.1、GStreamer ≥ 1.24（AppImage 使用宿主的 GLib、WebKit 与媒体栈）	x64 .AppImage / .deb

macOS 也可通过 Homebrew 安装：

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 切换）：

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，不保证所有插件兼容

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

• 内核与预设选择遵循资源清单及插件声明的版本范围；不保证任意最新上游版本都兼容。
• 正式版默认启用 CLI 集成：Windows / macOS / Linux 自动更新 PATH。需重新打开终端，其他 shell 仍需要手动配置。

交流

开发

参见中文开发指南或英文开发指南。功能详情见在线文档。

说明

[!WARNING] 开发预览 — 上游 dsh 仍在快速迭代，可能存在破坏性变更；升级前请确认兼容性。

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

社区推荐

• dsh-tauri-notify-webhook — 任务异常停止或完成时把通知转发到 webhook、邮件（SMTP）或 pushplus by @iuuuuuuuu
• dsh-pdf-reader — 按页 PDF 阅读、本地 OCR、引用、搜索和视觉裁剪 by @SkanderBog
• dsh-context-manager — 应用前审阅上下文，并按完整历史组选择保留、总结或省略较早内容 by @SkanderBog
• @ryuu-64/dsh-find-all — 在当前对话中按 Ctrl+F，查找已保存的历史内容 by @Ryuu-64

相关项目

• deepseek-harness — 上游 dsh agent 平台
• deepseek-harness-pkg — 预打包 Harness 发行版与下载源
• dsh-pet · dsh-pet-mov · dsh-pet-component — 桌宠素材与渲染组件
• dsh-plugin-codex-pets · BongoCat · dsh-dafeiyu · codex-to-dsh-pet · dsh-pet-sticker — 桌宠参考项目

Contributors

License

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