> ## 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. # Xây dựng cục bộ trong Manus Studio > Xây dựng trang web, ứng dụng web, ứng dụng di động và trò chơi trong một thư mục trên máy tính của chính bạn bằng Manus Studio. Chọn dịch vụ do Manus quản lý hoặc một dự án cục bộ thuần túy. ## Đây là gì **Xây dựng cục bộ** (Build locally) cho phép Manus xây dựng trang web, ứng dụng web, ứng dụng di động hoặc trò chơi trong một thư mục trên máy tính của chính bạn. Bạn làm việc trong **Manus Studio**, ứng dụng máy tính của Manus dành cho macOS (Apple Silicon) và Windows. Manus viết mã, chạy dự án và hiển thị bản xem trước trực tiếp. Manus sử dụng các tệp, thư mục và công cụ đã có sẵn trên máy tính của bạn. Để tìm hiểu Manus Studio có thể làm gì trên máy tính của bạn, hãy đọc [Manus Studio](https://manus.im/docs/vi/features/desktop.md). Hãy dùng tính năng này trong các trường hợp sau: * Dự án của bạn đã nằm sẵn trên máy tính. * Bạn muốn giữ quy trình làm việc Git của riêng mình. * Bạn muốn dùng các công cụ của riêng mình song song với Manus. Bạn cũng có thể dùng cùng quy trình này trên [Cloud Computer](https://help.manus.im/en/articles/15392111-what-is-the-cloud-computer). Khi đó, thư mục dự án nằm trên Cloud Computer thay vì trên máy của bạn. Với mỗi trang web hoặc ứng dụng di động, bạn chọn một trong hai loại dự án: | Thuật ngữ | Ý nghĩa | | :- | :- | | **Dự án do Manus quản lý** | Dự án kết nối với các dịch vụ của Manus, chẳng hạn như lưu trữ (hosting), cơ sở dữ liệu, đăng nhập người dùng, tính năng AI, lịch sử phiên bản và xuất bản. Bạn cũng có thể tiếp tục dự án trong Manus trên web. | | **Dự án cục bộ thuần túy** | Một dự án thông thường trên máy tính của bạn. Bạn dùng công cụ và dịch vụ của riêng mình. Manus không thiết lập lưu trữ, xuất bản hay các dịch vụ Manus khác. | | **Lịch sử phiên bản Manus** | Danh sách các phiên bản đã lưu mà Manus giữ cho một dự án do Manus quản lý. Danh sách này tách biệt với kho Git của riêng bạn. | Bảng dưới đây cho biết những lựa chọn áp dụng cho từng loại dự án. | Loại dự án | Lựa chọn của bạn | Nơi diễn ra quá trình phát triển | | :- | :- | :- | | **Trang web hoặc ứng dụng web** | Do Manus quản lý hoặc cục bộ thuần túy | Máy tính của bạn | | **Ứng dụng di động** | Do Manus quản lý hoặc cục bộ thuần túy | Do Manus quản lý: Manus Cloud. Cục bộ thuần túy: máy tính của bạn. | | **Trò chơi** | Luôn do Manus quản lý | Máy tính của bạn | *** ## Cách sử dụng ### Thiết lập Manus Studio **1. Tải xuống Manus Studio** Mở [manus.im/desktop](https://manus.im/desktop). Chọn **macOS (Apple Silicon)** hoặc **Windows**, sau đó chạy trình cài đặt. **2. Đăng nhập** Mở Manus Studio và đăng nhập bằng tài khoản Manus của bạn. Nếu Manus yêu cầu cập nhật trước khi bạn dùng thư mục cục bộ, hãy cài đặt phiên bản mới nhất. **3. Bật Làm việc cục bộ và chọn thư mục** Trong khung trò chuyện, bật **Làm việc cục bộ** (Work locally). Nhấp vào **Chọn thư mục** (Choose a folder) và chọn thư mục chứa dự án của bạn, hoặc thư mục nơi Manus sẽ tạo dự án. Xem [Manus Studio](https://manus.im/docs/vi/features/desktop.md) để biết về các chế độ quyền và quyền truy cập thư mục. ### Bắt đầu một trang web mới trên máy tính của bạn **1. Mô tả trang web và vị trí của nó** Bắt đầu một tác vụ trong Manus Studio. Mô tả trang web và cho Manus biết nơi xây dựng trang web trên máy tính của bạn. **2. Chọn loại dự án** Manus hỏi bạn muốn thiết lập trang web như thế nào. Chọn **Do Manus quản lý** (Manus-managed) để dùng dịch vụ lưu trữ, cơ sở dữ liệu, đăng nhập, lịch sử phiên bản và xuất bản của Manus. Chọn **cục bộ thuần túy** (plain local) để chỉ dùng công cụ và dịch vụ của riêng bạn. **3. Cho phép lưu trữ mã nếu thư mục không trống** Với dự án do Manus quản lý, Manus kiểm tra thư mục. Nếu thư mục đã chứa tệp, Manus hiển thị thẻ **Lưu trữ mã dự án** (Project code storage). Thẻ hỏi: "Allow Manus to sync your project's code?" Nhấp vào **Cho phép và khởi tạo** (Allow and initialize) để tiếp tục. Nếu bạn hủy, Manus sẽ không thiết lập dự án. **4. Xem lại kế hoạch** Manus trình bày kế hoạch cho trang web. Hãy yêu cầu thay đổi trước khi Manus bắt đầu xây dựng. **5. Xem trước và tinh chỉnh** Manus chạy trang web trên máy tính của bạn và mở bản xem trước trực tiếp trong Manus Studio. Mô tả những thay đổi bạn muốn trong cùng tác vụ. Câu lệnh ví dụ: ```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] > > Nếu bạn đã chọn loại dự án ngay trong câu lệnh, ví dụ "giữ dự án này ở cục bộ, không dùng dịch vụ lưu trữ của Manus", Manus sẽ không hỏi lại. ### Tiếp tục một trang web đã có trên máy tính của bạn **1. Chỉ cho Manus thư mục** Trong Manus Studio, cho Manus biết cần tiếp tục dự án nào. Hãy cung cấp đường dẫn thư mục đầy đủ nếu có thể. **2. Xác nhận đúng bản sao** Manus tìm các trang web Manus trong thư mục đó và các thư mục lân cận. Nếu Manus tìm thấy nhiều kết quả phù hợp, hoặc kết quả không rõ ràng, Manus sẽ hỏi bạn muốn chọn cái nào. **3. Chọn cách kết nối mã hiện có** Thư mục có thể chứa mã chưa được liên kết với Manus. Trong trường hợp đó, Manus yêu cầu bạn chọn do Manus quản lý hoặc cục bộ thuần túy. Manus giữ nguyên các tệp hiện có của bạn và không áp dụng mẫu khởi đầu đè lên chúng. ### Thêm trang web vào một dự án lớn hơn Bạn có thể thêm trang web vào một dự án không phải là trang web, ví dụ trang web chính thức cho một trò chơi. 1. Cho Manus biết bạn muốn có một trang web riêng bên trong dự án lớn hơn. Ví dụ: "Thêm trang web chính thức cho trò chơi này." 2. Manus tạo trang web trong thư mục con riêng, ví dụ `website/`. 3. Chỉ thư mục con đó thuộc về trang web. Manus không đưa phần còn lại của dự án vào các phiên bản của trang web. ### Xây dựng ứng dụng di động **1. Mô tả ứng dụng** Trong Manus Studio, mô tả ứng dụng di động mà bạn muốn xây dựng. **2. Chọn loại dự án** Manus yêu cầu bạn chọn trước khi bắt đầu. **Do Manus quản lý** (Manus-managed) cung cấp cho bạn backend, cơ sở dữ liệu, đăng nhập, tính năng AI, lịch sử phiên bản và bản dựng ứng dụng. **Cục bộ thuần túy** (Plain local) giữ quá trình phát triển trên máy tính của bạn với backend và dịch vụ của riêng bạn. **3. Xác nhận việc chuyển sang Manus Cloud** Hiện tại, ứng dụng di động do Manus quản lý chạy trong Manus Cloud. Nếu bạn chọn loại này, Manus sẽ chuyển tác vụ từ máy tính của bạn sang Manus Cloud trước khi bắt đầu phát triển. Manus sẽ thông báo cho bạn về việc chuyển này trước khi bạn chọn. > [!WARNING] > > Các tệp trong thư mục cục bộ của bạn có thể không được chuyển cùng tác vụ sang Manus Cloud. Nếu bạn có mã sẵn, hãy cho Manus biết trước khi chọn để Manus có thể lên kế hoạch chuyển mã sang. ### Xây dựng trò chơi 1. Trong Manus Studio, mô tả trò chơi và cho Manus biết nơi xây dựng trò chơi trên máy tính của bạn. 2. Manus thiết lập trò chơi dưới dạng dự án do Manus quản lý. Manus không yêu cầu bạn chọn loại dự án. 3. Tiếp tục với quy trình Game Dev thông thường. Xem [Game Developer](https://manus.im/docs/vi/features/game-developer.md). ### Lưu phiên bản và xuất bản dự án do Manus quản lý **1. Yêu cầu Manus lưu phiên bản** Khi bạn hài lòng với một thay đổi, hãy yêu cầu Manus lưu phiên bản. Manus tải một bản sao mã trong thư mục trang web lên một kho riêng tư do Manus quản lý. Manus chỉ dùng bản sao này cho lịch sử phiên bản và xuất bản. **2. Xuất bản khi bạn sẵn sàng** Yêu cầu Manus xuất bản, hoặc xuất bản theo hướng dẫn trong [Xuất bản](https://manus.im/docs/vi/website-builder/publishing.md). Manus hỏi "Allow Manus to publish?" Chọn **Cho phép một lần** (Allow once), hoặc **Luôn cho phép với trang web này** (Always allow for this website) để bỏ qua câu hỏi này vào lần sau. Chỉ chủ sở hữu dự án mới có thể xuất bản dự án cục bộ. Việc lưu phiên bản tự nó không xuất bản trang web của bạn, trừ khi bạn đã bật xuất bản tự động. > [!NOTE] > > Một commit trong kho Git của riêng bạn không tạo phiên bản Manus và không xuất bản trang web của bạn. ### Kiểm thử thanh toán Stripe trong dự án cục bộ 1. Yêu cầu Manus thêm tính năng thanh toán. Manus thiết lập Stripe ở chế độ thử nghiệm. Xem [Thanh toán](https://manus.im/docs/vi/website-builder/payments.md). 2. Kiểm thử quy trình thanh toán đơn hàng (checkout) bằng thẻ thử nghiệm Stripe `4242 4242 4242 4242`. 3. Để kiểm thử thanh toán đầy đủ, Stripe phải gửi các sự kiện thanh toán (webhook) đến ứng dụng của bạn. Bản xem trước trên máy tính của bạn không thể nhận các sự kiện này. Hãy yêu cầu Manus chuyển dự án sang một sandbox đám mây tạm thời để kiểm thử. Manus sẽ xin sự chấp thuận của bạn trước. 4. Trước khi xuất bản lần đầu, hãy yêu cầu Manus kết nối webhook Stripe từ một bản xem trước trên đám mây. ### Kết nối dự án cục bộ thuần túy với Manus sau này 1. Mở thư mục dự án trong Manus Studio. 2. Yêu cầu Manus kết nối trang web với Manus. 3. Manus liên kết thư mục hiện có với một dự án mới do Manus quản lý. Manus giữ nguyên các tệp mã nguồn của bạn và không xây dựng lại trang web. Điều này áp dụng cho trang web và ứng dụng web. Để chuyển một ứng dụng di động cục bộ thuần túy sang do Manus quản lý, Manus sẽ chuyển tác vụ sang Manus Cloud và xem xét cách chuyển mã của bạn sang. *** ## Những điều bạn cần biết ### Thành phần nào chạy ở đâu * **Bản xem trước chạy trên máy tính của bạn.** Manus Studio mở bản xem trước từ một địa chỉ cục bộ trên máy của bạn. Các thiết bị khác không thể mở địa chỉ này. * **Chia sẻ với người khác bằng cách xuất bản.** Để người khác xem được trang web, hãy xuất bản trang web, hoặc tiếp tục tác vụ trong Manus Cloud. * **Đồng bộ trước khi tiếp tục trên đám mây.** Một tác vụ đám mây mới bắt đầu từ phiên bản được đồng bộ gần nhất. Các thay đổi chỉ tồn tại trên máy tính của bạn sẽ không được đưa vào. Hãy yêu cầu Manus đồng bộ trước, sau đó chọn **Tiếp tục trong tác vụ đám mây mới** (Continue in a new cloud task). * **Chỉ chủ sở hữu mới có thể dùng tệp cục bộ.** Tệp cục bộ, xuất bản cục bộ và tiếp tục trong tác vụ mới chỉ khả dụng cho chủ sở hữu dự án. * **Ứng dụng di động được quản lý chạy trong Manus Cloud.** Trang web, ứng dụng web và trò chơi vẫn nằm trên máy tính của bạn. Ứng dụng di động do Manus quản lý được chuyển sang Manus Cloud. ### Những gì Manus tải lên * **Dự án do Manus quản lý:** Khi bạn lưu hoặc đồng bộ một phiên bản, Manus tải lên mã trong thư mục trang web. Manus không tải lên phần còn lại của một dự án lớn hơn, chẳng hạn như trò chơi đi kèm một trang web phụ trợ. * **Chỉ thiết lập thì không tải mã lên.** Việc kết nối thư mục hoặc thiết lập dự án do Manus quản lý tự nó không tải mã của bạn lên. * **Chọn do Manus quản lý không xuất bản bất cứ thứ gì.** Trang web của bạn chỉ trở nên công khai khi bạn xuất bản. * **Dự án cục bộ thuần túy:** Manus không thiết lập dịch vụ Manus và không lưu phiên bản lên Manus. Bạn có thể kết nối dự án với Manus sau này. ### Cách Manus làm việc với kho Git của bạn * **Hai lịch sử riêng biệt.** Manus giữ lịch sử phiên bản riêng cho dự án do Manus quản lý. Kho Git của bạn và lịch sử của nó vẫn tách biệt. * **Thiết lập Git của bạn được giữ nguyên.** Manus không thay đổi remote, nhánh, hook hay thông tin xác thực của bạn. Manus không nhập lịch sử Git của bạn. * **Commit không được sao chép qua lại.** Commit của bạn không xuất hiện trong lịch sử phiên bản Manus, và phiên bản Manus không xuất hiện dưới dạng commit trong kho của bạn. * **Tệp dùng chung.** Cả hai lịch sử đều theo dõi cùng các tệp trong thư mục. Khi Manus đưa thay đổi từ lịch sử riêng của mình vào, những thay đổi đó xuất hiện trong kho Git của bạn dưới dạng thay đổi chưa commit. * **Thư mục không có kho Git riêng.** Nếu thư mục trang web không nằm trong một kho Git, công cụ Git của bạn sẽ hiển thị lịch sử phiên bản Manus cho thư mục đó. Để dùng một kho riêng ở đó, hãy yêu cầu Manus thiết lập. Đừng tự chạy `git init` trong thư mục đó. * **Manus thêm hai mục vào thư mục trang web.** Một tệp dự án nhỏ liên kết thư mục với dự án Manus của bạn. Một thư mục ẩn lưu trữ lịch sử phiên bản Manus. Đừng xóa mục nào. Đừng commit thư mục ẩn vào kho của riêng bạn. * **Git worktree và nhánh.** Bạn có thể commit tệp dự án nhỏ vào kho của mình. Khi đó, nhánh hoặc worktree mới vẫn được liên kết với cùng dự án Manus. * **Dự án đám mây và GitHub.** Với các dự án bạn xây dựng trong Manus Cloud, hãy đọc [Tích hợp GitHub](https://manus.im/docs/vi/website-builder/github-integration.md) và [Kiểm soát mã](https://manus.im/docs/vi/website-builder/code-control.md). ### Giới hạn hiện tại * **Chưa thể khôi phục phiên bản (rollback) cho dự án cục bộ.** Bạn không thể khôi phục một dự án cục bộ do Manus quản lý về phiên bản đã lưu trước đó. Để hoàn tác thay đổi, hãy dùng lịch sử Git của riêng bạn. * **Kiểm thử webhook Stripe đầy đủ cần sandbox đám mây.** Thanh toán đơn hàng ở chế độ thử nghiệm hoạt động được ở cục bộ. Các sự kiện thanh toán cần một sandbox đám mây tạm thời. * **Trò chơi luôn do Manus quản lý.** Tùy chọn cục bộ thuần túy không khả dụng cho trò chơi. * **Ứng dụng di động được quản lý cần Manus Cloud.** Bạn không thể phát triển ứng dụng di động do Manus quản lý trên máy tính của chính mình. ### Công cụ trên máy tính của bạn * **Manus dùng các công cụ bạn đang có.** Manus dùng các ngôn ngữ lập trình, trình quản lý gói và các công cụ khác đã được cài đặt trên máy tính của bạn. * **Các gói của dự án được cài đặt như một phần của tác vụ.** Manus cài đặt các gói mà dự án của bạn cần, theo thiết lập riêng của dự án. * **Thay đổi hệ thống cần sự cho phép của bạn.** Trước khi Manus cài đặt hoặc sửa chữa một công cụ cho toàn bộ máy tính của bạn, Manus sẽ giải thích thay đổi và xin phép bạn. Manus không dùng quyền quản trị viên khi chưa có sự chấp thuận của bạn. ### Di chuyển hoặc sao chép thư mục dự án * **Di chuyển toàn bộ thư mục.** Nếu bạn di chuyển hoặc đổi tên toàn bộ thư mục trang web, liên kết tới dự án Manus và lịch sử phiên bản của nó vẫn được giữ nguyên. * **Chỉ sao chép tệp dự án không tạo ra trang web mới.** Bản sao trỏ đến cùng một dự án Manus. Thay vào đó, hãy yêu cầu Manus thiết lập một dự án mới. ### Credit Các tác vụ làm việc với máy tính của bạn sử dụng credit theo cùng mức như các tác vụ tương đương trên đám mây. Độ phức tạp của tác vụ quyết định chi phí, không phải vị trí của tệp. Xem [Understanding Credit Consumption in the Manus Desktop App](https://help.manus.im/en/articles/14134826-understanding-credit-consumption-in-the-manus-desktop-app). *** ## Mẹo * **Cung cấp cho Manus đường dẫn thư mục đầy đủ.** Một đường dẫn đầy đủ, chẳng hạn như `~/Documents/yoga-site`, giúp Manus tìm đúng dự án ngay lần đầu. * **Dùng thư mục mới, trống cho trang web mới.** Khi đó, Manus thiết lập dự án mà không yêu cầu bạn xác nhận việc lưu trữ mã. * **Nêu loại dự án trong câu lệnh đầu tiên.** Hãy nói "do Manus quản lý" hoặc "giữ dự án này ở cục bộ" để bỏ qua câu hỏi thiết lập. * **Chọn do Manus quản lý nếu bạn định xuất bản bằng Manus.** Bạn có ngay lưu trữ, lịch sử phiên bản và xuất bản mà không cần thiết lập thêm. * **Đặt trang web phụ trợ trong thư mục con riêng.** Khi đó, lịch sử phiên bản và nội dung tải lên chỉ bao gồm trang web, không phải toàn bộ dự án. * **Commit công việc vào Git trước các thay đổi lớn.** Tính năng khôi phục phiên bản chưa khả dụng cho dự án cục bộ do Manus quản lý, vì vậy lịch sử Git của riêng bạn là lưới an toàn. * **Commit tệp dự án nhỏ, không commit thư mục ẩn.** Khi đó, các nhánh và worktree của bạn vẫn liên kết với cùng dự án Manus. * **Lên kế hoạch kiểm thử thanh toán sớm.** Hãy yêu cầu Manus thiết lập một sandbox đám mây tạm thời khi bạn sẵn sàng kiểm thử toàn bộ quy trình thanh toán. * **Xuất bản để chia sẻ.** Bản xem trước cục bộ chỉ hoạt động trên máy tính của bạn. Hãy xuất bản trang web để gửi liên kết cho người khác. *** ## Câu hỏi thường gặp > [accordion] Tôi có cần Manus Studio để xây dựng cục bộ không? > > Có. Việc xây dựng trên máy tính của chính bạn cần Manus Studio cho macOS (Apple Silicon) hoặc Windows. Tải xuống tại [manus.im/desktop](https://manus.im/desktop). Bạn cũng có thể dùng cùng quy trình này trên Cloud Computer. > [accordion] Dự án do Manus quản lý và dự án cục bộ thuần túy khác nhau thế nào? > > Dự án do Manus quản lý kết nối với các dịch vụ của Manus như lưu trữ, cơ sở dữ liệu, đăng nhập, lịch sử phiên bản và xuất bản. Dự án cục bộ thuần túy là một dự án thông thường trên máy tính của bạn. Bạn dùng công cụ và dịch vụ của riêng mình, và Manus không thiết lập lưu trữ hay xuất bản. > [accordion] Manus có tải mã của tôi lên không? > > Với dự án do Manus quản lý, Manus tải lên mã trong thư mục trang web khi bạn lưu hoặc đồng bộ một phiên bản. Việc thiết lập dự án tự nó không tải mã lên. Với dự án cục bộ thuần túy, Manus không lưu phiên bản lên Manus. > [accordion] Manus có thay đổi kho Git của tôi không? > > Không. Manus giữ lịch sử phiên bản riêng, tách biệt với kho của bạn. Manus không thay đổi remote, nhánh, hook hay thông tin xác thực của bạn. Khi Manus thay đổi tệp, những thay đổi đó xuất hiện trong kho của bạn dưới dạng thay đổi chưa commit. > [accordion] Tại sao tác vụ ứng dụng di động của tôi bị chuyển lên đám mây? > > Hiện tại, ứng dụng di động do Manus quản lý chạy trong Manus Cloud. Manus sẽ thông báo cho bạn điều này trước khi bạn chọn. Để giữ ứng dụng trên máy tính của bạn, hãy chọn phát triển cục bộ thuần túy. > [accordion] Tại sao Manus không yêu cầu tôi chọn loại dự án cho trò chơi? > > Trò chơi được xây dựng cục bộ luôn do Manus quản lý. Manus thiết lập trò chơi với các dịch vụ của Manus và tiếp tục sang bước tiếp theo. > [accordion] Tôi có thể khôi phục dự án cục bộ về phiên bản trước không? > > Chưa. Tính năng khôi phục phiên bản chưa khả dụng cho dự án cục bộ do Manus quản lý trong bản phát hành này. Hãy commit vào kho Git của riêng bạn trước các thay đổi lớn để bạn có thể tự khôi phục tệp. > [accordion] Tôi có thể kiểm thử thanh toán Stripe trên máy tính của mình không? > > Bạn có thể kiểm thử quy trình thanh toán đơn hàng ở chế độ thử nghiệm của Stripe. Kiểm thử đầy đủ các sự kiện thanh toán (webhook) cần một sandbox đám mây tạm thời. Hãy yêu cầu Manus thiết lập. Manus sẽ xin sự chấp thuận của bạn trước khi chuyển dự án. > [accordion] Người khác có thể mở bản xem trước cục bộ của tôi không? > > Không. Bản xem trước chạy tại một địa chỉ cục bộ trên máy tính của bạn. Để chia sẻ trang web, hãy xuất bản trang web hoặc tiếp tục tác vụ trong Manus Cloud. > [accordion] Tôi có thể kết nối trang web cục bộ thuần túy với Manus sau này không? > > Có. Hãy yêu cầu Manus kết nối trang web. Manus liên kết thư mục hiện có với một dự án do Manus quản lý và giữ nguyên các tệp mã nguồn của bạn. > [accordion] Manus yêu cầu cài đặt một công cụ trên máy tính của tôi. Tại sao? > > Dự án của bạn cần một công cụ bị thiếu, đã lỗi thời hoặc không hoạt động trên máy tính của bạn. Manus sẽ giải thích thay đổi và xin phép bạn trước khi cài đặt hoặc sửa chữa một công cụ cho toàn bộ máy tính của bạn. > [accordion] Xây dựng cục bộ có tốn nhiều credit hơn không? > > Không. Các tác vụ làm việc với máy tính của bạn sử dụng credit theo cùng mức như các tác vụ tương đương trên đám mây. Xem [Gói và giá cả](https://manus.im/docs/vi/introduction/plans.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.