反重力自定义主题技能
创建并应用自定义玻璃态主题(壁纸、协调的调色板、自定义装饰器、预烘焙的玻璃面板和分割浏览器安全覆盖层)到反重力,无需修改应用程序二进制文件。
仓库布局
themes/themes.json— 主题预设(颜色、壁纸路径、SVG装饰器、玻璃透明度/饱和度默认值)。themes/assets/— 光栅壁纸(.webp/.png/.jpg)和SVG贴纸/角落装饰。engine/core.js— 独立DOM + CSS注入引擎(零实时模糊、L-玻璃布局、分割浏览器孔洞裁剪、composer药丸对比度、实时主题设置模态框)。scripts/build_payload.py— 将themes/themes.json+engine/core.js编译到 gitignored 的dist/theme_payload.js中(当安装了Pillow时,自动将>2560像素的光栅缩小为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 或脚本中硬编码个人操作系统路径(
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背景以及可读的 composer 药丸,然后报告成功。
- 反重力打开时,运行
不可协商的架构规则
- 零实时模糊: 切勿向
.agy-shell、.agy-chat-frame或可滚动窗格添加 CSSbackdrop-filter: blur(...)——Electron 滚动在实时模糊下会严重掉帧。engine/core.js而是预烘焙模糊的画布纹理(syncPrebakedGlass)。 - 仅数据主题创作: 在
themes/themes.json+themes/assets/中添加主题。保持engine/core.js不变,除非反重力更改其上游 DOM 选择器。 - 分割浏览器裁剪: 切勿在右侧浏览器窗格上绘制不透明覆盖层;保持
data-has-browser-hole+evenoddclip-path行为不变,以便嵌入的 Chromium 视图保持清晰。 - 无个人数据泄露: 在提交前检查修改过的文件是否存在绝对用户路径或个人
theme_config.json状态。