> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 桌面应用
> 在 macOS、Windows 或 Linux 上安装 Mintlify 桌面应用，在带有标签页和键盘快捷键的原生窗口中使用控制台和编辑器。
桌面应用目前处于 beta 阶段，可能会发生变化。
Mintlify 桌面应用在你的电脑上运行你的[控制台](https://app.mintlify.com)和[编辑器](/docs/zh/editor/index)。你可以在标签页或多个窗口中工作，访问与浏览器中相同的内容和设置。
桌面应用更新内容的方式与在编辑器中工作相同。你也可以[打开电脑上的 Markdown 文件](#open-local-files)进行编辑，或将其复制到项目中。如需在本地预览整个站点，请使用 [CLI](/docs/zh/cli/index)。
## 安装
需要搭载 Apple 芯片的 macOS 14 或更高版本。
1. 从 [mintlify.com/desktop](https://mintlify.com/desktop) 下载桌面应用。
2. 打开该文件。
3. 将 **Mintlify** 拖到你的 **Applications** 文件夹中。
你也可以通过终端安装。
```bash Install the desktop app theme={null}
curl -fsSL https://desktop.mintlify.com/install.sh | bash
```
该脚本会安装到 `/Applications`；如果你无法写入 `/Applications`，则会安装到 `~/Applications`。
需要 64 位 Windows 10 或更高版本。
1. 从 [mintlify.com/desktop](https://mintlify.com/desktop) 下载桌面应用。
2. 运行安装程序。
需要 x86\_64 设备。桌面应用提供 AppImage 和 `.deb` 软件包两种格式。
从 [mintlify.com/desktop](https://mintlify.com/desktop) 下载任一文件，或通过终端安装 AppImage。
```bash Install the desktop app theme={null}
curl -fsSL https://desktop.mintlify.com/install.sh | bash
```
该脚本会将应用安装到 `~/.local/share/mintlify-desktop`，在 `~/.local/bin` 中添加 `mintlify-desktop` 命令，并将 Mintlify 添加到你的应用程序菜单中。
AppImage 需要 FUSE 2。如果桌面应用无法启动，请安装 FUSE 2。在 Ubuntu 上：
```bash Install FUSE 2 theme={null}
sudo apt install libfuse2
```
## 登录
桌面应用会使用你已在默认浏览器中登录的 Mintlify 账户为你登录。
1. 打开桌面应用。桌面应用会显示 **Log in to Mintlify** 界面。
2. 点击 **Continue in browser**。你的默认浏览器会打开 Mintlify 授权页面，显示你的账户和组织。
3. 点击 **Approve**。如需登录其他组织，请先点击 **Use a different organization**。
4. 返回桌面应用。桌面应用会为你完成登录。
桌面应用与浏览器共享同一会话。在其中一处退出登录，另一处也会退出。
### 不使用浏览器登录
部分组织不支持浏览器登录，例如设置了[最长会话时长](/docs/zh/dashboard/session-security#maximum-session-lifetime)的组织。如果授权页面提示桌面登录不可用，请改为在桌面应用内登录：
1. 在 **Log in to Mintlify** 界面，点击 **Log in here instead**。
2. 按照你在浏览器中登录控制台的相同方式登录。
## 标签页和窗口
在单独的标签页或窗口中打开你正在处理的每个页面。重启应用后，标签页和窗口会恢复到你离开时的位置。
右键点击标签页可以复制该标签页、复制其链接或关闭其他标签页。用鼠标中键点击标签页可以将其关闭。
如需在侧边栏而不是窗口顶部显示标签页，请在[设置](#settings)中更改标签页布局。
### 每个标签页都有独立的会话
新标签页打开时，会登录到与打开它的标签页相同的账户和组织。之后，每个标签页都会保持各自独立的会话：
* 在一个标签页中切换组织不会影响其他标签页，因此你可以同时在不同的组织中工作。
* 退出登录或登录其他账户只会影响当前标签页。
如需在所有位置退出登录，请使用[设置](#settings)中的 **Clear all data**。
### 指向其他网站的链接
标签页只会加载 Mintlify 控制台以及它用于登录、获取 AI 功能额度和连接 Git 提供商的服务。指向任何其他网站的链接都会在你的默认浏览器中打开。
## 打开本地文件
打开电脑上的 Markdown 文件，在编辑器中查看和编辑。桌面应用可以打开不超过 5 MB 的 `.md`、`.mdx`、`.markdown` 和 `.txt` 文件。
要打开文件，请选择 **File** > **Open File…** 或按 Cmd + O。文件会在新标签页中打开。
* **Visual** 模式使用 Mintlify 组件（如提示框、卡片、步骤和代码块）渲染文件。
* **Markdown** 模式显示原始源码。对于可视化编辑器无法渲染的内容，请使用此模式。
按 Cmd + S 或点击 **Save**，将更改写回文件。桌面应用会保持文件的 frontmatter 不变。在 Visual 模式下保存可能会重新格式化部分 Markdown，例如列表标记和间距。
Visual 模式不会应用你站点的主题，也不会加载代码片段和相对路径图片。重启应用后，本地文件标签页不会重新打开。
打开和编辑本地文件无需登录。
### 将文件复制到项目
登录后，你可以将本地文件作为新页面添加到组织的某个项目中。
1. 点击 **Copy to project**。
2. 选择一个项目。
桌面应用会在新标签页中打开该项目的编辑器，并将文件作为新页面添加到导航末尾。页面标题和描述取自文件的 frontmatter。像发布其他更改一样[发布](/docs/zh/editor/publish)该页面。
## 键盘快捷键
在 Windows 和 Linux 上，请使用 Ctrl 代替 Cmd。
| 操作 | 快捷键 |
| :- | :- |
| 新建标签页 | Cmd + T |
| 在新标签页中新建页面 | Cmd + N |
| 打开文件 | Cmd + O |
| 新建窗口 | Cmd + Shift + N |
| 关闭标签页 | Cmd + W |
| 关闭窗口 | Cmd + Shift + W |
| 转到标签页 1-9 | Cmd + 1-9 |
| 下一个标签页 | Ctrl + Tab |
| 上一个标签页 | Ctrl + Shift + Tab |
| 后退 | Cmd + \[ |
| 前进 | Cmd + ] |
| 重新加载 | Cmd + R |
| 放大 | Cmd + + |
| 缩小 | Cmd + - |
| 重置缩放 | Cmd + 0 |
| 页面内查找 | Cmd + F |
| 查找下一个 | Cmd + G |
| 查找上一个 | Cmd + Shift + G |
| 复制页面 URL | Cmd + Shift + C |
| 打开设置 | Cmd + , |
有关编辑器内的快捷键，请参阅[键盘快捷键](/docs/zh/editor/keyboard-shortcuts)。
## 设置
在 macOS 上按 Cmd + ,，或在 Windows 和 Linux 上按 Ctrl + , 打开设置。
* **Tab layout**：在窗口顶部（**Horizontal**）或侧边栏中（**Vertical**）显示标签页。
* **Check for updates**：检查应用是否有新版本。参见[更新](#updates)。
* **Clear all data**：退出所有标签页的登录，关闭所有标签页并重置设置。应用会重新启动。
设置窗口还会显示应用版本。
## 更新
应用会在启动时以及运行期间每四小时检查一次更新。有可用更新时，标签栏中会出现 **Update** 按钮。
如需手动检查更新，请在[设置](#settings)中点击 **Check for updates**。你也可以在应用菜单中选择 **Check for Updates…**。在 macOS 上，它位于 **Mintlify** 菜单中的 **About Mintlify** 下方。在 Windows 和 Linux 上，它位于 **File** 菜单底部。对话框会显示是否有可用更新，并允许你安装更新。
* **macOS**：点击 **Update**，在应用内下载并安装更新。
* **Windows 和 Linux**：点击 **Update**，从浏览器下载新版本，然后进行安装。
## 卸载
1. 退出桌面应用。
2. 将 **Mintlify** 从你的 **Applications** 文件夹移到废纸篓。
3. 如需删除你的登录信息和设置，请删除 `~/Library/Application Support/Mintlify Electron`。
1. 打开 **Settings** > **Apps** > **Installed apps**。
2. 找到 **Mintlify** 并选择 **Uninstall**。
3. 如需删除你的登录信息和设置，请删除 `%APPDATA%\Mintlify Electron`。
如果你是通过脚本安装的桌面应用，请删除脚本创建的文件：
```bash Remove the desktop app theme={null}
rm -rf ~/.local/share/mintlify-desktop \
~/.local/bin/mintlify-desktop \
~/.local/share/applications/mintlify-desktop.desktop \
~/.local/share/icons/hicolor/512x512/apps/mintlify-desktop.png
```
如果你安装的是 `.deb` 软件包，请使用你的软件包管理器将其删除。
如需删除你的登录信息和设置，请删除 `~/.config/Mintlify Electron`。
## Related topics
- [示例](/docs/zh/components/examples.md)
- [GitHub](/docs/zh/deploy/github.md)
- [重定向](/docs/zh/create/redirects.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.