xtxo/dsh-ui

DSH-UI：DeepSeek Harness 官方风格极轻桌面客户端

基于 tw93/Pake 与 deepseek-ai/deepseek-harness 深度定制打造

🌐 在线主页 •
下载客户端 •
核心优势 •
自主构建 •
English

🌟 核心优势

* 🍃 极致轻巧（仅 ~8.7MB）：告别动辄 150MB+ 的臃肿 Electron 壳。基于 Rust + 系统原生 Webview2 / WebKit 渲染容器，内存占用降低 80% 以上。
* ⚡ 毫秒级极速唤醒：内置智能缓存直启引擎，跳过 npx 的每次远端联网解析，双击即秒开。
* 🚀 全自动服务生命周期（双击即用）：
* 无需手动在终端输入命令。
* 双击客户端，Rust 内核自动在后台以无黑框静默模式拉起 dsh web 智能体服务。
* 自动进行端口探针与握手，就绪后瞬间切入对话窗口。
* 退出应用时自动彻底释放后台进程，无幽灵进程残留。
* 🎨 DeepSeek 原生品牌与动效：
* 内置 16x16 ~ 512x512 高清多尺寸蓝鲸图标。
* 专属暗色呼吸感启动过渡页面。
* 📁 桌面级原生交互增强：
* 开启本地文件 / 代码项目拖拽支持（Drag & Drop）。
* 支持 Windows / macOS 系统托盘常驻与快捷键呼出。

📥 快速下载

前往 GitHub Releases 页面 (v0.1.19) 或直接点击下方直链下载：

| 平台 | 安装包直接下载 | 架构说明 |
| :--- | :--- | :--- |
| macOS (Apple Silicon) | 🍏 DeepSeek.Harness_0.1.19_aarch64.dmg | M1 / M2 / M3 / M4 系列 Mac |
| Windows 绿色免安装版（推荐） | 🟢 DeepSeek-Harness-Portable.zip | 无需安装，解压后运行 DeepSeek-Harness.exe |
| Windows Setup 安装版 | 🪟 DeepSeek.Harness_0.1.19_x64-setup.exe | Windows 10 / 11 64位，适合普通用户安装 |
| Windows MSI (中文) | 🪟 DeepSeek.Harness_0.1.19_x64_zh-CN.msi | WiX MSI 中文安装包，适合企业/静默部署 |
| Windows MSI (英文) | 🪟 DeepSeek.Harness_0.1.19_x64_en-US.msi | WiX MSI 英文安装包，适合企业/静默部署 |

🛠️ 本地编译与打包指南

本项目完全开源，任何人都可以根据本指南在本地自行编译打包属于自己的客户端！
1. 准备环境
- 安装 Node.js (>= 18)
- 安装 Rust 编译器与 Cargo (1.80+)

2. 克隆仓库与安装依赖
git clone https://github.com/xtxo/dsh-ui.git
cd dsh-ui
npm install

3. 一键编译

🍏 macOS 编译 (DMG / APP)
方式一：直接运行构建脚本
chmod +x ./scripts/build-macos.sh
./scripts/build-macos.sh

方式二：编译 Apple Silicon 或 Intel
npm run build:mac-arm64  # M1/M2/M3/M4
npm run build:mac-x64    # Intel
编译产物位于：src-tauri/target/release/bundle/dmg/

🪟 Windows 编译
方式一：直接运行脚本
.\scripts\build-windows.ps1

方式二：使用 npm 脚本
npm run build:windows
编译产物位于：src-tauri/target/release/deepseek-harness.exe

🐧 Linux 编译 (DEB / AppImage)
chmod +x ./scripts/build-linux.sh
./scripts/build-linux.sh

📂 项目结构

dsh-ui/
├── src-tauri/              # 🦀 Rust / Tauri Pake 核心源码与后台生命周期管理器
│   ├── src/
│   │   ├── app/backend.rs  # 智能后台服务探针与拉起引擎
│   │   └── lib.rs          # 客户端入口
│   ├── icons/              # 多平台高清图标 (ICNS, ICO, PNG)
│   ├── pake.json           # Pake 桌面容器配置
│   ├── tauri.conf.json     # Tauri 基础配置
│   ├── tauri.macos.conf.json # macOS 专属构建配置
│   └── tauri.windows.conf.json # Windows 专属构建配置
├── dist/                   # 🎨 内置启动过渡页 (含 DeepSeek 动效)
├── website/                # 🌐 静态展示与下载主页 (https://xtxo.github.io/dsh-ui/)
├── scripts/                # 🛠️ 跨平台构建脚本 (Windows, macOS, Linux)
└── .github/workflows/      # 🚀 GitHub Actions 多平台自动化发布流水线

❓ 常见问题 (FAQ)

Q1: 这是 DeepSeek 官方出品的桌面客户端吗？
答： 本项目是对 DeepSeek Harness 官方生态的轻量桌面打包与原生交互封装。
- 官方纯正内核：客户端后台拉起和运行的智能体服务、插件系统与模型调度代码 100% 来源于 DeepSeek 官方仓库源码与官方 npm 引擎 (@deepseek-ai/dsh)。
- 完全开源透明：本项目代码全部开源在 GitHub，不包含任何中间商服务，不收集用户任何私有数据或 API Key，所有配置与对话均仅保存在您本地电脑中。

Q2: macOS 提示「Apple 无法验证是否包含恶意软件 / 已损坏」如何解决？
答： 这是因为开源项目未购买苹果官方开发者商业签名证书（每年 $99），macOS Gatekeeper（安全门禁）会默认拦截。解决方法非常简单（任选一种即可）：
1. 方法一（推荐，3秒搞定）：打开「访达」➔ 进入「应用程序」文件夹 ➔ 按住 Control 键并右键点击 DeepSeek Harness.app ➔ 在弹出菜单中点击 「打开」 ➔ 弹窗中选择 「仍要打开」 即可（仅需首次操作一次）。
2. 方法二（系统设置）：打开 Mac 「系统设置」 ➔ 「隐私与安全性」 ➔ 找到「安全性」栏目 ➔ 点击 「仍要打开」。
3. 方法三（终端一条命令彻底放行）：打开 Mac「终端」执行命令：
xattr -cr "/Applications/DeepSeek Harness.app"

Q3: Windows 提示「Windows 已保护你的电脑 / SmartScreen」如何运行？
答： 同样是由于个人开源软件未附带昂贵的商业证书，属于微软 SmartScreen 针对新发布软件的通用防护提示。
点击弹窗上的 「更多信息 (More info)」 ➔ 选择 「仍要运行 (Run anyway)」 即可正常启动。

🤝 致谢与开源生态

- tw93/Pake：优秀的极简 Rust Web 桌面化引擎框架。
- deepseek-ai/deepseek-harness：DeepSeek 开源的“一切皆插件” Agent 框架。

📄 开源许可证

本项目基于 MIT License 协议开源。