[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83170":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":12,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":12,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":14,"starSnapshotCount":14,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},83170,"codex-helper","xqnode\u002Fcodex-helper","xqnode","Windows \u002F macOS 轻量托盘·菜单栏代理，让 Codex Desktop 一键切换 DeepSeek、千问、智谱、Kimi、MiniMax 等国产大模型。本地 Responses↔Chat 转译，开箱即用。",null,"Rust",129,1,56,0,73,11,70.2,"MIT License",false,"main",true,[],"2026-06-12 04:01:40","# Codex Helper\n\n> 轻量 Windows 托盘工具 — 让 **OpenAI Codex CLI** 一键切换到 DeepSeek、通义千问、智谱、Kimi、MiniMax 等国产大模型。\n\n> **零门槛设计**：双击安装 → 自动配置 → 托盘右键选模型 → 开始用 Codex。\n> 全程不需要打开终端、不需要改配置文件、不需要懂技术。\n\n---\n\n## 界面预览\n\n右键系统托盘图标，即可切换模型、打开设置或同步配置：\n\n![系统托盘菜单](assets\u002Ftray-menu.png)\n\n托盘 →「设置…」打开 API Key 配置窗口（厂商 Chip 切换、Base URL、测试连接）：\n\n![设置窗口](assets\u002Fsettings-window.png)\n\n---\n\n## 这是给谁用的？\n\n- **小白用户**：第一次接触 Codex，只想用 DeepSeek 替代 OpenAI 省钱\n- **怕折腾的用户**：看到 `~\u002F.codex\u002Fconfig.toml` 就头大\n- **多账号用户**：在 DeepSeek、通义、Moonshot 之间快速切换\n\n如果你已经是命令行高手，也可以走 [高级模式](#高级模式cli)。\n\n---\n\n## 一图看懂\n\n```\n┌──────────────────────────────────────────────────────────┐\n│  系统托盘  ┌───┐                                          │\n│            │ ⚡ │  ← 右键点这里                             │\n│            └───┘                                          │\n│       × API Key：未配置                                     │\n│       × 连接：需先配置 Key                                  │\n│       ─────────────────                                    │\n│       切换模型 · DeepSeek · pro  >   ← 厂商 → 具体型号      │\n│       ─────────────────                                    │\n│       常用                                                 │\n│         设置…                                              │\n│         重新同步配置 \u002F 检测连接 \u002F 请求日志…                   │\n│       更多  → 配置文件夹、切回 OpenAI 官方…                   │\n│       ─────────────────                                    │\n│       退出 Codex Helper                                    │\n└──────────────────────────────────────────────────────────┘\n                       ↓ 托盘里切换模型\n┌──────────────────────────────────────────────────────────┐\n│  Codex Desktop \u002F CLI  →  Codex Helper 代理  →  模型 API   │\n└──────────────────────────────────────────────────────────┘\n```\n\n**就这么简单：装上 → 托盘里填 Key、选模型 → 在 Codex 里用。**\n\n---\n\n## 三步上手\n\n### 第 1 步：下载安装\n\n去 [Releases 页面](https:\u002F\u002Fgithub.com\u002Fxqnode\u002Fcodex-helper\u002Freleases) 下载（**目前仅 Windows**）：\n\n| 类型 | 文件 | 操作 |\n|------|------|------|\n| **安装版** | `CodexHelper-x.x.x-Setup.exe` | 双击 → 一路下一步 |\n| **便携版** | `CodexHelper-x.x.x-win64.zip` | 解压后双击 `codex-helper.exe` |\n\n> macOS \u002F Linux 安装包尚未发布（托盘与设置窗口目前仅支持 Windows）。安装版会自动：可选开机启动、写入 Codex 配置、注册系统托盘。\n\n### 第 2 步：填 API Key（首次启动自动弹出）\n\n首次启动时，Codex Helper 会**自动检测**你的环境：\n\n- ✅ 已装 Codex？— 自动写入代理配置\n- ✅ 已有 `DEEPSEEK_API_KEY` 环境变量？— 自动读取\n- ✅ 都没有？— 弹出引导窗口：\n\n```\n┌────────────────────────────────────────────────┐\n│  欢迎使用 Codex Helper                          │\n│                                                │\n│  请选择一个模型：                                │\n│  ● DeepSeek（推荐，性价比最高）                  │\n│  ○ 通义千问                                     │\n│  ○ Moonshot                                    │\n│                                                │\n│  粘贴你的 API Key:                              │\n│  ┌──────────────────────────────────────────┐  │\n│  │ sk-...                                   │  │\n│  └──────────────────────────────────────────┘  │\n│  👉 还没有 Key？[点这里申请 DeepSeek Key]      │\n│                                                │\n│  [测试连接]                    [完成]            │\n└────────────────────────────────────────────────┘\n```\n\n### 第 3 步：打开 Codex 就能用\n\n```bash\ncodex\n```\n\n完成。**不需要任何额外配置。**\n\n切换模型？**托盘切换厂商通常无需重启**（详见 [常见问题](#faq-model-switch)）。\n\n---\n\n## 小白友好设计\n\n我们把所有「技术门槛」都铲平了：\n\n| 你担心的事 | Codex Helper 怎么做 |\n|-----------|---------------------|\n| 不知道 Codex 装没装 | 启动时自动检测，没装会给下载链接 |\n| 不知道去哪申请 Key | 每个模型旁边都有「点此申请」直达官网 |\n| 不知道 Key 填对没 | 输入框实时校验格式，填错变红 |\n| 怕改坏配置文件 | 全程 GUI，自动备份 10 份历史 |\n| 报错看不懂英文 | 所有错误翻译成中文 + 给出具体建议 |\n| 不知道当前用的哪个模型 | 托盘图标颜色区分（蓝=DeepSeek，绿=通义...）+ 鼠标悬停显示 |\n| 切换后没生效 | 自动检测 Codex 进程，提示「请重启 Codex」并提供一键操作 |\n| 想回到 OpenAI 官方 | 托盘菜单 → 「恢复官方登录」一键完成 |\n| 后台代理怎么停 | 退出托盘程序 = 自动停代理；下次开机自动启动 |\n\n---\n\n## 友好错误提示示例\n\n❌ 不好：\n```\nError: 401 Unauthorized\n```\n\n✅ Codex Helper：\n```\n┌────────────────────────────────────────────────┐\n│  ⚠ DeepSeek API Key 无效                       │\n│                                                │\n│  可能原因：                                      │\n│  • Key 被复制时多了空格或换行                    │\n│  • Key 已过期或被删除                            │\n│  • DeepSeek 账户余额不足                         │\n│                                                │\n│  [重新填写 Key]    [打开 DeepSeek 控制台]        │\n└────────────────────────────────────────────────┘\n```\n\n---\n\n## 支持的模型\n\n| 模型 | 推荐场景 | 申请 Key |\n|------|---------|---------|\n| **DeepSeek** | 性价比最高，推荐首选 | [platform.deepseek.com](https:\u002F\u002Fplatform.deepseek.com\u002F) |\n| **通义千问** | 阿里生态，国内速度快 | [dashscope.aliyun.com](https:\u002F\u002Fdashscope.aliyun.com\u002F) |\n| **Moonshot** | 长上下文优秀 | [platform.moonshot.cn](https:\u002F\u002Fplatform.moonshot.cn\u002F) |\n| **智谱 GLM** | 中文能力强 | [bigmodel.cn](https:\u002F\u002Fwww.bigmodel.cn\u002F) |\n| **中转站** | 任何 OpenAI 兼容 API | — |\n\n> 中转站端点也是在 GUI 里填，不用编辑配置文件。\n\n---\n\n## 设置窗口（迷你 GUI）\n\n托盘右键 → 「设置」打开，包含：\n\n- **模型管理**：添加 \u002F 删除 \u002F 编辑模型预设\n- **API Key 管理**：所有 Key 集中管理，掩码显示\n- **代理设置**：本地监听 `127.0.0.1:25543`（固定端口，默认无需改）\n- **开机启动**：开关\n- **导出 \u002F 导入**：备份你的配置到其他电脑\n- **关于**：版本、检查更新、查看日志\n\n整个窗口预计 \u003C 500 行代码，绝不臃肿。\n\n---\n\n## 工作原理（可跳过）\n\n```\n┌─────────────┐   1. Codex 永远连本地代理   ┌────────────────┐\n│  Codex CLI  │ ──────────────────────────► │  Codex Helper  │\n│             │   http:\u002F\u002F127.0.0.1:25543\u002Fv1     │   (托盘进程)    │\n└─────────────┘                              └────────┬───────┘\n                                                      │\n                              2. 代理根据你的选择转发   │\n                                                      ▼\n                              ┌───────────┬──────────┬──────────┐\n                              ▼           ▼          ▼          ▼\n                         DeepSeek      通义        Moonshot   中转站\n```\n\n- Codex 的 `~\u002F.codex\u002Fconfig.toml` 一次性写好，永不再改\n- 切换模型 = 切换代理的转发目标，**Codex 完全无感知**\n- 代理自动处理 Responses API 与 Chat Completions 的格式转换\n\n---\n\n## 高级模式（CLI）\n\n如果你喜欢命令行，也可以用 CLI 控制托盘程序：\n\n```bash\ncodex-helper use deepseek      # 切换模型\ncodex-helper status            # 查看当前状态\ncodex-helper test              # 测试当前模型连通性\ncodex-helper list              # 列出所有模型\ncodex-helper restore-openai    # 恢复 OpenAI 官方\ncodex-helper doctor            # 一键诊断\n```\n\nCLI 和托盘共享同一个后端，命令立即反映到托盘图标。\n\n---\n\n## 安装包做了什么\n\n为了真正「双击下一步」，安装包会自动完成：\n\n1. 安装主程序到 `Program Files\\CodexHelper\\`（Windows）\n2. 添加开机启动项（可在设置中关闭）\n3. 注册 `codex-helper:\u002F\u002F` Deep Link（用于 Key 一键导入）\n4. **自动备份** 现有的 `~\u002F.codex\u002Fconfig.toml` 到 `~\u002F.codex-helper\u002Fbackups\u002F`\n5. 注入代理配置到 `~\u002F.codex\u002Fconfig.toml`\n6. 在系统托盘启动主程序\n7. 弹出首次引导窗口\n\n**全程无需打开终端。**\n\n---\n\n## 卸载也很干净\n\nWindows「设置 → 应用」卸载，或运行安装目录下的卸载程序，将：\n\n- ✅ 还原 `~\u002F.codex\u002Fconfig.toml` 到安装前状态（从备份）\n- ✅ 移除开机启动项\n- ✅ 询问是否保留 `~\u002F.codex-helper\u002F` 配置目录\n\n**不残留任何东西。**\n\n---\n\n## 与 CC Switch 的区别\n\n| | CC Switch | Codex Helper |\n|---|-----------|--------------|\n| 定位 | 7 种 AI 工具全能管理器 | **专注 Codex** |\n| 体积 | 桌面应用 ~50MB | **托盘 ~10MB** |\n| 上手成本 | 需要理解 Provider 概念 | **零概念，选模型就行** |\n| 适合人群 | 多工具高级用户 | **小白 + 只用 Codex 的人** |\n| 学习曲线 | 中等 | **几乎为零** |\n\n如果你只用 Codex，Codex Helper 更轻、更专、更省心。\n\n---\n\n## 数据存储\n\n| 路径 | 内容 |\n|------|------|\n| `~\u002F.codex-helper\u002Fconfig.json` | 当前模型、代理端口（默认 **25543**）等设置 |\n| `~\u002F.codex-helper\u002Fkeys.enc` | **加密存储**的 API Keys（不明文） |\n| `~\u002F.codex-helper\u002Fbackups\u002F` | Codex 配置自动备份（保留 10 份） |\n| `~\u002F.codex-helper\u002Flogs\u002F` | 运行日志（出问题时上传） |\n\n**所有数据仅在本地，不上传任何服务器。**\n\n---\n\n## 开发路线\n\n| 阶段 | 目标 | 状态 |\n|------|------|------|\n| **M1** | 托盘程序骨架 + 内置代理 + DeepSeek 预设 | ⏳ |\n| **M2** | 首次引导窗口 + Key 加密存储 + 自动检测 | ⏳ |\n| **M3** | 一键安装包 (Win\u002FmacOS\u002FLinux) + 自动备份恢复 | ⏳ |\n| **M4** | 通义\u002FMoonshot\u002F智谱预设 + 设置窗口 + 中文报错 | ⏳ |\n| **M5** | CLI 高级模式 + 自动更新 + 日志面板 | ⏳ |\n\n---\n\n## 技术栈（开发者）\n\n- **核心**：Rust（小体积、跨平台、单 exe）\n- **托盘**：`tray-icon` + `tao`（无需 Electron\u002FTauri 全套）\n- **设置窗口**：原生 webview（仅在打开时加载，~3MB）\n- **代理**：`hyper` + `tokio`\n- **打包**：Windows Inno Setup + 便携 zip（macOS dmg \u002F Linux AppImage 规划中）\n\n预计单文件 \u003C 10MB，内存占用 \u003C 30MB。\n\n---\n\n## 交流群\n\n扫码加入 **AI 交流群**（企业微信），交流 Codex 使用心得、反馈问题：\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fai-group-qr.png\" alt=\"AI 交流群二维码\" width=\"240\">\n\u003C\u002Fp>\n\n---\n\n## 贡献\n\n欢迎 Issue 和 PR，尤其欢迎：\n\n- 新模型预设（附 base_url + 测试通过截图）\n- 中文报错文案优化\n- 小白用户的反馈（你卡在哪一步了？）\n\n---\n\n## 常见问题\n\n**Q：装上后 Codex 怎么没反应？**\nA：看任务栏右下角是否有 Codex Helper 托盘图标（圆角蓝底 + 金色闪电）。没有的话，开始菜单搜「Codex Helper」启动一次；便携版请双击 `codex-helper.exe`（会自动启动托盘）。\n\n**Q：便携版 zip 解压后双击 exe 没反应？**\nA：新版已支持双击直接启动。若仍无托盘，在 PowerShell 进入解压目录执行：\n\n```powershell\n.\\codex-helper.exe start\n```\n\n首次使用建议先执行 `.\\codex-helper.exe init`，再 `start`。\n\n**Q：安装版和 zip 便携版有什么区别？**\nA：功能相同，都是同一个 `codex-helper.exe`。安装版会写入开始菜单、支持卸载程序，并可选开机自启；zip 解压即用，适合不想装软件的用户。\n\n**Q：升级或重装后，图标还是旧的（蓝色圆形 \u002F 模糊）？**\nA：多半是 **Windows 图标缓存** 没刷新——同一路径反复覆盖安装时，资源管理器和任务栏可能仍显示旧图标，即使 exe 已是新版。安装包结束时会自动执行 `ie4uinit.exe -show`；若仍不对，在 PowerShell 执行：\n\n```powershell\nie4uinit.exe -show\ntaskkill \u002FIM explorer.exe \u002FF; start explorer.exe\n```\n\n仍无效可**注销或重启电脑**。正确图标应为**圆角蓝底渐变 + 金色闪电**（与设置页左上角一致）。\n\n**Q：设置窗口打不开？**\nA：需先启动托盘代理。托盘 →「设置…」，或先运行 `codex-helper start`，再执行 `codex-helper settings`。若提示端口占用，说明已有实例在跑，在任务栏找到托盘图标即可。\n\n**Q：Codex 报 `error sending request` \u002F `502` \u002F 连不上本地代理？**\nA：Codex 通过固定地址 `http:\u002F\u002F127.0.0.1:25543\u002Fv1` 访问 Helper。请依次检查：\n\n1. 任务栏是否有 Codex Helper 托盘图标（没有则启动 `codex-helper.exe start`）\n2. 浏览器打开 [http:\u002F\u002F127.0.0.1:25543\u002Fhealth](http:\u002F\u002F127.0.0.1:25543\u002Fhealth) 应返回正常\n3. 托盘 → **重新同步配置**，然后**完全退出并重启 Codex Desktop**\n4. 运行 `codex-helper doctor`，确认 config.toml 与 config.json 端口均为 **25543**\n\n若从旧版升级后 config 里仍是随机端口（如 18063），删除 `%USERPROFILE%\\.codex-helper\\config.json` 后重新 `codex-helper init`，或托盘重新同步配置。\n\n- `502 Bad Gateway`：Helper 已连上，多为 API Key \u002F 网络 \u002F 中转站问题 → 设置里「测试连接」\n- `error sending request`：Helper 未运行或端口不一致 → 按上面 1–4 步排查\n\n**Q：任务管理器里有两个 `codex-helper.exe`？**\nA：可能同时跑了**安装版 + zip 便携版**，或旧开机自启路径未删。任务管理器 → 右键 → 打开文件所在位置，保留一份即可；检查 `shell:startup` 里是否有多余快捷方式。\n\n**Q：下载后 Windows 提示「已保护你的电脑」？**\nA：安装包未数字签名，属正常情况。点「更多信息」→「仍要运行」。仅建议从 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fxqnode\u002Fcodex-helper\u002Freleases) 下载。\n\n**Q：可以同时用 OpenAI 官方和 DeepSeek 吗？**\nA：可以。托盘 → 更多 →「切换回 OpenAI 官方」，或 CLI 执行 `codex-helper restore-openai`。\n\n**Q：如何清除所有配置？**\nA：托盘 → 设置 → 右上角「清除所有配置」。会删除 API Key、厂商选择与请求日志；之后需重新填 Key 并重启 Codex Desktop。\n\n**Q：切换模型需要重启 Codex 吗？**\n\n\u003Ca id=\"faq-model-switch\">\u003C\u002Fa>\n\n**Codex Helper 本身不用重启**，托盘切换后代理会一直运行。\n\n| 操作 | 需要重启 Codex？ |\n|------|------------------|\n| 托盘切换厂商（DeepSeek → 千问 等） | 通常**不需要**，新开一条对话即可 |\n| 设置里改具体型号或 API Key | **建议**完全退出并重新打开 Codex Desktop |\n| 切换后仍不对 | 完全退出 Desktop 再打开，或托盘 →「重新同步配置」 |\n\n说明：\n\n- **托盘切换厂商**：会立刻热更新代理、写入 `~\u002F.codex\u002Fconfig.toml`、同步模型目录和 Desktop 会话库，下一条消息即走新厂商。\n- **设置里改型号**（如 V4 Flash → V4 Pro）：保存后配置已更新，但 Desktop 可能缓存旧 UI，因此建议重启。\n- **在 Codex 里点选模型**：选项来自 Helper 写入的目录，但**实际调用以 Helper 当前配置为准**；改型号请走 **托盘 → 设置… → 保存**。\n\n若切换后没生效：先在 Codex 里**新开对话**试一次；仍不对则**完全退出 Codex Desktop**（任务栏右键退出，不要只关窗口）。\n\n**Q：中转站 Base URL 怎么填？**\nA：填 OpenAI 兼容网关地址，需带 `\u002Fv1`，例如 `http:\u002F\u002Fyour-host:8080\u002Fv1`。官方厂商的 Base URL 在设置里只读，无需修改。\n\n**Q：一键诊断怎么用？**\nA：PowerShell 或 cmd 执行 `codex-helper doctor`，会检查配置目录、Codex 配置、API Key、环境变量与代理是否在运行。\n\n**Q：会不会偷我的 API Key？**\nA：源代码开源，Key 存于本地 `%USERPROFILE%\\.codex-helper\\`，请求只发往你选的官方端点。\n\n**Q：付费吗？**\nA：完全免费，MIT 协议。模型 API 费用付给各模型厂商。\n\n**Q：Codex Desktop 里 Computer Use \u002F Browser Use 报「Node REPL 工具不可用」？**\nA：Computer Use 依赖 Codex 本地的 `node_repl`（需 `[features] js_repl = true`）。Codex Helper 每次同步配置时会自动打开该开关。请确认：\n\n1. Codex 设置 → **Computer Use** 已安装插件（`computer-use@openai-bundled` enabled）\n2. 托盘 → **重新同步配置**，然后**完全退出并重启 Codex Desktop**\n3. **新开一条对话**再试（旧对话可能在 `js_repl=false` 时创建，线程里不会注入 `mcp__node_repl__js`）\n4. 使用 `$computer-use` 或 `@Computer Use`，例如：`打开 QQ 音乐播放七里香`\n\n若重启后仍失败，打开 `%USERPROFILE%\\.codex\\config.toml` 检查是否又被写回 `js_repl = false`（Codex 已知 bug，见 [openai\u002Fcodex#25090](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex\u002Fissues\u002F25090)）。可再次点「重新同步配置」，或手动改为 `js_repl = true` 后重启。\n\n若配置都正常但新对话仍报 Node REPL 不可用，多半是 Codex Desktop 的线程级 bug（[openai\u002Fcodex#21301](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex\u002Fissues\u002F21301)）：同一会话里 `mcp__node_repl__js` 可能未注入。可执行 `codex-helper doctor` 检查；或临时切回 OpenAI 官方模型验证 Computer Use 是否正常。\n\n---\n\n## 许可证\n\nMIT © 2026\n\n---\n\n## 免责声明\n\n本项目为非官方工具，与 OpenAI、DeepSeek 等公司无关联。请遵守各模型服务商使用条款；API Key 仅存于本地，请妥善保管。\n","Codex Helper 是一个轻量级的 Windows 系统托盘工具，旨在让用户能够一键切换 OpenAI Codex CLI 到 DeepSeek、通义千问等国产大模型。它采用 Rust 语言开发，具有零门槛的设计理念，用户只需双击安装，通过系统托盘菜单即可完成模型切换与配置，无需手动修改任何配置文件或打开终端。此项目特别适合初次接触 Codex 的小白用户、不希望处理复杂配置的技术恐惧者以及需要频繁切换不同大模型服务的多账号持有者使用。MIT License 让其开源且易于二次开发。",2,"2026-06-11 04:10:20","CREATED_QUERY"]