Hướng dẫn tự làm thú cưng để bàn Codex
Thú cưng của Codex App không phải chỉ dùng được mấy bạn có sẵn. Phía chính thức để sẵn cả một lối tuỳ chỉnh đầy đủ: chỉ cần chuẩn bị một spritesheet đúng quy cách và một pet.json, bỏ vào thư mục trên máy, thì nhân vật nào bạn vẽ ra cũng dọn lên màn hình ở được. Đỡ việc hơn nữa là phía chính thức còn ra một kỹ năng tên hatch-pet: quăng cho nó vài tấm ảnh tham khảo, cả bộ hoạt ảnh nó vẽ thay bạn. Bài này nói rõ cả hai lối, và khép lại bằng một ví dụ có thật: hai tấm ảnh chế chuột lang nước đã thành một thú cưng chạy được như thế nào.
Đây có phải cách chơi chính thức không
Đúng vậy. hatch-pet nằm trong thư mục curated (tuyển chọn) của kho kỹ năng chính thức openai/skills của OpenAI, còn quy cách khung vẽ, 9 hàng trạng thái hoạt ảnh, số khung hình và thời lượng từng hàng đều được file hợp đồng chính thức quy định cứng. Một điểm cần lưu ý: kho này hiện đã được đánh dấu là đang chuyển đi, hệ sinh thái kỹ năng mới nằm ở openai/plugins, nhưng bản thân hatch-pet vẫn còn ở chỗ cũ và vẫn cài dùng được.
Bản thể của một thú cưng đơn giản hơn đa số mọi người nghĩ — chỉ hai file:
~/.codex/pets/id-thú-cưng-của-bạn/
├── pet.json # metadata gồm 4 trường
└── spritesheet.webp # spritesheet 1536×1872 (PNG cũng được)Chi tiết quy cách (mỗi hàng hoạt ảnh dùng mấy khung hình, những ô nào bắt buộc để trống trong suốt) chúng tôi đã gom thành bảng tra nhanh, xem giải thích chi tiết quy cách spritesheet.
Lối một: hatch-pet, để AI vẽ thay bạn
Hợp với người muốn chất vẽ tay tinh xảo và đang dùng sẵn Codex App. Điều kiện là trong Codex có kỹ năng sinh ảnh chính thức ($imagegen, bản mới thường có sẵn).
- Cài: trong khung chat Codex gõ
$skill-installer hatch-pet, cài xong khởi động lại Codex; - Ra đề: cứ nói thẳng “ấp cho tôi một bạn ___”. Có thể chỉ đưa mô tả bằng chữ, cũng có thể kèm ảnh tham khảo — linh vật của công ty, bản phác tay, thậm chí một tấm ảnh thú cưng thật. Phong cách chọn được
pixel,plush(nhồi bông),clay(đất sét),sticker(nhãn dán),3d-toy(đồ chơi 3D)…, không chỉ định thì nó tự suy ra; - Đợi nó làm: hatch-pet sẽ sinh một hình cơ sở cho bạn duyệt trước, rồi sinh từng hàng 9 trạng thái hoạt ảnh (chờ, chạy trái phải, vẫy tay, nhảy, thất bại, chờ đợi, làm việc, rà soát), tự động ghép thành ảnh lớn 1536×1872, tách nền trong suốt, chạy script kiểm tra;
- Bật lên: thành phẩm rơi thẳng vào
~/.codex/pets/, vào phần cài đặt thú cưng chọn là xong.
Kinh nghiệm thực dụng khi đưa ảnh tham khảo: mỗi lần đưa 1-3 tấm, ảnh có nhân vật nguyên người và nền sạch thì cho kết quả tốt nhất; hãy yêu cầu nó giữ “cùng một khuôn mặt, cùng một bảng màu” xuyên suốt mọi hàng động tác — đây là tiêu chí có trọng số cao nhất trong bộ QA chính thức.
Lối hai: vẽ từng khung hình bằng code
Ai không muốn quay số, muốn kiểm soát 100% thì đi lối này. Cả 91 thú cưng trên trang này đều được sinh ra bằng chương trình Python + Pillow: ghép thân bằng các mảng màu trên một lưới nhỏ, theo từng trạng thái mà áp tham số cho mỗi khung hình, cuối cùng ghép thành ảnh lớn đúng quy cách. Viết xong một engine vẽ rồi thì thêm một bạn mới chỉ tốn mười dòng cấu hình. Toàn bộ mạch suy nghĩ và cách thiết kế số khung hình nằm ở chương tự làm trong hướng dẫn sử dụng.
Thực chiến: hai tấm ảnh chế, một thú cưng để bàn
Có bạn đọc gửi tới hai tấm ảnh chế chuột lang nước và hỏi “thế này có làm được không”. Được, và đây đúng là quy trình chuẩn của việc đặt làm từ ảnh mẫu. Cách chúng tôi làm chia ba bước:
- Rút đặc điểm, không phải đồ lại: thứ rút ra từ ảnh tham khảo là một danh sách đặc điểm — thân tròn màu trà sữa, mảng mõm hình bầu dục sẫm màu chiếm nửa mặt, tai tròn nhỏ, má hồng, dáng nằm dài uể oải, viền màu nâu ấm;
- Vẽ lại theo đặc điểm: dùng danh sách này vẽ một bạn chuột lang nước gốc trên lưới pixel, đủ 9 hàng hoạt ảnh (hệ nằm dài thì cú nhảy cũng nhảy nghiêm túc);
- Qua kiểm tra chính thức: dùng validate_atlas.py trong kho chính thức soát lại kích thước, số khung hình, độ trong suốt, xanh hết mới cho lên trang.
Thành phẩm tên là Paka chuột lang nước nằm dài, xem trước cả 9 trạng thái và tải miễn phí được ngay trên trang của nó.
Năm chỗ dễ lật xe nhất
- Số khung hình mỗi hàng khác nhau: chờ 6 khung, vẫy tay 4 khung, nhảy 5 khung, chạy và thất bại 8 khung, còn lại 6 khung — ô nào vẽ dư thì phải để trong suốt cả ô, không thì không qua nổi bước kiểm tra;
- Nhảy đừng lòi ra khỏi ô: cả con thú cưng (kể cả tai và mũ) ở bất kỳ khung hình nào cũng phải nằm trọn trong 192×208;
- Phần trong suốt phải sạch: không được để bóng đổ mờ, bóng nền, vệt tốc độ, và trong pixel trong suốt cũng không được giấu giá trị RGB thừa;
- Cấp thư mục: pet.json phải nằm trực tiếp trong
pets/id-thú-cưng/, giải nén mà lồng thêm một lớp thư mục là nguyên nhân phổ biến nhất của chuyện “thú cưng không hiện ra”; - Hàng working không phải chạy: phía chính thức nói rõ hàng này thể hiện “tập trung làm việc”, vẽ thành sải chân chạy là bị chấm không đạt.
Bảng quy cách đầy đủ hơn (gồm cả thời lượng phát từng hàng theo chuẩn chính thức) nằm ở đây.
Lười động tay?
Trang này đã chuẩn bị sẵn 91 bạn: bộ sưu tập gốc 50 bạn + loạt lấy cảm hứng 41 bạn, tất cả đều đã qua script kiểm tra chính thức, tải miễn phí, sửa thoải mái. Trang chi tiết của mỗi bạn đều kèm một dòng lệnh cài bằng PowerShell, 30 giây là chuột lang nước hay mèo cyber đã dọn vào màn hình bạn.