跳轉到主要內容

這是什麼

於本機建置(Build locally) 可讓 Manus 在您自己電腦上的資料夾中建置網站、網頁應用程式、行動應用程式或遊戲。您會在 Manus Studio 中工作,這是適用於 macOS(Apple Silicon)和 Windows 的 Manus 桌面應用程式。Manus 會撰寫程式碼、執行專案,並顯示即時預覽。它會使用您電腦上既有的檔案、資料夾和工具。若要了解 Manus Studio 可以在您的電腦上做什麼,請參閱 Manus Studio。 在下列情況下使用此功能:
  • 您的專案已經存放在您的電腦上。
  • 您想保留自己的 Git 工作流程。
  • 您想在使用 Manus 的同時搭配自己的工具。
您也可以在 Cloud Computer 上使用相同的工作流程。在這種情況下,專案資料夾位於 Cloud Computer 上,而不是您自己的電腦上。 對於每個網站或行動應用程式,您可以從兩種專案類型中擇一: 下表列出各類專案適用的選項。

如何使用

設定 Manus Studio

1

下載 Manus Studio

開啟 manus.im/desktop。選擇 macOS (Apple Silicon) 或 Windows,然後執行安裝程式。
2

登入

開啟 Manus Studio,並使用您的 Manus 帳戶登入。如果 Manus 要求您在使用本機資料夾前先更新,請安裝最新版本。
3

開啟「在本機工作」並選擇資料夾

在聊天框中,開啟 在本機工作(Work locally)。點擊 選擇資料夾(Choose a folder),然後選擇您的專案所在的資料夾,或您希望 Manus 建立專案的資料夾。如需權限模式和資料夾存取的說明,請參閱 Manus Studio。

在您的電腦上建立新網站

1

描述網站及其位置

在 Manus Studio 中開始一個任務。描述網站,並告訴 Manus 要在您電腦上的哪個位置建置。
2

選擇專案類型

Manus 會詢問您想如何設定網站。選擇 由 Manus 管理(Manus-managed) 以使用 Manus 的代管、資料庫、登入、版本紀錄和發佈功能。選擇 純本機(plain local) 則只使用您自己的工具和服務。
3

如果資料夾不是空的,請允許程式碼儲存

