- 中文 · English
+ Themes, image wallpapers, and live wallpapers for the Codex desktop app.
+ Keep the native sidebar, tasks, project picker, and composer. Never patch the official app package.
-> This repository is an enhanced derivative of [Fei-Away/Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin) and preserves its full upstream history. Its current focus is compatibility with recent Windows Codex DOM, sidebar, and system-tray behavior.
-
- Give Codex a face that breathes.
- External themes for the Codex desktop app · Local CDP inject · No official package mutation
+ 中文 · English
- One image, one mood · Code with atmosphere
+
+
+
+
- Unofficial. Does not modify .app / app.asar / WindowsApps.
+
- Smarter Connections · Passionate Creation
- Connect AI · Power Creation
-
+> Unofficial and not affiliated with OpenAI. Codex Dream Skin injects themes through loopback-only `127.0.0.1` CDP. It does not modify WindowsApps, `.app`, `app.asar`, or the official code signature.
-
- Thanks to passion8.cc for sponsoring this project.
- Full-power AI gateway: official models, no silent downgrades, no wrapper shells.
- One-line setup for Codex / Claude Code / Grok.
-
+## Why use it
-
-
- Theme install and API config stay separate — this project never rewrites your provider settings.
-
-
+- **The native UI stays interactive** — This is not a fake screenshot over the window. Sidebar, chat, tasks, and composer continue to work.
+- **Live wallpapers inside Codex** — Windows supports muted, looping local MP4/WebM backgrounds. It does not change your desktop wallpaper.
+- **One Windows manager** — Browse, search, preview, and switch wallpapers; control reveal; pause the skin; or restore the stock appearance.
+- **Turn images into themes** — Import PNG, JPEG, or WebP artwork and keep full-window composition readable.
+- **Reversible and auditable** — No official binary patching. Stop injection and return to the stock Codex appearance at any time.
+- **Windows and macOS** — Windows ships a self-contained EXE; macOS ships a menu-bar Studio and installation scripts.
-## Tested featured preset: Arina Hashimoto
+## Windows: start in 30 seconds
-“Arina Hashimoto / 桥本有菜” has been verified on the real Codex home screen in
-both light and dark appearances. The user-provided source PNG is `1672 × 941`;
-the preset's `2560 × 1440` JPEG is a standardized derived export that preserves
-the source's near-16:9 composition and does not add source detail. The sidebar,
-cards, project picker, and composer
-shown below are native Codex controls.
+1. Download [`CodexDreamSkinManager.exe`](https://github.com/CCDawn/Codex-Dream-Skin-Enhanced/releases/latest/download/CodexDreamSkinManager.exe).
+2. Run it and select a PNG, JPEG, WebP, MP4, or WebM from your wallpaper library.
+3. Click **应用到 Codex**. Use **启动 / 重新应用** if Codex needs the skin reapplied.
-
-
- Light · real injected screenshot; unsent input hidden during capture (preview only)
-
+The manager is a self-contained single-file app with the tested Dream Skin engine and Node.js runtime embedded. End users do not need the .NET SDK, Node.js, or manual PowerShell commands.
-
-
- Dark · real injected screenshot; unsent input hidden during capture (preview only)
-
+> Releases are currently unsigned, so Windows may show an unknown-publisher prompt. Download only from this repository's [Releases](https://github.com/CCDawn/Codex-Dream-Skin-Enhanced/releases) page and verify the companion `.sha256` file.
+
+### Wallpaper reveal
+
+The right-side slider controls the relationship between the theme veil and the wallpaper:
+
+- `100%` shows the original image/video with the page-wide veil reduced to zero.
+- Lower values increase text-area and theme treatment visibility for busy backgrounds or task pages.
+
+## macOS installation
+
+Open [`macos/`](./macos/) and double-click:
-Install from the repo and switch in one command on macOS:
+```text
+Install Codex Dream Skin.command
+```
+
+Or run:
```bash
cd macos
-./scripts/install-dream-skin-macos.sh --no-launch
-~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
- --id preset-romantic-rose
+./scripts/install-dream-skin-macos.sh
+```
+
+Use the menu-bar Studio to import, save, and switch image themes. See [`macos/README.md`](./macos/README.md) for the full guide.
+
+## Feature matrix
+
+| Feature | Windows | macOS |
+|---|:---:|:---:|
+| PNG / JPEG / WebP image themes | ✅ | ✅ |
+| MP4 / WebM live wallpapers | ✅ | — |
+| Graphical theme manager | ✅ Standalone EXE | ✅ Menu-bar Studio |
+| Wallpaper search and preview | ✅ | ✅ |
+| Save and switch themes | ✅ | ✅ |
+| Wallpaper reveal control | ✅ | — |
+| Pause injection / restore stock appearance | ✅ | ✅ |
+| Modifies official app files | **Never** | **Never** |
+
+## Real results
+
+| Windows / shared theme | macOS dark theme |
+|---|---|
+|  |  |
+
+See [`docs/showcase.en.md`](./docs/showcase.en.md) for more real screenshots, the character preset, and eight concept directions.
+
+## How it works
+
+```text
+Local wallpaper / theme config
+ ↓
+Dream Skin local theme store
+ ↓
+127.0.0.1 loopback CDP
+ ↓
+Independent background layer in the Codex renderer
+ ↓
+Native sidebar, tasks, and composer stay interactive
```
-Windows has a persistent local theme store and system-tray controls, and seeds
-the same Arina Hashimoto preset. For the first repo-based setup:
+Windows videos are transferred to the renderer in chunks and assembled into a Blob URL. Players and blobs are released when switching, pausing, or cleaning up. Video pauses automatically while the page is hidden.
+
+## Security boundaries
+
+- CDP binds only to `127.0.0.1`; it is not exposed to your LAN.
+- The project does not modify WindowsApps, `.app`, `app.asar`, or official signatures.
+- It does not read or rewrite API keys, base URLs, model providers, or Codex conversation content.
+- Avoid running untrusted local programs while a debugging port is active; a malicious local process may attempt to access it.
+- Official Codex updates can change the DOM. If a theme stops applying, try **启动 / 重新应用** and check [Issues](https://github.com/CCDawn/Codex-Dream-Skin-Enhanced/issues).
+
+## Run from source and build
+
+### Windows script entry points
```powershell
-powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
-powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1
+powershell.exe -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
+powershell.exe -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1
```
-After launch, switch directly through **已保存主题 → 桥本有菜**; no cross-folder
-manual import is required. The enhanced **更换背景图或视频** action accepts
-PNG/JPEG/WebP artwork and muted looping MP4/WebM video, which can then be saved
-for one-click switching.
+### Build the single-file EXE
-> The downloadable user source is [`docs/images/presets/romantic-rose-source.png`](./docs/images/presets/romantic-rose-source.png) (`1672 × 941`); the macOS one-click preset uses the normalized derived [`background.jpg`](./macos/presets/preset-romantic-rose/background.jpg) (`2560 × 1440`). Do not import either screenshot above: they contain real UI and are previews only. The background is a user-provided AI-generated example, not an official OpenAI/Codex visual or endorsement; confirm likeness and asset rights before redistributing it.
+Requires the .NET 8 SDK and Node.js 22+:
-## Concept gallery (not importable backgrounds)
+```powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\windows\app\build-manager.ps1
+```
-These eight images communicate achievable visual directions, but they are
-interface mockups rather than usable theme backgrounds. Generate a UI-free
-`2560 × 1440` image with the copy-ready [reference prompt guide](./docs/reference-background-prompt-guide.en.md)
-before importing a similar look. See the [concept prompt breakdown](./docs/background-generation-prompts.md)
-for the eight individual styles.
+Output is written to `windows/dist/`. The build runs the Windows regression suite, publishes a self-contained `win-x64` EXE, and executes a post-publish self-test.
-
+No. It controls only the theme background inside Codex. The Windows manager can import ordinary MP4/WebM files, but it does not render Wallpaper Engine Scene, Web, or packaged projects.
+
-
-
- Cyan Virtual Singer
-
+
+Why can an official Codex update break a theme?
-
-
- Stage Black-Gold
-
+Dream Skin depends on the Codex renderer DOM and local CDP. Official updates can move those structures. **启动 / 重新应用** often fixes it; compatibility patches are published in this repository.
+
-## What it does
+
+Can I return to completely stock Codex?
-- **Real UI** — Sidebar, cards, project picker, and input stay native. Not a fake full-window screenshot.
-- **Continuous wallpaper** — One 16:9 image spans the full window; adaptive focus, safe-area, and route treatment keep native content readable.
-- **Swappable art** — Drop in a UI-free image you like and it becomes your theme.
-- **Saved themes** — Switch local themes from the macOS menu bar or Windows system tray.
-- **Restorable** — One-click restore to the stock look.
-- **Safer path** — Local-loopback CDP inject only. No official binary or signature changes.
+Yes. The Windows manager provides **恢复官方外观**, and the macOS Studio includes uninstall/restore actions. No official application package is patched.
+
-## Quick start
+
+Are wallpaper files uploaded?
-Platform scripts are ready — different plumbing, same goal: theme Codex.
+No. Wallpapers and themes stay local, and injection uses only a loopback connection on your machine.
+
-| Platform | Dir | Entry |
-|------|------|------|
-| Apple Silicon / Intel Mac | [`macos/`](./macos/) | Double-click `Install Codex Dream Skin.command` |
-| Windows | [`windows/`](./windows/) | `scripts/install-dream-skin.ps1` → `start-dream-skin.ps1` |
+## Documentation
-More detail:
+- [Windows guide](./windows/README.en.md)
+- [macOS guide](./macos/README.md)
+- [Platform and path map](./docs/platforms.md)
+- [Showcase](./docs/showcase.en.md)
+- [Reference image-generation prompts](./docs/reference-background-prompt-guide.en.md)
+- [Concept prompt breakdown](./docs/background-generation-prompts.md)
+- [Project notes](./docs/PROJECT.md)
-- Mac: [`macos/README.md`](./macos/README.md)
-- Windows: [`windows/SKILL.md`](./windows/SKILL.md)
-- Paths: [`docs/platforms.md`](./docs/platforms.md)
-- Copy-ready reference prompt guide: [`docs/reference-background-prompt-guide.en.md`](./docs/reference-background-prompt-guide.en.md)
-- Eight concept prompt breakdowns: [`docs/background-generation-prompts.md`](./docs/background-generation-prompts.md)
-- Project notes: [`docs/PROJECT.md`](./docs/PROJECT.md)
+## Sponsor
+
+
-## Feedback & contributions
+Thanks to [passion8.cc](https://passion8.cc/register?aff=TuPe) for sponsoring this project. Theme installation and API configuration remain separate; this project never rewrites model-provider settings.
-- **Issues:** Use the [issue templates](./.github/ISSUE_TEMPLATE/) (bug / feature). Blank issues are disabled. Please try Verify / Restore self-checks before filing bugs.
-- **PRs:** Follow the [PR template](./.github/pull_request_template.md) — describe the change and tick the self-checks you actually ran (e.g. `macos/tests/run-tests.sh`, verify / restore).
+## Feedback and contributions
-## Safety
+- Use the [Bug / Feature issue templates](./.github/ISSUE_TEMPLATE/).
+- PRs should include the platform, reproduction or goal, validation command, and restore test.
+- Contribution guide: [中文](./.github/CONTRIBUTING.md) · [English](./.github/CONTRIBUTING.en.md)
-- CDP binds `127.0.0.1` only — avoid untrusted local processes while the theme runs.
-- Does not touch the official install directory or code signature.
-- **Never** rewrites API Key / Base URL; relay and theme stay separate.
+This repository is an enhanced derivative of [Fei-Away/Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin) and preserves the full upstream history.
-## License
+## License and trademark notice
-- See [`macos/LICENSE`](./macos/LICENSE) (MIT) and [`macos/NOTICE.md`](./macos/NOTICE.md)
-- Unofficial; Codex and related rights belong to their owners.
-- People / IP material in bundled presets and previews is illustrative only — clear likeness, asset, and trademark rights before commercial redistribution.
+[MIT License](./LICENSE). Not affiliated with OpenAI. Codex and related trademarks belong to their respective owners. Character/IP assets in presets and previews are examples only; confirm likeness, asset, and trademark rights before redistribution.
---
-Star it, pick a look, and make Codex yours for today.
+If Dream Skin makes Codex feel more like your own workspace, consider leaving a **Star** and sharing a screenshot of your theme.
diff --git a/README.md b/README.md
index 2435ad5..292dab8 100644
--- a/README.md
+++ b/README.md
@@ -1,171 +1,212 @@
-# Codex Dream Skin
+
Codex Dream Skin
- 中文 · English
+ 给 Codex 桌面端换上主题、静态壁纸和动态壁纸。
+ 保留原生侧栏、任务、项目选择器与输入框，不修改官方安装包。
-> 本仓库是 [Fei-Away/Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin) 的增强派生版本，保留完整上游历史；当前重点维护新版 Windows Codex 的 DOM、边栏与系统托盘兼容性。
-
+
+## Tested character preset: Arina Hashimoto
+
+The “Arina Hashimoto / 桥本有菜” preset has been tested on the real Codex home screen in both light and dark appearances. The user-provided source PNG is `1672 × 941`; the preset's `2560 × 1440` JPEG is a standardized derivative that preserves the near-16:9 composition and does not add source detail.
+
+
+
+ Light · real injected screenshot
+
+
+
+
+ Dark · real injected screenshot
+
+
+On Windows, switch through **已保存主题 → 桥本有菜** after installation. On macOS:
+
+```bash
+cd macos
+./scripts/install-dream-skin-macos.sh --no-launch
+~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
+ --id preset-romantic-rose
+```
+
+The user source is [`images/presets/romantic-rose-source.png`](./images/presets/romantic-rose-source.png); the macOS preset uses [`../macos/presets/preset-romantic-rose/background.jpg`](../macos/presets/preset-romantic-rose/background.jpg).
+
+> The screenshots above contain real UI and are previews only. The character background is a user-provided AI-generated example, not an official OpenAI/Codex visual or endorsement. Confirm likeness and asset rights before redistribution.
+
+## Eight concept directions
+
+Generate a UI-free `2560 × 1440` asset with the [reference prompt guide](./reference-background-prompt-guide.en.md). See the [concept prompt breakdown](./background-generation-prompts.md) for all eight directions.
+
+| | |
+|---|---|
+|  |  |
+| Pink Custom | God of Wealth |
+|  |  |
+| Red-White Sci-Fi | Clear Custom |
+|  |  |
+| Inspiration | Purple Night |
+|  |  |
+| Cyan Virtual Singer | Stage Black-Gold |
+
+---
+
+[Download Windows EXE](https://github.com/CCDawn/Codex-Dream-Skin-Enhanced/releases/latest/download/CodexDreamSkinManager.exe) · [Project home](../README.en.md)
diff --git a/docs/showcase.md b/docs/showcase.md
new file mode 100644
index 0000000..b90016c
--- /dev/null
+++ b/docs/showcase.md
@@ -0,0 +1,71 @@
+# Codex Dream Skin 效果展厅
+
+[返回项目首页](../README.md) · [English](./showcase.en.md)
+
+这里收录经过实机验证的主题与概念视觉方向。截图中的侧栏、卡片、项目选择器和输入框均为 Codex 原生控件；概念图包含 UI，不能直接作为背景导入。
+
+## 真实注入效果
+
+### Dream Skin 红白科幻
+
+
+ 
+ 
+ 
-
+ Download Windows EXE
+ ·
+ Install on macOS
+ ·
+ View showcase
+ ·
+ Report an issue
+
+
+
