Codex 皮肤插件安装与 GitHub 源码
使用标准命令安装或升级 Codex Skin 插件，核对 Paid Alpha 版本，并查看 GitHub 源码与固定 Helper 边界
Codex Skin 插件是主题目录与 ChatGPT 桌面应用中受支持 Codex 界面之间的免费入口。它只识别有限的主题任务，调用固定平台 wrapper，并返回结构化结果。公开源码托管在 GitHub，采用 MIT License。
当前 Paid Alpha 的插件支持 macOS 与 Windows。即使没有 Pro 订阅，也可以应用已经发布的 Free 主题、查看本地状态并启动离线 Restore。Free 与 Pro 主题包走相同的设备授权、包校验和可见结果验证流程。
插件负责什么
安装后的 Skills 对应四类稳定能力：
- 使用
codex-skin-version核对已加载版本 - 按准确六位 ID 应用或切换已发布主题
- 查看有限的本地状态
- 离线恢复官方 Codex 外观
Skill 会把主题 ID 作为独立参数传给固定平台 wrapper，不会把用户消息中的其他文字拼接成 Shell 命令。本地操作由签名 Helper 执行，Helper 在有限事务内完成可见验证，随后退出。
插件不会修改官方 Codex 安装包，不会运行主题提供的代码，也不接受自定义 API origin。应用结束后不会留下后台自动重复应用服务。
从 Git-backed Marketplace 安装
在终端运行当前公开安装流程：
codex plugin marketplace add yuanjohn01-byte/codex-skin-plugin --ref main
codex plugin add codex-skin@codex-skin
codex plugin list --json第一条命令把公开 Marketplace 仓库的 main ref 加入 Codex，第二条安装 codex-skin@codex-skin，第三条核对 JSON。结果中应该恰好有一个该插件的条目，并且 installed: true、enabled: true。
Paid Alpha Helper 尚未采用商业 Apple Developer ID/notarization 或公开 Windows 代码签名，因此首次运行时可能看到 Gatekeeper 或 SmartScreen 提示。请保持系统保护开启，只使用固定 Bootstrap 选择的发布版本。
不需要填写 Marketplace 表单、编辑 Codex 配置或删除缓存。安装步骤固定，便于把公开仓库、插件 ID 与经过审核的发布版本逐项核对。
核对 Production Paid Alpha 版本
安装后完全退出 Codex，重新打开并新建任务，然后运行：
$codex-skin-version当前 Production 版本应该显示插件版本 0.1.0-paid-alpha、Helper .17、Bootstrap .16 与 API origin https://codexskin.ai。它通过 GitHub prerelease 分发，并非 stable/latest。
新任务中的 Skill 结果才是有效版本检查。插件详情页残留旧副标题，不能单独用来判断安装或升级失败。
更新已经安装的版本
刷新现有 Marketplace snapshot，再次安装同一个插件 ID 并核对 JSON：
codex plugin marketplace upgrade codex-skin
codex plugin add codex-skin@codex-skin
codex plugin list --json之后完全退出 Codex，重新打开，在新任务中运行 $codex-skin-version。不要用手工下载 Helper 或清空缓存代替这套步骤。
哪些内容是开源的
公开的 codex-skin-plugin 仓库包含可安装插件、Marketplace metadata、Skills、平台 wrappers，以及 Helper、adapter、Bootstrap 和 Restorer 源码。仓库还包括发布所需的白名单公开合同与验证公钥、合成测试 fixture、测试，以及 README、SECURITY、LICENSE、NOTICE、CHANGELOG 和 release notes。
代码采用 MIT License，第三方组件和资产继续遵循各自的许可证与 NOTICE。
公开插件不等于整个 Codex Skin 产品全部开源。下面这些内容仍是私有资产：
- 网站、API、账户、结账与管理端源码
- secrets、签名私钥、客户数据和 Production 配置
- Pro 主题包、源图、权利记录、未发布主题与私有 QA 资料
这样的边界让用户可以审查进入本机的代码，同时避免公开凭据、客户信息、商业主题文件和受许可限制的私有框架源码。
Skills、wrapper、Bootstrap 与 Helper
Skill -> 固定平台 wrapper -> 经过验证的 Bootstrap/Helper -> 官方 CodexSkill 提取受支持的意图与六位 ID，显示必要提醒或确认，并解释结构化结果。它不会组合开放式本地命令。
wrapper 只接受固定参数，并调用插件发布版本钉住的外部 Helper。第一次应用或经过验证的升级中，Bootstrap launcher 可能从固定 GitHub Releases 路径获取 release-tagged 候选。激活前会核对签名 descriptor、平台、文件大小、SHA-256 和 Helper 自检，未通过校验的候选不会执行。
Helper 处理设备授权、主题交付、主题包验证、应用、本地状态和 Restore。已发布主题是 data-only 包，只包含 manifest 与声明的本地图片，不能携带 CSS、JavaScript、Shell 命令、selector 或远程执行 URL。
Restore 所需的恢复引擎与状态位于可替换的插件缓存之外。插件缓存被移除或损坏，不会一并删除回到已保存官方外观的离线路径。
在 Codex 任务中使用插件
请求可以很短；涉及具体主题时，必须带真实六位 ID。例如：
Codex Skin，请应用主题 100002
Codex Skin，请显示这台电脑的本地主题状态
Codex Skin，请恢复 Codex 官方外观Apply 可能打开浏览器进行设备批准；没有有效 Pro access 时，也可能打开 Pricing。请在事务自动打开的页面继续，然后回到同一个 Codex 任务。不要粘贴 wrapper 命令，也不要重复提交 Apply。
状态检查只读取本机信息，不访问网络。deviceLinked: true 只说明本机存在设备引用，不能证明当前网页 session 或 Pro access 仍有效。同样，最后应用 ID 表示最近一次通过可见验证并提交的操作，不能证明完全退出后新建的 renderer 仍保持主题。
安装失败时不要破坏现有环境
Marketplace add/upgrade 或插件安装失败时，先停止手工修改。保留还能工作的插件，保存失败命令和完整原始报错。下面三项诊断信息可以分享：
codex --version
codex plugin marketplace list
codex plugin list --json不要在公开 Issue 中提交 Token、Cookie、账户或付款信息、提示词、源码、项目文件和本地绝对路径。可以在 GitHub 报告不含私密信息、可复现的插件问题；账户或订单问题请使用联系页面。
只有 codex-skin Marketplace snapshot 缺失或过期时，Public README 提供了一个可逆刷新方式：
codex plugin marketplace remove codex-skin
codex plugin marketplace add yuanjohn01-byte/codex-skin-plugin --ref main
codex plugin add codex-skin@codex-skin
codex plugin list --json这不会移除已经安装的插件。如果旧版本仍能使用，但升级失败，请保留现有安装并提交诊断，不要先卸载。
常见问题
Codex Skin 插件是开源的吗？
是。可独立安装的插件及其用户侧 Helper 路径以 MIT License 公开。私有网站、服务凭据、客户数据、商业主题包、源图和权利记录不属于该公开仓库。
使用插件需要 Node 或 Go 吗？
不需要。面向用户的发布版本使用自包含 Helper。Node 和 Go 用于开发与仓库检查，普通用户应用或恢复主题时无需安装这两个运行时。
可以手工下载或运行 Helper 吗？
受支持的用户流程不会要求这样做。固定 wrapper 与 Bootstrap 会选择并验证钉住的发布版本。任何要求下载未知 Helper、填写自定义服务 origin、粘贴 CSS、JavaScript、selector 或命令片段的教程，都不属于 Codex Skin 插件合同。