Community影像github.com

反重力自訂主題

當使用者想要從桌布圖片、色彩調色盤、美學氛圍或預設主題來設計、自訂、安裝、更新或排解反重力 IDE 或管理員的視覺主題時使用。

反重力自訂主題 是什麼?

這個技能提供一個完全在客戶端運作的流程,用於在反重力(Antigravity)IDE 中設計、編譯、部署自訂的玻璃態(glassmorphic)主題。它圍繞一個模組化儲存庫結構,包含主題 JSON 定義、用於可縮放向量圖形(SVG)裝飾和點陣桌布的資產、一個零即時模糊的 DOM/CSS 注入引擎,以及一個跨平台的 Node.js 除錯協定(CDP)守護行程,用於監控檔案變更並在執行中重新載入主題。工作流程從收集使用者意圖(例如溫暖、柔和、賽博龐克)和處理來源圖片開始;然後將顏色萃取成正確對比的主題代幣,並將資產儲存在 `themes/assets/` 中。接著,將新條目新增至 `themes/themes.json`,執行 Python 建置腳本以生成 `dist/theme_payload.js`,並啟動(或重新載入)CDP 守護行程。內建驗證程式碼會檢查 `themeActive` 和 `hasLiveBlurRule` 等屬性,以確保在報告成功之前應用正確。標榜嚴格規則:無即時模糊,僅限資料主題編輯(勿碰 `engine/core.js`),分割瀏覽器安全裁切,以及無個人資料洩漏(請勿在 JSON/JS 中使用絕對 OS 路徑)。它支援 Windows、macOS 和 Linux。

相容平台~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/giakiet22102006/antigravity-custom-theme-skill/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

反重力自訂主題技能

建立並將自訂玻璃態主題(桌布、一致調色盤、自訂作曲者裝飾、預製玻璃面板以及安全分割瀏覽器疊加層)套用至反重力,無需修改應用程式二進位檔。

儲存庫結構

  • themes/themes.json — 主題預設(顏色、桌布路徑、SVG 裝飾、玻璃透明度/飽和度預設值)。
  • themes/assets/ — 點陣桌布(.webp/.png/.jpg)和 SVG 貼紙/角落裝飾。
  • engine/core.js — 獨立 DOM + CSS 注入引擎(零即時模糊、L-glass 佈局、分割瀏覽器孔洞裁切、作曲者藥丸對比、即時主題設定模態框)。
  • scripts/build_payload.py — 將 themes/themes.json + engine/core.js 編譯為 gitignore 的 dist/theme_payload.js(當 Pillow 安裝時,自動將 >2560px 的點陣圖縮小為 WebP)。
  • daemon/theme_daemon.js — 跨平台 Node.js(>= 22)CDP 守護行程,監看 DevToolsActivePort 和 dist/theme_payload.js。
  • scripts/install-win.ps1、scripts/install-unix.sh、scripts/uninstall.js、scripts/verify_cdp.js — 作業系統設定、移除及即時 CDP 驗證。
  • references/theme-schema.md — 精確的 themes.json 結構、對比規則及反重力選取器備註。

工作流程

  1. 收集美學資訊與檢查圖片
    • 僅在意圖不明確時簡短詢問遺漏的資訊(氛圍:溫暖舒適、賽博龐克霓虹、動畫風格、宇宙金色、極簡純 CSS 漸層等)。
    • 如果使用者提供的圖片有不需要的角落浮水印/簽名,請先將其清理/裁剪乾淨,然後再進行後續處理。
  2. 設計一致代幣(深色或淺色玻璃)
    • 閱讀 references/theme-schema.md 以了解每個 themes.json 鍵。
    • 從圖片中提取主色與強調色,以填入 primary、secondary、overlayRgb、bg、frameBg、sidebarBg、aiCardBg、headerBg、inputCardBg 和 modalBg,並確保清晰的對比度。
    • 對於明亮/白天/粉彩桌布,設定 "isLight": true,搭配高對比深色墨色(uiTextColor、pillTextColor)和淺色磨砂 aiCardBg/overlayRgb。
    • 當使用者想要匹配的聊天頭像(或提供角色/主題藝術品)時,也製作或裁剪方形 userAvatar 和 agentAvatar 資產(PNG/WebP 或自訂 SVG 徽章)以及自訂 sticker/cornerSvg 裝飾。
  3. 暫存資產與編輯 themes/themes.json
    • 將桌布儲存於 themes/assets/<slug>.webp(或 .png),可選的 SVG 貼紙/角落,以及可選的 userAvatar / agentAvatar 檔案儲存於 themes/assets/。
    • 在 themes/themes.json 中新增一個條目,引用 "assets/<filename>"(除非要求移除,否則保留現有範例預設值)。
    • 切勿在 JSON、JS 或腳本中硬編碼個人 OS 路徑(C:\Users\...、/Users/...、/home/...)。
  4. 編譯語法檢查負載
    • 執行 python scripts/build_payload.py(或 python3 scripts/build_payload.py)。
    • 執行 node --check dist/theme_payload.js 以確保零語法問題。
  5. 執行 / 熱重新載入守護行程
    • Windows: powershell -ExecutionPolicy Bypass -File scripts/install-win.ps1
    • macOS / Linux: bash scripts/install-unix.sh(或使用 --foreground 進行互動式測試)
    • 如果守護行程已在執行,重建 dist/theme_payload.js 會透過 fs.watch 觸發自動熱重新載入。
  6. 透過 CDP 進行即時驗證
    • 在反重力開啟時執行 node scripts/verify_cdp.js。
    • 在報告成功之前,確認 themeActive: true、hasLiveBlurRule: false、有效的 .agy-shell 背景以及可讀的作曲者藥丸。

不可協商的架構規則

  • 零即時模糊: 絕對不要對 .agy-shell、.agy-chat-frame 或可滾動窗格添加 CSS backdrop-filter: blur(...) — Electron 在即時模糊下滾動時會嚴重掉幀。engine/core.js 改為預先烘焙模糊的畫布紋理(syncPrebakedGlass)。
  • 僅資料主題編輯: 在 themes/themes.json + themes/assets/ 中新增主題。除非反重力變更其上游的 DOM 選擇器,否則請勿修改 engine/core.js。
  • 分割瀏覽器裁切: 切勿在右側瀏覽器窗格上繪製不透明疊加層;保持 data-has-browser-hole + evenodd clip-path 行為不變,以使嵌入的 Chromium 視圖保持清晰。
  • 無個人資料洩漏: 在提交前檢查修改過的檔案中是否有絕對使用者路徑或個人 theme_config.json 狀態。

相關技能