---
title: 桌面应用
description: Multica Desktop 是什么、和 Web 有什么区别、什么时候值得用。
---

import { Callout } from "fumadocs-ui/components/callout";

Multica Desktop 是原生桌面应用——macOS / Windows / Linux 三个平台。它和 Web 版连同一个后端，看到的数据完全一样，但给了几个 Web 做不到的能力：**[工作区](/workspaces) 独立的多标签页**、**自动启动 [守护进程](/daemon-runtimes)**、**一键升级**。

## Desktop 和 Web 该用哪个

| | Web | Desktop |
|---|---|---|
| 访问方式 | 浏览器打开 URL | 装一个本地应用 |
| 多标签页 | 浏览器自己的标签页（不区分工作区）| **每个工作区一组独立标签页** |
| 守护进程 | 要你自己跑 `multica daemon start` | 启动时**自动拉起** |
| 升级 | 刷新页面就是最新 | 应用自动检查 + 下次启动安装 |
| 登录后的数据 | 完全一样 | 完全一样 |

**选 Web**：临时用、在别人电脑上、不想装应用的场景。  
**选 Desktop**：每天用 Multica、会同时操作多个工作区、不想自己管守护进程的场景。

## 多 tab：工作区之间切换怎么表现

Desktop 为**每个你加入的工作区**独立维护一组标签页。切换工作区时，当前工作区的标签页会被整体隐藏，上次那个工作区的标签页会原样恢复——像 VSCode 的多 workspace 行为或 Slack 的 workspace 切换。

举例：你在工作区 A 打开了 3 个 issue 标签页，切到工作区 B，A 的那 3 个标签页消失，B 里显示你上次在 B 留下的标签页；切回 A，那 3 个原样回来。**不同工作区的标签页不会互相串到对方**。

登出会**清空所有工作区的标签页状态**，防止多用户共用同一台机器时的数据泄露。

## Desktop 怎么自动更新

Desktop 启动时会去 GitHub Releases 检查新版本。检查到新版本：

1. 在后台静默下载新版本
2. 提示你「准备就绪，下次启动时安装」
3. 你点击退出（或下次重启）时，应用关闭前把新版本装好
4. 再次打开时就是新版本

整个过程**不中断你正在做的事**。

<Callout type="warning">
**Windows 的 ARM64 和 x64 是独立的更新通道**——装错架构会识别不到更新。安装时下载对应你机器架构的那个 `.exe`（带 `arm64` 后缀的是 ARM 版）。
</Callout>

macOS 版本已经签名 + 公证，第一次打开不会有"未知开发者"的警告。Linux 版是 `.AppImage`——自动更新机制依赖 electron-updater，在某些发行版可能不稳定，**不工作时手动下载新版本覆盖**。

## 还要单独装 CLI 和守护进程吗

**不用**。Desktop 包里**内置了同一个 `multica` CLI 二进制**——Desktop 启动时会自动启动守护进程的独立 profile（和你命令行手动跑的守护进程互不干扰）。

如果你已经装过 CLI 并手动跑过 `multica daemon start`，Desktop 不会抢占你那个守护进程——它起自己的，用不同的 profile 隔离。两边注册的是**不同的运行时**，在 UI 里能看到两个独立运行时。

想在终端里跑 CLI 命令，Desktop 不提供特殊方式——照常用系统的 CLI（如果你单独装了），或者用 Desktop 自带的版本（在应用的资源目录里，`resources/bin/multica`）。

## 怎么下载安装

去 [多卡下载页](https://multica.ai/download) 拿对应平台的安装包：

| 平台 | 文件 |
|---|---|
| macOS（Intel 或 Apple Silicon）| `.dmg` |
| Windows x64 | `.exe`（常规）|
| Windows ARM64 | `.exe`（带 `arm64` 后缀）|
| Linux | `.AppImage` |

安装后第一次打开需要登录——和 Web 版一样的 email + 验证码流程。登录成功后 Desktop 自动把工作区列表同步下来。

<Callout type="warning">
**发布版的 Desktop 是锁死连 Multica Cloud 的**。后端 / WebSocket / Web 前端 URL（`VITE_API_URL` / `VITE_WS_URL` / `VITE_APP_URL`）在构建时就写死了，应用内**没有切换后端的入口**。要让 Desktop 连自部署后端，需要你自己从源码 build：

```bash
git clone https://github.com/multica-ai/multica.git
cd multica
# 编辑 apps/desktop/.env.production：
#   VITE_API_URL=https://api.your-domain
#   VITE_WS_URL=wss://api.your-domain/ws
#   VITE_APP_URL=https://your-domain
pnpm install
pnpm --filter @multica/desktop package
```

不想自己 build 的话，自部署的官方路径是 **Web 前端 + CLI**——见 [自部署快速上手](/self-host-quickstart)。Desktop 运行时切换后端的能力跟踪在 [issue #1371](https://github.com/multica-ai/multica/issues/1371)。
</Callout>

## 下一步

- [Cloud Quickstart](/cloud-quickstart) —— Desktop 版的 Cloud 接入流程
- [Self-Host Quickstart](/self-host-quickstart) —— 自部署后端（Desktop 连自部署需要自行构建，见上方提示）
- [守护进程与运行时](/daemon-runtimes) —— 守护进程机制（Desktop 自动起它，但行为一样）
