HeiGe Codex Skin Studio v5.4.5

5.4.5 - 2026-07-19

修复

• 修复顶部「皮肤常驻」开启慢/假等待：菜单 HTTP 超时由 3s 提到 15s（与主题保存一致），业务错误（含 BACKGROUND_START_FAILED 补偿关闭）立刻告警，不再误排队 CDP 兜底；CDP 兜底超时收至 20s。
• 修复 Windows 开启常驻时前后台抢锁出现 LOCK_MALFORMED（staging 缺 owner.json）导致开启被补偿回关：锁获取对 LOCK_MALFORMED / 瞬时 LOCK_PERMISSIONS 做有界重试，清理并发 staging 时跳过未写完的目录，并显式传递 AppIdentityToken。
• 修复提升权限会话下计划任务 RunLevel=Limited 与 High IL 锁目录冲突导致的 LOCK_PERMISSIONS / BACKGROUND_START_FAILED：注册进程若已提升，控制器任务改为 Highest；Windows 握手等待放宽到 35s。
• 合入 Windows 常驻重启接管：用户正常启动不带 CDP 的 Codex 时，后台控制器会安全退出并以 CDP 重新拉起再注入（独立版/可开 CDP 环境；Store 屏蔽 9341 仍属环境限制）。restart-into-cdp 改为附着等待完成并回传错误，避免 detached 子进程脱离交互会话后静默失败。
• 修复 Windows 常驻任务 Stop-ScheduledTask 后 Start-Process 拉起的 Node 变孤儿、叠成双后台并写旧 handshake 的问题：启停/注销前按 task-name + state-directory 精确杀掉残留 --background 控制器；握手等待在「字段不匹配且 PID 已死」时清掉陈旧文档再继续等。

性能

• 保留 5.4.4 的空闲健康巡检 10s；有 relaunch/注入/renderer 控制请求等交互时改用 1s 节拍，避免 CDP 兜底最坏多等一整拍。

测试

• 新增常驻超时阈值、业务失败不排队 CDP、双节拍、锁重试与 Windows 握手 35s 等回归断言。
• 新增 Windows 孤儿后台控制器精确清理、启停顺序（stop→orphan→start）与握手清陈旧死 PID 文档等回归断言。

HeiGe Codex Skin Studio v5.4.1

HeiGe Codex Skin Studio v5.4.1

新功能

• 新增 apply.command --restart 强制重启入口：先正常退出 Codex 再拉起注入，用于长时间运行后整窗帧率骤降（合成器卡死在约 10 帧，与皮肤无关）这类只有冷重启才能恢复的场景。
• 健康会话下直接重跑 apply 保持幂等不重启；退出步骤校验进程身份，绝不强杀，30 秒未退出明确报错。

性能

• 侧栏 PR 状态点隐藏规则从父级反向匹配改为直接命中 svg，移除样式表中唯一的反向失效扫描热点；实测流式输出时皮肤的每 token 样式重算开销从约 +0.57ms 降到约 +0.03ms。
• 新增测试门禁，禁止此类高开销选择器回归。

验证

• Node 全量测试：991 项，985 通过，0 失败，6 项按明确环境门禁跳过。
• macOS 实机验证：健康会话下 apply.command --restart 完成退出、重启、皮肤与主题中心自动回注，重启后合成帧率恢复满帧。
• 重建确定性制品，SHA-256：753acbd2bd91556722a433f9de2c2b0f9337e3f03b2a0df4e00c2dcd01537670。

HeiGe Codex Skin Studio v5.4.0

HeiGe Codex Skin Studio v5.4.0

新增主题

• 新增「龙珠 · 筋斗云」。
• 新增「龙珠 · 超级赛亚人」。
• 内置主题总数从 10 套增加到 12 套。

可读性与性能

• 两个新主题采用浅色半透明阅读表面和深色文字，兼顾复杂背景与 Codex 原生白色信息卡。
• 龙珠双主题的「当前主题」大横幅分别对焦人物脸部，小卡片与顶部圆形入口使用独立脸部特写。
• 修复深色主题在原生白色「环境信息」看板和顶部浅色按钮上的文字对比度，同时保留增删统计语义色。
• 两张主视觉均为 1600×900 WebP，单张低于 180 KB。
• 不增加依赖、监听器、网络请求、后台任务或高斯模糊。
• 阅读增强继续默认开启，且不使用大面积实时高斯模糊。

