xiaoge200/dsh-desktop

🐳 DSH 工作台（DSH Desktop）

把 DeepSeek Harness（DSH）装进桌面的跨平台应用 —— 下载、双击、开聊。

version
platform
CI
PRs Welcome

📖 目录

- 这是什么？
- 为什么要做它？
- 功能一览
- 快速开始（新手教程）
- 常见问题（FAQ）
- 开发者指南（从源码构建）
- 项目结构
- 参与贡献
- 开源许可

这是什么？🤔

DSH（DeepSeek Harness）是一个运行在你本地电脑上的 AI 智能体工具。过去想用它，你得先装好 Node.js，再在命令行里敲一堆指令——对不熟悉编程的朋友来说，光是“装环境”这一步就够劝退了。

DSH 工作台把这一切打包解决掉了：

- 装好就能用，不需要装 Node.js、不需要碰命令行
- 首次启动自动初始化，之后秒开，没网也能用
- 有新版自动升级，失败了还会自动退回旧版，你什么都不用管

简单说：这是一个“零门槛”的 DSH 桌面版。

为什么要做它？💡

| 新手会遇到的问题 | 我们的解法 |
|---|---|
| 要装 Node.js、配置环境，劝退小白 | 安装包内置 Node 运行时，双击即装 |
| 首次安装依赖要等半小时 | 内置完整 DSH 依赖包，首启即用 |
| 命令行操作看不懂 | 图形界面 + 全白话提示，技术细节自动折叠 |
| 升级麻烦、容易装坏 | 后台自动更新，失败自动回滚，全程不打扰 |

✨ 功能一览

- 🖥️ 跨平台：Windows / macOS / Linux 都能装
- 📦 免环境：内置 Node 运行时，不依赖系统环境
- ⚡ 秒级启动：首次初始化后开箱即用，完全离线可用
- 🔄 自动更新：DSH 有新版本自动安装，网络不稳会自动切换镜像源
- 🪟 独立窗口：DSH 界面直接嵌入应用，不依赖系统浏览器
- 🧩 托盘常驻：关窗口最小化到托盘，随时一键唤回
- 🌐 中英双语：界面随系统语言自动切换
- 🛡️ 安全本地运行：服务只在本机运行，不对外网开放
- 💬 小白友好：所有提示都说人话，出错了也知道该怎么办

🚀 快速开始（新手教程）

完全没接触过的小伙伴，照下面 3 步走就行。

第 1 步：下载安装包

1. 打开本仓库的 Releases（发行版） 页面：
2. 选择最新版本，下载对应系统的安装包：
- Windows：.msi / .exe（要求 Win10 及以上，无需管理员权限）
- macOS：.dmg（Apple Silicon / arm64；要求 macOS 11 及以上。Intel 版暂不提供）
- Linux：暂不提供（打包链路待修复）
3. 双击安装包，一路点「下一步」完成安装

第 2 步：启动

安装完成后，桌面会出现 DSH 工作台 的图标，双击打开。

- 首次启动会做一次性初始化，大约一两分钟（视电脑速度而定），进度页会实时显示状态
- 之后每次启动都是秒开

第 3 步：开始使用

界面加载完成后，就是 DSH 的工作台了，像普通聊天软件一样直接用就好。

日常使用小贴士：

| 想做的事 | 怎么做 |
|---|---|
| 最小化到托盘 | 直接点窗口右上角的「关闭」按钮 |
| 再次打开 | 点系统托盘里的 🐳 图标 →「打开界面」 |
| 开机自启 | 托盘菜单 →「设置」→ 打开「开机自启」 |
| 关闭自动更新 | 托盘菜单 →「设置」→ 关闭「自动更新」 |
| 彻底退出 | 托盘菜单 →「退出」 |

❓ 常见问题（FAQ）

Q：需要安装 Node.js 吗？
不需要。Node 运行时已内置在安装包里，打开就能用。

Q：我的数据存在哪里？
存在你电脑的用户目录下（Windows 为 %APPDATA%\com.dsh.desktop）。卸载应用时数据默认保留，重装不丢。

Q：怎么卸载？
Windows 在「设置 → 应用」里找到 DSH 工作台卸载即可，无需管理员权限。卸载只删除程序本体，你的数据会保留。

Q：提示端口被占用怎么办？
不用管。端口被占用时应用会自动换一个空闲端口，对你完全无感。

Q：DSH 更新失败会怎样？
不会坏。更新前会自动备份旧版本，新版本装不上会自动回滚，下次启动再重试，全程不打扰你。

Q：杀毒软件拦截 / 误报怎么办？
如果被杀毒软件拦截，请把安装包或安装目录加入信任白名单后重新安装；仍不行的话，欢迎到 Issue 区反馈给我们。

Q：打开后界面是英文/中文，能切换吗？
界面语言跟随系统语言自动切换（中英双语），无需手动设置。

Q：网页里的「插件市场」提示要配置 pnpm（找不到 pnpm / 没有权限 / 可执行文件已存在）？
0.1.8 起桌面端已自带 pnpm，插件市场直接用内置的，不需要系统里装。若你在 0.1.7 及更早版本
遇到这条提示，按提示在终端执行一次即可（装好后重启应用）：

npm i -g pnpm --force        # Windows 需要用管理员身份运行终端
brew install pnpm            # macOS（Homebrew）

装不上也没关系——设置窗口「插件」页里的市场走内置 npm，不受影响。
🛠️ 开发者指南（从源码构建）

想自己编译、二次开发或贡献代码的看这里；普通用户直接跳过本节。

前置要求：Rust 1.77+、Node 18+，以及各平台的 Tauri 系统依赖。

1. 安装依赖
npm install

2. 开发模式运行（带热更新）
npm run tauri dev

3. 打包安装包
npm run tauri build

注意：npm install 依赖 npm 脚本执行（@tauri-apps/cli、esbuild 需要 postinstall）。若你的环境开启了 npm allow-scripts 策略，需在 .npmrc 的 allow-scripts 中放行它们。

🗂️ 项目结构（简版）

dsh-desktop/
├─ src/              # 前端界面（启动进度页、设置页）
├─ src-tauri/        # 桌面壳（Rust / Tauri）
├─ resources/        # 内置运行时资源（构建期注入）
├─ scripts/          # 构建脚本
├─ docs/             # 发布手册与实现文档
└─ package.json

📚 更多文档

- 发布手册 docs/RELEASE.md —— 如何发布新版本
- 实现记录 docs/IMPLEMENTATION.md —— 开发中的踩坑记录
- 更新日志 CHANGELOG.md

🤝 参与贡献

欢迎任何形式的贡献！你可以：

- 🐛 提 Issue：报告 bug、提出新功能建议
- ✨ 提 PR：修 bug、加功能、改进文档
- 💬 在讨论区分享使用心得

给本项目点个 ⭐，也是对我们最大的鼓励！

📄 开源许可

本项目基于 Apache License 2.0 开源，详见 LICENSE。

本项目是 DSH（DeepSeek Harness）的桌面封装，与 DeepSeek 官方无隶属关系。