企业官网建设流程全解析

Codex Router macOS桌面体验：菜单栏托盘、灵动岛与控制中心完整使用指南

【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router

Codex Router是一款专为 Codex 打造的本地外部模型路由器，支持 Kimi OAuth/API 引导式接入、DeepSeek 等数十家模型厂商，并内置安全迁移与回滚能力。在 macOS 上，它提供了三大桌面界面：常驻菜单栏托盘、仿灵动岛的实时请求浮层，以及功能完整的控制中心（Control Center），让你不用打开终端，就能完成接入模型、查看配额、管理用量等全部操作。本文带你 5 分钟上手这套完整的 macOS 桌面体验。

一个 App，三种界面

安装后的Codex Router.app由两部分协同工作：Swift 编写的原生宿主负责菜单栏图标和可选的灵动岛浮层，内嵌的 Electron 应用则提供完整的控制中心窗口。三者共享同一套本地控制平面，所以你在任何界面看到的服务状态、配额数据和 Token 历史都是完全一致的。

详细机制可参考 docs/MACOS-TRAY.md 与 docs/DESKTOP-TRAY.md。

一键安装菜单栏应用

macOS 或 Linux 用户只需在终端粘贴一条引导式安装命令（详见 README.md 与 install.sh）：

curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \ | sh -s -- --target codex --guided --with-tray

安装程序会询问你想接入哪些模型厂商，并全程在私密的本地提示符中录入凭据。完成后应用会装到~/Applications/Codex Router.app，Spotlight、访达、Launchpad 都能按名称找到它。原生 Swift 源码位于 apps/macos/ModelRouterTray/。

几个贴心的默认行为：

• 🍎不占 Dock：菜单栏宿主是轻量后台进程，关闭窗口只是隐藏，Cmd+Tab 随时唤回；
• ⏰登录自启：注册了 launchd LaunchAgent，开机自启、异常退出自动重启；
• 🛡️只读姿态：托盘只展示和引导，不会替你禁用、卸载或改动路由器的既有配置。

菜单栏托盘：一瞥即知全局

点击菜单栏图标，弹层会展示Codex 服务状态、全部厂商用量概览（All usage）、当前活跃厂商详情，以及与命令行完全一致的厂商接入入口。

用量卡片怎么读？每个已连接的账户（如 Kimi、Grok、DeepSeek）各有一张配额卡片，标明限额与重置时间；官方账户余额可用时直接显示余额，否则回退为本地实测的 7 日流量并明确标注，从不把本地流量伪装成厂商账单。图表支持 7 / 30 / 90 天范围切换，悬停任意刻度可看到当天 Token 数，用量每 30 秒自动刷新。

菜单栏显示模式与自定义图标

在控制中心的Settings → Menu bar中可以做精细调节：

“仅在 Codex 运行时显示”

Settings → Show tray提供两种策略：Always（始终显示）与With Codex——托盘只在 Codex 桌面应用或codexCLI 打开时出现，全部退出后自动隐藏。后者对终端进程也有专门检测，不会漏掉 CLI 会话。

灵动岛：请求进行时一眼看清

在Tray Settings → Dynamic Island中开启（可选Off/Notch/Desktop），屏幕顶部中央会出现一块随请求而动的“灵动岛”：

• 📡 它跟随处理最新请求的厂商，空闲显示“思考中”动效，生成时切换为思考动画，出错时给出明确 Error 标签；
• ⏱️悬停快速查看当日 Token 总量、固定 7 日折线图与厂商配额剩余；点击展开完整的账户用量详情；
• 🧵多任务并行时，岛内显示首个请求的厂商标志 + Codex 会话标题，其余请求以+N汇总，悬停可列出每个在途请求的状态与耗时；
• 🔋 若厂商报告了周配额，剩余百分比会常驻在岛尾，方便随时监控。

桌面小组件（macOS 14+）

从系统小组件图库添加Codex Router Usage或Codex Router Reset：前者展示今日 Token 与 7 日累计折线，后者以大字倒计时展示下次配额重置。点击组件会直接打开控制中心对应用量页，无需任何额外配置。

控制中心：完整桌面管理面板

通过 Spotlight 打开Codex Router.app，或点菜单栏面板中的Control Center，即可进入全功能窗口。前端源码位于 apps/control-center/，核心页面包含 Dashboard、Usage、Status、Models、Local、Harness、Settings。

仪表盘（Dashboard）一眼汇总：服务健康（Router / Gateway / External forwards 三项状态）、在线状态、实时负载、24 小时 Token 总量，以及按小时堆叠的输入/输出流量图。

用量（Usage）支持 7 / 30 / 90 天视图，区分常规输入、缓存输入与输出，并列出各厂商上报的账户限额；还会统计最近 20 次成功流式回复的平均输出速度（tokens/s）。

模型（Models）按模型家族分组展示等价路由，每个厂商路由独立提供可见性开关、子代理模型选择与推理强度（reasoning effort）控制；顶部可直接 Connect provider 接入新厂商，DeepSeek、Kimi 等 OAuth 厂商一键Install & Sign In，API 厂商用原生安全输入框填 Key——密钥只通过本地标准输入写入受保护凭据文件，绝不进入进程参数或日志。

连接（Connections）中还有Use without OpenAI login开关：将新 Codex 会话切换到外部模型路由（需至少一个已连接的外部厂商），切换完成后自动优雅重启 Codex 桌面应用生效，关闭开关则原样恢复此前的配置。

实用小贴士

1. 移动仓库后重建：安装的应用记录了构建时的仓库路径，移动目录后重跑./bin/model-router-tray即可；
2. 维护按钮：Update & Verify会把当前main版本应用到 Codex 安装并自动运行 doctor 体检；
3. 浏览器版面板：执行./bin/panel可把只读版面板打开在浏览器中，地址含本机能力凭证，请当作密码对待；
4. 隐私设计：本地流量图只统计本机经此路由器的请求，从不存储提示词、响应内容与 API 密钥。

至此，菜单栏托盘管状态、灵动岛管实时请求、控制中心管一切配置——Codex Router 的 macOS 桌面体验已经形成闭环。装好之后，你的外部模型（Kimi、DeepSeek 等）就真正住进了 Codex 的工作流里。

【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router