Cách xuất bản trang web với Cursor: Tác nhân đám mây hoặc máy chủ của riêng bạn23 min read
Reading Time: 11 minutesĐể xuất bản một trang web với Cursor, trước tiên hãy chạy dự án, sau đó chọn đường dẫn triển khai. Tác nhân đám mây của Cursor có quy trình Xuất bản được ghi lại cho kho lưu trữ được kết nối với Vercel. Nếu bạn tích hợp sẵn trình chỉnh sửa trên máy tính để bàn hoặc sử dụng máy chủ khác, hãy triển khai kho lưu trữ đã được đánh giá bằng quy trình thông thường của máy chủ đó. Cổng chuyển tiếp và xem trước của Cursor cho phép bạn kiểm tra ứng dụng nhưng cũng không phải là địa chỉ công khai mà bạn cung cấp cho khách hàng.
Hướng dẫn này dành cho người xây dựng muốn khởi chạy thành công thay vì ảnh chụp màn hình trang đích được tạo. Nó bao gồm lựa chọn kho lưu trữ, lời nhắc, bản xem trước cục bộ và đám mây, kiểm tra bản dựng, xuất bản và đường dẫn tạo phẩm được chia sẻ tùy chọn cho các bên liên quan. Nếu nhiều người cần xem lại cùng một bản thảo trước khi ra mắt, hãy cân nhắc một không gian làm việc AgentGrid.io được chia sẻ thay vì trao đổi ảnh chụp màn hình.
Cách xây dựng một trang web trong Cursor và xuất bản nó với AgentGrid.io
Thiết lập AgentGrid.io trước khi viết mã trong Cursor để ứng dụng đến đúng không gian làm việc.
Bước 1: Tạo không gian làm việc của trang trong AgentGrid.io
Đăng nhập tại app.agentgrid.io, chọn đúng nhóm và chọn không gian làm việc cho trang web. Sử dụng một không gian làm việc riêng cho đối tượng hẹp hơn. Chọn một tạo phẩm ứng dụng cho trang web chứ không phải bản tóm tắt Markdown. Việc chia sẻ liên kết tạo phẩm riêng tư không biến nó thành một trang công cộng.

Bước 2: Kết nối Cursor Agent, không chỉ đơn thuần là trình soạn thảo
Mở dự án trang web trong Cursor và sử dụng chế độ Tác nhân, chế độ này có thể chỉnh sửa tệp và chạy các lệnh đầu cuối. Cung cấp cho nó hướng dẫn này: Connect this Cursor Agent to agentgrid.io. Run npx @animaapp/cli@latest login, show me the verification URL and code, and wait for my approval. Do not publish yet. Phê duyệt tên, không gian làm việc cũng như Đọc và Viết trong trình duyệt của bạn. Tắt Xuất bản trừ khi bạn muốn tác nhân triển khai. Sau đó yêu cầu Cursor chạy npx @animaapp/cli@latest workspaces và xác minh rằng nó có thể nhìn thấy không gian làm việc dự kiến. Nếu quyền truy cập thiết bị đầu cuối bị vô hiệu hóa, thay vào đó hãy sử dụng nhập thư mục thủ công.
Bước 3: Build, test và import dự án một lần
Nhắc Cursor: Xây dựng trang đích đặt chỗ đáp ứng cho xưởng xe đạp. Sử dụng kho lưu trữ này, thêm danh sách dịch vụ rõ ràng và gọi hành động đặt chỗ, chạy các bước kiểm tra có sẵn và cho tôi biết tệp nào là điểm vào trang web. Không thay đổi mã không liên quan. Xem lại sự khác biệt của nó và mở bản xem trước cục bộ. Cho tác nhân được kết nối chạy npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, thay thế thư mục thực tế và ID không gian làm việc mà nó liệt kê. Mở URL tạo tác được trả về. Đối với một trang web tĩnh, hãy đảm bảo index.html và tài sản tham chiếu của nó có mặt. Loại trừ node_modules, xây dựng đầu ra và thông tin xác thực. Nếu không thể kết nối, hãy chọn Mới → Thư mục tải lên hoặc Mới → Nhập từ ZIP trong AgentGrid.io. Nhập là ảnh chụp nhanh, không tự động đồng bộ hóa với kho lưu trữ. Xác minh các tập tin, bản xem trước và không gian làm việc của nó.

