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

# 在 Manus Studio 中本地构建

> 借助 Manus Studio，在您自己电脑上的文件夹中构建网站、Web 应用、移动应用和游戏。您可以选择 Manus 托管服务，也可以选择纯本地项目。

## 这是什么

**本地构建**让 Manus 在您自己电脑上的文件夹中构建网站、Web 应用、移动应用或游戏。您在 **Manus Studio** 中工作，这是 Manus 适用于 macOS（Apple Silicon）和 Windows 的桌面应用。Manus 负责编写代码、运行项目并显示实时预览。它会使用您电脑上已有的文件、文件夹和工具。要了解 Manus Studio 能在您的电脑上做什么，请参阅 [Manus Studio](https://manus.im/docs/zh-cn/features/desktop.md)。

在以下情况下使用此功能：

* 您的项目已经保存在您的电脑上。
* 您希望保留自己的 Git 工作流。
* 您希望在使用 Manus 的同时使用自己的工具。

您也可以在 [Cloud Computer](https://help.manus.im/en/articles/15392111-what-is-the-cloud-computer) 上使用相同的工作流。在这种情况下，项目文件夹位于 Cloud Computer 上，而不是您自己的电脑上。

对于每个网站或移动应用，您需要从两种项目类型中选择一种：

| 术语 | 含义 |
| :- | :- |
| **Manus 托管项目** | 项目连接到 Manus 服务，例如托管、数据库、用户登录、AI 功能、版本历史和发布。您还可以在网页版 Manus 中继续该项目。 |
| **纯本地项目** | 您电脑上的普通项目。您使用自己的工具和服务。Manus 不会设置托管、发布或其他 Manus 服务。 |
| **Manus 版本历史** | Manus 为 Manus 托管项目保存的版本列表。它与您自己的 Git 仓库相互独立。 |

下表显示了每种类型的项目适用哪些选项。

| 项目类型 | 您的选择 | 开发运行位置 |
| :- | :- | :- |
| **网站或 Web 应用** | Manus 托管或纯本地 | 您的电脑 |
| **移动应用** | Manus 托管或纯本地 | Manus 托管：Manus Cloud。纯本地：您的电脑。 |
| **游戏** | 始终为 Manus 托管 | 您的电脑 |

***

## 如何使用

### 设置 Manus Studio

**1. 下载 Manus Studio**

打开 [manus.im/desktop](https://manus.im/desktop)。选择 **macOS (Apple Silicon)** 或 **Windows**，然后运行安装程序。

**2. 登录**

打开 Manus Studio，并使用您的 Manus 账户登录。如果 Manus 要求您在使用本地文件夹之前进行更新，请安装最新版本。

**3. 开启 Work locally 并选择文件夹**

在聊天框中开启 **Work locally**。点击 **Choose a folder**，然后选择项目所在的文件夹，或希望 Manus 创建项目的文件夹。有关权限模式和文件夹访问，请参阅 [Manus Studio](https://manus.im/docs/zh-cn/features/desktop.md)。

### 在您的电脑上创建新网站

**1. 描述网站及其位置**

在 Manus Studio 中开始一个任务。描述您想要的网站，并告诉 Manus 要在您电脑上的哪个位置构建它。

**2. 选择项目类型**

Manus 会询问您希望如何设置网站。选择 **Manus 托管**，即可使用 Manus 的托管、数据库、登录、版本历史和发布功能。选择 **纯本地**，则只使用您自己的工具和服务。

**3. 如果文件夹不为空，请允许代码存储**

对于 Manus 托管项目，Manus 会检查文件夹。如果文件夹中已有文件，Manus 会显示一张 **Project code storage** 卡片。卡片会询问："Allow Manus to sync your project's code?" 点击 **Allow and initialize** 继续。如果您取消，Manus 将不会设置该项目。

**4. 查看计划**

Manus 会给出网站的构建计划。请在 Manus 开始构建之前提出修改意见。

**5. 预览并完善**

Manus 会在您的电脑上运行网站，并在 Manus Studio 中打开实时预览。在同一任务中描述您想要的修改即可。

示例提示词：

```text theme={null}
Build a booking website for my yoga studio in a new folder called yoga-site
in my Documents folder. Include a class schedule, a booking form, and a contact page.
```

> [!NOTE]
>
> 如果您已在提示词中选择了项目类型，例如"保持本地，不使用 Manus 托管"，Manus 就不会再次询问。

### 继续开发电脑上已有的网站

**1. 让 Manus 指向该文件夹**

在 Manus Studio 中，告诉 Manus 要继续哪个项目。如果可以，请提供完整的文件夹路径。

**2. 确认正确的副本**

Manus 会在该文件夹及其附近的文件夹中查找 Manus 网站。如果 Manus 找到多个匹配项，或匹配项不明确，它会询问您指的是哪一个。

**3. 选择如何连接现有代码**

文件夹中可能包含尚未关联到 Manus 的代码。在这种情况下，Manus 会请您选择 Manus 托管或纯本地。Manus 会保留您现有的文件，不会用初始模板覆盖它们。

### 将网站添加到更大的项目中

您可以将网站添加到非网站类的项目中，例如为游戏添加官方网站。

1. 告诉 Manus 您希望在这个更大的项目中添加一个独立的网站。例如："为这款游戏添加一个官方网站。"
2. Manus 会在单独的子文件夹中创建网站，例如 `website/`。
3. 只有该子文件夹属于网站。Manus 不会将项目的其余部分包含在网站版本中。

### 构建移动应用

**1. 描述应用**

在 Manus Studio 中，描述您想要构建的移动应用。

**2. 选择项目类型**

Manus 会在开始之前请您做出选择。**Manus 托管** 为您提供后端、数据库、登录、AI 功能、版本历史和应用构建。**纯本地** 则在您的电脑上进行开发，并使用您自己的后端和服务。

**3. 确认迁移到 Manus Cloud**

Manus 托管的移动应用目前在 Manus Cloud 中运行。如果您选择此项，Manus 会在开发开始前将任务从您的电脑迁移到 Manus Cloud。Manus 会在您做出选择之前告知您这一迁移。

> [!WARNING]
>
> 本地文件夹中的文件可能不会随任务一起迁移到 Manus Cloud。如果您有现有代码，请在做出选择之前告诉 Manus，以便它规划如何迁移这些代码。

### 构建游戏

1. 在 Manus Studio 中，描述游戏并告诉 Manus 要在您电脑上的哪个位置构建它。
2. Manus 会将游戏设置为 Manus 托管项目，不会请您选择项目类型。
3. 继续使用常规的 Game Dev 工作流。请参阅 [Game Developer](https://manus.im/docs/zh-cn/features/game-developer.md)。

### 保存版本并发布 Manus 托管项目

**1. 让 Manus 保存版本**

当您对某项修改感到满意时，请让 Manus 保存一个版本。Manus 会将网站文件夹中代码的副本上传到由 Manus 管理的私有仓库。Manus 仅将此副本用于版本历史和发布。

**2. 准备就绪后发布**

让 Manus 发布，或按照 [发布](https://manus.im/docs/zh-cn/website-builder/publishing.md) 中的说明进行发布。Manus 会询问"Allow Manus to publish?" 选择 **Allow once**，或选择 **Always allow for this website**，下次即可跳过此问题。只有项目所有者才能发布本地项目。除非您开启了自动发布，否则仅保存版本并不会发布您的网站。

> [!NOTE]
>
> 在您自己的 Git 仓库中提交（commit）不会创建 Manus 版本，也不会发布您的网站。

### 在本地项目中测试 Stripe 支付

1. 让 Manus 添加支付功能。Manus 会以测试模式设置 Stripe。请参阅 [支付](https://manus.im/docs/zh-cn/website-builder/payments.md)。
2. 使用 Stripe 测试卡号 `4242 4242 4242 4242` 测试结账流程。
3. 要进行完整的支付测试，Stripe 必须将支付事件（webhooks）发送到您的应用。在您自己电脑上运行的预览无法接收这些事件。请让 Manus 将项目迁移到临时云端沙盒中进行此项测试。Manus 会先征求您的同意。
4. 在首次发布之前，请让 Manus 从云端预览中连接 Stripe webhook。

### 稍后将纯本地项目连接到 Manus

1. 在 Manus Studio 中打开项目文件夹。
2. 让 Manus 将网站连接到 Manus。
3. Manus 会将现有文件夹关联到一个新的 Manus 托管项目。它会保留您的源文件，不会重新构建网站。

这适用于网站和 Web 应用。要将纯本地移动应用转为 Manus 托管，Manus 会将任务迁移到 Manus Cloud，并评估如何迁移您的代码。

***

## 您需要了解的内容

### 各部分在哪里运行

* **预览在您的电脑上运行。** Manus Studio 通过您电脑上的本地地址打开预览。其他设备无法打开此地址。
* **通过发布与他人分享。** 要让其他人看到网站，请发布网站，或在 Manus Cloud 中继续该任务。
* **在云端继续之前先同步。** 新的云端任务会从最新同步的版本开始。仅存在于您电脑上的修改不会被包含在内。请先让 Manus 同步，然后选择 **Continue in a new cloud task**。
* **只有所有者可以使用本地文件。** 本地文件、本地发布以及在新任务中继续，仅对项目所有者开放。
* **Manus 托管的移动应用在 Manus Cloud 中运行。** 网站、Web 应用和游戏保留在您的电脑上。Manus 托管的移动应用会迁移到 Manus Cloud。

### Manus 会上传什么

* **Manus 托管项目：** 当您保存或同步版本时，Manus 会上传网站文件夹中的代码。它不会上传更大项目的其余部分，例如配套网站所在的游戏项目。
* **仅进行设置不会上传代码。** 连接文件夹或设置 Manus 托管项目本身不会上传您的代码。
* **选择 Manus 托管不会发布任何内容。** 只有在您发布网站后，它才会公开。
* **纯本地项目：** Manus 不会设置 Manus 服务，也不会将版本保存到 Manus。您可以稍后将项目连接到 Manus。

### Manus 如何与您的 Git 仓库协作

* **两套独立的历史记录。** Manus 会为 Manus 托管项目保留自己的版本历史。您自己的 Git 仓库及其历史记录保持独立。
* **您的 Git 设置保持不变。** Manus 不会更改您的 remotes、分支、hooks 或凭据，也不会导入您的 Git 历史记录。
* **提交不会相互复制。** 您的提交不会出现在 Manus 版本历史中，Manus 版本也不会以提交的形式出现在您的仓库中。
* **共享文件。** 两套历史记录跟踪的是文件夹中的同一批文件。当 Manus 从自己的历史记录中引入修改时，这些修改会以未提交更改的形式出现在您的 Git 仓库中。
* **没有自身 Git 仓库的文件夹。** 如果网站文件夹不在任何 Git 仓库中，您的 Git 工具会显示该文件夹的 Manus 版本历史。如需在此使用单独的仓库，请让 Manus 进行设置。请不要自行在该文件夹中运行 `git init`。
* **Manus 会在网站文件夹中添加两项内容。** 一个小型项目文件将文件夹关联到您的 Manus 项目；一个隐藏文件夹用于存储 Manus 版本历史。请勿删除其中任何一项，也不要将隐藏文件夹提交到您自己的仓库。
* **Git worktree 和分支。** 您可以将这个小型项目文件提交到您的仓库。这样，新建的分支或 worktree 仍会关联到同一个 Manus 项目。
* **云端项目与 GitHub。** 对于在 Manus Cloud 中构建的项目，请参阅 [GitHub 集成](https://manus.im/docs/zh-cn/website-builder/github-integration.md) 和 [代码控制](https://manus.im/docs/zh-cn/website-builder/code-control.md)。

### 当前限制

* **本地项目暂不支持回滚。** 您无法将 Manus 托管的本地项目回滚到之前保存的版本。要撤销修改，请使用您自己的 Git 历史记录。
* **完整的 Stripe webhook 测试需要云端沙盒。** 测试模式下的结账可在本地运行，而支付事件需要临时云端沙盒。
* **游戏始终为 Manus 托管。** 游戏不提供纯本地选项。
* **Manus 托管的移动应用需要 Manus Cloud。** 您无法在自己的电脑上开发 Manus 托管的移动应用。

### 您电脑上的工具

* **Manus 会使用您已有的工具。** Manus 会使用您电脑上已安装的编程语言、包管理器和其他工具。
* **项目依赖包会在任务中安装。** Manus 会根据项目自身的设置，安装项目所需的依赖包。
* **系统级更改需要您的许可。** 在 Manus 为整台电脑安装或修复某个工具之前，它会说明所做的更改并征求您的许可。未经您同意，它不会使用管理员权限。

### 移动或复制项目文件夹

* **移动整个文件夹。** 如果您移动或重命名整个网站文件夹，它与 Manus 项目的关联及其版本历史都会保持不变。
* **仅复制项目文件不会创建新网站。** 该副本仍指向同一个 Manus 项目。如需新项目，请让 Manus 设置一个新项目。

### 积分

在您电脑上执行的任务与云端同等任务的积分消耗速率相同。费用取决于任务的复杂程度，而不是文件所在的位置。请参阅 [Understanding Credit Consumption in the Manus Desktop App](https://help.manus.im/en/articles/14134826-understanding-credit-consumption-in-the-manus-desktop-app)。

***

## 提示

* **向 Manus 提供完整的文件夹路径。** 完整路径（例如 `~/Documents/yoga-site`）可以帮助 Manus 第一次就找到正确的项目。
* **为新网站使用一个新的空文件夹。** 这样 Manus 设置项目时就无需请您确认代码存储。
* **在第一条提示词中说明项目类型。** 说明"Manus 托管"或"保持本地"，即可跳过设置问题。
* **如果您打算通过 Manus 发布，请选择 Manus 托管。** 无需额外设置即可获得托管、版本历史和发布功能。
* **将配套网站放在单独的子文件夹中。** 这样版本历史和上传内容只包含网站，而不是整个项目。
* **在进行大规模修改之前，先将工作提交到 Git。** Manus 托管的本地项目暂不支持回滚，因此您自己的 Git 历史记录就是您的安全保障。
* **提交小型项目文件，而不是隐藏文件夹。** 这样您的分支和 worktree 会始终关联到同一个 Manus 项目。
* **尽早规划支付测试。** 当您准备测试完整的支付流程时，请让 Manus 设置一个临时云端沙盒。
* **通过发布来分享。** 本地预览只能在您的电脑上使用。发布网站后，即可将链接发送给其他人。

***

## 常见问题

> [accordion] 本地构建需要 Manus Studio 吗？
>
> 需要。在您自己的电脑上构建需要使用适用于 macOS（Apple Silicon）或 Windows 的 Manus Studio。请从 [manus.im/desktop](https://manus.im/desktop) 下载。您也可以在 Cloud Computer 上使用相同的工作流。

> [accordion] Manus 托管项目和纯本地项目有什么区别？
>
> Manus 托管项目会连接到 Manus 服务，例如托管、数据库、登录、版本历史和发布。纯本地项目是您电脑上的普通项目。您使用自己的工具和服务，Manus 不会设置托管或发布。

> [accordion] Manus 会上传我的代码吗？
>
> 对于 Manus 托管项目，当您保存或同步版本时，Manus 会上传网站文件夹中的代码。仅设置项目本身不会上传代码。对于纯本地项目，Manus 不会将版本保存到 Manus。

> [accordion] Manus 会更改我的 Git 仓库吗？
>
> 不会。Manus 会保留自己的版本历史，与您的仓库相互独立。它不会更改您的 remotes、分支、hooks 或凭据。当 Manus 修改文件时，这些修改会以未提交更改的形式出现在您的仓库中。

> [accordion] 为什么我的移动应用任务被迁移到了云端？
>
> Manus 托管的移动应用目前在 Manus Cloud 中运行。Manus 会在您做出选择之前告知您这一点。如果您希望将应用保留在自己的电脑上，请改为选择纯本地开发。

> [accordion] 为什么 Manus 没有让我为游戏选择项目类型？
>
> 在本地构建的游戏始终为 Manus 托管。Manus 会使用 Manus 服务设置游戏，然后直接进入下一步。

> [accordion] 我可以将本地项目回滚到之前的版本吗？
>
> 暂时不行。当前版本中，Manus 托管的本地项目不支持回滚。请在进行大规模修改之前提交到您自己的 Git 仓库，以便您自行恢复文件。

> [accordion] 我可以在自己的电脑上测试 Stripe 支付吗？
>
> 您可以在 Stripe 测试模式下测试结账流程。完整测试支付事件（webhooks）需要临时云端沙盒。请让 Manus 进行设置。Manus 会在迁移项目之前征求您的同意。

> [accordion] 其他人可以打开我的本地预览吗？
>
> 不可以。预览在您电脑上的本地地址运行。要分享网站，请发布网站，或在 Manus Cloud 中继续该任务。

> [accordion] 我可以稍后将纯本地网站连接到 Manus 吗？
>
> 可以。让 Manus 连接该网站即可。Manus 会将现有文件夹关联到一个 Manus 托管项目，并保留您的源文件。

> [accordion] Manus 请求在我的电脑上安装工具，这是为什么？
>
> 您的项目需要的某个工具在您的电脑上缺失、版本过旧或无法正常工作。在为整台电脑安装或修复工具之前，Manus 会说明所做的更改并征求您的许可。

> [accordion] 本地构建会消耗更多积分吗？
>
> 不会。在您电脑上执行的任务与云端同等任务的积分消耗速率相同。请参阅 [套餐与定价](https://manus.im/docs/zh-cn/introduction/plans.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.