Các skill Meshy cho Hermes Agent
Thêm các skill Meshy vào Hermes Agent để agent của bạn có thể tạo mô hình 3D, texture và hoạt hình, cũng như chuẩn bị bản in 3D, ngay từ một cuộc trò chuyện.
Tổng quan
Meshy có hai skill dành cho Hermes Agent:
meshy-3d-generation: Văn bản sang 3D, Ảnh sang 3D và Nhiều ảnh sang 3D, tạo texture và tái tạo texture bằng AI, remesh theo ngân sách đa giác, UV unwrapping, tự động rigging và tạo hoạt hình cho nhân vật dạng người, cùng khả năng xuất sang GLB, FBX, OBJ, STL hoặc USDZ.meshy-3d-printing: phân tích và sửa khả năng in, 3MF một màu và đa màu, điều chỉnh kích thước theo tỷ lệ thực tế, các sản phẩm Creative Lab như tượng nhỏ, đèn, móc khóa và nam châm tủ lạnh, cùng khả năng chuyển giao cho phần mềm cắt lớp đã cài đặt.
Mỗi skill được cài đặt độc lập, vì vậy bạn có thể chỉ thêm skill in nếu đó là tất cả những gì bạn cần. Cả hai skill đều chạy Meshy CLI, chính là gói meshy-cli trên npm. Bạn chỉ cần đăng nhập một lần trên trình duyệt và không cần khóa API.
Các skill này là mã nguồn mở trong kho lưu trữ meshy-3d-agent trên GitHub.
Trước khi bắt đầu
-
Bạn cần có Hermes Agent.
-
Bạn cần Node.js 22.12 trở lên, kèm npm, trên máy tính chạy Hermes.
-
Để tạo mô hình, bạn cần một gói Meshy trả phí. Mỗi tác vụ tạo mô hình sẽ tiêu tốn tín dụng Meshy theo mức giá API. Để biết chi phí của từng tác vụ, xem Giá. Phân tích khả năng in là miễn phí, và các bước in cục bộ, chẳng hạn như thay đổi tỷ lệ mô hình hoặc mở nó trong phần mềm cắt lớp, không cần đăng nhập.
Cài đặt các skill
Để Hermes tự thực hiện việc cài đặt, hãy dán đoạn văn bản sau vào cuộc trò chuyện:
Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md
Hermes sẽ kiểm tra Node.js, cài đặt Meshy CLI cùng cả hai skill, sau đó hướng dẫn bạn đăng nhập.
Để tự cài đặt các skill, hãy thêm chúng từ GitHub bằng Hermes:
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing
Bạn cũng có thể cài đặt cả hai skill bằng trình cài đặt skills:
npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent
Bạn không cần cài đặt toàn cục bằng npm install -g meshy-cli. Nếu không có nó, các skill sẽ chạy CLI thông qua npm exec. Việc cài đặt toàn cục chỉ giúp khởi động nhanh hơn.
Nếu Hermes không sử dụng các skill trong một cuộc trò chuyện đang mở khi bạn cài đặt chúng, hãy bắt đầu một phiên mới.
Đăng nhập
Lần đầu tiên bạn yêu cầu một mô hình, Hermes sẽ bắt đầu quy trình đăng nhập Meshy CLI và gửi cho bạn một liên kết cùng một mã dùng một lần.
Để đăng nhập, hãy làm theo các bước sau:
-
Mở liên kết trên bất kỳ thiết bị nào.
-
Nếu trang yêu cầu nhập mã, hãy nhập mã vào ô Device code chính xác như Hermes hiển thị, sau đó nhấp vào Continue.
-
Nếu Meshy yêu cầu bạn đăng nhập, hãy đăng nhập vào tài khoản Meshy của bạn.
-
Trên trang Connect Meshy CLI, nhấp vào Connect. Trang sẽ hiển thị Meshy CLI authorized.

