duxweb/ReTheme
GitHub: duxweb/ReTheme
ReTheme 是一个基于 Tauri 2 的 ChatGPT 桌面端主题管理引擎,通过将样式与版本适配解耦实现安全、可自动更新的社区驱动换肤。
Stars: 99 | Forks: 7
ReTheme
为 ChatGPT 桌面端打造的安全、可更新、社区驱动主题引擎。
Tauri 2 + Rust · macOS 与 Windows · 中文与 English
官网 ·
下载 ·
主题开发 ·
反馈
简体中文 | English
ReTheme 把主题作者面对的稳定逻辑插槽与 ChatGPT 的版本适配分开。主题只声明颜色、样式、图片和双语文案;匹配规则由签名兼容数据独立更新,因此 ChatGPT 升级时通常无需重新发布主题或桌面应用。
## 主题预览
主题可以统一覆盖 ChatGPT 的背景、首页横幅、建议卡片、输入框、侧栏、菜单、图标、设置页与会话界面,同时保留原生交互和自适应布局。
### 齐天 · 暗色国风
### 莓果 · 浅色手帐
## 功能
| 能力 | 说明 |
|:--|:--|
| 主题运行时 | 覆盖首页、会话、输入框、侧栏、菜单、设置、卡片和装饰插槽 |
| 社区主题 | 通过 `retheme://` 深链下载,经平台签名验证后安装 |
| 本地开发 | 直接加载未打包主题目录,方便创作者实时调试 |
| 安全恢复 | 停止主题、退出 ReTheme 或安装更新前恢复 ChatGPT 官方界面 |
| 远程兼容 | 按 ChatGPT 版本获取签名适配数据,支持新旧版本并存 |
| 桌面体验 | 托盘、关闭隐藏、单实例、双语界面、深浅色与自动更新 |
ReTheme 桌面仓库不内置社区主题。主题在社区发布并按需下载,安装包保持精简。
## 下载
前往 [GitHub Releases](https://github.com/duxweb/ReTheme/releases) 下载:
- macOS Apple Silicon (`aarch64`)
- macOS Intel (`x86_64`)
- Windows x64 双语安装器(简体中文 / English)
首次启动后,ReTheme 会检测已安装的 ChatGPT。关闭主窗口会隐藏到托盘;请使用托盘菜单中的“退出 ReTheme”彻底退出。
## 主题开发
开发主题是普通目录,不需要克隆 ReTheme 源码,也不需要 Rust、Cargo、`.ctheme` 解密或平台签名。只选择以下一种方式即可。
### 手工开发
完整规则、字段、插槽、双语、明暗模式、Banner 规格和验收要求统一见 [主题开发规范](docs/theme-development.md)。创建最小主题:
pnpm dlx @duxweb/retheme-theme-skill create ./my-theme
修改 `manifest.json`、`styles/` 和 `assets/`,再使用与桌面端、服务端相同的校验器验证目录:
pnpm dlx @duxweb/retheme-theme-skill validate ./my-theme
发布前同样校验源码 ZIP:
pnpm dlx @duxweb/retheme-theme-skill validate ./my-theme.zip
在 ReTheme 中选择“加载本地主题”进行实际测试。正式发布时上传根目录直接包含 `manifest.json` 的源码 ZIP,由平台审核并生成 `.ctheme`。
### 使用 AI Skill
一条命令安装完整 Skill:
pnpm dlx @duxweb/retheme-theme-skill install
安装包已包含详细协议、插槽、QA、Banner 生图提示词、起始模板和当前系统的编译版校验器。无需下载本仓库。重启 Codex 后直接描述任务:
使用 retheme-theme-development Skill,在 /path/to/my-theme 创建一套支持中英文和深浅模式的主题,完成校验但不要打包成 .ctheme。
AI 必须以共享校验器结果为准;不要为了迁就主题而放宽协议,也不要使用 ChatGPT 内部类名或改变原生布局。
## 本地开发
需要 Node.js 22、pnpm 10、Rust stable 与 Tauri 对应的系统依赖。
pnpm install
cp src-tauri/config/api.example.toml src-tauri/config/api.toml
cp src-tauri/config/security.example.toml src-tauri/config/security.toml
pnpm tauri dev
验证:
pnpm test
pnpm build
cargo test --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
配置模板不包含生产密钥。维护者发版请阅读 [发布流程](docs/releasing.md),安全边界见 [安全设计](docs/security.md)。
## 相关链接
- [主题开发规范](docs/theme-development.md)
- [AI Skill 安装](packages/retheme-theme-skill/README.md)
- [Theme Development Guide](docs/theme-development.en.md)
- [安全设计](docs/security.md)
- [发版流程](docs/releasing.md)
- [开源协议](LICENSE)
- [ReTheme 官网](https://retheme.app)
- [LINUX DO 社区](https://linux.do/)
- [问题反馈](https://github.com/duxweb/ReTheme/issues)
标签:ChatGPT, Promptflow, Rust, Tauri, 主题引擎, 可视化界面, 桌面应用, 用户界面, 网络流量审计, 通知系统