企业官网建设流程全解析

Win-CodexBar 是一款面向 Windows 原生的用量监控工具，能免登录查看 OpenAI Codex、Claude Code 等多家 AI 服务商的配额消耗。其中浏览器 Cookie 导入功能让工具直接从你本地浏览器读取登录态，无需任何手动登录或填写 API Key。本文详解 Windows DPAPI 自动解密原理、一键导入步骤、手动粘贴 Cookie header 的实战方法，以及 ABE 加密、WSL 等常见坑位。

为什么需要导入浏览器 Cookie？

CodexBar 的核心价值是"不登录、不填 Key，直接看用量"。对于通过网页登录的服务商（Claude、Cursor、Kimi 等），最便捷的认证方式就是复用你浏览器里已有的登录态：

• 自动导入：CodexBar 读取浏览器 Cookie 数据库，用当前 Windows 用户的 DPAPI 凭据解密，只提取已启用服务商域名下的 Cookie（如claude.ai）
• 手动粘贴：自动解密被阻止时，从 DevTools 复制Cookie请求头粘贴到设置页

整个过程 Cookie 只保存在内存和受 DPAPI 保护的本地文件中，每次轮询服务商时自动刷新。

Windows DPAPI 自动解密是怎么工作的

Chromium 系浏览器（Chrome、Edge、Brave 及 Chromium）把 Cookie 存进 SQLite 数据库，用DPAPI + AES-256-GCM双层加密；Firefox 则是不加密的 SQLite。

自动导入的流程只有 4 步：

1. 读取浏览器标准位置的 Cookie 数据库
2. 用当前用户凭据经 Windows DPAPI（CryptUnprotectData）解出 AES 密钥，再解密 Cookie
3. 只提取已启用服务商对应域名的 Cookie
4. 保存在内存中，每次轮询刷新

相关实现可参考 rust/src/browser/cookies.rs 中的dpapi_decrypt函数，以及 docs/COOKIES.md 的官方说明。

⚠️关键限制：新版 Chromium 引入了App-Bound Encryption（ABE），把 Cookie 密钥绑定到浏览器安装本身（Local State中出现app_bound_encrypted_key、Cookie 值带v20前缀）。CodexBar不会绕过这层保护——此时自动导入会失败，只能改用手动粘贴或 Firefox。

支持的浏览器一览

每个 Chrome 渠道都是独立的导入选项，只读取自己的User Data配置文件，互不干扰。

一键自动导入：3 步搞定

1. 打开Settings→ 切换到Providers选项卡
2. 在左侧列表选择目标服务商（如 Claude、Cursor），在右侧详情面板找到Browser Cookies区域
3. 在下拉框中选择已检测到的浏览器（会显示配置文件数量），点击Import

对应界面逻辑见 apps/desktop-tauri/src/surfaces/settings/providers/CookieSection.tsx。

导入成功后面板会显示绿色的成功提示与保存时间戳；想清除已保存的 Cookie，点Remove即可。

手动粘贴 Cookie header：ABE 与 WSL 的救命方案

当自动导入被 ABE 拦截、数据库被锁，或你运行在 WSL 中时，用手动粘贴兜底：

1. 打开浏览器，登录服务商官网（如claude.ai）
2. 按F12打开 DevTools，切到Network标签
3. 刷新页面，点击任意一条发往该服务商的请求
4. 在Request Headers中复制整个Cookie头的值
5. 回到 CodexBar 的Settings → 服务商详情 → Browser Cookies，把值粘贴进文本框并保存

💡 小贴士：在 Kimi 场景下，Cookie 源设为 automatic 时，CodexBar 还会额外读取 ChromiumLocal Storage中未过期的access_token（Local Storage 不受 ABE 保护），刷新 Token 一律不读取。

实战避坑清单：这些错误你可能都会遇到

📌 一个高频误区：关闭浏览器并不能解除 ABE。ABE 是 Chromium 的能力边界，升级后写入的新 Cookie 一律受保护，只有旧版/未迁移的配置文件里还留有可读的 DPAPI/AES-GCM Cookie。

Cookie 存在哪里？安全吗？

手动保存的 Cookie 与自动导入的结果统一落盘到：

%AppData%\Roaming\CodexBar\manual_cookies.json

该文件通过secure_file模块写入，在 Windows 上使用DPAPI 用户级保护（设置页 Credentials 区域会标注Protected (windows-dpapi-user)），其他用户账号无法读取。存储与目录结构详见 rust/src/settings/manual_cookies.rs 和 docs/CONFIGURATION.md。

快速上手：该选自动还是手动？

• 只用 Firefox→ 全自动，零配置 ✅
• Chrome/Edge/Brave 老配置文件→ 优先试自动导入，失败再看报错
• 新版 Chromium 已启用 ABE / 运行在 WSL→ 直接走手动粘贴方案，一劳永逸
• 多 Chrome 渠道并存→ 下拉框会按渠道分开列出，选你实际登录的那个

掌握这套流程后，无论是本地 Windows 还是 WSL 环境，都能在两分钟内让 CodexBar 完整接管你的多服务商用量监控。更多服务商认证方式（web / cli / oauth 对比）可查阅 docs/PROVIDERS.md。