准确描述哪些地方显示、哪些地方不显示
先记录最小事实：官方 Codex 是否打开；主题在首页和任务页都没有、只在首页出现、只在旧窗口出现，还是界面空白或只有部分样式；辅助进程显示成功、报错，还是一闪而过。写明使用的启动器或命令、当时打开的页面、窗口尺寸，以及问题发生在首次安装还是某次更新之后。不要只写无法使用。不同现象分别指向来源、进程、目标选择、响应式样式、图片处理或兼容性，调查方法完全不同。
- 官方应用能否单独启动。
- 首页与任务页各自表现。
- 准确启动入口和输出。
- 首次安装或更新后失效。
先恢复并建立官方应用基线
用文档记录的恢复入口停止视觉会话，再从普通官方入口打开 Codex。检查项目、登录、导航、任务和输入框是否在没有第三方视觉层时正常。如果官方应用本身已经异常，应先处理该基线问题，不要继续改主题文件。状态和日志应在恢复运行后再决定是否清理，因为它们可能记录目标会话。基线清楚后正常退出官方 Codex，让下一次已审查的主题启动从可预期状态开始。这样可以把视觉层故障与应用安装、账户和操作系统问题分开。
- 手动删除前先运行恢复。
- 独立打开官方 Codex。
- 检查正常任务和控件。
- 干净退出后再尝试主题启动。
核对来源、版本与平台启动入口
回到原始仓库，不要使用复制压缩包或旧博客附件。对照当前平台 README、近期提交与 Issue，并记录所用提交。Windows 要确认 Microsoft Store 官方应用和文档要求的 Node.js；macOS 要确认处理器架构、官方应用位置和准确的 .command 或脚本。启动器一闪而过时，只在终端运行它所调用且已经审查的脚本，以保留错误输出。不要通过关闭安全机制、运行无关二进制或授予宽泛权限掩盖来源与前置条件问题。
- 只使用原始仓库当前平台目录。
- 记录提交和前置环境版本。
- 保留已审查脚本的终端输出。
- 不绕过警告或随意扩大权限。
确认辅助层连接的是预期 Codex 窗口
本机运行时样式需要连接预期的官方 Codex 渲染页面。旧窗口、多个应用实例、残留辅助状态或其他本机调试工具都可能让目标选择变得含糊。关闭多余窗口和重复辅助进程，再按普通启动器的文档行为运行。端口被占用时先识别所有者，不要随意结束进程。运行 verify 或 doctor 并保存文本结果。仅看到应用窗口打开并不能证明连接成功；证据应说明是否找到预期端点与渲染页，以及首页和任务页是否都接收到样式。
- 关闭重复窗口和辅助进程。
- 识别本机端口所有者。
- 保存 verify 或 doctor 输出。
- 明确检查两个页面目标。
把图片处理问题与样式连接问题分开
如果面板或强调色改变但背景没有出现，说明运行时层可能已经工作，失败点更可能在图片处理或配置。用一张权利明确、尺寸适中的 PNG 或 JPEG 副本测试，不要拿珍贵原图诊断。核对文档格式与大小限制、处理后文件位置，以及当前主题是否仍引用旧路径。如果背景出现但文字不可读，这是构图问题，不代表辅助层失败，应转到构图与对比度指南。每次只换一个变量，才能判断是文件、配置还是目标页面导致结果不同。
- 使用简单且授权清楚的测试副本。
- 核对格式和大小限制。
- 确认当前主题引用目标文件。
- 把可读性与可见性分开判断。
处理更新并准备可用证据
主题在 Codex 更新前可用时，应先恢复并确认新版官方应用健康，再查看上游当前兼容说明。只有当前源码要求时才重新安装或应用，避免把旧安装状态与新启动器混用。仍无法解决时，提交系统版本、架构、官方应用来源、源码提交、准确启动器或命令、脱敏后的 verify 输出，以及首页与任务页各自结果。公开前移除用户名、令牌、私人路径、项目名和任务内容。网站文案错误反馈给 CodexSkin，脚本运行行为应交给上游维护者。
- 分开记录 Codex 与辅助层更新时间。
- 提供准确环境与源码状态。
- 公开前完成诊断脱敏。
- 把问题提交给正确维护方。