反重力自訂主題技能
建立並將自訂玻璃態主題(桌布、一致調色盤、自訂作曲者裝飾、預製玻璃面板以及安全分割瀏覽器疊加層)套用至反重力,無需修改應用程式二進位檔。
儲存庫結構
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結構、對比規則及反重力選取器備註。
工作流程
- 收集美學資訊與檢查圖片
- 僅在意圖不明確時簡短詢問遺漏的資訊(氛圍:溫暖舒適、賽博龐克霓虹、動畫風格、宇宙金色、極簡純 CSS 漸層等)。
- 如果使用者提供的圖片有不需要的角落浮水印/簽名,請先將其清理/裁剪乾淨,然後再進行後續處理。
- 設計一致代幣(深色或淺色玻璃)
- 閱讀
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裝飾。
- 閱讀
- 暫存資產與編輯
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/...)。
- 將桌布儲存於
- 編譯語法檢查負載
- 執行
python scripts/build_payload.py(或python3 scripts/build_payload.py)。 - 執行
node --check dist/theme_payload.js以確保零語法問題。
- 執行
- 執行 / 熱重新載入守護行程
- Windows:
powershell -ExecutionPolicy Bypass -File scripts/install-win.ps1 - macOS / Linux:
bash scripts/install-unix.sh(或使用--foreground進行互動式測試) - 如果守護行程已在執行,重建
dist/theme_payload.js會透過fs.watch觸發自動熱重新載入。
- Windows:
- 透過 CDP 進行即時驗證
- 在反重力開啟時執行
node scripts/verify_cdp.js。 - 在報告成功之前,確認
themeActive: true、hasLiveBlurRule: false、有效的.agy-shell背景以及可讀的作曲者藥丸。
- 在反重力開啟時執行
不可協商的架構規則
- 零即時模糊: 絕對不要對
.agy-shell、.agy-chat-frame或可滾動窗格添加 CSSbackdrop-filter: blur(...)— Electron 在即時模糊下滾動時會嚴重掉幀。engine/core.js改為預先烘焙模糊的畫布紋理(syncPrebakedGlass)。 - 僅資料主題編輯: 在
themes/themes.json+themes/assets/中新增主題。除非反重力變更其上游的 DOM 選擇器,否則請勿修改engine/core.js。 - 分割瀏覽器裁切: 切勿在右側瀏覽器窗格上繪製不透明疊加層;保持
data-has-browser-hole+evenoddclip-path行為不變,以使嵌入的 Chromium 視圖保持清晰。 - 無個人資料洩漏: 在提交前檢查修改過的檔案中是否有絕對使用者路徑或個人
theme_config.json狀態。