帮助文档

MAxi 使用指南与参考文档。从安装到进阶，一站式解决你的疑问。

什么是 MAxi

MAxi 是由 MonoStudio 开发的全自主 AI 桌面智能体。与传统的对话式 AI 助手不同，MAxi 能够直接理解你的意图，自主规划任务路径，并在本地环境中实时执行——操作文件系统、运行终端命令、浏览网页，从想法到落地全程自动化。

✦ 反重力 2.0

MAxi 的核心任务引擎。传统智能体像电梯只能逐层运行，反重力 2.0 让任务自由飞行——去中心化调度、并行执行、动态优化。

MAxi 目前处于内测阶段，需要通过邮件申请获得使用资格。支持 macOS 和 Windows 平台。

系统要求

项目 macOS Windows
操作系统 macOS 12 (Monterey) 及以上 Windows 10 (64-bit) 及以上
处理器 Apple Silicon 或 Intel x64 架构
内存 8 GB RAM（推荐 16 GB） 8 GB RAM（推荐 16 GB）
磁盘空间 ≥ 500 MB 可用空间 ≥ 500 MB 可用空间
网络 稳定的互联网连接（AI 推理需要在线）

安装指南

获得使用资格后，你会收到一封包含下载链接的邮件。根据你的操作系统选择对应版本：

下载安装包

macOS 用户下载 .dmg 文件，Windows 用户下载 .exe 安装程序。

完成安装

macOS：打开 .dmg 文件，将 MAxi 拖入 Applications 文件夹。首次打开可能需要在「系统设置 → 隐私与安全性」中允许运行。
Windows：运行 .exe 安装程序，按向导提示完成安装。

登录账户

打开 MAxi，使用你申请资格时的邮箱登录。首次登录会自动初始化工作环境。

开始使用

在对话框中输入你的任务描述，MAxi 会自动分析并开始执行。

💡 提示

MAxi 支持自动更新。有新版本时会在应用内提示，无需手动下载。

快速上手

以下是几个典型的使用场景，帮助你快速了解 MAxi 的能力：

场景一：创建一个新项目

// 在对话框中输入： 帮我创建一个 Express.js 项目， 包含用户认证、SQLite 数据库和 REST API。

MAxi 会自动初始化项目结构、安装依赖、编写代码，并运行测试验证。

场景二：修复 Bug

我的登录接口返回 500 错误， 帮我排查并修复。

MAxi 会读取相关代码，定位问题根源，自动修复并验证修复结果。

场景三：代码重构

把 src/ 下的所有 API 路由从回调风格 重构为 async/await，并确保测试全部通过。

MAxi 分析现有代码结构，批量修改，自动运行测试确保无回归。

自主推理

MAxi 不依赖逐步指令。当你描述一个目标时，它会：

  1. 分析上下文——理解当前项目结构、技术栈和代码状态
  2. 拆解任务——将复杂目标分解为可执行的子任务
  3. 规划路径——自主选择最优的执行顺序和策略
  4. 逐步执行——在本地环境中实时操作

与传统 AI 助手的区别

传统助手只能回答问题或生成代码片段。MAxi 能直接操作你的开发环境，从分析到编码到测试全程自主完成。

实时执行

MAxi 可以直接与你的本地环境交互：

  • 文件系统——读取、创建、编辑文件和文件夹
  • 终端——运行命令、安装依赖、执行脚本
  • 浏览器——打开网页、检查网络请求、验证页面效果

所有操作都在你眼前实时展示，你可以随时查看执行过程。

自我修正

当执行过程中遇到错误时，MAxi 会自动：

  • 回溯——分析错误产生的原因
  • 定位——找到问题所在的代码位置
  • 修复——自动修改代码解决问题
  • 重试——重新执行验证修复是否成功

✦ 无需手动 Debug

MAxi 会自主完成错误排查和修复。你只需要描述你想要的结果，它会处理中间遇到的所有问题。

安全沙箱