Bước 4: Cập nhật cùng một tạo phẩm, sau đó xuất bản có chủ ý
Dán URL cấu phần phần mềm vào Tác nhân Cursor và yêu cầu cải tiến chính xác, chẳng hạn như sửa menu di động trên cấu phần phần mềm đó. Xác nhận thay đổi trong Lịch sử. Khi trang web được phê duyệt, hãy sử dụng Xuất bản trong AgentGrid.io hoặc yêu cầu rõ ràng một tác nhân được kết nối có khả năng Xuất bản để triển khai nó. Mở URL công khai thu được rồi kiểm tra đường liên kết điều hướng và đặt chỗ. Việc xuất bản tách biệt với việc chia sẻ tạo phẩm riêng tư. Những thay đổi mã sau này không tự động thay thế việc triển khai công khai: xuất bản bản cập nhật khi bạn muốn chúng xuất hiện.

Những gì Cursor có thể xuất bản trực tiếp
Cursor của Tài liệu thiết lập môi trường đám mây mô tả một trình tự cụ thể: lưu công việc vào kho lưu trữ, kết nối tài khoản Vercel, chọn Xuất bản trong Cửa sổ đại lý và nhận URL triển khai. Cursor liên kết repo với dự án Vercel và triển khai nhánh mặc định của nó. Nhánh mặc định sau này sẽ tự động triển khai. Nhóm Cursor triển khai cho nhóm Vercel cần có kế hoạch trên Sở thích. Những yêu cầu này không phải là nút xuất bản chung cho mọi dự án biên tập cục bộ.
Bước 1: Bắt đầu ở kho lưu trữ phù hợp
Đối với trang web hiện có, hãy mở kho lưu trữ của nó trong Cursor và yêu cầu Đại lý tuân theo khung, thành phần, thử nghiệm và quy ước thiết kế hiện có. Yêu cầu nó xác định những gì đã được triển khai và chi nhánh nào đang sản xuất trước khi thay đổi mã. Đối với dự án Cloud Agent mới, Cursor ghi lại lộ trình bắt đầu từ đầu và bước tạo kho lưu trữ Origin; kiểm tra tính khả dụng trong tài khoản của bạn trước khi dựa vào nó. Môi trường dự thảo không có kho lưu trữ đã lưu chưa sẵn sàng cho đường dẫn Xuất bản Vercel được ghi lại.
Lời nhắc ví dụ: “Trong kho lưu trữ này, hãy xây dựng một trang web Trang chủ, Hội thảo và Ghé thăm đáp ứng cho cửa hàng thực vật của Cedar House. Sử dụng biểu tượng được cung cấp và lịch trình hội thảo, không phải tính khả dụng được phát minh. Giữ nguyên khuôn khổ và quy ước về kiểu dáng hiện có. Thêm tiêu đề và mô tả trang, liên kết đăng ký hoạt động từ project-notes.md và menu di động thân thiện với bàn phím. Hiển thị kế hoạch, triển khai kế hoạch, liệt kê các tệp và thử nghiệm đã thay đổi, đồng thời dừng lại trước khi triển khai.”
Nếu dự án có các tuyến API, xác thực hoặc các trang do máy chủ hiển thị, hãy xác định chúng ngay bây giờ. Máy chủ chỉ tĩnh có thể không hỗ trợ thời gian chạy. Hỏi những biến môi trường mà ứng dụng mong đợi và liệu có bất kỳ biến nào sẽ được hiển thị trên trình duyệt hay không. Không bao giờ dán bí mật sản xuất vào lời nhắc của nhân viên hoặc đưa chúng vào kiểm soát nguồn.
Bước 2: Xem trước ứng dụng đang chạy
Cài đặt các phần phụ thuộc và chạy lệnh phát triển do dự án xác định. Đối với phiên soạn thảo Cursor cục bộ, hãy mở URL phát triển cục bộ trong trình duyệt. Đối với Tác nhân đám mây, tài liệu Cursor đã phát hiện và định cấu hình thủ công các cổng chuyển tiếp trong Cửa sổ tác nhân. Mở ứng dụng được chuyển tiếp trong trình duyệt nội bộ và kiểm tra các trang thực. Nhật ký xây dựng có nội dung “hoàn thành” không thể xác thực điều hướng phản hồi hoặc lời kêu gọi hành động đang hoạt động.
Kiểm tra trang web ở chiều rộng hẹp và rộng. Theo các liên kết đến các điểm đến dự định và các hình thức kiểm tra. Hãy thử điều hướng bằng bàn phím và tiêu điểm hiển thị. Kiểm tra các lựa chọn thay thế hình ảnh, siêu dữ liệu, thứ tự tiêu đề, nội dung bị thiếu và trạng thái tải. Xác thực giờ cửa hàng, chi tiết liên hệ, bản sao hợp pháp và quyền hình ảnh đối với nguồn được phê duyệt. Nếu trang web phụ thuộc vào API, hãy kiểm tra yêu cầu không thành công và xác nhận rằng không có thông tin xác thực nào xuất hiện trong gói trình duyệt.
Lời nhắc kiểm tra: “Chạy các tập lệnh tìm lỗi mã nguồn, kiểm tra và xây dựng sản xuất của kho lưu trữ này. Mở ba trang trong trình duyệt ở độ rộng dành cho thiết bị di động và máy tính để bàn. Báo cáo nội dung bị hỏng, liên kết chết và các điều khiển không thể truy cập, sau đó sửa lỗi mã. Không thay đổi cấu hình triển khai hoặc xuất bản. Tóm tắt các lỗi cần có quyết định của con người.” Trên thực tế, hãy tự mở trình duyệt sau khi đại lý báo cáo thành công.
Bước 3: Chọn đường dẫn khởi chạy
| Đường dẫn | Tốt nhất khi | Những gì trở nên công khai |
|---|---|---|
| Đại lý đám mây xuất bản lên Vercel | Kho lưu trữ và kết nối Vercel đã sẵn sàng | URL triển khai Vercel và miền được định cấu hình |
| Quy trình triển khai của máy chủ của bạn | Bạn đã sử dụng quy trình CI/CD hoặc nền tảng khác | URL triển khai của máy chủ |
| Hiện vật AgentGrid.io | Trước tiên, một nhóm cần có một phiên bản làm việc có thể xem xét được | Không có gì cho đến khi hiện vật được xuất bản riêng |
Hai đường dẫn đầu tiên là các tuyến triển khai. Thứ ba là quy trình cộng tác và xuất bản với bản sao ứng dụng của riêng nó. Chọn một nguồn sự thật và ghi lại phiên bản mà người đánh giá đã thấy.
Bước 4: Xuất bản với Cursor Cloud Agent và Vercel
Khi tác phẩm đã được lưu vào kho lưu trữ, hãy kết nối tài khoản Vercel trong Cursor. Trong Cửa sổ tổng đài viên, chọn Xuất bản phía trên đầu vào của tổng đài viên. Nếu Cursor cung cấp Thêm Vercel, trước tiên hãy hoàn thành kết nối đó. Xem lại kho lưu trữ, nhóm Vercel đích, nhánh mặc định, biến môi trường và cài đặt bản dựng trước khi phê duyệt. Sau đó, luồng tài liệu của Cursor sẽ liên kết repo, triển khai nhánh mặc định và trả về URL.
Không sử dụng nhánh xem trước làm bằng chứng về những gì sẽ nằm trên nhánh mặc định. Kiểm tra sự khác biệt và mọi đánh giá cần thiết về mã con người trước khi hợp nhất. Cam kết sau này với nhánh đó có thể tự động triển khai lại trang web trực tiếp, vì vậy hãy xác định quy trình phê duyệt và khôi phục ngay bây giờ. Nếu trang web được tạo là tĩnh, hãy xác nhận thư mục đầu ra; nếu có liên quan đến các tuyến máy chủ, hãy xác nhận rằng máy chủ hỗ trợ thời gian chạy của ứng dụng. Coi miền DNS và thanh toán là các quyết định quyền sở hữu riêng biệt.
Bước 5: Triển khai qua máy chủ khác hoặc chia sẻ để xem xét
Với một máy chủ khác, hãy cam kết mã đã được đánh giá và tuân theo quy trình tải lên hoặc kho lưu trữ dành riêng cho khung của nhà cung cấp đó. Định cấu hình lệnh xây dựng, vị trí đầu ra, biến môi trường, chuyển hướng và miền tùy chỉnh trên máy chủ đó. Sử dụng triển khai bản xem trước để phê duyệt của các bên liên quan khi có sẵn. Cursor hỗ trợ mã và lệnh; máy chủ sở hữu URL công khai và cài đặt sản xuất.
Để đánh giá nhóm, AgentGrid.io ghi lại một Kết nối Cursor. Xác nhận môi trường tác nhân có thể chạy luồng kết nối, chỉ cấp quyền truy cập vào không gian làm việc dự định và yêu cầu môi trường đó trả về liên kết giả. Nếu kết nối không phù hợp, hãy tự nhập thư mục dự án đã xem xét hoặc ZIP. Kiểm tra bản xem trước và nguồn tạo tác sau khi chuyển; liên kết riêng không phải là trang web sản xuất và các chỉnh sửa trong kho lưu trữ gốc không tự động đồng bộ hóa với bản sao đã nhập.
Lời nhắc chuyển giao trong phạm vi: “Sau khi tôi cho phép kết nối, hãy đặt dự án Cedar House đã được đánh giá vào không gian làm việc được đặt tên dưới dạng một tạo phẩm ứng dụng chưa được xuất bản. Trả lại URL riêng tư của nó và liệt kê mọi phần phụ thuộc hoặc tính năng phụ trợ không chuyển được. Không xuất bản, chia sẻ ra bên ngoài hoặc chọn một không gian làm việc khác.” Khi nhóm đăng xuất, hãy sử dụng cổ vật luồng xuất bản riêng biệt nếu AgentGrid.io là máy chủ được chọn.
Bước 6: Xác minh việc triển khai thực tế
Mở URL công khai khi đăng xuất và từ điện thoại. So sánh các trang của nó với bản xem trước đã được phê duyệt. Kiểm tra điều hướng, biểu mẫu, đích đăng ký, HTTPS, siêu dữ liệu, tải hình ảnh và bất kỳ miền tùy chỉnh nào. Ghi lại bản sửa đổi cam kết hoặc tạo tác đã triển khai. Nếu trang công khai cũ hơn, hãy kiểm tra lựa chọn nhánh, đầu ra bản dựng, biến môi trường, nhật ký triển khai và bộ nhớ đệm trước khi thông báo. Chạy lại thử nghiệm sau mỗi lần cập nhật sản phẩm.
Thực hiện cập nhật tiếp theo có chủ ý
Ghi lại phiên bản đã được phê duyệt và URL công khai. Các chỉnh sửa mới là bản nháp cho đến khi được xem xét và xuất bản lại.
Câu hỏi thường gặp
Cursor có thể xuất bản một trang web mà không cần Vercel không?
Có, bằng cách tạo mã cho quy trình làm việc của nhà cung cấp dịch vụ lưu trữ khác. Tài liệu kiểm soát Xuất bản Tác nhân đám mây được thảo luận ở đây sử dụng Vercel. Xem trước trình soạn thảo trên máy tính để bàn và các cổng chuyển tiếp không phải là dịch vụ lưu trữ độc lập.
Tại sao Xuất bản không có sẵn trong phiên Cloud Agent của tôi?
Kiểm tra xem dự án đã được lưu vào kho lưu trữ chưa và Vercel đã được kết nối chưa. Tính đủ điều kiện, kế hoạch, cài đặt tổ chức và quyền lưu trữ cũng có thể quan trọng. Làm theo hướng dẫn thiết lập hiện tại của Cursor thay vì cho rằng các điều khiển giống nhau xuất hiện trong mọi tài khoản.
Bản xem trước Cursor có cập nhật trang web trực tiếp của tôi không?
Không. Bản xem trước cục bộ hoặc được chuyển tiếp sẽ hiển thị quy trình phát triển để kiểm tra. Triển khai là một sự kiện riêng biệt. Trong đường dẫn Vercel của Cursor, các cam kết trong tương lai với nhánh mặc định có thể cập nhật sản phẩm sau khi thiết lập tích hợp.
Tôi có thể chỉ sử dụng AgentGrid.io để phê duyệt không?
Vâng. Giữ lại một tạo phẩm chưa được xuất bản để chia sẻ đánh giá, sau đó xuất bản tạo phẩm đã được phê duyệt đó hoặc triển khai kho lưu trữ được đánh giá tương ứng thông qua máy chủ hiện có của bạn. Giữ cả hai bản sao được căn chỉnh nếu bạn sử dụng cả hai.
Để so sánh việc chuyển giao, hãy xem hướng dẫn của chúng tôi về chia sẻ đầu ra đại lý dưới dạng liên kết. các xuất bản trang web Claude Design bao gồm một điểm khởi đầu khác, trong khi Hướng dẫn xuất bản trang web Muse hiển thị một tạo phẩm đã được đánh giá đang chuyển sang xuất bản. Đây là những quy trình công việc khác nhau, không thể thay thế cho nhau các tính năng của sản phẩm.

Figma
Adobe XD
Blog


