SnowCrescenter-tech/dsh-desktop

dsh-desktop

🇨🇳 中文 · 🇬🇧 English

一键原生桌面客户端，双击就能用上 DeepSeek Harness。不用装 Node，不用敲命令，安装完成，打开就是一个窗口。

无边框窗口 · 系统托盘 · 原生通知 · 单实例运行。DeepSeek Harness 的全部能力，零搭建成本。

中文

📖 完整文档站（中英即时切换）→ https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

项目简介

DeepSeek Harness 是 DeepSeek 官方的 agent 框架。官方目前还是开发者预览版，自己动手装的话，得先装 Node 22.19+ 或 Node 24、装好 pnpm，再对着命令行敲一串命令。对大多数非技术用户来说，这道门槛实在太高了。

dsh-desktop 把 DeepSeek Harness 的 Web UI 包进一个原生 Windows 桌面程序。界面本身完全不动，只是外面多了一层顺手的壳：程序常驻系统托盘，窗口用自绘标题栏，消息走 Windows 原生通知，同一时间只跑一个实例。下载、安装、双击，完事。

功能一览

| 功能 | 一句话说明 |
|---|---|
| 无边框窗口 | 自绘 36px 标题栏 + 实时状态点 |
| 系统托盘 | 常驻后台，单击唤回，右键菜单齐全 |
| 原生通知 | 标准 Windows 通知样式，原生缺失时降级为托盘气泡 |
| 单实例运行 | 同时只跑一个，重复双击唤出已有窗口 |
| 开机自启 | 可选，登录后在后台静默启动 |
| 首次引导 | 首启粘贴 API Key，即贴即用，Key 只存本机 |
| 端口 0 自动分配 | 每次启动自动挑空闲端口，永不冲突 |
| 自动更新 | 后台静默下载，重启即完成更新 |

功能特性

- ▭ 无边框窗口：没有系统默认边框，36px 标题栏由程序自绘，并带一个实时状态点。青色 = 本地服务运行中，灰色 = 启动中，红色 = 出错了。Windows 11 下窗口圆角由 DWM 原生渲染。
- ▣ 系统托盘：程序常驻托盘。单击图标唤回主窗口；右键菜单包含：打开主界面、开机自启（复选）、关于、退出。
- ◈ 原生通知：提醒走 Windows 原生通知样式，和普通应用一模一样；系统不支持时自动降级为托盘气泡。
- ◎ 单实例运行：同一时间只允许一个实例，重复双击只会把已有窗口唤到前台。
- ↻ 开机自启：可选，登录后在后台自动启动，由 Windows 注册表 Run 键实现。
- ▤ 首次启动引导：第一次运行弹出一个向导对话框，引导你输入 DeepSeek API Key。Key 只保存在这台电脑上，位置是 /.env。
- ⇄ 端口 0 自动分配：每次启动都让系统挑一个空闲端口（--port 0），天然不会和 3080 或其他程序撞车。
- ↑ 自动更新：安装版（NSIS）启动后会在后台静默检查新版本并自动下载；下载就绪后弹原生通知，托盘菜单出现"重启并更新"，点击即重启应用完成安装。便携版没有安装器，"检查更新"会打开 GitHub Releases 页面，由你自行下载新版 zip 替换旧目录。

快速开始

1. 到 Releases 页面下载最新安装包。
2. 安装完成，双击桌面上的 DeepSeek Harness 图标。
3. 首次启动时，在引导对话框里粘贴你的 DeepSeek API Key，主窗口会自动打开。

程序会自动启动服务、打开主界面，这些都不需要你手动操作。

首次运行流程

首次启动是一条编排好的流水线。如果没有配置 API Key，先弹模态对话框引导输入；然后写盘 desktop profile，以 --profile desktop --port 0 拉起捆绑的 CLI，监督器等待就绪行（dsh web: http://127.0.0.1:）。一旦解析到，就把 Web UI 载入内容区，状态点变青。

1. 获取单实例锁。若已有实例在运行，本进程直接退出，由已有实例唤出主窗口。
2. 若尚未配置 API Key，先弹出引导对话框，输入并保存到 /.env。
3. 写盘 desktop profile，再以 dsh --profile desktop --port 0 拉起捆绑的 CLI。
4. 等待就绪行（dsh web: http://127.0.0.1:）。解析到后，Web UI 载入内容区，状态点变青；若超时，则显示带重试按钮的错误视图。

