Pascal Editor

1. Pascal Editor là gì?

Pascal Editor là công cụ dựng mô hình nhà 3D chạy ngay trong trình duyệt. Bạn vẽ tường, thêm cửa, đặt nội thất, sơn vật liệu, rồi đi dạo bên trong ngôi nhà ở góc nhìn người thật. Dự án mô tả nó là phần mềm dựng nhà 3D miễn phí, mã nguồn mở (giấy phép MIT), không cần công cụ nặng và không khó học.

Có hai cách dùng:

• Bản web tại https://editor.pascal.app : không cài gì, đăng nhập là dùng, dự án lưu trên đám mây.
• Bản chạy trên máy qua dòng lệnh: dự án lưu ngay trên máy bạn, và có thể nối với AI agent (chương trình AI tự làm việc như Claude Code, Codex) để AI vẽ giúp.

Mọi thứ bạn tự dựng, tự sửa, tự chia sẻ đều miễn phí. Chỉ các tính năng AI của bản web (trợ lý chat, tạo ảnh và video render, tạo vật liệu, tạo đồ vật) mới tiêu "credit", và credit thì phải mua hoặc có trong gói trả phí.

Hợp với bạn nếu:

• Bạn muốn phác thảo căn nhà, căn phòng, thử cách bày nội thất mà không học phần mềm CAD.
• Bạn cần mô hình 3D để xuất sang Blender, game, hoặc in bản vẽ mặt bằng PDF.
• Bạn là lập trình viên muốn cho AI agent dựng và chỉnh mô hình nhà.

Chưa hợp nếu:

• Bạn cần bản vẽ kỹ thuật để xin phép xây dựng hay thi công. Trang chính thức không nói công cụ này thay được phần mềm chuyên ngành.
• Bạn chỉ có điện thoại: các thao tác trong tài liệu đều dùng chuột và bàn phím.
• Bạn muốn bản chạy trên máy cho Windows: lúc viết bài, dòng lệnh của Pascal mới hỗ trợ chính thức macOS.

2. Cần chuẩn bị gì?

Cho bản web (cách dễ nhất):

• Máy tính có chuột và một trình duyệt bản mới.
• Tài khoản Google hoặc một địa chỉ email để đăng nhập. Pascal không dùng mật khẩu.
• Mạng internet.

Cho bản chạy trên máy:

• Hệ điều hành: tài liệu ghi bản dòng lệnh đầu tiên hỗ trợ macOS; Linux và Windows chưa được kiểm chứng.
• Node.js 22.13 trở lên: nền tảng chạy công cụ dòng lệnh của Pascal. Tải tại https://nodejs.org
• npm: trình cài gói đi kèm sẵn trong Node.js, bạn không phải cài riêng.
• Trình duyệt để mở trình biên tập.
• Không cần tài khoản Pascal hay khóa API cho phần chạy trên máy.

	Bản web	Bản chạy trên máy
Cài đặt	Không	Cần Node.js và một lệnh
Tài khoản	Cần để tạo và lưu dự án	Không cần
Nơi lưu dự án	Đám mây, trong tài khoản của bạn	File ~/.pascal/data/pascal.db trên máy
Hệ điều hành	Bất kỳ, qua trình duyệt	macOS (Linux, Windows chưa kiểm chứng)

3. Cài đặt từng bước

Cách A: Dùng bản web, không cài gì

Bước 1: Mở trang và đăng nhập

Mở https://editor.pascal.app rồi đăng nhập. Có hai lựa chọn:

• Google: bấm "Continue with Google" và chọn tài khoản.
• Email: gõ địa chỉ rồi bấm "Email me". Pascal gửi cho bạn một thư chứa đường dẫn đăng nhập và mã 6 số; bấm đường dẫn hoặc gõ mã vào. Đường dẫn và mã hết hạn sau 5 phút.

Đúng là khi bạn vào được trang danh sách dự án của mình.

Bước 2: Tạo dự án

Bấm Create a new project, đặt tên. Ở mục Starting point, giữ Blank project (dự án trống) hoặc chọn một mẫu có sẵn. Chọn Public (công khai) hoặc Private (riêng tư), rồi bấm Create project.

Đúng là khi trình biên tập mở ra với một mặt lưới trống. Từ đây bạn sang thẳng mục 4.

Cách B: Chạy trên máy bằng dòng lệnh

Bước 1: Kiểm tra Node.js

node --version

Đúng là khi bạn thấy số phiên bản từ v22.13 trở lên.

Bước 2: Khởi động Pascal

npx @pascal-app/cli editor

