---
title: 桌面端下载与安装
source: https://vjmap.com/guide/map-video/desktop.html
---

---
group: 入门
description: 下载唯杰地图动画桌面端（Windows / macOS，官网或 GitHub），第一次打开怎么放行，以及怎么用自己电脑的显卡出片。
---

# 桌面端下载与安装

唯杰地图动画桌面端是一个独立的窗口程序，里面就是网页版的同一个编辑器：同一个账号、同一批工程。区别在出片：桌面端用你这台电脑的显卡渲染，通常比服务器快得多，4K、60 帧和透明通道都能出，成片直接存在本机。

桌面端是可选的，不装也能在浏览器里使用全部功能。

## 下载

当前版本 **1.0.1**（2026-10-24）。官网和 GitHub 上是同一份安装包，任选一处下载；国内网络建议从官网下载，速度更快。

| 你的电脑 | 官网下载 | GitHub 下载 |
|---|---|---|
| Windows 10 / 11（64 位） | [Windows 安装包 .exe（274 MB）](https://vjmap.com/download/map-video-desktop/VJMapVideo-Setup-1.0.1-x64.exe) | [GitHub](https://github.com/vjmap/map-video-desktop/releases/download/v1.0.1/VJMapVideo-Setup-1.0.1-x64.exe) |
| Mac，Apple 芯片（M1 / M2 / M3 / M4…） | [Apple 芯片版 .dmg（281 MB）](https://vjmap.com/download/map-video-desktop/VJMapVideo-1.0.1-mac-arm64.dmg) | [GitHub](https://github.com/vjmap/map-video-desktop/releases/download/v1.0.1/VJMapVideo-1.0.1-mac-arm64.dmg) |
| Mac，Intel 芯片 | [Intel 芯片版 .dmg（296 MB）](https://vjmap.com/download/map-video-desktop/VJMapVideo-1.0.1-mac-x64.dmg) | [GitHub](https://github.com/vjmap/map-video-desktop/releases/download/v1.0.1/VJMapVideo-1.0.1-mac-x64.dmg) |

- GitHub 版本页：[github.com/vjmap/map-video-desktop/releases](https://github.com/vjmap/map-video-desktop/releases)，有历次版本和更新说明；[最新版本](https://github.com/vjmap/map-video-desktop/releases/latest)这个地址总是指向最新版。
- 想核对下载的文件是否完整，可以对照官网的 [SHA256SUMS.txt](https://vjmap.com/download/map-video-desktop/SHA256SUMS.txt)。

不知道是哪种 Mac：点左上角苹果菜单 →「关于本机」，「芯片」写着 Apple M… 就是 Apple 芯片，写「处理器 Intel…」就是 Intel 芯片。

## Windows：第一次运行

安装包暂时没有数字签名，系统会拦一下：

1. 双击安装包，出现「Windows 已保护你的电脑」时，点 **更多信息** → **仍要运行**。
2. 按提示安装。程序装在当前用户下，不需要管理员权限，装好后桌面上有「唯杰地图动画」。
3. 360、火绒等安全软件如果提示风险，选「允许」或「信任」。

只有第一次要这样，之后正常打开。

## macOS：第一次打开

安装包暂时没有经过 Apple 公证，第一次打开会提示「无法验证开发者」或「已损坏」：

1. 打开 dmg，把「唯杰地图动画」拖进「应用程序」。
2. 在「应用程序」里双击打开，被拦下后，打开 **系统设置 → 隐私与安全性**，往下找到「唯杰地图动画」那一条，点 **仍要打开**，输入开机密码确认。
3. 如果提示「已损坏，无法打开」，打开「终端」，粘贴下面这行并回车（需要输入开机密码），再双击打开：

```bash
sudo xattr -cr /Applications/唯杰地图动画.app
```

只有第一次要这样。

## 用桌面端出片

1. 打开桌面端，在窗口里登录唯杰地图账号。账号和网页版、智能体平台、官网通用，登录后这台电脑会自动登记。
2. 打开工程，点顶栏的「导出」。对话框里多了一行「出片」：选「这台电脑 · 显卡名」就用本机的显卡出片；选「服务器」则和网页版一样由服务器渲染。
3. 成片默认存在「视频」文件夹（macOS 是「影片」）里的「唯杰地图动画」目录。对话框里点「更改目录」可以换位置。

在浏览器里用网页版时，只要桌面端开着、登录的是同一个账号，导出对话框的「出片」里也会出现「我的电脑「电脑名」」。选它就派给那台电脑出片，出完传回平台，那台电脑上也留一份。

在智能体平台的会话里，或通过 MCP 让 AI 出片时，有在线的桌面端，AI 也可以把出片交给它。

## 设置

菜单「文件 → 设置…」里可以调整：

| 设置 | 作用 |
|---|---|
| 站点地址 | 缺省连唯杰官网；私有化部署的用户填自己平台的地址（含部署子路径，如 `https://example.com/agent`） |
| 暂停接活 | 打开后，网页和 AI 都不会再把出片派到这台电脑，直到恢复；托盘菜单里也能暂停和恢复 |
| 允许平台 AI 和外部 AI 用这台电脑出片、截帧 | 关掉后只有你自己在导出对话框里选这台电脑时才出片 |
| AI 出的片也只存本机 | 打开后，AI 发起的出片不传回平台，会话里看不到成片；需要时在导出记录里点「上传到平台」 |
| 成片存放目录 | 成片存在哪；旁边的「打开」直接打开这个目录 |
| 缓存上限 | 出片用的素材、地图运行时和成片分段会缓存下来，下过一次就不再下载；「清空缓存」后下次出片重新下载 |

## 升级

有新版时下载新的安装包装上即可：Windows 直接覆盖安装，macOS 拖进「应用程序」替换。登录状态和设置都会保留。

::: tip 小技巧
桌面端用到的开源软件和许可，在菜单「帮助 → 开源软件许可」里可以查看。
:::