首次启动：设置 API Key

第一次运行会先弹出引导窗口，让你填写 DeepSeek API Key：

1. 打开 https://platform.deepseek.com，注册并登录。
2. 在 API Keys 页面点击"创建"，会得到一个形如 sk-... 的 Key。
3. 把 Key 粘贴进引导窗口，点击保存，主界面就会自动打开。

你的 Key 只会写在自己电脑上，不会上传到任何地方。

架构一览

dsh-desktop 是一个 Electron 外壳。主进程负责窗口、托盘、通知、开机自启，以及启动并守护捆绑的 DeepSeek Harness CLI 的运行时监督器；preload 桥把一份精简且冻结的 window.dshDesktop API 暴露给渲染层；窗口自身的 web 内容绘制标题栏，其下方一个沙箱化的 WebContentsView 承载 DeepSeek Harness 的 Web UI；这套 Web UI 跑在 desktop profile 上，按序装载 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app 和 @dsh-desktop/client。

常见问题

杀毒软件报毒、SmartScreen 提示怎么办？

桌面应用打包后没有数字签名，第一次运行时 Windows SmartScreen 可能会提示"Windows 已保护你的电脑"，部分杀毒软件也可能误报。这是打包软件的常见情况，不代表程序有问题。

- SmartScreen 提示：点击"更多信息" → "仍要运行"
- Windows Defender：病毒和威胁防护 → 排除项 → 添加排除项
- 360 安全卫士：木马查杀 → 信任区 → 添加信任目录
- 火绒安全：防护中心 → 病毒防护 → 信任区 → 添加文件/目录
- 腾讯电脑管家：病毒查杀 → 信任区

能安装在中文路径吗？

可以。桌面版不依赖命令行脚本，装在带中文的路径（比如"软件\DeepSeek Harness"）下也能正常运行。

端口被占用怎么办？

服务监听端口由系统自动分配（端口 0），启动时系统会挑一个空闲端口，天然不会和 3080 或其他程序冲突，也不需要手动配置。

关掉窗口后程序为什么还在？

关闭窗口默认是最小化到托盘，程序仍在后台运行。从托盘菜单里选"退出"才会完全结束。

怎么更新到新版本？

安装版启动后会在后台自动检查更新。新版本就绪时会有通知提醒，从托盘菜单选"重启并更新"（或直接重启应用），退出时即完成安装；任何时候都可以用托盘菜单的"检查更新"手动检查。便携版没有自安装器："检查更新"会打开 GitHub Releases 页面，下载最新的 zip 解压替换旧目录即可。

README 怎么做到中英即时切换？

本 README 是单文件双语排版：顶部 🇨🇳 中文 与 🇬🇧 English 两个标签直接跳转到对应章节，整个过程不翻页、不换文件。想要真正的交互式体验（语言即时切换、深色模式、站内搜索）时，请访问在线文档站：https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

需要付费吗？

软件本身是免费开源项目，但调用 DeepSeek 的 API 由官方按量计费。当前参考价（每百万 tokens）：deepseek-v4-flash 输入 $0.14、输出 $0.28；deepseek-v4-pro 输入 $0.435、输出 $0.87；命中缓存时输入价格要低得多。具体价格以 https://api-docs.deepseek.com/quick_start/pricing 为准，2026-08-16 起官方改为峰谷计价。

技术说明

- 基于 Electron 43 构建，内置 Node 运行时 v24.19.0。
- 通过 @deepseek-ai/dsh@0.1.0-rc.6 启动 Web UI。
- 数据与 API Key 保存在 %USERPROFILE%\.dsh（可用 DSH_HOME 环境变量覆盖）。
- desktop profile 按序装载：@deepseek-ai/dsh-base → @deepseek-ai/dsh-web-app → @dsh-desktop/client。
- 标题栏、托盘与引导遵循一套简约沉静的设计语言，配色取自 DeepSeek 品牌蓝（强调色 #4D6BFE、深墨 #10131A、纸白 #F4F6F9）。

免责声明

本项目是社区作品，非 DeepSeek 官方出品。DeepSeek Harness 目前处于 developer preview 阶段，后续可能有破坏性变更。本项目基于 MIT 协议开源，使用中遇到的问题请优先查阅官方文档。

相关链接

- DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- API 控制台：https://platform.deepseek.com
- 项目 Topics：dsh-plugin、dsh、deepseek-harness、windows、electron、desktop

English
📖 完整文档站点（即时中英文切换）→ https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

这是什么？

DeepSeek Harness 是 DeepSeek 官方的智能体框架。官方构建仍处于开发者预览阶段：手动搭建意味着要安装 Node 22.19+ 或 Node 24、pnpm，以及一系列命令行步骤。对大多数人来说，这个门槛太高了。

dsh-desktop 将 DeepSeek Harness Web UI 封装进一个原生 Windows 桌面应用。界面本身没有改动，只是套上了一层更友好的外壳：应用驻留在系统托盘，窗口拥有自己绘制的标题栏，通知采用标准 Windows 样式，并且同一时间只能运行一个实例。下载、安装、双击，搞定。

一览

| 功能 | 作用 |
|---|---|
| 无边框窗口 | 绘制的 36px 标题栏，带实时状态圆点 |
| 系统托盘 | 驻留在托盘中；单击即可唤回 |
| 原生通知 | 标准 Windows 通知样式，托盘气泡作为后备 |
| 单实例 | 同一时间只运行一份；再次启动会将其唤到前台 |
| 开机启动 | 可选，登录后在后台启动 |
| 首次运行引导 | 粘贴一次 API 密钥；它只保存在你的机器上 |
| 端口 0 自动分配 | Windows 在每次启动时挑选一个空闲端口 |
| 自动更新 | 后台下载；重启以应用 |

功能

- ▭ 无边框窗口：没有系统边框。36px 标题栏由应用绘制，并带有实时状态圆点：本地服务运行时为青色，启动中为灰色，出错时为红色。在 Windows 11 上，圆角由 DWM 原生提供。
- ▣ 系统托盘：应用驻留在托盘中。单击可唤回窗口；右键打开菜单：打开主窗口、开机启动（复选框）、关于、退出。
- ◈ 原生通知：提醒采用标准 Windows 通知样式，就像任何普通应用一样，在缺少原生支持的地方以托盘气泡作为后备。
- ◎ 单实例：同一时间只运行一份。再次双击只会将现有窗口带到前台。
- ↻ 开机启动：可选，登录后在后台启动，由 Windows 注册表 Run 键支持。
- ▤ 首次运行引导：首次启动会显示一个引导对话框，要求输入你的 DeepSeek API 密钥。密钥只保存在本机，位于 /.env。
- ⇄ 端口 0 自动分配：服务在每次启动时向 Windows 请求一个空闲端口（--port 0），因此它永远不会与端口 3080 或任何其他程序冲突。
- ↑ 自动更新：已安装（NSIS）版本会在启动后不久静默检查新版本，并在后台下载。准备就绪后，会出现一条原生通知，托盘菜单会显示“重启并更新”；选择它即可重启并应用。便携版 zip 没有安装程序，因此其“检查更新”会打开 GitHub Releases 页面。

快速开始

1. 从 Releases 页面获取最新安装程序。
2. 安装，然后双击桌面上的 DeepSeek Harness 图标。
3. 首次启动时，将你的 DeepSeek API 密钥粘贴到设置对话框中。主窗口会自动打开。

应用会启动服务并为你打开主窗口。无需手动操作。

首次运行：底层发生了什么

首次启动是一个编排好的流程。如果尚未配置 API 密钥，会弹出一个模态对话框要求输入。配置文件会写入磁盘，捆绑的 CLI 会以 --profile desktop --port 0 启动，然后 supervisor 会等待就绪行（dsh web: http://127.0.0.1:）。一旦解析完成，Web UI 就会加载到内容视图中，状态点变为青色。

1. 获取单实例锁。第二次启动只会将现有窗口带到前台。
2. 如果尚未配置 API 密钥，引导对话框会要求输入一个，并将其保存到 /.env。
3. 将 desktop 配置文件写入磁盘，然后启动捆绑的 CLI：dsh --profile desktop --port 0。
4. 等待就绪行（dsh web: http://127.0.0.1:）。一旦解析完成，Web UI 就会加载到内容视图中，状态点变为青色。如果超时，则会显示带有重试按钮的错误视图。

首次启动：设置你的 API 密钥

首次运行会显示一个设置对话框，你可以在其中输入你的 DeepSeek API 密钥：

