AGENT SKILL

codex-dream-skin

Apply, launch, verify, repair, update, or restore a full decorative skin for the Windows Codex desktop app. Use when the user asks for a Codex theme that goes beyond official color settings, wants the pink-purple Dream/Fiona-style interface, needs the skin reapplied after a Codex update, or needs a safe rollback without modifying WindowsApps or app.asar.

License 许可
MIT
最近更新
2026-11-03
Stars
★ 1
Forks
0

01 前言 Front Matter

name
codex-dream-skin
description
Apply, launch, verify, repair, update, or restore a full decorative skin for the Windows Codex desktop app. Use when the user asks for a Codex theme that goes beyond official color settings, wants the pink-purple Dream/Fiona-style interface, needs the skin reapplied after a Codex update, or needs a safe rollback without modifying WindowsApps or app.asar.

02 资源文件 15

03 SKILL.md 正文

Codex Dream Skin

Apply a reversible renderer skin through Chromium DevTools Protocol while launching the official Store-installed Codex executable. Never replace or take ownership of files under WindowsApps.

Workflow

  1. Install Node.js 22 or newer, close Codex, then run scripts/install-dream-skin.ps1 once to set the matching official base colors and create launch/restore shortcuts.
  2. Run scripts/start-dream-skin.ps1. The shortcut asks before restarting an already-open Codex app; CLI callers must explicitly add -RestartExisting.
  3. Run scripts/verify-dream-skin.ps1 -ScreenshotPath <absolute-path> after launch. Treat a missing hero, native composer, sidebar skin, or injection marker as failure. The native suggestion count is responsive and may be two to four.
  4. Inspect the screenshot against references/qa-inventory.md. Verify both the home screen and a normal task before signing off.
  5. Run scripts/restore-dream-skin.ps1 to remove the live skin, close the saved CDP session, and reopen Codex normally. Add -RestoreBaseTheme to restore only saved appearance keys, -RecoverConfigBackup for explicit byte-for-byte recovery of a damaged config, or -Uninstall to delete shortcuts. A completed config restore archives that install's backup so a later install captures a fresh baseline.

Guardrails

  • Preserve the official executable, package signature, user threads, pets, plugins, and authentication state.
  • Do not use the full reference screenshot as a fake whole-window overlay. It is only a cropped hero/polaroid asset; all controls remain live Codex controls.
  • Keep the reference image confined to the single top banner and decorative crop. Keep the cards below it as native Codex suggestion buttons with native labels/icons.
  • Attach the "选择项目" treatment to Codex's real project-selector toolbar and keep the current project button clickable; never draw a disconnected replacement.
  • Keep decorative layers pointer-events: none and keep real buttons, navigation, and composer above them.
  • On app updates, rerun install and launch; the scripts discover the current Appx package dynamically. Saved paths are never trusted for process control unless they still match a registered package identity.
  • The default launcher scans for a free port when 9335 is occupied. An explicitly requested occupied port fails closed.
  • Keep the injection daemon running for navigation/reload resilience. Its state and logs live under %LOCALAPPDATA%\CodexDreamSkin.
  • CDP targets must use a same-port loopback WebSocket, belong to the current Store package, retain the launch-time Browser ID, and expose expected Codex renderer markers.
  • Loopback prevents LAN exposure, but Chromium CDP has no same-user authentication. Run only trusted local software while the skin is active, and use restore to close the debug session when it is no longer needed.
  • Preserve config.toml as strict UTF-8. Never use encoding-dependent whole-file PowerShell reads/writes, silently transcode UTF-16, or overwrite a file that changed after it was read. Ambiguous TOML shapes must fail before writing rather than receive a best-effort rewrite.
  • Keep install/start/restore/verify serialized with the per-user operation lock in common-windows.ps1.

Checks

powershell -NoProfile -File tests\run-tests.ps1
node --check scripts\injector.mjs
node --check assets\renderer-inject.js

Resources

  • scripts/injector.mjs: CDP connection, renderer injection, verification, screenshot, and removal.
  • scripts/common-windows.ps1: Store-package discovery, Node validation, port ownership, state, and process identity safety.
  • scripts/config-utf8.ps1: atomic UTF-8 configuration backup, selective restore, and explicit recovery.
  • assets/dream-skin.css: full visual layer.
  • assets/renderer-inject.js: idempotent DOM integration and cleanup.
  • assets/dream-reference.png: user-provided visual reference used only in cropped decorative regions.
  • references/qa-inventory.md: required functional and visual signoff coverage.
  • references/runtime-notes.md: troubleshooting and update behavior.
  • tests/run-tests.ps1: configuration, state, recovery, payload, and CDP validation regression checks.

04 同仓库更多 Skills

siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

x-article-draft-uploader

把本地 Markdown 转为经核验的 X Articles 新草稿。适用于需要保留首图封面、正文图片相对位置,并在独立 Playwright 会话中复用用户已授权 Chrome 登录态的任务;不负责公开发布。

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wecom-operations

通过用户已配置的官方 wecom-cli 管理企业微信文档、智能文档、待办、会议和日程。适合创建或查询这些云端对象、把本地 Markdown 转为智能文档,以及在明确确认后更新或取消对象;不发送消息、不控制桌面客户端。

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wecom-local-vault

Inspect authorized local WeCom databases on macOS, create private plaintext snapshots, and query or export contacts, conversations, and messages without modifying the source account store. Use when the user asks to parse 企业微信/WeCom local data, recover a private database snapshot, inspect local contacts or sessions, search chat history, or export a bounded conversation.

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wechat-reading

Read and analyze WeRead/微信读书 search results, book metadata, bookshelf entries, progress, notes, highlights, public reviews, recommendations, and reading statistics through the official read-only Agent Gateway. Use for WeRead account questions or exports; do not imply that the current Gateway can add, remove, upload, rate, like, or edit content.

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wechat-mp-batch-exporter

Build a bounded, private archive from known WeChat Official Account article URLs or an owner-authorized account-history export, with explicit reconciliation of article, publish-group, and platform-marked-original counts. Use for batch body capture, history normalization, or enhanced metrics/comments workflows. Do not use for a one-page summary or to automate the WeChat client.

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wechat-local-vault

在 macOS 本机建立并查询私有微信数据快照。适用于盘点数据库、离线校验已有密钥候选、创建全量或增量明文快照、查会话与联系人、按时间检索消息、导出指定聊天、查看朋友圈或收藏,以及准备群聊摘要素材。所有查询只读,默认隐藏内部账号标识,不操控微信界面,也不发送任何内容。

★ 1