Skip to main content
Moxus Desktop 是 Moxus 的原生 AI 编程工作台。它将项目会话、Agent 执行过程、终端、文件变更和生成的交付物集中在一个桌面应用中。 与 Cursor、Claude Code 或 Codex 不同，Moxus Desktop 不需要你手动填写 Moxus API 密钥。 登录 Moxus 账户后，直接选择该账户可用的模型即可。
在 Moxus Desktop 下载页 下载当前 macOS 或 Windows 安装包。应用会在启动后和“设置 → 关于”中检查更新。

​
可以做什么

按项目工作

打开本地文件夹，在同一个项目下保留多个相互独立的 AI 会话。

使用通用会话

不打开项目也能开始任务，工作内容会保留在独立的 Moxus 工作区中。

跟进执行过程

在任务进行时查看消息、命令、审批、终端活动和文件变更。

在上下文中检查结果

在对话旁预览文件、差异、PDF、图片、视频和本地网页。

搜索实时网页

需要最新资料时使用网页搜索，查看搜索过程和可点击的来源。

管理多个会话

搜索、重命名、置顶或归档会话，保持项目中的任务井然有序。

​
开始前

你需要：
  • 可以登录桌面应用的 Moxus 账户。
  • 可用于目标模型的账户余额。
  • 与操作系统匹配的桌面端安装包。
正常使用 Moxus Desktop 不需要创建或复制 API 密钥。 API 密钥用于接口调用和第三方客户端。

​
第一次使用

1

安装并打开 Moxus Desktop

从发布页下载适合操作系统的安装包，完成安装后打开应用。
2

登录 Moxus

使用与 Moxus 网站相同的账户登录。登录完成后，应用会加载该账户可用的模型。
3

选择项目或创建通用会话

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

选择模型并发送任务

在输入框中选择模型，描述要完成的工作并发送。工作台会流式显示回复和 Agent 执行过程。
5

审阅变更和产物

在保留或使用结果前，从对话或右侧面板打开文件变更、终端输出、预览和生成的交付物进行检查。

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

​
项目工作区

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

​
通用会话

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

​
会话相互独立

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

​
排队后续消息

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

​
Agent 如何显示工作过程

一次请求中，除了最终回答外，对话还可能显示以下内容： 使用文件差异和预览面板审阅变更。涉及项目、文件或运行服务的审批尤其需要仔细确认。
当任务需要时，Moxus Desktop 可以读取和修改已打开工作区中的内容。请确认选择的文件夹，审阅每一项审批和文件变更。除非已获得组织许可，不要在提示词或项目文件中放入凭据、生产环境密钥或其他敏感信息。

​
文件、终端和交付物

​
文件审阅与预览

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

​
会话终端

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

​
生成的交付物

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

​
模型和计费

Desktop 中的模型列表由你的 Moxus 账户，以及该账户分组可使用的模型共同决定。模型未显示时，可能是该模型没有为 Desktop 启用，或当前账户分组没有权限使用。 请求消耗 Moxus 账户余额。当前价格请查看模型广场与定价，请求记录请查看控制台与用量。Desktop 也会为已完成的桌面请求保留本地账户记录，方便参考。

​
更新

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

​
常见问题

先确认同一 Moxus 账户能否在网站正常登录，再检查网络后重试。网站可以登录但桌面端仍失败时，联系支持时请附上报错信息和应用版本。
Desktop 只显示当前账户分组已启用、且支持 Desktop 的模型。先到模型广场确认模型是否存在；如果模型在模型广场中存在但 Desktop 不显示，请将完整模型名称提供给管理员。
打开审批行，阅读请求执行的操作后再继续。拒绝审批可能会使当前步骤停止；若要换一种方式完成任务，请继续输入新的要求。
打开生成该文件的消息中的产物卡片，再使用打开、下载或在文件夹中显示操作。若文件创建在项目中，也可以在项目文件树和变更列表中查找。
先查看会话的最后一条过程信息和终端输出，再到控制台与用量确认请求是否到达 Moxus、实际使用的模型，以及是否记录了接口错误。

​
相关文档