1. 前往 https://platform.deepseek.com 并登录。
2. 在 API Keys 页面点击“Create”以获取一个形如 sk-... 的密钥。
3. 将密钥粘贴到对话框中，点击保存，然后主窗口就会打开。

你的密钥只存储在你自己的机器上。它绝不会被上传到任何地方。

工作原理

dsh-desktop 是一个 Electron 外壳。主进程负责窗口、托盘、通知、自动启动以及运行时 supervisor，后者会启动并监视捆绑的 DeepSeek Harness CLI。一个 preload 桥向渲染器暴露了一个小型、冻结的 window.dshDesktop API。窗口自身的 web contents 绘制标题栏，其下方一个沙盒化的 WebContentsView 承载 DeepSeek Harness Web UI，后者运行在 desktop 配置文件上：@deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app 和 @dsh-desktop/client。

FAQ

杀毒软件警告或 SmartScreen 提示？

打包的桌面应用没有代码签名。首次运行可能会触发 Windows SmartScreen 的“Windows 已保护你的电脑”消息，某些杀毒工具也可能误报。这对于打包软件来说是正常的，并不是出现问题的迹象。

- SmartScreen：点击“更多信息”，然后点击“仍要运行”
- Windows Defender：病毒和威胁防护 → 排除项 → 添加排除项
- 360 安全卫士：木马查杀 → 信任区 → 添加信任目录
- 火绒安全：防护中心 → 病毒防护 → 信任区 → 添加文件/目录
- 腾讯电脑管家：病毒查杀 → 信任区

我可以将它安装到包含中文字符的路径中吗？

可以。桌面应用不依赖命令行脚本，因此它在包含中文字符的路径下也能正常工作（例如 软件\DeepSeek Harness）。

端口已被占用？
服务监听系统分配的端口（端口 0），因此 Windows 会在启动时选择一个空闲端口。它绝不会与端口 3080 或任何其他程序冲突，也无需手动配置。

为什么我关闭窗口后应用仍在运行？

默认情况下，关闭窗口会最小化到托盘，应用会继续在后台运行。从托盘菜单中选择“退出”即可完全退出。

如何更新到新版本？

已安装的版本会在启动后自动在后台检查更新。当新版本准备好时，会出现通知。从托盘菜单中选择“重启并更新”（或直接重启应用），更新会在退出时应用。你也可以随时使用托盘菜单中的“检查更新”项。便携版 zip 没有自安装程序：“检查更新”会打开 GitHub Releases 页面，你在那里下载最新的 zip 并替换旧文件夹。

如何在中英文之间即时切换？

本 README 是一个单文件双语文档。顶部的 🇨🇳 中文 和 🇬🇧 English 标签可直接跳转到你想要的章节，无需重新加载页面，也没有单独的文件。如需完整的交互体验（即时语言切换、深色模式、搜索），请使用文档站点：https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

我需要付费吗？

该软件免费且开源，但 DeepSeek API 是按用量付费的。当前参考价格（每百万 token）：deepseek-v4-flash 输入 $0.14 / 输出 $0.28；deepseek-v4-pro 输入 $0.435 / 输出 $0.87；缓存命中的输入要便宜得多。权威列表请见 https://api-docs.deepseek.com/quick_start/pricing。自 2026-08-16 起，计费将切换为高峰/非高峰定价。

技术说明

- 使用 Electron 43 和捆绑的 Node 运行时（v24.19.0）构建。
- 通过 @deepseek-ai/dsh@0.1.0-rc.6 运行 Web UI。
- 数据和你的 API 密钥位于 %USERPROFILE%\.dsh 下（可通过 DSH_HOME 环境变量覆盖）。
- desktop 配置文件按顺序挂载：@deepseek-ai/dsh-base → @deepseek-ai/dsh-web-app → @dsh-desktop/client。
- 标题栏、托盘和引导界面遵循基于 DeepSeek 品牌调色板（强调色 #4D6BFE、深墨色 #10131A、纸色 #F4F6F9）构建的极简、平静的设计语言。

免责声明

社区项目，并非 DeepSeek 官方产品。DeepSeek Harness 处于开发者预览阶段，可能会在不另行通知的情况下发生变化。本项目采用 MIT 许可证。遇到问题时，请先查阅官方文档。

链接

- 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- API 控制台：https://platform.deepseek.com
- 主题：dsh-plugin, dsh, deepseek-harness, windows, electron, desktop