这是什么
本地构建让 Manus 在您自己电脑上的文件夹中构建网站、Web 应用、移动应用或游戏。您在 Manus Studio 中工作,这是 Manus 适用于 macOS(Apple Silicon)和 Windows 的桌面应用。Manus 负责编写代码、运行项目并显示实时预览。它会使用您电脑上已有的文件、文件夹和工具。要了解 Manus Studio 能在您的电脑上做什么,请参阅 Manus Studio。 在以下情况下使用此功能:- 您的项目已经保存在您的电脑上。
- 您希望保留自己的 Git 工作流。
- 您希望在使用 Manus 的同时使用自己的工具。
下表显示了每种类型的项目适用哪些选项。
如何使用
设置 Manus Studio
1
下载 Manus Studio
打开 manus.im/desktop。选择 macOS (Apple Silicon) 或 Windows,然后运行安装程序。
2
登录
打开 Manus Studio,并使用您的 Manus 账户登录。如果 Manus 要求您在使用本地文件夹之前进行更新,请安装最新版本。
3
开启 Work locally 并选择文件夹
在聊天框中开启 Work locally。点击 Choose a folder,然后选择项目所在的文件夹,或希望 Manus 创建项目的文件夹。有关权限模式和文件夹访问,请参阅 Manus Studio。
在您的电脑上创建新网站
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 中打开实时预览。在同一任务中描述您想要的修改即可。
如果您已在提示词中选择了项目类型,例如”保持本地,不使用 Manus 托管”,Manus 就不会再次询问。
继续开发电脑上已有的网站
1
让 Manus 指向该文件夹
在 Manus Studio 中,告诉 Manus 要继续哪个项目。如果可以,请提供完整的文件夹路径。
2
确认正确的副本
Manus 会在该文件夹及其附近的文件夹中查找 Manus 网站。如果 Manus 找到多个匹配项,或匹配项不明确,它会询问您指的是哪一个。
3
选择如何连接现有代码
文件夹中可能包含尚未关联到 Manus 的代码。在这种情况下,Manus 会请您选择 Manus 托管或纯本地。Manus 会保留您现有的文件,不会用初始模板覆盖它们。
将网站添加到更大的项目中
您可以将网站添加到非网站类的项目中,例如为游戏添加官方网站。- 告诉 Manus 您希望在这个更大的项目中添加一个独立的网站。例如:“为这款游戏添加一个官方网站。”
- Manus 会在单独的子文件夹中创建网站,例如
website/。 - 只有该子文件夹属于网站。Manus 不会将项目的其余部分包含在网站版本中。
构建移动应用
1
描述应用
在 Manus Studio 中,描述您想要构建的移动应用。
2
选择项目类型
Manus 会在开始之前请您做出选择。Manus 托管 为您提供后端、数据库、登录、AI 功能、版本历史和应用构建。纯本地 则在您的电脑上进行开发,并使用您自己的后端和服务。
3
确认迁移到 Manus Cloud
Manus 托管的移动应用目前在 Manus Cloud 中运行。如果您选择此项,Manus 会在开发开始前将任务从您的电脑迁移到 Manus Cloud。Manus 会在您做出选择之前告知您这一迁移。
构建游戏
- 在 Manus Studio 中,描述游戏并告诉 Manus 要在您电脑上的哪个位置构建它。
- Manus 会将游戏设置为 Manus 托管项目,不会请您选择项目类型。
- 继续使用常规的 Game Dev 工作流。请参阅 Game Developer。
保存版本并发布 Manus 托管项目
1
让 Manus 保存版本
当您对某项修改感到满意时,请让 Manus 保存一个版本。Manus 会将网站文件夹中代码的副本上传到由 Manus 管理的私有仓库。Manus 仅将此副本用于版本历史和发布。
2
准备就绪后发布
让 Manus 发布,或按照 发布 中的说明进行发布。Manus 会询问”Allow Manus to publish?” 选择 Allow once,或选择 Always allow for this website,下次即可跳过此问题。只有项目所有者才能发布本地项目。除非您开启了自动发布,否则仅保存版本并不会发布您的网站。
在您自己的 Git 仓库中提交(commit)不会创建 Manus 版本,也不会发布您的网站。
在本地项目中测试 Stripe 支付
- 让 Manus 添加支付功能。Manus 会以测试模式设置 Stripe。请参阅 支付。
- 使用 Stripe 测试卡号
4242 4242 4242 4242测试结账流程。 - 要进行完整的支付测试,Stripe 必须将支付事件(webhooks)发送到您的应用。在您自己电脑上运行的预览无法接收这些事件。请让 Manus 将项目迁移到临时云端沙盒中进行此项测试。Manus 会先征求您的同意。
- 在首次发布之前,请让 Manus 从云端预览中连接 Stripe webhook。
稍后将纯本地项目连接到 Manus
- 在 Manus Studio 中打开项目文件夹。
- 让 Manus 将网站连接到 Manus。
- Manus 会将现有文件夹关联到一个新的 Manus 托管项目。它会保留您的源文件,不会重新构建网站。
您需要了解的内容
各部分在哪里运行
- 预览在您的电脑上运行。 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 集成 和 代码控制。
当前限制
- 本地项目暂不支持回滚。 您无法将 Manus 托管的本地项目回滚到之前保存的版本。要撤销修改,请使用您自己的 Git 历史记录。
- 完整的 Stripe webhook 测试需要云端沙盒。 测试模式下的结账可在本地运行,而支付事件需要临时云端沙盒。
- 游戏始终为 Manus 托管。 游戏不提供纯本地选项。
- Manus 托管的移动应用需要 Manus Cloud。 您无法在自己的电脑上开发 Manus 托管的移动应用。
您电脑上的工具
- Manus 会使用您已有的工具。 Manus 会使用您电脑上已安装的编程语言、包管理器和其他工具。
- 项目依赖包会在任务中安装。 Manus 会根据项目自身的设置,安装项目所需的依赖包。
- 系统级更改需要您的许可。 在 Manus 为整台电脑安装或修复某个工具之前,它会说明所做的更改并征求您的许可。未经您同意,它不会使用管理员权限。
移动或复制项目文件夹
- 移动整个文件夹。 如果您移动或重命名整个网站文件夹,它与 Manus 项目的关联及其版本历史都会保持不变。
- 仅复制项目文件不会创建新网站。 该副本仍指向同一个 Manus 项目。如需新项目,请让 Manus 设置一个新项目。
积分
在您电脑上执行的任务与云端同等任务的积分消耗速率相同。费用取决于任务的复杂程度,而不是文件所在的位置。请参阅 Understanding Credit Consumption in the Manus Desktop App。提示
- 向 Manus 提供完整的文件夹路径。 完整路径(例如
~/Documents/yoga-site)可以帮助 Manus 第一次就找到正确的项目。 - 为新网站使用一个新的空文件夹。 这样 Manus 设置项目时就无需请您确认代码存储。
- 在第一条提示词中说明项目类型。 说明”Manus 托管”或”保持本地”,即可跳过设置问题。
- 如果您打算通过 Manus 发布,请选择 Manus 托管。 无需额外设置即可获得托管、版本历史和发布功能。
- 将配套网站放在单独的子文件夹中。 这样版本历史和上传内容只包含网站,而不是整个项目。
- 在进行大规模修改之前,先将工作提交到 Git。 Manus 托管的本地项目暂不支持回滚,因此您自己的 Git 历史记录就是您的安全保障。
- 提交小型项目文件,而不是隐藏文件夹。 这样您的分支和 worktree 会始终关联到同一个 Manus 项目。
- 尽早规划支付测试。 当您准备测试完整的支付流程时,请让 Manus 设置一个临时云端沙盒。
- 通过发布来分享。 本地预览只能在您的电脑上使用。发布网站后,即可将链接发送给其他人。
常见问题
本地构建需要 Manus Studio 吗?
本地构建需要 Manus Studio 吗?
需要。在您自己的电脑上构建需要使用适用于 macOS(Apple Silicon)或 Windows 的 Manus Studio。请从 manus.im/desktop 下载。您也可以在 Cloud Computer 上使用相同的工作流。
Manus 托管项目和纯本地项目有什么区别?
Manus 托管项目和纯本地项目有什么区别?
Manus 托管项目会连接到 Manus 服务,例如托管、数据库、登录、版本历史和发布。纯本地项目是您电脑上的普通项目。您使用自己的工具和服务,Manus 不会设置托管或发布。
Manus 会上传我的代码吗?
Manus 会上传我的代码吗?
对于 Manus 托管项目,当您保存或同步版本时,Manus 会上传网站文件夹中的代码。仅设置项目本身不会上传代码。对于纯本地项目,Manus 不会将版本保存到 Manus。
Manus 会更改我的 Git 仓库吗?
Manus 会更改我的 Git 仓库吗?
不会。Manus 会保留自己的版本历史,与您的仓库相互独立。它不会更改您的 remotes、分支、hooks 或凭据。当 Manus 修改文件时,这些修改会以未提交更改的形式出现在您的仓库中。
为什么我的移动应用任务被迁移到了云端?
为什么我的移动应用任务被迁移到了云端?
Manus 托管的移动应用目前在 Manus Cloud 中运行。Manus 会在您做出选择之前告知您这一点。如果您希望将应用保留在自己的电脑上,请改为选择纯本地开发。
为什么 Manus 没有让我为游戏选择项目类型?
为什么 Manus 没有让我为游戏选择项目类型?
在本地构建的游戏始终为 Manus 托管。Manus 会使用 Manus 服务设置游戏,然后直接进入下一步。
我可以将本地项目回滚到之前的版本吗?
我可以将本地项目回滚到之前的版本吗?
暂时不行。当前版本中,Manus 托管的本地项目不支持回滚。请在进行大规模修改之前提交到您自己的 Git 仓库,以便您自行恢复文件。
我可以在自己的电脑上测试 Stripe 支付吗?
我可以在自己的电脑上测试 Stripe 支付吗?
您可以在 Stripe 测试模式下测试结账流程。完整测试支付事件(webhooks)需要临时云端沙盒。请让 Manus 进行设置。Manus 会在迁移项目之前征求您的同意。
其他人可以打开我的本地预览吗?
其他人可以打开我的本地预览吗?
不可以。预览在您电脑上的本地地址运行。要分享网站,请发布网站,或在 Manus Cloud 中继续该任务。
我可以稍后将纯本地网站连接到 Manus 吗?
我可以稍后将纯本地网站连接到 Manus 吗?
可以。让 Manus 连接该网站即可。Manus 会将现有文件夹关联到一个 Manus 托管项目,并保留您的源文件。
Manus 请求在我的电脑上安装工具,这是为什么?
Manus 请求在我的电脑上安装工具,这是为什么?
您的项目需要的某个工具在您的电脑上缺失、版本过旧或无法正常工作。在为整台电脑安装或修复工具之前,Manus 会说明所做的更改并征求您的许可。
本地构建会消耗更多积分吗?
本地构建会消耗更多积分吗?
不会。在您电脑上执行的任务与云端同等任务的积分消耗速率相同。请参阅 套餐与定价。