企业官网建设流程全解析

Win-CodexBar 是一款免费开源的 Windows 系统托盘应用，让你无需逐个登录各家控制台，就能在一处实时监控 56 款 AI 编码工具（如 Codex、Claude Code、Cursor、Copilot、Gemini、DeepSeek 等）的用量与配额。它基于 Tauri + React + Rust 构建，数据仅在你的本机处理，凭据用 Windows DPAPI 加密保护。

为什么你需要一个用量监控工具

用 AI 编程时，最令人头疼的往往是"额度还剩多少、什么时候重置"：

• Codex 的会话额度和周额度分属不同窗口，超额就会被拦截；
• Claude Code 有 5 小时会话限额和周限额；
• Cursor、Copilot、Kimi、MiniMax 等各有各的计费口径。

过去你要在十几个网页标签之间来回切换，还要分别登录。Win-CodexBar 把这些数据聚合到一个托盘小面板里，一眼看尽。

Win-CodexBar 核心功能

快速安装：两种官方方式

方式一：winget 一键安装（推荐）

在 PowerShell 中执行：

winget install Finesssee.Win-CodexBar

方式二：下载安装包

到官方 Release 页面下载两个文件之一：

• 安装包：CodexBar-<version>-Setup.exe
• 便携版：CodexBar-<version>-portable.exe

每个版本都附带.sha256校验文件，建议手动校验一次再安装。安装包会自动引导 WebView2 运行库和 VC++ 运行库，便携版则无需安装器集成。

首次运行：3 步打开用量面板

1. 从开始菜单或便携 exe 启动CodexBar，它会在任务栏托盘区驻留一个图标。
2. 点击托盘图标，弹出用量面板。
3. 进入Settings → Providers，勾选你正在用的服务商。

下面这张图就是点击托盘图标后打开的用量面板：顶部是服务商网格，下方是各家进度条。

面板底部提供快捷操作：Refresh（Ctrl+R 刷新）、Settings（Ctrl+, 打开设置）、About、Quit（Ctrl+Q 退出）。

在设置中启用服务商

上图是Settings → Providers页面，分为左右两栏：

• 左栏是服务商列表，支持搜索框按名称或 ID 过滤，绿色圆点表示该服务商当前正常。
• 右栏是当前服务商详情，例如 Codex 会显示账号、套餐、认证类型（OAuth / Cookie / CLI），以及会话与每周两条用量进度条。

在详情页你可以按需配置：

• Tray Display：选择哪个窗口驱动托盘百分比（如 Automatic）；
• Cookie source：Automatic/Manual/Disabled；
• Credential Storage：API key 与手动 Cookie 都标注Protected (windows-dpapi-user)。

完整的 56 款服务商清单、各自认证方式与跟踪内容见 docs/PROVIDERS.md。

5 种凭据方式，总有一种适合你

不同服务商读取用量走不同通道，Win-CodexBar 都做了封装，你只需按类型填一次：

浏览器 Cookie 导入是最方便的免登录方式：它在本地读取你浏览器的 Cookie 并用 DPAPI 解密，只有你启用的服务商对应域名才会被提取，详见 docs/COOKIES.md。若自动导入失败（例如新版 Chromium 的 App-Bound 加密），可手动粘贴 Cookie 头作为兜底。

用 CLI 把用量接进脚本与 CI

除了托盘面板，Win-CodexBar 还带一个codexbar命令行工具，桌面与 CLI 共享同一份配置，适合自动化场景：

codexbar usage -p claude # 查询单个服务商 codexbar usage -p all # 查询所有已启用服务商 codexbar cost -p codex # 本地 token 成本（基于 JSONL 日志） codexbar config providers # 列出启用的服务商

完整命令与参数说明见 docs/CLI.md。你还可以用它给脚本或 CI 加一道"额度低于阈值就暂停"的闸门。

隐私与安全：数据不出本机

很多用户最关心"我的凭据安不安全"。Win-CodexBar 的设计是默认本地：

• 零遥测：不发送任何数据到项目方服务器，无分析、无崩溃上报、无广告 SDK；
• DPAPI 加密：API Key、手动 Cookie、Token 账户经安全文件层写入，Windows 上优先用用户级 DPAPI 保护；
• 按需提取：只有你启用的服务商才会读取对应浏览器的 Cookie；
• 配置路径：全部保存在%AppData%\Roaming\CodexBar\，运行codexbar config path可查询实时位置，见 docs/CONFIGURATION.md；
• 安全诊断：诊断快照只含服务商 / 来源 / 状态元数据，绝不包含原始 Cookie 或 API Key。

删除%APPDATA%\CodexBar\和%LOCALAPPDATA%\CodexBar\两个目录即可彻底清除所有痕迹。

从源码构建（可选）

如果你是开发者，想自己编译，前置只要 Node.js + pnpm（Rust 和 MinGW 会由脚本自动安装）：

git clone https://gitcode.com/gh_mirrors/wi/Win-CodexBar.git cd Win-CodexBar .\scripts\dev.ps1

构建流程与细节见 docs/BUILDING.md。底层架构上，所有服务商都通过唯一工厂 rust/src/core/provider_factory.rs 实例化，每家逻辑隔离在 rust/src/providers/ 下；新增服务商时缺少匹配分支会直接编译报错，保证不遗漏。

常见问题

Q：需要登录每个 AI 平台吗？A：不需要逐个登录网页。基于 Cookie 的服务商只需导入一次浏览器 Cookie；基于 CLI 的（Codex、Gemini、Claude Code）确保对应 CLI 已登录即可。

Q：超额会显示什么？A：会显示真实百分比（如 Copilot 超额显示115% used），进度条保持满格避免溢出。

Q：数据会被上传吗？A：不会。应用只在你显式配置某服务商后，才连接该服务商自己的 API，其余数据都留在本机。

Win-CodexBar 把"额度焦虑"从十几个网页标签里解放出来，一个托盘图标即可掌控 56 款 AI 编码工具的用量与配额。现在就winget install Finesssee.Win-CodexBar，几分钟内让用量尽收眼底。