> ## 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，在您自己電腦上的資料夾中建置網站、網頁應用程式、行動應用程式和遊戲。您可以選擇由 Manus 管理的服務，或純本機專案。

## 這是什麼

**於本機建置（Build locally）** 可讓 Manus 在您自己電腦上的資料夾中建置網站、網頁應用程式、行動應用程式或遊戲。您會在 **Manus Studio** 中工作，這是適用於 macOS（Apple Silicon）和 Windows 的 Manus 桌面應用程式。Manus 會撰寫程式碼、執行專案，並顯示即時預覽。它會使用您電腦上既有的檔案、資料夾和工具。若要了解 Manus Studio 可以在您的電腦上做什麼，請參閱 [Manus Studio](https://manus.im/docs/zh-tw/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 儲存庫是分開的。 |

下表列出各類專案適用的選項。

| 專案類型 | 您的選項 | 開發執行位置 |
| :- | :- | :- |
| **網站或網頁應用程式** | 由 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）**。點擊 **選擇資料夾（Choose a folder）**，然後選擇您的專案所在的資料夾，或您希望 Manus 建立專案的資料夾。如需權限模式和資料夾存取的說明，請參閱 [Manus Studio](https://manus.im/docs/zh-tw/features/desktop.md)。

### 在您的電腦上建立新網站

**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 中開啟即時預覽。在同一個任務中描述您想要的修改。

提示詞範例：

```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 管理（Manus-managed）** 提供後端、資料庫、登入、AI 功能、版本紀錄和應用程式建置。**純本機（Plain local）** 則讓開發留在您的電腦上，並使用您自己的後端和服務。

**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-tw/features/game-developer.md)。

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

**1. 請 Manus 儲存版本**

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

**2. 準備好後即可發佈**

請 Manus 發佈，或依照[發佈](https://manus.im/docs/zh-tw/website-builder/publishing.md)中的說明進行發佈。Manus 會詢問「允許 Manus 發佈嗎？」選擇 **允許一次（Allow once）**，或選擇 **一律允許此網站（Always allow for this website）**，下次就不會再詢問。只有專案擁有者可以發佈本機專案。除非您開啟了自動發佈，否則儲存版本本身不會發佈您的網站。

> [!NOTE]
>
> 在您自己的 Git 儲存庫中進行的 commit 不會建立 Manus 版本，也不會發佈您的網站。

### 在本機專案中測試 Stripe 付款

1. 請 Manus 新增付款功能。Manus 會以測試模式設定 Stripe。請參閱[付款](https://manus.im/docs/zh-tw/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 管理的專案。它會保留您的原始檔案，不會重新建置網站。

這適用於網站和網頁應用程式。若要將純本機的行動應用程式改為由 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 整合](https://manus.im/docs/zh-tw/website-builder/github-integration.md)和[程式碼控制](https://manus.im/docs/zh-tw/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 管理。** 您無需額外設定，即可獲得代管、版本紀錄和發佈功能。
* **將搭配網站放在專屬的子資料夾中。** 這樣版本紀錄和上傳內容只會包含網站，而不是整個專案。
* **在進行大幅修改前，先將您的工作 commit 到 Git。** 由 Manus 管理的本機專案尚無法回溯，因此您自己的 Git 紀錄就是您的安全保障。
* **Commit 小型專案檔案，而不是隱藏資料夾。** 這樣您的 branches 和 worktrees 就會持續連結到同一個 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、branches、hooks 或憑證。當 Manus 修改檔案時，這些修改會以未 commit 的變更形式出現在您的儲存庫中。

> [accordion] 為什麼我的行動應用程式任務被移到雲端？
>
> 由 Manus 管理的行動應用程式目前在 Manus Cloud 中執行。Manus 會在您做出選擇前告知您這一點。若要讓應用程式留在您的電腦上，請改為選擇純本機開發。

> [accordion] 為什麼 Manus 沒有請我為遊戲選擇專案類型？
>
> 於本機建置的遊戲一律由 Manus 管理。Manus 會使用 Manus 服務設定遊戲，並直接進入下一步。

> [accordion] 我可以將本機專案回溯到較早的版本嗎？
>
> 目前還不行。此版本中，由 Manus 管理的本機專案尚無法回溯。請在進行大幅修改前 commit 到您自己的 Git 儲存庫，以便自行還原檔案。

> [accordion] 我可以在自己的電腦上測試 Stripe 付款嗎？
>
> 您可以在 Stripe 測試模式下測試結帳流程。完整測試付款事件（webhooks）需要臨時的雲端沙盒。請 Manus 為您設定。Manus 會在移動專案前徵求您的同意。

> [accordion] 其他人可以開啟我的本機預覽嗎？
>
> 不行。預覽是在您電腦上的本機位址執行。若要分享網站，請發佈網站或在 Manus Cloud 中繼續任務。

> [accordion] 我可以稍後將純本機網站連接到 Manus 嗎？
>
> 可以。請 Manus 連接網站。Manus 會將既有資料夾連結到由 Manus 管理的專案，並保留您的原始檔案。

> [accordion] Manus 要求在我的電腦上安裝工具，為什麼？
>
> 您的專案需要一個在您電腦上缺少、版本過舊或無法正常運作的工具。在為整台電腦安裝或修復工具之前，Manus 會說明這項變更並徵求您的許可。

> [accordion] 於本機建置會消耗更多點數嗎？
>
> 不會。使用您電腦進行的任務，其點數消耗率與雲端中同等的任務相同。請參閱[方案與定價](https://manus.im/docs/zh-tw/introduction/plans.md)。


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