zcx960/deepseek-desktop

DeepSeek 桌面聊天

English · 下载安装包 · GitHub Actions

在同一个桌面窗口中使用 Harness 和 DeepSeek 官方 Chat。顶部切换模式，两边页面保持打开，未发送的输入不会因切换丢失。

本项目基于 dsh-tauri/deepseek-harness-desktop 的 Tauri 2 + React 桌面端重做，基础提交为 bd4da3aee51d65061001857e4234a8942ceca6ff。当前版本为 0.15.4-chat.1，应用名称为 DeepSeek Desktop Chat。这是社区衍生项目，并非 DeepSeek 官方桌面客户端。

功能

- Harness / Chat 切换：Harness 保留原有内核、档案、插件和会话功能；Chat 打开 https://chat.deepseek.com/。
- 独立登录存储：Chat 使用独立持久化 WebView 存储，与 Harness 的 API Key、会话和设置分开。
- 恢复上次模式：重新启动后自动回到上次选择的模式。
- Chat 工具栏：刷新页面、在浏览器打开、确认后清除本地 Chat 数据。
- 独立故障处理：Chat 加载失败时可以重试或使用浏览器，仍可切回 Harness。
- 访问隔离：Chat 页面不能调用桌面 Tauri 命令；其他网站的 HTTP(S) 链接交给系统浏览器。

清除 Chat 数据会退出所有应用窗口中的 Chat 登录并清除本地 Cookie、缓存和网站存储，不会删除官网在线对话或 Harness 数据。

下载与运行

到本仓库的 Releases 下载名称为 DeepSeek Desktop Chat、标签以 chat-build- 开头的预发布版本。较早的 v0.2.0 属于旧 Electron 实现。

| 系统 | 安装包 | 要求 |
| --- | --- | --- |
| macOS Apple Silicon | 文件名含 aarch64-apple-darwin 的 .dmg | 内嵌 Chat 需要 macOS 14+ |
| macOS Intel | 文件名含 x86_64-apple-darwin 的 .dmg | 内嵌 Chat 需要 macOS 14+ |
| Windows x64 | .exe（NSIS）或 .msi | Windows 10+，WebView2 |
| Linux x64 | .AppImage 或 .deb | 基于 Ubuntu 22.04 构建 |

安装后启动应用，选择顶部 Chat 并自行登录 DeepSeek 账号。Chat 使用官网账号，不使用 Harness 的 API Key。Harness 按原有流程启动本地内核，首次准备运行环境需要网络；Chat 和远程模型调用也需要网络。

当前安装包未签名，macOS 包未经过 Apple 公证，系统可能提示无法验证开发者。桌面端采用手动更新，以避免上游安装器覆盖 Chat 功能；Harness 内核仍可在应用内更新。每次构建附带 SHA256SUMS-.txt 和 build-info-.json，可核对安装包校验值和源码提交。

使用限制

- macOS 14 以下可使用 Harness 和浏览器入口，不提供内嵌持久化 Chat。
- 跨域登录弹窗交给系统浏览器，浏览器的登录状态不会自动导入应用。官网变更或限制内嵌浏览器时可能影响登录。
- 已在 Apple Silicon 上验证模式切换、草稿保留、存储隔离、清除数据、设置弹窗和全屏，并加载官方登录页；未使用真实账号完成登录或发消息。
- GitHub Actions 的跨平台打包成功不等于各平台原生交互已实测。完整记录见 验证说明。

新版使用独立应用标识 io.github.deepseek-desktop.chat，不会自动迁移旧 Electron 版的桌面设置或 Chat 登录数据。Harness 数据继续遵循基底项目的 ~/.dsh 档案规则。旧版源码仍保留在 Git 历史中。

开发

需要 Node.js 24+、项目指定的 pnpm、Rust stable，以及相应平台的 Tauri 构建依赖。

git clone https://github.com/zcx960/deepseek-desktop.git
cd deepseek-desktop
pnpm install --frozen-lockfile
pnpm build:plugins
pnpm dev:desktop

pnpm typecheck
pnpm exec vitest run
node --test scripts/collect-chat-artifacts.test.mjs
cargo test --manifest-path src-tauri/Cargo.toml --lib
pnpm tauri build --no-sign

macOS 上运行完整 Vitest 测试时使用 TMPDIR=/private/tmp pnpm exec vitest run，避免 Git 与 Node 对系统临时目录符号链接的解析差异。Chat 架构、本地 smoke 测试和存储实现见 Chat 开发说明。

GitHub Actions 打包

打开 Build Chat installers，选择 Run workflow：

1. 选择要构建的分支，默认使用 main。
2. 需要发布到 Releases 时勾选 publish_release；仅 main 支持发布。
3. 流程先执行类型检查和测试，再并行打包 macOS 两种架构、Windows x64 和 Linux x64。
4. 四个平台产物全部完成后才发布预发布版本。仅打包时可从该次运行的 Artifacts 下载，保留 30 天。

流程不需要 Apple 或 Windows 签名密钥，使用锁定的依赖文件构建并记录源码提交。发布采用独立的 chat-build- 标签，旧版上游签名发布流程不在此仓库执行。

基底与许可证

Tauri 外壳、Harness 安装与进程管理、内置插件等能力来自 deepseek-harness-desktop；Agent 内核来自 deepseek-ai/deepseek-harness。本仓库在此基础上增加 Chat 模式和独立构建发布流程。

保留上游 MIT 许可证 与 禁止商业二次开发的附加条款，以及原作者版权声明。