WorkBuddy与CodeBuddy多账号管理工具使用经验：账号切换与用量统计方法
工具简介
同时使用多个 WorkBuddy 或 CodeBuddy 账号时，如果每次都手动退出、重新登录，不仅操作比较繁琐，也不方便查看不同账号的积分和使用情况。workbuddy-switch主要用于解决多账号管理问题，可以将多个账号集中保存，并根据实际使用需求进行切换。
除了桌面应用之外，workbuddy-switch还提供 npm / WebUI 使用方式，支持 Windows、macOS 和 Linux 等环境。根据不同使用场景，还可以管理 WorkBuddy、CodeBuddy CLI 和 CodeBuddy CN IDE 的认证配置。
本文由我的站长站整理，主要记录该工具的功能特点和实际使用方法。如果平时只使用一个账号，工具中的部分功能可能用不上；如果账号数量较多，集中管理会更加方便。
工具功能内容
| 功能模块 | 功能说明 |
|---|---|
| 账号管理 | 支持OAuth扫码登录、本机账号导入以及手动添加token等方式管理账号。 |
| 账号切换 | 根据目标账号更新本地认证配置，并重新启动对应的客户端环境。 |
| 会话复制 | 可以将选定会话复制到其他账号，同时处理相关本地数据和索引。 |
| 自动签到 | 支持启动检查、定时检查以及手动执行全部账号签到。 |
| Token保活 | 按照设定条件检查并刷新认证信息，减少长期未使用造成的认证失效问题。 |
| 积分到期查询 | 查看账号积分资源、剩余数量和到期时间，并对临近到期的资源进行提示。 |
| 积分统计 | 查看请求用量、使用趋势、模型分类、账号消耗和请求明细。 |
| Token统计 | 统计WorkBuddy、CodeBuddy CLI和CodeBuddy IDE的Token使用情况。 |
| CodeBuddy CLI | 使用独立的CLI认证配置，并可以从统一账号库选择后续会话使用的账号。 |
| CodeBuddy CN IDE | 根据桌面客户端的本地认证信息进行账号切换，与CLI认证环境相互独立。 |
| 自动轮换 | 根据账号状态和积分到期情况，为后续CLI会话选择合适的账号。 |
| 自动更新 | 通过GitHub Releases检查新版本，并使用应用自身的更新机制完成升级。 |
| 权限检测 | macOS环境提供应用管理和完全磁盘访问权限的检测及操作提示。 |
安装方式
workbuddy-switch目前可以通过桌面应用或 npm / WebUI 使用。对于普通桌面用户，使用Tauri桌面版本会更加直观；习惯终端和浏览器管理方式的用户，则可以使用npm版本。
桌面版本
桌面版适用于Windows、macOS和Linux。可以在项目的GitHub Releases页面查看对应系统的安装包，安装后直接运行应用。
项目地址：https://github.com/changexbc/workbuddy-switch
npm / WebUI版本
如果不需要使用完整桌面应用，也可以通过npm安装：
npm i -g workbuddy-switch
安装完成后运行：
workbuddy-switch
随后按照终端提示访问对应的Web管理界面即可。具体启动方式可能会随着项目版本变化，实际操作时以当前版本说明为准。
账号管理与切换
首次使用时，可以先将需要管理的账号添加到账号列表。根据当前环境不同，可以选择OAuth扫码登录、从本机导入或者手动添加认证信息。
添加账号
打开账号管理页面。
选择扫码登录、从本机导入或手动添加。
按照页面提示完成认证。
确认账号已经出现在账号列表中。
切换账号
选择需要使用的目标账号后执行切换操作，工具会根据对应平台处理本地认证文件，然后重新启动相关客户端环境。
这种方式的重点并不是同时让多个账号处于同一个客户端登录状态，而是方便在不同账号之间快速更换当前使用的认证环境。因此，如果正在运行重要任务，最好先确认任务状态，再进行账号切换。
会话复制
部分使用场景还需要保留原账号中的会话内容。workbuddy-switch提供会话复制功能，可以选择需要复制的会话，并将相关数据写入目标账号。
由于这类操作会涉及本地数据库、会话文件和索引数据，使用前建议做好备份。不要为了迁移少量数据而直接删除原有数据库，以免出现无法恢复的情况。
自动签到与Token保活
如果账号需要定期执行签到，可以开启自动签到功能。工具支持启动时检查，并按照设定周期进行检查，同时保留一定时间范围内的签到记录。
Token保活主要用于检查认证状态，在执行相关操作之前按照设定阈值进行刷新，也可以按照每日策略进行维护。
实际使用时没有必要将刷新周期设置得过于频繁。认证信息属于账号的重要凭证，频繁操作反而可能增加异常情况排查的难度，应根据相关服务的正常使用规则设置。
积分到期查询
多账号环境下，逐个登录查看积分比较麻烦，因此积分到期查询是比较实用的辅助功能。工具可以整理不同账号的积分资源、剩余数量以及到期时间，并对临近到期的资源进行提示。
需要更新数据时，可以在账号页面执行「刷新积分」。账号较多时，可以按照到期时间查看不同账号的资源状态，这样比单纯按照账号名称查找更加直观。
需要注意的是，积分数据属于服务端信息，第三方工具显示的数据可能受到接口状态、缓存和更新时间影响。如果工具显示的数据与官方页面存在差异，应以官方页面实际数据为准。
积分统计与Token统计
除了查看当前积分之外，workbuddy-switch还提供使用统计功能，可以从时间、账号、模型和请求等多个角度了解使用情况。
积分统计可以查看整体使用情况、每日变化、模型分类、账号消耗以及请求明细。Token统计则分别整理WorkBuddy、CodeBuddy CLI和CodeBuddy IDE的输入、输出及缓存读写数据。
| 统计项目 | 主要内容 |
|---|---|
| 积分总览 | 查看不同账号的积分资源情况。 |
| 使用趋势 | 了解近期每天的使用变化。 |
| 模型分类 | 查看不同模型的调用情况。 |
| 账号消耗 | 了解不同账号的资源使用情况。 |
| 请求明细 | 查看具体请求相关记录。 |
| Token构成 | 查看输入、输出以及缓存Token。 |
| 项目排行 | 查看Token使用较多的项目。 |
| 模型排行 | 查看不同模型的Token使用情况。 |
| 会话排行 | 了解不同会话的资源消耗情况。 |
CodeBuddy CLI账号切换
CodeBuddy CLI可以与WorkBuddy共用账号管理库，但实际运行时仍然使用自己的认证配置。也就是说，账号集中保存并不代表CLI和WorkBuddy会完全共享当前登录状态。
在macOS和Linux环境中，可以通过apiKeyHelper处理相关认证；Windows环境则涉及settings.JSON中的env.CODEBUDDY_AUTH_TOKEN配置。
执行CLI账号切换后，新的认证配置主要用于后续启动的CLI会话。已经运行中的会话不会因为账号列表发生变化而自动切换，因此如果需要使用新的账号，通常需要重新加载或重新启动CLI。
CodeBuddy CN IDE账号切换
CodeBuddy CN IDE采用独立的桌面客户端认证机制，与CodeBuddy CLI的认证环境并不是同一套配置。工具可以通过本地Safe Storage相关数据完成账号切换，然后重新启动CodeBuddy CN客户端。
首次使用前，建议先正常启动CodeBuddy CN并完成一次登录，让客户端建立所需的本地认证环境，之后再使用账号切换功能。
如果同时使用CLI和IDE，不要把两者的账号状态混在一起判断。CLI切换完成后，并不意味着IDE当前登录账号也会同步变化。
自动轮换功能
当账号数量比较多时，可以使用自动轮换功能。工具会根据设定的检查周期分析账号状态，并结合积分到期情况选择后续CLI会话使用的账号。
这里需要特别注意，自动轮换并不是强制修改正在运行的会话。已经启动的CLI任务仍然使用原有认证环境，新的账号配置主要作用于后续启动或重新加载的会话。
因此，在执行长时间任务时，不建议误以为开启自动轮换后当前任务会立即更换账号。实际使用前应先确认当前版本的轮换规则和生效时机。
日常使用中的安全注意事项
这类多账号管理工具会接触本地认证文件、Token、数据库和客户端配置，因此数据安全比功能本身更加重要。
不要将包含Token或认证信息的文件上传到公开代码仓库。
不要把完整认证凭证发送给其他人。
迁移账号之前先备份原有配置。
不要随意删除客户端数据库或认证文件。
使用共享电脑时，应特别注意本地账号残留和登录状态。
发现认证异常时，优先检查官方客户端和账号状态。
升级与版本兼容
workbuddy-switch可以通过GitHub Releases获取新版本，并支持应用自身的更新机制。由于WorkBuddy、CodeBuddy CLI、CodeBuddy CN IDE以及工具本身都会进行版本更新，不同版本之间的本地配置和认证方式可能发生变化。
如果升级后出现账号无法识别、切换失败或者统计数据异常，建议先确认当前工具版本和相关客户端版本，再查看项目最新说明。不要在没有备份的情况下直接修改本地认证数据库。
其他说明
macOS用户在使用涉及本地应用数据的功能时，可能需要按照系统提示授予应用管理或完全磁盘访问等相关权限。如果没有对应权限，部分本地配置读取或修改功能可能无法正常工作。
对于正在执行的重要任务，建议在切换账号、更新应用或者修改认证配置之前先确认任务已经保存。客户端重新启动可能导致正在运行的操作中断，这一点在日常使用中需要特别注意。
工具具体支持哪些功能，可能会随着项目版本变化而调整。因此，本文主要作为使用经验整理，实际界面、配置名称和操作流程应以当前版本项目说明为准。
使用体验
从实际使用角度来看，workbuddy-switch主要解决的是多账号管理带来的重复操作问题。账号数量较少时，手动切换可能并不会明显增加工作量；当账号数量增加后，统一查看账号状态、积分到期时间和Token使用情况会更加方便。
其中，账号切换、积分到期查询和用量统计属于比较直观的功能，而自动签到、Token保活和自动轮换更适合有持续管理需求的用户。没有对应需求时，不必为了使用全部功能而增加复杂配置。
本文由我的站长站整理分享。对于涉及账号认证、本地数据库和Token的操作，建议以数据安全为前提，先备份再调整，同时结合当前版本的实际功能进行使用。