Agent Skills › sdbds/Codex-QingLong-Skin

sdbds/Codex-QingLong-Skin

GitHub

用于在macOS上安装、自定义、验证和恢复Codex Dream Skin Studio，将个人图片转为Codex横幅与任务背景。提供安全的CDP主题故障排除与回滚，严格保护原生界面完整性与安全签名。

2 个 Skill 4

GitHub

安装全部 Skills

npx skills add sdbds/Codex-QingLong-Skin --all -g -y

更多选项

预览集合内 Skills

npx skills add sdbds/Codex-QingLong-Skin --list

集合内 Skills (2)

codex-dream-skin-studio

用户希望将个人图片转换为Codex应用的横幅或任务背景需要修复或回滚Codex的自定义主题以恢复官方外观遇到CDP注入导致的界面异常或安全校验问题

macos/SKILL.md

查看 Skill 详情 ›

npx skills add sdbds/Codex-QingLong-Skin --skill codex-dream-skin-studio -g -y

SKILL.md

Frontmatter

{
    "name": "codex-dream-skin-studio",
    "description": "Install, customize, launch, verify, repair, update, or restore Codex Dream Skin Studio on macOS. Use when a user wants to turn a personal image into a Codex banner and task background while preserving the native interface, or needs safe CDP theme troubleshooting and rollback.",
    "compatibility": "macOS, official Codex Desktop app, signed bundled Node.js 20 or newer"
}

Codex Dream Skin Studio

This file is an optional Codex capability entry. The delivery is a complete standalone project; users do not need to install it as a Skill.

Workflow

Run Install Codex Dream Skin.command from the complete project folder.
Run Customize Codex Dream Skin.command, choose an image in Finder, and enter a theme name.
Verify the live result with Verify Codex Dream Skin.command. A pass requires a visible native sidebar and composer, no horizontal overflow, non-interactive decoration, and—on the home route—a real banner, native cards, and project selector.
Restore the official appearance with Restore Codex Dream Skin.command.

Guardrails

Never modify the official .app, app.asar, or its code signature.
Use the official Codex app's signed Node.js runtime only after validating its signature, Team ID, architecture, and minimum version.
Bind CDP to loopback, verify that the listener belongs to Codex, and reject non-Codex renderer targets.
Preserve all native cards, navigation, project selectors, task content, composer controls, and keyboard focus.
Keep decoration at pointer-events: none.
Require explicit authorization before restarting an already-running Codex instance.
Stop an injector only when its recorded PID, executable, command line, and start time all match.

Key resources

README.md: user installation and customization guide.
scripts/injector.mjs: CDP connection, injection, removal, verification, and screenshots.
assets/dream-skin.css: live native interface styling.
assets/renderer-inject.js: idempotent DOM integration and cleanup.
scripts/doctor-macos.sh: signed-runtime, payload, and optional live-session self-check.
references/qa-inventory.md: release and visual acceptance criteria.

codex-dream-skin

为Windows版Codex应用通过CDP注入可逆装饰皮肤。支持安装、启动、验证及安全回滚，不修改系统文件。适用于更换主题、青龙宫阙界面或更新后恢复皮肤等场景。

用户请求Codex深度自定义主题或青龙宫阙界面 Codex更新后需要重新应用或恢复皮肤

windows/SKILL.md

查看 Skill 详情 ›

npx skills add sdbds/Codex-QingLong-Skin --skill codex-dream-skin -g -y

SKILL.md

Frontmatter

{
    "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 deep-jade \"青龙宫阙\"\/QingLong interface, needs the skin reapplied after a Codex update, or needs a safe rollback without modifying WindowsApps or app.asar."
}

Codex Dream Skin

Apply a reversible renderer skin through Chromium DevTools Protocol while launching the official Store-installed Codex executable. The launcher supports both the stable OpenAI.Codex package and OpenAI.CodexBeta by reading the executable path from AppxManifest.xml. Never replace or take ownership of files under WindowsApps.

Workflow

Run scripts/install-dream-skin.ps1 once to set the matching official base colors and create launch/restore shortcuts.
Run scripts/start-dream-skin.ps1. Add -RestartExisting only when the user authorized restarting an already-open Codex app.
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.
Inspect the screenshot against references/qa-inventory.md. Verify both the home screen and a normal task before signing off.
Run scripts/restore-dream-skin.ps1 for live removal. Add -Uninstall to delete shortcuts; add -RestoreBaseTheme when the user also wants the pre-install config backup restored.

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 stable or Beta Appx packages and their current executable dynamically.
If port 9335 is occupied, choose another port consistently for start, verify, and restore.
Keep the injection daemon running for navigation/reload resilience. Its state and logs live under %LOCALAPPDATA%\CodexDreamSkin.

Resources

scripts/codex-app.ps1: stable/Beta Appx discovery and manifest-based executable resolution.
scripts/injector.mjs: CDP connection, renderer injection, verification, screenshot, and removal.
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.