Skip to content

Commit 2759dd5

Browse files
authored
Rework the theme library, sponsor, and one-click apply README sections (#262)
Rework the theme library, sponsor, and one-click apply sections Everything on this branch since v1.5.5, in both READMEs: - Header gains a DreamSkin.cc / Gallery / Online Studio link line. - "Sponsors" becomes "Exclusive sponsor": table layout, rewritten Passion8 copy, and the affiliate link moves from register?aff=TuPe to sign-up?aff=ZgLT with the 10% first-top-up benefit and support address. - New "Theme library & community" section: the DreamSkin.cc mark, Gallery and Studio entry points, and one screenshot per bullet -- the desktop simulator trying on 晨雾山水, and the online Studio editing 月下松岚. The old gallery card-wall shot had 30 buttons across 6 cards wrapping onto three rows, which read as clutter at README width. - New "One-click apply" subsection covering the dreamskin:// flow and its safety boundary. - "What it does" gains a one-click apply bullet, and the manual ZIP import section now points at one-click apply first.
1 parent c020d24 commit 2759dd5

7 files changed

Lines changed: 174 additions & 25 deletions

File tree

README.en.md

Lines changed: 87 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,35 @@
1313
One image, one mood · Code with atmosphere
1414
</p>
1515

16+
<p align="center">
17+
Official theme library: <a href="https://dreamskin.cc"><strong>DreamSkin.cc</strong></a> ·
18+
<a href="https://dreamskin.cc/gallery">Gallery</a> ·
19+
<a href="https://dreamskin.cc/studio">Online Studio</a>
20+
</p>
21+
1622
<p align="center">
1723
Unofficial. Does not modify <code>.app</code> / <code>app.asar</code> / WindowsApps.
1824
</p>
1925

26+
## 🤝 Exclusive sponsor
27+
28+
<table>
29+
<tr>
30+
<td width="180">
31+
<a href="https://passion8.cc/sign-up?aff=ZgLT"><img src="docs/images/sponsor-passion8.png" alt="Passion8" width="150"></a>
32+
</td>
33+
<td>
34+
Thanks to Passion8 for being this project's exclusive sponsor! Passion8 is an AI API relay for developers, giving individuals and teams stable, low-cost access to mainstream large models.<br><br>
35+
<strong>Full-power AI, within reach</strong>: the full OpenAI and Claude lineups, original models, no silent downgrades and no wrapper shells; frontier models for a fraction of official pricing, with top-ups at 1:1 — <strong>$1 = ¥1</strong>. Keep your official SDK and point the base URL at Passion8: Claude Code, Codex, Grok, and any OpenAI-compatible client just work — one line of config, no code changes.<br><br>
36+
<strong>Global edge acceleration</strong>: Cloudflare's global edge plus multi-route BBR acceleration for low latency and high availability; 7×24 relay, 99.9% SLA, sub-second TTFT target.<br><br>
37+
<strong>Secure by default</strong>: isolated API keys, encrypted key storage, and HTTPS end to end — privacy first.<br><br>
38+
Passion8 has a benefit for this project's users: register through <a href="https://passion8.cc/sign-up?aff=ZgLT">this link</a> and your first top-up earns an automatic 10% bonus — no application needed, credited within 30 minutes. Questions go to <a href="mailto:support@passion8.cc">support@passion8.cc</a>.
39+
</td>
40+
</tr>
41+
</table>
42+
43+
<sub>Theme install and API config stay separate — this project never rewrites your provider settings.</sub>
44+
2045
## Install directly
2146

2247
Ordinary users first install and quit the official Codex / ChatGPT app once,
@@ -30,31 +55,77 @@ the [macOS guide](./docs/install-macos.md) or
3055
[Windows guide](./docs/install-windows.md) for unsigned first-run approval,
3156
updates, and uninstall steps.
3257

33-
## Sponsors
58+
## Theme library & community
3459

3560
<p align="center">
36-
<a href="https://passion8.cc/register?aff=TuPe">
37-
<img src="docs/images/sponsor-passion8.png" alt="Passion8" height="72">
61+
<a href="https://dreamskin.cc">
62+
<img src="docs/images/dreamskin-mark.svg" alt="DreamSkin.cc" height="88">
3863
</a>
3964
</p>
4065

4166
<p align="center">
42-
<strong>Smarter Connections · Passionate Creation</strong><br>
43-
<sub>Connect AI · Power Creation</sub>
67+
<strong>DreamSkin.cc</strong> · the official theme library and authoring platform<br>
68+
<sub>Make your workspace <em>yours.</em></sub>
4469
</p>
4570

4671
<p align="center">
47-
Thanks to <a href="https://passion8.cc/register?aff=TuPe"><strong>passion8.cc</strong></a> for sponsoring this project.<br>
48-
Full-power AI gateway: official models, no silent downgrades, no wrapper shells.<br>
49-
One-line setup for Codex / Claude Code / Grok.
72+
<a href="https://dreamskin.cc/gallery"><strong>Browse the Gallery →</strong></a>
73+
&nbsp;·&nbsp;
74+
<a href="https://dreamskin.cc/studio"><strong>Online Studio →</strong></a>
75+
</p>
76+
77+
- [**Gallery**](https://dreamskin.cc/gallery) — browse reviewed community themes
78+
with recent/popular sorting and creator rankings. Every theme can be tried on
79+
in an in-page desktop simulator before you install it.
80+
81+
<p align="center">
82+
<a href="https://dreamskin.cc/gallery">
83+
<img src="docs/images/site-tryon-en.webp" alt="Trying on the community theme 晨雾山水 in the DreamSkin.cc desktop simulator" width="900">
84+
</a><br>
85+
<sub>Trying on the community theme 晨雾山水 · switch home/task page, wide/compact window, and sidebar on the spot, then apply in one click or download the pack</sub>
5086
</p>
5187

88+
- [**Online Studio**](https://dreamskin.cc/studio) — swap the background, tune
89+
theme colors, and write Safe CSS in the browser, then export a `.zip` pack or
90+
submit it to the library (sign-in required; published after human review).
91+
5292
<p align="center">
53-
<sub>
54-
Theme install and API config stay separate — this project never rewrites your provider settings.
55-
</sub>
93+
<a href="https://dreamskin.cc/studio">
94+
<img src="docs/images/site-studio-en.webp" alt="Editing the community theme 月下松岚 in the DreamSkin.cc online Studio" width="900">
95+
</a><br>
96+
<sub>Online Studio · live preview on the left, background artwork, appearance/focal point, and palette on the right; any library theme loads straight in to keep editing</sub>
5697
</p>
5798

99+
The macOS menu bar and Windows tray both link straight to **Gallery** and
100+
**Online Studio**.
101+
102+
### One-click apply
103+
104+
Found a theme you like on DreamSkin.cc? **Apply** hands it to the local client
105+
directly — no download-then-import step. Requires client v1.5.0 or newer
106+
(v1.5.5+ recommended).
107+
108+
Flow and safety boundary:
109+
110+
- The page invokes the local app through `dreamskin://apply?version=ver_...`.
111+
The link can carry exactly one theme version ID — **never** an arbitrary URL,
112+
file path, or command — and there is no silent-apply parameter.
113+
- The app fetches the package only from the fixed official API, and refuses
114+
redirects.
115+
- A native confirmation appears first, and the app checks the version's review
116+
status, apply-compatibility flag, version, package size, actually downloaded
117+
byte count, and SHA-256.
118+
- It then reuses exactly the same ZIP, manifest, image, and Safe CSS validation
119+
as a manual import.
120+
- Success requires the real renderer to report the new theme as rendered. On a
121+
launch or render failure the app tries to restore the previous theme, and the
122+
restore is itself visibility-verified; if it cannot confirm either state it
123+
reports the status as unconfirmed rather than claiming a rollback.
124+
125+
Only themes that fully satisfy the current pack contract (background image +
126+
`theme.json` + non-empty `theme.css` + declared `safe-css` capability) show the
127+
one-click button. Anything else goes through the manual import below.
128+
58129
## Tested featured presets
59130

60131
### Gothic Void Crusade / 哥特虚空远征
@@ -101,6 +172,7 @@ to use and save it for one-click switching.
101172
- **Continuous wallpaper** — One 16:9 image spans the full window; adaptive focus, safe-area, and route treatment keep native content readable.
102173
- **Swappable art** — Drop in a UI-free image you like and it becomes your theme.
103174
- **Saved themes** — Switch local themes from the macOS menu bar or Windows system tray.
175+
- **One-click apply** — Hit apply on [DreamSkin.cc](https://dreamskin.cc); the client verifies origin and checksum, then installs it.
104176
- **Theme ZIP import** — Pick an ordinary `.zip` on either platform and add a validated pack to the local library.
105177
- **Restorable** — One-click restore to the stock look.
106178
- **Safer path** — Local-loopback CDP inject only. No official binary or signature changes.
@@ -127,6 +199,9 @@ GUI approval path.
127199

128200
### Import a downloaded theme
129201

202+
For themes from DreamSkin.cc, prefer [one-click apply](#one-click-apply). The
203+
manual `.zip` path below is the fallback, and covers packs from any other source.
204+
130205
Choose **Import Theme ZIP…** from the macOS menu bar app or Windows tray. Only
131206
ordinary `.zip` files are accepted; the legacy `.dreamskin` extension is not
132207
supported, and renaming the suffix is not a supported migration path. An
@@ -156,8 +231,7 @@ containing `theme.json`, `theme.css`, and its image into the saved-theme folder:
156231
Both controls include **Open Themes Folder**. Reopen the menu/tray after moving
157232
the directory. Do not add another wrapper level, links, nested archives, or an
158233
image-only folder without `theme.json`. Manual placement bypasses the ZIP
159-
importer's archive checks, so use trusted content only. Both controls also link
160-
directly to the DreamSkin.cc Gallery and online Studio.
234+
importer's archive checks, so use trusted content only.
161235

162236
### For developers: run from source
163237

README.md

Lines changed: 75 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,35 @@
1313
一张图,一种心情 · 写代码,也要有氛围感
1414
</p>
1515

16+
<p align="center">
17+
官方主题库:<a href="https://dreamskin.cc"><strong>DreamSkin.cc</strong></a> ·
18+
<a href="https://dreamskin.cc/gallery">主题库 Gallery</a> ·
19+
<a href="https://dreamskin.cc/studio">在线 Studio</a>
20+
</p>
21+
1622
<p align="center">
1723
非 OpenAI 官方产品。不修改 <code>.app</code> / <code>app.asar</code> / WindowsApps。
1824
</p>
1925

26+
## 🤝 独家赞助
27+
28+
<table>
29+
<tr>
30+
<td width="180">
31+
<a href="https://passion8.cc/sign-up?aff=ZgLT"><img src="docs/images/sponsor-passion8.png" alt="Passion8" width="150"></a>
32+
</td>
33+
<td>
34+
感谢 Passion8 独家赞助本项目!Passion8 是一家面向开发者的 AI API 中转服务商,为个人开发者与团队提供稳定、低成本的主流大模型接入。<br><br>
35+
<strong>满血 AI · 触手可及</strong>:OpenAI、Claude 全系列原版模型,无降智、无套壳;使用前沿 AI 模型仅需官方价格的一小部分,充值 1:1,<strong>1$ = 1¥</strong>。保留原有官方 SDK,只把 Base URL 换成 Passion8,Claude Code、Codex、Grok 以及任意 OpenAI 兼容客户端都能直接跑——一行配置,代码不用改。<br><br>
36+
<strong>全球节点加速</strong>:Cloudflare 全球边缘 + 多线路 BBR 加速,低延迟、高可用、稳定如一;7×24 稳定中转,99.9% SLA,首 Token 目标 1 秒内。<br><br>
37+
<strong>安全可靠</strong>:独立 API Key、密钥加密存储、全链路 HTTPS,隐私优先。<br><br>
38+
Passion8 为本项目用户准备了专属福利:通过<a href="https://passion8.cc/sign-up?aff=ZgLT">此链接</a>注册,首次充值自动赠送 10% 额度,无需申请,30 分钟内到账。有问题联系 <a href="mailto:support@passion8.cc">support@passion8.cc</a>。
39+
</td>
40+
</tr>
41+
</table>
42+
43+
<sub>换肤与 API 配置互相独立,本项目不会自动改写你的模型供应商设置。</sub>
44+
2045
## 直接安装
2146

2247
普通用户只需先安装并退出一次官方 Codex / ChatGPT,然后从
@@ -28,30 +53,65 @@
2853
不需要 clone 源码、安装 Node.js 或手动运行 `.sh` / `.ps1`。首次未签名放行、更新和卸载步骤见
2954
[macOS 安装说明](./docs/install-macos.md) / [Windows 安装说明](./docs/install-windows.md)
3055

31-
## 赞助商
56+
## 主题库与社区
3257

3358
<p align="center">
34-
<a href="https://passion8.cc/register?aff=TuPe">
35-
<img src="docs/images/sponsor-passion8.png" alt="Passion8" height="72">
59+
<a href="https://dreamskin.cc">
60+
<img src="docs/images/dreamskin-mark.svg" alt="DreamSkin.cc" height="88">
3661
</a>
3762
</p>
3863

3964
<p align="center">
40-
<strong>更智能的连接 · 更热爱的创造</strong><br>
41-
<sub>热爱驱动 · 无限可能 · Connect AI · Power Creation</sub>
65+
<strong>DreamSkin.cc</strong> · 本项目的官方主题库与创作平台<br>
66+
<sub>Make your workspace <em>yours.</em></sub>
4267
</p>
4368

4469
<p align="center">
45-
感谢 <a href="https://passion8.cc/register?aff=TuPe"><strong>passion8.cc</strong></a> 赞助本项目。<br>
46-
满血 AI 中转:官方模型直连,无降智、无套壳;一行配置接入 Codex / Claude Code / Grok。
70+
<a href="https://dreamskin.cc/gallery"><strong>浏览主题库 →</strong></a>
71+
&nbsp;·&nbsp;
72+
<a href="https://dreamskin.cc/studio"><strong>在线 Studio →</strong></a>
73+
</p>
74+
75+
- [**主题库 Gallery**](https://dreamskin.cc/gallery):浏览社区已审核的主题,支持最新 / 热门排序和创作者榜单。
76+
每套主题都能先在网页里的桌面模拟器中试穿,再决定装不装。
77+
78+
<p align="center">
79+
<a href="https://dreamskin.cc/gallery">
80+
<img src="docs/images/site-tryon-zh.webp" alt="在 DreamSkin.cc 的桌面模拟器里试穿社区主题「晨雾山水」" width="900">
81+
</a><br>
82+
<sub>社区主题「晨雾山水」的在线试穿 · 首页/任务页、宽窄窗口、侧栏展开收起都能当场切,满意了再一键换肤或下载主题包</sub>
4783
</p>
4884

85+
- [**在线 Studio**](https://dreamskin.cc/studio):在浏览器里换背景图、调主题色、写 Safe CSS,导出 `.zip` 主题包,
86+
也可以直接投稿到主题库(需登录,经人工审核后公开)。
87+
4988
<p align="center">
50-
<sub>
51-
换肤与 API 配置互相独立,本项目不会自动改写你的模型供应商设置。
52-
</sub>
89+
<a href="https://dreamskin.cc/studio">
90+
<img src="docs/images/site-studio-zh.webp" alt="在 DreamSkin.cc 在线 Studio 里编辑社区主题「月下松岚」" width="900">
91+
</a><br>
92+
<sub>在线 Studio · 左侧实时预览,右侧调背景图、外观焦点与配色;主题库里任意一套主题都能一键载入继续改</sub>
5393
</p>
5494

95+
macOS 菜单栏和 Windows 托盘都有「主题库 Gallery」和「在线 Studio」入口,可以直接打开。
96+
97+
### 一键换肤
98+
99+
在 DreamSkin.cc 上看到喜欢的主题,点「一键换肤」就能让本机客户端直接装上,不用先下载再手动导入。
100+
需要 v1.5.0 或更新的客户端(建议 v1.5.5 及以上)。
101+
102+
流程与安全边界:
103+
104+
- 网页通过 `dreamskin://apply?version=ver_...` 唤起本机 App。链接只能携带一个主题版本 ID,**不能**携带
105+
任意 URL、文件路径或命令,也不存在静默应用参数。
106+
- App 只向固定的官方 API 取包,并拒绝重定向。
107+
- 换肤前弹出原生确认框,并核对该版本的审核状态、一键兼容标记、版本号、包大小、实际下载字节数和 SHA-256。
108+
- 通过后复用与手动导入完全相同的 ZIP、manifest、图片与 Safe CSS 校验。
109+
- 只有真实渲染进程确认新主题已生效才算成功。启动或渲染失败会自动尝试恢复换肤前的主题,恢复结果
110+
同样要经过可见性验证;无法确认时会明确报告状态未确认,而不是假装已恢复。
111+
112+
只有完整满足当前主题包契约(背景图 + `theme.json` + 非空 `theme.css` + 声明 `safe-css` 能力)的主题
113+
才会显示一键换肤按钮;不满足的走下面的手动导入。
114+
55115
## 实测精选预设
56116

57117
### Gothic Void Crusade / 哥特虚空远征
@@ -91,6 +151,7 @@
91151
- **真背景层**:一张 16:9 纯壁纸连续铺满整窗,首页突出氛围,任务页自动降低干扰
92152
- **可换图**:换一张喜欢的纯背景,自适应焦点、安全区和配色后变成你的主题
93153
- **可存主题**:macOS 菜单栏与 Windows 系统托盘都能保存/切换本地主题
154+
- **一键换肤**:在 [DreamSkin.cc](https://dreamskin.cc) 上点一下,客户端核对来源与校验和后直接装上
94155
- **可导入主题包**:两端都可直接选择普通 `.zip`,安全校验后加入本地主题库
95156
- **可恢复**:一键还原官方外观
96157
- **相对安全**:本机回环 CDP 注入,不改官方二进制与签名
@@ -113,6 +174,9 @@
113174

114175
### 导入下载的主题
115176

177+
从 DreamSkin.cc 装主题优先用[一键换肤](#一键换肤)。下面是手动导入 `.zip` 的兜底路径,也适用于任何
178+
其他来源的主题包。
179+
116180
在 macOS 菜单栏选择“导入主题 ZIP…”,或在 Windows 托盘选择同名菜单。只支持普通 `.zip`
117181
不支持 `.dreamskin` 后缀,也不要仅改后缀伪装。正式 Studio 主题包包含 `manifest.json`
118182
`theme.json`、非空 `theme.css` 和恰好一张 `background.webp|jpg|png`;还可包含 `LICENSE.txt` 和预留的
@@ -132,8 +196,7 @@
132196

133197
菜单里有“打开主题文件夹”快捷入口。移动后重新打开菜单/托盘即可;不要再套一层目录,也不要放链接、
134198
嵌套压缩包或缺少三件套的文件夹。手动目录不会经过 ZIP 导入器的归档校验,请只使用可信内容。升级前
135-
已经保存且没有 CSS 的 legacy 主题仍可切换,但不会注入额外 CSS。两端菜单也可直接打开 DreamSkin.cc
136-
的“主题库 Gallery”和“在线 Studio”。
199+
已经保存且没有 CSS 的 legacy 主题仍可切换,但不会注入额外 CSS。
137200

138201
### 开发者:从源码运行
139202

docs/images/dreamskin-mark.svg

Lines changed: 12 additions & 0 deletions
Loading

docs/images/site-studio-en.webp

69.7 KB
Loading

docs/images/site-studio-zh.webp

65.3 KB
Loading

docs/images/site-tryon-en.webp

72.3 KB
Loading

docs/images/site-tryon-zh.webp

68.7 KB
Loading

0 commit comments

Comments
 (0)