> ## Documentation Index
> Fetch the complete documentation index at: https://dshtauri.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

> 在 Windows、macOS 或 Linux 上安装 DeepSeek Harness Desktop。

桌面端安装包保持轻量。首次启动时，应用会下载兼容的 Node.js 运行时和预构建
Harness 内核。

## 系统要求

| 平台      | 要求                | 分发格式                                |
| ------- | ----------------- | ----------------------------------- |
| Windows | Windows 10 或更高版本  | NSIS `.exe` 或本地化 `.msi`             |
| macOS   | macOS 10.15 或更高版本 | Apple Silicon/Intel `.dmg`、Homebrew |
| Linux   | 现代 64 位发行版        | `.deb` 或 AppImage                   |

首次启动需要网络。安装完成后，除模型供应商、插件或更新需要联网外，常规工作在本机进行。

## 从 GitHub Releases 安装

<Steps>
  <Step title="打开发布页面">
    访问[最新版本](https://github.com/dsh-tauri-desk/deepseek-harness-desktop/releases/latest)。
  </Step>

  <Step title="选择安装包">
    下载与操作系统和架构匹配的资源。Linux 发行版支持时，优先使用 `.deb`。
  </Step>

  <Step title="安装并启动">
    运行安装程序，然后从应用菜单打开 **DeepSeek Harness Desktop**。
  </Step>
</Steps>

## 通过 Homebrew 安装 macOS 版本

```bash theme={null}
brew install dsh-tauri-desk/desktop/deepseek-harness
```

## 平台说明

<AccordionGroup>
  <Accordion title="Windows 安全提示">
    确认安装包来自官方 GitHub Release。应用使用受支持 Windows 已包含的 WebView2。
  </Accordion>

  <Accordion title="macOS 阻止首次启动">
    验证下载来源后，在**系统设置 → 隐私与安全性**中允许该应用运行。
  </Accordion>

  <Accordion title="Linux Wayland 黑屏">
    优先使用 `.deb`。AppImage 仍然黑屏时可尝试：

    ```bash theme={null}
    WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 GDK_BACKEND=x11 ./Deepseek*.AppImage
    ```
  </Accordion>
</AccordionGroup>

<Note>
  正式版用户无需安装 Node.js、pnpm 或 Docker；只有开发桌面端源码时才需要这些工具。
</Note>

接下来阅读[首次运行](./first-run)。