對於由 Manus 管理的專案,Manus 會檢查資料夾。如果資料夾中已有檔案,Manus 會顯示一張 專案程式碼儲存(Project code storage) 卡片,詢問:「允許 Manus 同步您專案的程式碼嗎?」點擊 允許並初始化(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 會保留您既有的檔案,不會用入門範本覆蓋它們。

將網站加入較大的專案

您可以將網站加入非網站類型的專案,例如為遊戲建立官方網站。
  1. 告訴 Manus 您想在較大的專案中加入一個獨立的網站。例如:「為這款遊戲新增一個官方網站。」
  2. Manus 會在專屬的子資料夾中建立網站,例如 website/。
  3. 只有該子資料夾屬於網站。Manus 不會將專案的其他部分納入網站版本中。

建置行動應用程式

1

描述應用程式

在 Manus Studio 中,描述您想建置的行動應用程式。
2

選擇專案類型

Manus 會在開始之前請您做出選擇。由 Manus 管理(Manus-managed) 提供後端、資料庫、登入、AI 功能、版本紀錄和應用程式建置。純本機(Plain local) 則讓開發留在您的電腦上,並使用您自己的後端和服務。
3

確認移至 Manus Cloud

由 Manus 管理的行動應用程式目前在 Manus Cloud 中執行。如果您選擇此選項,Manus 會在開始開發之前,將任務從您的電腦移至 Manus Cloud。Manus 會在您做出選擇前告知您這項移動。
您本機資料夾中的檔案可能不會隨任務一起移至 Manus Cloud。如果您已有程式碼,請在做出選擇前告訴 Manus,讓它規劃如何將程式碼轉移過去。

建置遊戲

  1. 在 Manus Studio 中,描述遊戲,並告訴 Manus 要在您電腦上的哪個位置建置。
  2. Manus 會將遊戲設定為由 Manus 管理的專案,不會請您選擇專案類型。
  3. 接著依照一般的 Game Dev 工作流程進行。請參閱 Game Developer。

儲存版本並發佈由 Manus 管理的專案

1

請 Manus 儲存版本

當您對某項修改感到滿意時,請 Manus 儲存一個版本。Manus 會將網站資料夾中的程式碼副本上傳到一個由 Manus 管理的私人儲存庫。Manus 只會將此副本用於版本紀錄和發佈。
2

準備好後即可發佈

請 Manus 發佈,或依照發佈中的說明進行發佈。Manus 會詢問「允許 Manus 發佈嗎?」選擇 允許一次(Allow once),或選擇 一律允許此網站(Always allow for this website),下次就不會再詢問。只有專案擁有者可以發佈本機專案。除非您開啟了自動發佈,否則儲存版本本身不會發佈您的網站。
在您自己的 Git 儲存庫中進行的 commit 不會建立 Manus 版本,也不會發佈您的網站。

在本機專案中測試 Stripe 付款

  1. 請 Manus 新增付款功能。Manus 會以測試模式設定 Stripe。請參閱付款。
  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 管理的專案。它會保留您的原始檔案,不會重新建置網站。
這適用於網站和網頁應用程式。若要將純本機的行動應用程式改為由 Manus 管理,Manus 會將任務移至 Manus Cloud,並評估如何轉移您的程式碼。

您需要了解的內容

各項內容的執行位置

  • 預覽在您的電腦上執行。 Manus Studio 會從您電腦上的本機位址開啟預覽。其他裝置無法開啟此位址。
  • 透過發佈與他人分享。 若要讓其他人看到網站,請發佈網站,或在 Manus Cloud 中繼續任務。
  • 在雲端繼續之前請先同步。 新的雲端任務會從最新同步的版本開始。只存在於您電腦上的修改不會包含在內。請先請 Manus 同步,然後選擇 在新的雲端任務中繼續(Continue in a new cloud task)。
  • 只有擁有者可以使用本機檔案。 本機檔案、本機發佈和在新任務中繼續等功能,僅限專案擁有者使用。
  • 由 Manus 管理的行動應用程式在 Manus Cloud 中執行。 網站、網頁應用程式和遊戲會留在您的電腦上。由 Manus 管理的行動應用程式則會移至 Manus Cloud。

Manus 會上傳哪些內容

  • 由 Manus 管理的專案: 當您儲存或同步版本時,Manus 會上傳網站資料夾中的程式碼。它不會上傳較大專案的其他部分,例如搭配網站所屬的遊戲。
  • 僅進行設定不會上傳程式碼。 連接資料夾或設定由 Manus 管理的專案,本身並不會上傳您的程式碼。
  • 選擇由 Manus 管理不會發佈任何內容。 只有在您發佈網站時,網站才會公開。
  • 純本機專案: Manus 不會設定 Manus 服務,也不會將版本儲存到 Manus。您可以稍後再將專案連接到 Manus。

Manus 如何與您的 Git 儲存庫搭配運作

  • 兩份獨立的紀錄。 Manus 會為由 Manus 管理的專案保存自己的版本紀錄。您自己的 Git 儲存庫及其紀錄則保持獨立。
  • 您的 Git 設定保持不變。 Manus 不會變更您的 remotes、branches、hooks 或憑證,也不會匯入您的 Git 紀錄。
  • Commit 不會互相複製。 您的 commit 不會出現在 Manus 版本紀錄中,Manus 版本也不會以 commit 的形式出現在您的儲存庫中。
  • 共用的檔案。 兩份紀錄追蹤的是資料夾中相同的檔案。當 Manus 從自己的紀錄中帶入修改時,這些修改會以未 commit 的變更形式出現在您的 Git 儲存庫中。
  • 沒有獨立 Git 儲存庫的資料夾。 如果網站資料夾不在任何 Git 儲存庫中,您的 Git 工具會顯示該資料夾的 Manus 版本紀錄。若要在該處使用獨立的儲存庫,請 Manus 為您設定。請勿自行在該資料夾中執行 git init。
  • Manus 會在網站資料夾中新增兩個項目。 一個小型專案檔案會將資料夾連結到您的 Manus 專案;一個隱藏資料夾則儲存 Manus 版本紀錄。請勿刪除其中任何一個。請勿將隱藏資料夾 commit 到您自己的儲存庫。
  • Git worktrees 和 branches。 您可以將小型專案檔案 commit 到您的儲存庫。如此一來,新的 branch 或 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 管理。 您無需額外設定,即可獲得代管、版本紀錄和發佈功能。
  • 將搭配網站放在專屬的子資料夾中。 這樣版本紀錄和上傳內容只會包含網站,而不是整個專案。
  • 在進行大幅修改前,先將您的工作 commit 到 Git。 由 Manus 管理的本機專案尚無法回溯,因此您自己的 Git 紀錄就是您的安全保障。
  • Commit 小型專案檔案,而不是隱藏資料夾。 這樣您的 branches 和 worktrees 就會持續連結到同一個 Manus 專案。
  • 及早規劃付款測試。 當您準備好測試完整的付款流程時,請 Manus 設定臨時的雲端沙盒。
  • 透過發佈來分享。 本機預覽只能在您的電腦上使用。發佈網站後,即可將連結傳送給其他人。

常見問題

是的。在您自己的電腦上建置需要適用於 macOS(Apple Silicon)或 Windows 的 Manus Studio。請從 manus.im/desktop 下載。您也可以在 Cloud Computer 上使用相同的工作流程。
由 Manus 管理的專案會連接到 Manus 服務,例如代管、資料庫、登入、版本紀錄和發佈。純本機專案則是您電腦上的一般專案。您使用自己的工具和服務,Manus 不會設定代管或發佈。
對於由 Manus 管理的專案,當您儲存或同步版本時,Manus 會上傳網站資料夾中的程式碼。設定專案本身不會上傳程式碼。對於純本機專案,Manus 不會將版本儲存到 Manus。
不會。Manus 會保存自己的版本紀錄,與您的儲存庫分開。它不會變更您的 remotes、branches、hooks 或憑證。當 Manus 修改檔案時,這些修改會以未 commit 的變更形式出現在您的儲存庫中。
由 Manus 管理的行動應用程式目前在 Manus Cloud 中執行。Manus 會在您做出選擇前告知您這一點。若要讓應用程式留在您的電腦上,請改為選擇純本機開發。
於本機建置的遊戲一律由 Manus 管理。Manus 會使用 Manus 服務設定遊戲,並直接進入下一步。
目前還不行。此版本中,由 Manus 管理的本機專案尚無法回溯。請在進行大幅修改前 commit 到您自己的 Git 儲存庫,以便自行還原檔案。
您可以在 Stripe 測試模式下測試結帳流程。完整測試付款事件(webhooks)需要臨時的雲端沙盒。請 Manus 為您設定。Manus 會在移動專案前徵求您的同意。
不行。預覽是在您電腦上的本機位址執行。若要分享網站,請發佈網站或在 Manus Cloud 中繼續任務。
可以。請 Manus 連接網站。Manus 會將既有資料夾連結到由 Manus 管理的專案,並保留您的原始檔案。
您的專案需要一個在您電腦上缺少、版本過舊或無法正常運作的工具。在為整台電腦安裝或修復工具之前,Manus 會說明這項變更並徵求您的許可。
不會。使用您電腦進行的任務,其點數消耗率與雲端中同等的任務相同。請參閱方案與定價。