验证

• Node 全量测试：990 项，984 通过，0 失败，6 项按明确环境门禁跳过。
• 公开发布素材来源门禁：39/39 通过。
• macOS 从正式候选 .skill 安装后，12 套预设均完成真实切换。
• 确定性制品 SHA-256：cabce9f7eb66e5999f92a4f7bf5ddae1b00371f0e255e2bc3e8c18d8fed5d6aa。

已知边界

• Windows 自动化门禁已启动；本次按项目所有者要求未等待整组完成后再合并。
• Microsoft Store/MSIX 真机仍未在当前 Mac 验证。
• 两张新图片由项目所有者提供并确认公开发布，第三方角色形象的权利边界见 ASSET_PROVENANCE.md。

HeiGe Codex Skin Studio v5.3.0

新功能

• 阅读增强默认开启，为 AI 回复区提供主题自适应半透明底色，并可在主题中心随时关闭。
• 阅读增强偏好跨重新注入保留，并通过现有 renderer 通道同步，不增加后台接口、滚动监听、定时器或动画。

修复

• 修复同一对话中过程回复未覆盖、最终回复已覆盖的不一致问题。
• 蒙版改用统一回复正文节点，增加对称留白并移除大阴影，改善左上角边缘并缩小滚动绘制范围。
• 修复发布包中可执行 .zsh 入口被错误打包为 0644 的问题。

验证

• Node 全量测试：988 项，982 通过，0 失败，6 项按平台或实机条件跳过。
• GitHub Actions 的 Node 22、macOS lifecycle、Windows PowerShell parity 和可复现 .skill 制品四组门禁全部通过。
• Windows 门禁实际覆盖 PowerShell 5.1、PowerShell 7、32 位解析、候选包重建安装和隔离 Scheduled Task。
• 本机真实 Codex DOM 检查中，18 个 AI 回复区域全部覆盖，遗漏 0。
• 同一窗口滚动 A/B 对照未发现开启阅读增强带来可测性能回退。

平台边界

Windows 自动化门禁已经通过，但 Microsoft Store/MSIX 真实商店应用接收 CDP 参数的完整流程仍需要 Windows 真机验证。

HeiGe Codex Skin Studio v5.2.5

修复

• 修复 Windows PowerShell 5.1 的 Skill 文档契约失败。
• 明确写出仅当用户主动要求安装 Miku Future 时才执行宠物安装。
• 保持皮肤安装与宠物安装相互独立，不因安装或应用皮肤自动启用可选宠物。
• 完整包含 5.2.4 的换肤锁竞争修复。

验证

• Node 全量测试通过。
• macOS lifecycle 与 launchd 测试通过。
• Windows PowerShell 5.1、PowerShell 7、32 位解析、确定性制品安装和隔离 Scheduled Task 集成全部执行并通过。
• 可复现 .skill 制品测试通过。
• 发布素材检查通过，共 37 个视觉素材。

安装包继续使用本机回环 CDP，不修改 Codex 的 app.asar、应用二进制或签名资源。

HeiGe Codex Skin Studio v5.2.4

修复

• 修复后台巡检与菜单换肤请求并发争抢跨进程文件锁，导致部分主题点击偶发不生效的问题。
• 控制器内部的持锁操作改为 FIFO 串行执行，并对其他可信进程造成的短暂 LOCK_HELD 增加有限重试。
• 保留原有跨进程安全锁和全部安全校验。
• 重新生成确定性 .skill 制品，确保压缩包字节、发布哈希与当前源码完全一致。

验证

• 用户实测连续换肤正常。
• 重启 Codex 后，主题、持久化、CDP 和主题菜单均正确恢复。
• Node 全量测试：985 项，979 项通过，0 项失败，6 项按环境跳过。
• 发布治理测试：10/10 通过。
• 发布素材检查通过，共 37 个视觉素材。

安装包继续使用本机回环 CDP，不修改 Codex 的 app.asar、应用二进制或签名资源。

HeiGe Codex Skin Studio v5.2.3

新功能

• 主题中心常驻显示当前安装版本，支持手动检查 GitHub 最新正式版。
• 检测到新版本后，可一键复制完整更新指令并交给 Codex 执行。

修复