MAxi 的所有操作都在隔离环境中运行：

  • 关键操作（如删除文件、修改系统配置）需要你的确认
  • 你可以在任何时候中断或接管正在执行的任务
  • 文件修改支持回滚，出错可恢复到修改前的状态
  • 网络访问受控，不会未经授权上传你的代码

🔒 你的代码始终在本地

MAxi 运行在你的设备上，代码不会被上传到外部服务器（仅 AI 推理所需的上下文会发送到模型服务）。

上下文管理

MAxi 维护一个持续的全局上下文，这让它能够：

  • 在长时间任务中不遗忘之前的操作和决策
  • 跨会话保持项目理解（关闭再打开后仍记得项目状态）
  • 处理超大代码库（支持 10 万行以上的项目）

💡 上下文窗口

MAxi 通过智能上下文管理突破了传统 AI 的上下文长度限制。它会自动管理记忆与上下文的优先级，确保关键信息始终可用。

任务机制

MAxi 采用去中心化任务流，而非传统的线性执行：

  • 并行子任务——将复杂目标拆解为可并行执行的子任务图
  • 动态调度——实时优化执行顺序，优先处理关键路径
  • 状态感知——持续监控每个子任务的进度和状态

这意味着 MAxi 能同时处理多个相关任务，比逐步执行更快、更高效。

快捷键

快捷键 功能
⌘ + Enter / Ctrl + Enter 发送消息
⌘ + N / Ctrl + N 新建对话
⌘ + K / Ctrl + K 搜索 / 快速命令
⌘ + , / Ctrl + , 打开设置
Esc 中断当前任务
⌘ + Z / Ctrl + Z 撤销最近的文件修改

常见问题

MAxi 和 ChatGPT / Claude 有什么区别？
传统 AI 助手只能对话和生成文本。MAxi 是一个桌面智能体，能直接操作你的电脑——读写文件、运行命令、浏览网页，从想法到可运行的代码全程自动化。
我的代码数据安全吗？
MAxi 运行在你的本地设备上，所有文件操作都在本地完成。只有与 AI 推理相关的上下文信息会发送到模型服务，且传输经过加密。你的源代码不会被上传或存储在外部服务器上。
MAxi 是免费的吗？
MAxi 目前处于内测阶段，使用资格通过申请获取。具体的定价方案将在正式发布时公布。
支持哪些编程语言？
MAxi 支持所有主流编程语言和技术栈，包括但不限于 JavaScript/TypeScript、Python、Java、Go、Rust、C/C++ 等。它的能力来自底层大语言模型，不局限于特定语言。
断网还能用吗？
MAxi 的 AI 推理部分需要联网。但本地已缓存的项目状态和文件操作不受网络影响。在网络不稳定时，MAxi 会暂停推理并在恢复后继续执行。
如何更新到最新版本？
MAxi 内置自动更新功能。有新版本时，应用内会弹出提示，点击即可完成更新，无需手动下载。
能同时处理多个项目吗？
可以。MAxi 支持多会话，你可以为不同项目开启独立的对话窗口，每个会话维护各自的上下文。

故障排除

应用无法启动

  • macOS：检查「系统设置 → 隐私与安全性」是否阻止了应用运行，点击「仍要打开」
  • Windows：尝试右键 → 以管理员身份运行。如果 Windows Defender 拦截，请在安全中心中添加信任

AI 响应缓慢

  • 检查网络连接是否稳定
  • 尝试缩小任务范围，分步执行
  • 关闭其他占用网络带宽的应用

任务执行中断

  • 按 Esc 可中断当前任务
  • 如果任务意外中断，MAxi 会自动保存进度，重新发送相同的指令即可从断点继续
  • 检查磁盘空间是否充足

登录失败

  • 确认使用的是申请资格时的邮箱地址
  • 检查邮箱中是否收到了验证邮件
  • 清除应用缓存后重试（设置 → 高级 → 清除缓存）

联系我们

如果以上内容未能解答你的问题，欢迎通过以下方式联系我们：

✉ 技术支持

support@monostudio.top

✉ 法务咨询

legal@monostudio.top

我们通常会在 48 小时内回复你的邮件。