Codex Toolkit

一套完整的 Codex Desktop Computer Use Chrome 插件修复与配置管理工具集。

🚀 快速开始

如果你用 Codex

加载技能：

/install-skill https://github.com/ZYY374/codex-plugin-fix

然后遇到问题时：

/codex-plugin-fix

如果你不用 Codex

直接跑脚本：

powershell -ExecutionPolicy Bypass -File fix-codex-plugins.ps1

📦 包含什么

codex-plugin-fix/
├── SKILL.md                         ← Agent 技能文件
├── README.md                        ← 你在这里
├── scripts/
│   └── fix-codex-plugins.ps1        ← 独立 PowerShell 修复脚本
└── guides/
    ├── auto-update-fix.md           ← 自动更新后修复详解
    ├── config-management.md         ← 配置备份/恢复/迁移
    ├── chrome-plugin-deep-dive.md   ← Chrome 插件原理与排查
    └── api-provider-switch.md       ← 安全更换 API 供应商

🛠️ 能修什么

症状	工具	时间
Computer Use 插件不可用	SKILL.md 场景 A 或 .ps1	2 分钟
自动更新后插件报错 / 消失	SKILL.md 场景 A 或 .ps1	2 分钟
换供应商后插件配置丢失	SKILL.md 场景 B 或 guides/	1 分钟
Chrome 插件安装失败	SKILL.md 场景 C	30 秒
想备份配置防止意外	guides/config-management.md	1 分钟

💡 为什么会有这些问题

Codex Desktop 通过 Microsoft Store 自动更新，但：

• 用户目录的插件文件不会自动同步
• 更换 API 供应商会重置 config.toml
• Chrome 插件需要系统级配置（注册表）

本工具集自动化处理所有这些情况。

🔧 单独功能

只修 Computer Use 报错

→ 看 guides/auto-update-fix.md 第 4 步

只备份配置

→ 跑 guides/config-management.md 的备份脚本

只看 Chrome 怎么配

→ 看 guides/chrome-plugin-deep-dive.md

只换 API 供应商

→ 看 guides/api-provider-switch.md

📋 给 Agent 的说明

如果你的 Agent 平台（如 Hermes、Reasonix 等）支持 skill，直接将本仓库作为技能安装即可。Agent 会自动根据场景触发对应修复流程。

如果你的 Agent 不能加载 skill，让它读 guides/ 目录下的教程按步骤执行。