• 修复换肤后顶部空白横条无法拖动 Codex 窗口的问题。
• 限定 Electron no-drag 区域只覆盖主题入口和主题中心交互控件。

文档与社区

• README 重构为首页样式，新增完整手册、英文文档、主题提示词库和传播文案。
• 新增 Bug、功能建议、主题晒图 Issue 模板与 PR 模板。

验证

• macOS 真机重新安装并验证 Miku 主题下窗口拖动、主题入口和主题切换。
• Node 全量测试：982 项，976 通过，0 失败，6 项按环境跳过。
• 发布素材检查通过，共 37 个视觉素材。

安装包继续使用本机回环 CDP，不修改 Codex 的 app.asar、应用二进制或签名资源。

HeiGe Codex Skin Studio v5.2.2

性能优化

主题请求检测与健康巡检现在共用一次 renderer 扫描，减少常驻检查开销，同时保持一秒内响应主题点击。主题卡片继续采用点击即切换，不增加保存按钮或二次确认。

修复

修复 renderer 无法直连控制端点时，后台巡检漏读排队请求并将内置主题错误恢复成 Miku 的问题。

主题中心「当前主题」看板现在使用每款主题独立的主体焦点，优先展示人物脸部；自定义图片改为完整展示。字体颜色处理说明中的 👉 和 ✅ 引导符号也已恢复。

验证

当前 Mac 已完成 Miku 与原神主题往返点击验证，后台确认后均保持正确主题。自动化测试共 962 项，956 项通过，6 项按环境条件跳过，0 项失败。

安装包继续使用本机回环 CDP，不修改 Codex 的 app.asar、应用二进制或签名资源。

HeiGe Codex Skin Studio v5.2.1

5.2.1 - 2026-07-17

新功能

• 内置主题会随皮肤自动同步 Codex 的浅色、深色或系统外观。
• 菜单上传的自定义图片会根据画面亮度自动选择 Codex 深浅外观，旧版快捷图片也能兼容补判。
• 主题面板新增字体颜色异常处理说明，可按「左下角头像 → 设置 → 外观」手动调整浅色或深色主题。
• 发布包内继续自带可选的 Miku Future 动画 Pet，可独立安装，不覆盖 Codex 内置宠物。

性能优化

• 主题点击后立即完成当前 renderer 渲染，Codex 真机实测画面切换约 52 ms。
• renderer 无法直连本机控制端点时，持久化请求改为后台排队，主题卡片保持可操作。
• 快速连续切换主题时合并等待中的请求，仅持久化最后一次选择。

修复

• 修复 CSP 阻止 renderer 请求控制端点后，主题按钮长时间锁定并产生约 2 至 3 秒可感知延迟的问题。
• 修复深色与浅色图片切换后，Codex 设置中的外观没有同步变化的问题。

发布说明

• 安装包内含可选 Miku Future Pet，皮肤安装不会自动启用 Pet。
• 安装包继续使用本机回环 CDP，不修改 Codex 的 app.asar、应用二进制或签名资源。

HeiGe Codex Skin Studio v5.1.0

5.1.0 - 2026-07-17

新功能

• 全新「极光画廊」主题中心，支持主题缩略图预览、原生界面恢复和自定义图片入口。
• 主题中心与左侧菜单采用统一的玻璃质感和交互层级。

性能优化

• 主题切换改为先完成当前界面渲染，再在后台持久化状态，显著缩短可感知等待时间。
• 健康巡检不再反复进入耐久锁，压缩生产锁链并降低长期运行时的 CPU 占用。

修复

• 修复助手消息区域出现锐利白边、丢失半透明效果的问题。
• 修复切换到原生界面后被后台巡检重新切回 Miku 主题的问题。
• 修复多个对话重复展示相同 Git 和 PR 状态图标的问题。
• 修复 macOS 首次安装状态目录、Codex 精确启动和失败阶段诊断。
• 修复 Windows 计划任务身份归一化与跨 PowerShell 兼容问题。
• 修复自定义桌宠需要重启时缺少明确提示的问题。

发布说明

• 安装包继续使用本机回环 CDP，不修改 Codex 的 app.asar、应用二进制或签名资源。
• 项目所有者已确认当前视觉素材随本版本公开发布。素材权利边界与来源记录见 ASSET_PROVENANCE.md 和 NOTICE.md。