Chi tiết dự án
Antigravity Mod
Antigravity Mod (Furina 3D Edition) là bộ công cụ tùy biến giao diện và Việt hóa toàn diện cho ứng dụng desktop Google Antigravity 2.0 trên Windows, nổi bật với nhân vật đồng hành 3D Chibi Furina dựng bằng Three.js/WebGL phản hồi theo từng ký tự đang gõ.
Lưu ý: Đây là dự án mod giao diện cộng đồng không chính thức (unofficial mod) dành cho người dùng cá nhân trên Windows; không phải sản phẩm chính thức của Google.
Hình ảnh thực tế
Vấn đề & Động lực
Giao diện mặc định của ứng dụng chưa hỗ trợ tiếng Việt đầy đủ và không cung cấp tùy chọn cá nhân hóa hình nền, màu nhấn hay đồng hành tương tác trong không gian nhập liệu.
Giải pháp
Viết script PowerShell hỗ trợ tiêm trực tiếp qua Chrome DevTools Protocol (CDP) khi ứng dụng đang mở hoặc vá bền vững vào app.asar (kèm sao lưu và cập nhật SHA-256), nạp engine JavaScript điều phối Three.js FBXLoader, caret tracking và từ điển dịch DOM hai chiều.
Tính năng cốt lõi
Nhân vật 3D Chibi Furina (Three.js / WebGL)
Nạp model furi.fbx cùng các lớp texture sRGB nguyên bản qua Three.js FBXLoader ngay phía trên khung chat, kèm cơ chế fallback sang SVG 2D hoặc ảnh tùy chỉnh.
Theo dõi con trỏ gõ chữ (Eye & Caret Tracking)
Đọc tọa độ Selection / Range.getClientRects() theo thời gian thực để xoay đầu và thân 3D theo vị trí ký tự đang nhập, kết hợp vật lý lò xo khi gõ và phản hồi khi nhấn Enter.
Việt hóa DOM bảo toàn văn bản gốc
Lưu trữ văn bản gốc trên từng DOM Text Node để chuyển đổi tức thì giữa Tiếng Việt và Tiếng Anh (Alt + L) qua hiệu ứng chuyển cảnh nhẹ.
Cơ chế cài đặt Dual-Mode (Live CDP & Persistent ASAR)
Tự động phát hiện DevToolsActivePort để inject thử nghiệm ngay lập tức mà không cần khởi động lại, hoặc đóng gói vào dist/preload.js trong app.asar kèm file backup.
Công nghệ sử dụng
- PowerShell
- Three.js
- WebGL
- JavaScript
- CSS
- CDP
Kiến trúc hệ thống
Installer & Patcher (Mod Antigravity.ps1)
Phát hiện đường dẫn cài đặt, sao lưu file gốc (.bak), tiêm payload qua CDP WebSocket hoặc vá app.asar với mã băm SHA-256 cập nhật.
WebGL Companion & Caret Engine (src/mod.js)
Khởi tạo canvas Three.js trong suốt không cản chuột vùng nhập liệu, tải model FBX và theo dõi tọa độ con trỏ văn bản theo thời gian thực.
DOM Localization & Theme Layer (src/mod.js, src/styles.css)
Áp dụng biến CSS chủ đề, hình nền tùy chỉnh, menu điều khiển nhanh (Alt + M) và bộ dịch DOM giữ nguyên khả năng khôi phục bản gốc.
Thách thức kỹ thuật
Đồng bộ tọa độ 3D theo con trỏ soạn thảo phức tạp
Khung nhập liệu dựa trên DOM/contenteditable thay đổi tọa độ liên tục khi cuộn hoặc xuống dòng. Cần tính toán tọa độ tương đối so với khung composer và clamp góc xoay để chuyển động tự nhiên mà không giật khung hình.
Giữ ổn định sau cập nhật ứng dụng gốc
Vì đây là mod không chính thức can thiệp vào Electron ASAR/DOM, mọi bản cập nhật của ứng dụng gốc có thể ghi đè patch hoặc đổi class DOM — đòi hỏi cơ chế backup rõ ràng và selector an toàn.
Bài học rút ra
- Tách riêng đường inject thử nghiệm (Live CDP) và đường cài đặt bền vững (ASAR backup) giúp phát triển và khôi phục an toàn hơn rất nhiều.
- Luôn đặt pointer-events và z-index cẩn thận cho lớp WebGL overlay để không bao giờ cản trở thao tác gõ hay chọn văn bản của người dùng.
Phạm vi triển khai hiện tại
Phiên bản v2.6.1 đang được phát hành công khai trên GitHub với mã nguồn PowerShell, JS/CSS và tài nguyên model/texture để người dùng tự kiểm tra và cài đặt trên Windows 10/11.