-
Quay lại cuộc trò chuyện. Hermes sẽ tiếp tục yêu cầu mà bạn đã đưa ra.
Mã sẽ hết hạn sau 10 phút. Nếu mã hết hạn, hãy yêu cầu Hermes cấp mã mới. Bạn có thể phê duyệt đăng nhập từ bất kỳ trình duyệt nào, vì vậy nó cũng hoạt động khi Hermes chạy trên máy chủ hoặc qua SSH.
Meshy CLI lưu trữ phiên đăng nhập trong ~/.config/meshy/credentials.json. Mọi agent chạy cùng người dùng trên máy tính đó sẽ dùng chung phiên đăng nhập. Nếu MESHY_API_KEY đã được thiết lập, CLI sẽ sử dụng khóa API đó thay vì phiên trình duyệt.
Ví dụ về prompt
Hãy mô tả công việc bằng lời của chính bạn. Ví dụ:
- Tạo một mô hình 3D của một chú chó husky con và lưu dưới dạng GLB trong ./assets.
- Biến bức ảnh này thành một mô hình 3D có texture và giữ nguyên tỷ lệ của nó. (đính kèm hình ảnh)
- Tạo ba chai lọ thuốc low-poly cho trò chơi của tôi, mỗi chai dưới 1.500 tam giác.
- Rig nhân vật dạng người này, thêm hoạt hình đi bộ, và xuất ra dưới dạng FBX.
- Giúp tôi in 3D một tượng rồng nhỏ, cao 80 mm, dưới dạng 3MF đa màu.
Các yêu cầu tiếp theo sẽ tái sử dụng kết quả trước đó, ví dụ như tạo một LOD 1.500 mặt, bây giờ dưới dạng FBX, hoặc thu nhỏ xuống 150 mm. Để tự phê duyệt từng bước trả phí, hãy thêm hỏi tôi trước khi dùng tín dụng vào yêu cầu của bạn.
Khắc phục sự cố
Bảng dưới đây liệt kê các vấn đề thường gặp, nguyên nhân và cách khắc phục.
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Hermes không sử dụng các skill Meshy | Hermes không tải các skill trong cuộc trò chuyện đang mở, hoặc không khớp yêu cầu của bạn với chúng. | Bắt đầu một phiên mới, hoặc nhắc đến Meshy trong yêu cầu của bạn. |
Không tìm thấy node hoặc npm | Node.js chưa được cài đặt, hoặc Hermes không thể tìm thấy nó. | Cài đặt Node.js 22.12 trở lên từ trang web Node.js, sau đó khởi động lại Hermes. |
| Hermes yêu cầu khóa API | Các skill không cần khóa API. Chúng đăng nhập qua trình duyệt của bạn. | Từ chối, và yêu cầu Hermes đăng nhập qua trình duyệt thay vào đó. Không bao giờ dán khóa API vào cuộc trò chuyện. |
| Mã đăng nhập đã hết hạn | Mã chỉ có hiệu lực trong 10 phút. | Yêu cầu Hermes bắt đầu lại quy trình đăng nhập. |
| Hermes không thể tạo mô hình do gói đăng ký hoặc tín dụng của bạn | Việc tạo mô hình cần một gói trả phí và đủ tín dụng. | Kiểm tra gói đăng ký và số dư của bạn trên trang Subscription trong ứng dụng web Meshy. |
| Bạn đang đăng nhập nhầm tài khoản Meshy | Meshy CLI sử dụng lại phiên đăng nhập đã lưu trữ trên máy tính của bạn. | Yêu cầu Hermes chạy meshy auth logout, sau đó đăng nhập lại. |
FAQ
- Làm thế nào để thêm Meshy vào Hermes Agent?
- Yêu cầu Hermes làm theo hướng dẫn tại https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, hoặc chạy hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation và lệnh tương tự cho meshy-3d-printing. Bạn cũng cần Node.js 22.12 trở lên kèm npm.
- Tôi có cần khóa API Meshy không?
- Không. Các skill đăng nhập qua trình duyệt của bạn bằng mã dùng một lần, và Meshy CLI lưu trữ phiên đăng nhập. Nếu MESHY_API_KEY đã được thiết lập trong môi trường của bạn, Meshy CLI sẽ sử dụng nó thay thế.
- Tôi có thể chỉ cài đặt skill in 3D không?
- Có. meshy-3d-printing được cài đặt và hoạt động độc lập, bao gồm cả các bước tạo mô hình mà bản in cần.
- Nó có hoạt động khi Hermes chạy trên máy chủ từ xa không?
- Có. Quá trình đăng nhập hiển thị một liên kết và một mã mà bạn có thể phê duyệt từ bất kỳ trình duyệt nào.
- Đây có phải là các skill giống với plugin Codex không?
- Có. Plugin Codex, Claude Code, Cursor và Hermes Agent đều sử dụng meshy-3d-generation và meshy-3d-printing từ kho lưu trữ mã nguồn mở meshy-3d-agent.
- Nó có miễn phí không?
- Các skill này miễn phí và là mã nguồn mở. Việc tạo mô hình 3D yêu cầu một gói Meshy trả phí và sẽ tiêu tốn tín dụng Meshy theo mức giá API. Phân tích khả năng in là miễn phí.
Bước tiếp theo
-
Để sử dụng các skill tương tự trong Codex, xem Plugin Meshy cho Codex.
-
Để sử dụng các skill tương tự trong OpenClaw, xem Skill Meshy cho OpenClaw.
-
Để gọi Meshy API từ một AI agent bằng khóa API của riêng bạn, xem Tích hợp AI.