Lần đầu, công cụ chuẩn bị thư mục dữ liệu, tải phần trình biên tập, tìm một cổng mạng còn trống, khởi động trình biên tập cùng dịch vụ MCP (cầu nối cho AI agent) ở chế độ chạy nền, rồi mở trình duyệt. Bạn thấy từng giai đoạn hiện ra trên màn hình.

Đúng là khi trình duyệt mở một địa chỉ dạng http://pascal.localhost: kèm số cổng, và màn hình dòng lệnh in ra các lệnh pascal status, pascal logs --follow, pascal stop.

Sau lần chạy đầu thành công, Pascal tự cài luôn lệnh ngắn pascal để bạn dùng về sau.

Bước 3: Kiểm tra

pascal status

Lệnh này tóm tắt tình trạng của trình biên tập và dịch vụ MCP.

Cách khác: cài lệnh pascal trước

npm install --global @pascal-app/cli
pascal editor

Lưu ý: Pascal chạy nền, nên đóng cửa sổ dòng lệnh không làm nó tắt. Nhưng khi khởi động lại máy, nó không tự bật lên; bạn chạy lại pascal editor. Dự án và phần đã cài vẫn còn nguyên.

4. Dùng lần đầu

Các bước dưới đây theo bài hướng dẫn "Your first scene" của dự án: từ mặt lưới trống đến một căn phòng có nội thất trong khoảng năm phút.

Bước 1: Vẽ một căn phòng

Mở thẻ Build ở thanh bên trái, trong nhóm Rooms chọn Rectangle (hình chữ nhật). Bấm một lần trên mặt lưới để đặt góc đầu, bấm lần nữa để đặt góc đối diện. Khi tường khép kín, Pascal tự thêm sàn và trần.

Muốn vẽ phòng nhiều góc, chọn Polygon, bấm từng góc rồi bấm lại vào góc đầu để khép. Nhấn Esc để dừng vẽ, Ctrl + Z (hoặc Cmd + Z trên Mac) nếu vẽ sai.

Bước 2: Thêm cửa đi và cửa sổ

Trong thẻ Build, bấm Door. Một cánh cửa bám theo con trỏ và tự hít vào tường; bấm lên tường để đặt. Làm tương tự với Window ở bức tường khác. Nhấn R để đổi hướng cửa.

Bước 3: Đặt nội thất

Mở thẻ Items (hoặc nhấn F), chọn một nhóm đồ rồi bấm vào món bạn muốn. Món đồ bám theo con trỏ; bấm vào trong phòng để đặt. Nhấn R và T để xoay theo từng nấc 45 độ, Esc khi xong.

Bước 4: Xoay và đi quanh mô hình

• Xoay góc nhìn: giữ chuột phải và kéo.
• Dịch khung nhìn: giữ chuột giữa và kéo, hoặc giữ phím Space rồi kéo.
• Phóng to, thu nhỏ: lăn chuột.

Thanh công cụ ở góc trên bên trái mặt lưới cho đổi giữa 3D, 2D (mặt bằng) và Split (cả hai). Nút Walkthrough ở thanh trên cùng cho bạn đi bộ trong nhà ở góc nhìn thứ nhất.

Bước 5: Lưu và xuất kết quả

Ở bản web, Pascal tự lưu vào tài khoản sau mỗi thay đổi, không có nút lưu phải nhớ. Để lấy file mang đi nơi khác, mở Settings ở cuối thanh bên trái, tìm mục Export: có Export GLB, Export STL, Export OBJ cho mô hình 3D, và nhóm Floorplan để xuất mặt bằng dạng PDF khổ A4.

Nối với AI agent (tùy chọn, cho người dùng Claude Code hoặc Codex)

Với bản chạy trên máy, thêm cầu nối cho Codex bằng:

pascal mcp setup codex

Với Claude Code, cài gói kỹ năng của dự án ngay trong Claude Code:

/plugin marketplace add pascalorg/editor
/plugin install pascal-agent-skills@pascal

