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

# Moxus Desktop

> 使用 Moxus Desktop 在本地完成项目、会话、文件、终端和交付物相关的 AI 编程工作。

Moxus Desktop 是 Moxus 的原生 AI 编程工作台。它将项目会话、Agent 执行过程、终端、文件变更和生成的交付物集中在一个桌面应用中。

与 Cursor、Claude Code 或 Codex 不同，**Moxus Desktop 不需要你手动填写 Moxus API 密钥。** 登录 Moxus 账户后，直接选择该账户可用的模型即可。

<Info>
  在 [Moxus Desktop 下载页](https://moxus.cloud/desktop) 下载当前 macOS 或 Windows 安装包。应用会在启动后和“设置 → 关于”中检查更新。
</Info>

## 可以做什么

<Columns cols={2}>
  <Card title="按项目工作" icon="folder-kanban">
    打开本地文件夹，在同一个项目下保留多个相互独立的 AI 会话。
  </Card>

  <Card title="使用通用会话" icon="message-square">
    不打开项目也能开始任务，工作内容会保留在独立的 Moxus 工作区中。
  </Card>

  <Card title="跟进执行过程" icon="list-checks">
    在任务进行时查看消息、命令、审批、终端活动和文件变更。
  </Card>

  <Card title="在上下文中检查结果" icon="panel-right-open">
    在对话旁预览文件、差异、PDF、图片、视频和本地网页。
  </Card>

  <Card title="搜索实时网页" icon="search">
    需要最新资料时使用网页搜索，查看搜索过程和可点击的来源。
  </Card>

  <Card title="管理多个会话" icon="messages-square">
    搜索、重命名、置顶或归档会话，保持项目中的任务井然有序。
  </Card>
</Columns>

## 开始前

你需要：

* 可以登录桌面应用的 Moxus 账户。
* 可用于目标模型的账户余额。
* 与操作系统匹配的桌面端安装包。

**正常使用 Moxus Desktop 不需要创建或复制 API 密钥。** API 密钥用于接口调用和第三方客户端。

## 第一次使用

<Steps>
  <Step title="安装并打开 Moxus Desktop">
    从发布页下载适合操作系统的安装包，完成安装后打开应用。
  </Step>

  <Step title="登录 Moxus">
    使用与 Moxus 网站相同的账户登录。登录完成后，应用会加载该账户可用的模型。
  </Step>

  <Step title="选择项目或创建通用会话">
    要处理已有代码库时选择本地项目文件夹；要讨论想法、制定计划或完成不属于项目的任务时，创建通用会话。
  </Step>

  <Step title="选择模型并发送任务">
    在输入框中选择模型，描述要完成的工作并发送。工作台会流式显示回复和 Agent 执行过程。
  </Step>

  <Step title="审阅变更和产物">
    在保留或使用结果前，从对话或右侧面板打开文件变更、终端输出、预览和生成的交付物进行检查。
  </Step>
</Steps>

## 项目、会话和通用工作区

### 项目工作区

项目工作区关联到你选择的本地文件夹，适合代码库开发、功能修改、排错，或需要读取已有文件的任务。一个项目可以包含多个会话，因此不同任务能保留各自的对话和工作上下文。

### 通用会话

通用会话不需要本地项目，适合规划、研究、短脚本、文档制作，或在进入代码库前先验证一个想法。通用会话的工作会保存在独立的 Moxus 工作区中，不会随意写入项目文件夹。

### 会话相互独立

切换项目或会话不会混合它们的对话历史。你可以在查看另一个会话时让正在运行的会话继续执行；重新打开应用后，可恢复的历史会在可用时重新加载。侧栏支持搜索、重命名、置顶和归档会话；归档只会将会话从常用列表中隐藏，不等于删除。

### 排队后续消息

当前任务运行时，可以继续输入后续要求并排队发送。发送前可以编辑已排队的消息，适合补充约束、调整方向或连续交代任务。

## Agent 如何显示工作过程

一次请求中，除了最终回答外，对话还可能显示以下内容：

| 内容   | 含义                            |
| ---- | ----------------------------- |
| 消息   | 模型回复，或等待你回答的问题。               |
| 过程   | 推理、搜索或任务阶段等进度信息。              |
| 命令   | Agent 请求本地运行环境执行的命令。          |
| 审批   | 继续前需要你确认的操作。                  |
| 用户输入 | Agent 在执行过程中向你提出的问题或需要你补充的信息。 |
| 文件变更 | 新建或修改的文件，可打开检查。               |
| 终端   | 与当前会话关联的终端输出。                 |
| 网页搜索 | Agent 搜索实时网页时显示的过程和来源。        |

使用文件差异和预览面板审阅变更。涉及项目、文件或运行服务的审批尤其需要仔细确认。

<Warning>
  当任务需要时，Moxus Desktop 可以读取和修改已打开工作区中的内容。请确认选择的文件夹，审阅每一项审批和文件变更。除非已获得组织许可，不要在提示词或项目文件中放入凭据、生产环境密钥或其他敏感信息。
</Warning>

## 文件、终端和交付物

### 文件审阅与预览

右侧面板可以显示文件树，并预览常见文本文件、图片、Markdown、PDF、视频、文件差异和本地网页。对本轮文件变更审阅后，可以应用或回滚变更。DOCX、XLSX、PPTX 等 Office 文件通常由操作系统中的默认应用打开。

### 会话终端

终端标签属于当前会话。这样命令输出和运行中的进程会始终关联到创建它们的任务，不会与其他项目或对话混在一起。

### 生成的交付物

Moxus Desktop 可以生成 PPTX、DOCX、XLSX 和 PDF 等文档交付物。生成后会在对话中显示为产物卡片，可直接打开、下载或在文件夹中显示。图表和 SVG 图可在对话中直接呈现；PDF 和视频可在应用内预览，Office 文件通常使用系统默认应用打开。

## 模型和计费

Desktop 中显示的模型，以你的 Moxus 账户当前可用的模型为准。某个模型未显示时，表示它当前无法在 Desktop 中使用。

请求消耗 Moxus 账户余额。当前价格请查看[模型广场与定价](/zh/overview/models-and-pricing)，请求记录请查看[控制台与用量](/zh/platform/dashboard-and-usage)。Desktop 也会为已完成的桌面请求保留本地账户记录，方便参考。

## 更新

Moxus Desktop 会在打开时、保持打开一段时间后，以及窗口重新回到前台时检查更新。也可以从侧栏更新入口或“设置 → 关于”中手动检查。发现更新后，在应用内安装并按提示重启即可。

## 常见问题

<AccordionGroup>
  <Accordion title="无法登录">
    先确认同一 Moxus 账户能否在网站正常登录，再检查网络后重试。网站可以登录但桌面端仍失败时，联系支持时请附上报错信息和应用版本。
  </Accordion>

  <Accordion title="找不到需要的模型">
    Desktop 只显示当前账户可以使用的模型。如果某个模型没有出现在列表中，说明它当前无法在 Desktop 中使用，请选择列表中的其他可用模型。
  </Accordion>

  <Accordion title="任务正在等待审批">
    打开审批行，阅读请求执行的操作后再继续。拒绝审批可能会使当前步骤停止；若要换一种方式完成任务，请继续输入新的要求。
  </Accordion>

  <Accordion title="找不到生成的文件">
    打开生成该文件的消息中的产物卡片，再使用打开、下载或在文件夹中显示操作。若文件创建在项目中，也可以在项目文件树和变更列表中查找。
  </Accordion>

  <Accordion title="结果不完整或请求失败">
    先查看会话的最后一条过程信息和终端输出，再到[控制台与用量](/zh/platform/dashboard-and-usage)确认请求是否到达 Moxus、实际使用的模型，以及是否记录了接口错误。
  </Accordion>
</AccordionGroup>

## 相关文档

* [模型广场与定价](/zh/overview/models-and-pricing)
* [API 密钥](/zh/platform/account-and-keys)
* [控制台与用量](/zh/platform/dashboard-and-usage)
* [Cursor 接入](/zh/integrations/clients/cursor)