Skip to content

Awesome Codex Theme v0.3.0-alpha.3: Full Skin Apply Repair

Choose a tag to compare

View all tags
@github-actions github-actions released this 20 Jul 19:18
v0.3.0-alpha.3
1cc9904

Awesome Codex Theme v0.3.0-alpha.3: Full Skin Apply Repair

Beta / 测试版。 This release fixes the Full Skin launch path and is the
first release with unambiguous Windows, Apple Silicon, and Intel download
names. / 此版本修复完整皮肤的启动路径，并首次清楚区分 Windows、Apple
Silicon 和 Intel 下载文件。

English

What changed

  • Fixed a Windows Full Skin false-success path. Store-package activation could
    discard the loopback debugging flags, leaving Theme Manager unable to inject
    the selected skin into the new Codex session. Theme Manager now launches
    only the exact executable discovered from the selected Store package, checks
    that it belongs to that package, and forwards only these local flags:

    --remote-debugging-address=127.0.0.1
--remote-debugging-port=<temporary OS-selected port>

  • Made the early Full Skin runtime wait until document.body exists and made
    cleanup tolerate a renderer navigation that has already discarded an old
    early-script registration.

  • Added macOS traffic-light window controls on the left; the Theme Manager no
    longer presents Windows-style controls in the upper-right on macOS.

  • Made the Copy Native action shorter so it does not overlap the theme preview
    in compact windows.

  • Release assets now explicitly identify Windows x64, macOS Apple
    Silicon    , and macOS Intel.

Verified before release

On Windows, an isolated ChatGPT Beta 26.715.3651.0 Full Skin test applied
qinglan-odyssey in dark mode, read back the theme ID, root marker, style, and
caption, then restored the native state successfully. The test used the
release-build Theme Manager and did not modify Codex application files,
app.asar, conversations, or private data.

This does not claim that a physical Mac Full Skin install/apply/restore
test has already passed. The Apple Silicon and Intel DMGs are built and
structure-checked in CI; physical-Mac verification remains a separate Beta
test step.

Choose the correct download

Your computer Choose this official Release asset
Windows 10/11 (64-bit) File name containing Windows-x64 and setup.exe
Mac with Apple Silicon (M1/M2/M3/M4) File name containing macOS-Apple-Silicon and .dmg
Mac with an Intel processor File name containing macOS-Intel and .dmg

Download only from this repository's GitHub Release. Do not use mirrors or
rename an asset to make it look compatible with another architecture.

Install and verify Full Skin

  1. Install the Theme Manager. On macOS, drag it to Applications before
    opening it; do not run the app from the mounted DMG.
  2. Open Theme Manager, choose a theme, light/dark mode, and the intended Codex
    target.
  3. Quit that Codex target completely first. Theme Manager intentionally
    does not silently terminate an ordinary user session.
  4. Select Apply Full Skin. It starts one controlled, loopback-only session
    and applies the verified background, materials, colors, and theme copy.
  5. Confirm the background and controls render normally, then choose
    Restore native. Quit and reopen Codex normally to confirm no style is
    left behind.

If it fails, include the Theme Manager version, operating system and CPU,
selected Codex channel/version, and the exact diagnostic message in a GitHub
issue. Do not edit Codex files or disable system security protections.

Updates and trust boundary

  • Theme updates: use Theme Manager's catalog refresh. New verified themes
    do not require reinstalling the desktop app.
  • App updates: use the in-app updater after it offers a signed update and
    asks for confirmation.
  • This Beta has a Tauri updater signature and macOS ad-hoc bundle signature.
    It does not yet have Windows Authenticode, Apple Developer ID signing, or
    Apple notarization. Windows SmartScreen or macOS Gatekeeper may therefore
    show an unknown-publisher warning. Review the repository and asset first;
    never disable SmartScreen or Gatekeeper globally.

中文说明

本次修复

  • 修复 Windows 完整皮肤可能“显示成功、实际未应用”的路径。此前 Store 包激活有
    可能丢失本机调试参数，导致 Theme Manager 无法向新启动的 Codex 会话注入主题。
    现在只会启动从所选 Store 包中发现并核验过的准确可执行文件，且只传入本机回环
    调试参数。
  • 完整皮肤运行时会等待 document.body 就绪；如果页面导航已经丢弃旧的早期脚本，
    恢复流程会继续清理可见状态，而不会误报失败。
  • macOS Theme Manager 使用左上角红黄绿窗口按钮，不再使用右上角 Windows 风格按钮。
  • 紧凑窗口中的“复制 Native”操作卡片已缩短，不会遮挡主题预览。
  • Release 文件名明确区分 Windows x64、macOS Apple Silicon 和
    macOS Intel。

发布前验证结果

在 Windows 上，使用隔离的 ChatGPT Beta 26.715.3651.0 和 Release 构建的
Theme Manager，已成功应用 qinglan-odyssey 暗色完整皮肤，读回主题 ID、根标记、
样式与标题标记，并成功恢复原生状态。整个流程不修改 Codex 应用文件、app.asar、
聊天记录或私有数据。

这不等于已经完成真实 Mac 上的安装、应用与恢复验证。Apple Silicon 和 Intel DMG
会在 CI 中完成构建和结构检查；真实 Mac 验证仍是本 Beta 的独立测试步骤。

下载选择

你的设备 下载此 Release 文件
Windows 10/11（64 位） 文件名含 Windows-x64 且以 setup.exe 结尾
Apple Silicon Mac（M1/M2/M3/M4） 文件名含 macOS-Apple-Silicon 且以 .dmg 结尾
Intel Mac 文件名含 macOS-Intel 且以 .dmg 结尾

请只从本仓库 GitHub Release 下载，不要使用第三方镜像，也不要通过改文件名来跨架构安装。

安装与验证完整皮肤

  1. 安装 Theme Manager。macOS 必须先拖入 Applications，不要从已挂载的 DMG
    直接运行。
  2. 打开 Theme Manager，选择主题、明暗模式和目标 Codex。
  3. 先完全退出该 Codex 目标。 Theme Manager 不会静默强制结束普通用户会话。
  4. 点击 应用完整皮肤。它会启动一个受控的仅本机回环会话，并应用经过验证的
    背景、材质、颜色和主题文字。
  5. 确认背景和控件显示正常后，点击 恢复原生；随后正常退出并重新打开 Codex，
    确认没有残留样式。

如仍失败，请在 GitHub Issue 中附上 Theme Manager 版本、操作系统与 CPU、所选 Codex
渠道/版本和完整报错信息。不要修改 Codex 文件，也不要关闭系统安全保护。

更新与信任边界

  • 主题更新： 在 Theme Manager 中刷新主题目录即可；新增已验证主题不需要重装应用。
  • 应用更新： 等待内置更新器发现并提示后，由用户确认安装。
  • 本 Beta 使用 Tauri updater 签名和 macOS ad-hoc 包完整性签名；暂未提供 Windows
    Authenticode、Apple Developer ID 或 Apple notarization。因此 SmartScreen 或
    Gatekeeper 仍可能显示未知发布者提示。请先确认仓库与文件来源，绝不要全局关闭
    SmartScreen 或 Gatekeeper。
Assets 11
Loading