Chỉ dùng một ứng dụng AI cho mỗi bản Pascal đang chạy trên máy. Chi tiết xem tại https://editor.pascal.app/docs/developers/mcp

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
npx: command not found hoặc báo Node.js quá cũ	Chưa cài Node.js, hoặc bản thấp hơn 22.13.	Cài Node.js bản mới từ https://nodejs.org rồi mở cửa sổ dòng lệnh mới.
Lần chạy đầu báo npm không cài được lệnh pascal	npm thiếu quyền ghi vào thư mục cài đặt chung. Trình biên tập vẫn chạy bình thường.	Tiếp tục dùng dạng dài, ví dụ npx @pascal-app/cli status, hoặc sửa quyền của npm rồi chạy npm install --global @pascal-app/cli.
Khởi động lại máy xong không mở được trình biên tập	Pascal không tự cài dịch vụ khởi động cùng máy.	Chạy lại npx @pascal-app/cli editor.
Bạn yêu cầu một cổng bằng --port nhưng Pascal mở ở cổng khác	Cổng đó đang bị ứng dụng khác dùng; Pascal báo xung đột và tự chọn cổng trống.	Dùng địa chỉ mà dòng lệnh in ra. Không cần sửa gì.
pascal stop không dừng được	Tiến trình còn sống nhưng không phản hồi kiểm tra sức khỏe.	Xem pascal status --json, rồi dùng pascal stop --force.
Trình biên tập không lên mà không rõ lý do	Cần xem chẩn đoán và nhật ký.	Chạy npx @pascal-app/cli doctor, sau đó npx @pascal-app/cli logs --lines 200.
Bản web: thư đăng nhập có mã không dùng được	Mã và đường dẫn hết hạn sau 5 phút.	Bấm "Resend code" để nhận mã mới.
Khung 3D trống hoặc không hiện mô hình	Trình biên tập dựng hình bằng WebGPU, một công nghệ đồ họa của trình duyệt đời mới.	Cập nhật trình duyệt lên bản mới nhất hoặc thử trình duyệt khác. Tài liệu chính thức không liệt kê danh sách trình duyệt được hỗ trợ.
Claude Code báo có hai kết nối Pascal	Bạn vừa cài gói kỹ năng vừa từng thêm kết nối bằng tay.	Chạy claude mcp remove --scope user pascal rồi khởi động lại Claude Code.

6. Gỡ cài đặt / cập nhật

Cập nhật trình biên tập chạy trên máy:

npx @pascal-app/cli update

Bản mới được cài song song và chỉ được kích hoạt khi vượt qua bước kiểm tra; nếu lỗi, Pascal tự quay về bản cũ. File dự án không bị thay. Bản mới nhất lúc viết bài là v1.0.3, phát hành ngày 24/9/2026.

Lệnh pascal cài chung trên máy được cập nhật riêng:

npm install --global @pascal-app/cli@latest

Gỡ bản chạy trên máy: dừng Pascal rồi gỡ lệnh.

pascal stop
npm uninstall --global @pascal-app/cli

Dữ liệu còn lại nằm trong thư mục .pascal ở thư mục người dùng của bạn. Công cụ không có lệnh nào tự xóa dự án. Muốn gỡ sạch, tự tay xóa thư mục .pascal.

Lưu ý: File ~/.pascal/data/pascal.db chứa toàn bộ dự án trên máy của bạn. Hãy sao chép nó ra nơi khác trước khi xóa.

Bản web không có gì để gỡ. Muốn xóa tài khoản, vào Settings, kéo xuống Danger zone, bấm "Delete account" và gõ DELETE để xác nhận. Việc xóa không hoàn tác được.

7. Câu hỏi hay gặp

Pascal có mất tiền không? Dùng miễn phí. Việc dựng, sửa và chia sẻ không tốn gì. Các tính năng AI trên bản web tiêu credit; ở gói Free bạn mua credit khi cần, còn các gói Pascal Pro và Pascal Max có sẵn credit hằng tháng. Giá hiện hành hiển thị trong phần cài đặt của tài khoản.

Không đăng nhập thì làm được gì? Bạn xem được các dự án công khai trên trang cộng đồng và mở được đường dẫn chia sẻ để đi dạo trong mô hình. Muốn tạo và lưu dự án của riêng mình trên bản web thì phải đăng nhập.

Dữ liệu của tôi nằm ở đâu? Bản web lưu dự án trong tài khoản của bạn trên đám mây. Bản chạy trên máy lưu trong ~/.pascal/data/pascal.db, chỉ mở cổng nội bộ trên máy bạn và không mở ra mạng ngoài. Dự án cũng ghi rõ cầu nối cho AI agent trên máy không tự tải dự án lên đâu cả.

Bản chạy trên máy có dùng được trên Windows không? Tài liệu ghi bản dòng lệnh đầu tiên hỗ trợ macOS, còn Linux và Windows chưa được kiểm chứng. Nếu bạn dùng Windows, bản web là lựa chọn chắc chắn hơn.

Bản mẫu "Pascal Next" trong video có nằm trong bản mã nguồn mở không? Chưa. Dự án ghi rõ bản xem trước tại https://editor.pascal.app/next cho thấy hướng đi sắp tới và chưa thuộc bản mã nguồn mở đã phát hành.