01
产品简介
Workbuddy Muxo 是一个多账号统一管理工具，把平时分散在各个客户端里的登录态集中管理：
- 一次扫码接入账号，随时一键切换，不用反复退出登录
- 统一查看各账号的 Token 用量、积分、签到状态
- 支持备份 / 迁移账号（导出 / 导入）
- 附带 Agent Companion 会话悬浮窗，随时唤出 AI 会话栏
i
数据只保存在本机（
%APPDATA%\com.wbswitch.app），不上传服务器。02
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 1803 及以上 / Windows 11（x64） |
| WebView2 运行时 | 必需；Win10 / 11 一般已自带，缺失时安装程序会联网下载 |
| 网络 | 可选；仅用于版本更新、账号校验、广告位展示 |
| Node.js / Rust | 不需要（仅开发构建时需要） |
03
安装与卸载
安装
下载安装包（百度网盘）
提取码 33vm
- 双击
workbuddy-muxo_0.1.67_x64-setup.exe - 若出现 SmartScreen / 360 提示「未知发布者」，选择「更多信息 → 仍要运行」或「允许程序运行」
- 按向导下一步完成安装（默认安装到当前用户目录，无需管理员权限）
- 安装完成后自动创建开始菜单与桌面快捷方式
卸载
- 开始菜单 → 右键 Workbuddy Muxo → 卸载；或
- 设置 → 应用 → 已安装的应用 → Workbuddy Muxo → 卸载
!
卸载默认保留账号数据目录；如需彻底清空，手动删除
%APPDATA%\com.wbswitch.app。04
界面总览
启动后是单窗口应用，左侧为固定导航，右侧为内容区：
- 账号管理
- 关联会话
- Token 统计
- 积分统计
- 设置
广告位
- 左上角品牌标识与版本号
- 左中5 个功能入口
- 左下广告位（轮播图 + 3 条文字链接，自动轮换）
- 右上角各客户端图标状态（WorkBuddy / CodeBuddy IDE / JetBrains / VS Code 插件）
05
账号管理
5.1 添加账号（OAuth 扫码）
- 进入「账号管理」
- 选择 国内版 / 国际版（按你实际使用的服务区选择）
- 点击 「OAuth 扫码添加」
- 用对应客户端或手机完成扫码授权
- 授权成功后，账号会出现在下方「账号」列表
i
同一台机器上已经登录过的账号，也会被识别，建议一并加入，方便随时切回。
5.2 切换账号
- 在账号卡片上点击 「切换」
- 系统会把当前账号的登录态替换为目标账号，并自动重启相关的 CodeBuddy CLI 进程
- 切换完成后，打开客户端即为新账号
5.3 账号详情
点击账号卡片上的「…」或信息区，可查看：
- 邮箱 / UID
- 积分、积分包、有效期
- 当前 Token 用量
- 删除该账号（仅删除本机记录，不影响官方账号）
5.4 导入 / 导出备份
| 操作 | 说明 |
|---|---|
| 导出 | 把本机所有账号的登录态打包成备份文件，用于换机或重装 |
| 导入 | 选择备份文件批量恢复账号 |
!
备份文件包含登录凭据，请妥善保管，不要外传。
5.5 CodeBuddy CLI 接入
- 点击「接入 CLI」可把当前账号写入 CodeBuddy CLI 的
settings.json认证信息 - 切换账号时会自动刷新 Token；若 CLI 正在运行，切换过程会先关闭 CLI，重新打开即为新账号
06
关联会话
用于管理 AI 编码会话（本地会话文件与 VS Code 侧会话的关联 / 同步）：
- 查看会话树、会话分组
- 同步会话到 VS Code / 指定目录
- 复制会话内容
i
若你只做账号切换，这一页可以不用。
07
Token 统计 / 积分统计
| 页面 | 内容 |
|---|---|
| Token 统计 | 各账号的 Token 消耗趋势与占比，便于判断哪个账号额度先耗尽 |
| 积分统计 | 各账号积分余额、积分包构成、到期情况 |
数据来自官方接口，打开页面时实时拉取。
08
设置
设置页按卡片分组：
| 卡片 | 作用 |
|---|---|
| 启动设置 | 「开机时静默启动到托盘」开关（直接反映系统登录项状态）；之后可从托盘「打开主界面」恢复窗口 |
| 外观 | 主题：浅色 / 深色 / 跟随系统 |
| Agent Companion | 「启用会话悬浮窗」开关 + 「悬浮窗设置」按钮 |
| 自动签到 | 为允许的账号自动核验并补签；可设置时间窗口（留空不限），可在下方按账号关闭；含签到日志 |
| 自动旅行 | 按官方状态自动派发 / 领取旅行奖励（国际版无此项） |
| CodeBuddy CLI 自动轮换 | 按策略在多个 CLI 账号间自动轮换；含轮换日志 |
| 限额监听 | 监控额度耗尽情况并提醒 |
| 权限检测 | 检查各客户端目录 / 文件权限是否满足读写 |
| 自动更新 | 检查并安装新版本（也可从托盘菜单触发） |
| 错误日志 / 通知历史 | 排查问题用；可查看、清空 |
| 支持工具 | 打开数据目录、GitHub Release 等 |
09
Agent Companion 会话悬浮窗
- 开启方式：设置 → Agent Companion → 启用会话悬浮窗
- 关闭方式：同一开关，或 托盘右键 → 取消勾选 Agent Companion
- 表现：屏幕右侧出现一个小图标（猫咪头像胶囊），点击展开为竖向会话栏；可拖动到任意位置（位置会被记住）
- 若被主窗口遮挡，把主窗口移开或点托盘菜单即可看到
!
悬浮窗由同目录的
agent-studio-runtime.exe 提供，不要单独删除该文件。10
托盘与窗口行为
- 程序常驻系统托盘（右下角）
- 托盘右键菜单：打开主界面 / 显示或隐藏悬浮窗 / 检查更新 / 退出
- 开机静默启动时窗口不弹出，需从托盘「打开主界面」唤出
- 本程序为单实例：重复双击只会唤起已运行的窗口
11
常见问题（FAQ）
Q1双击没反应 / 打不开？
A
① 检查是否已在运行（看托盘图标）；② 被 360 拦截时在「信任区」加入程序目录；③ 查看 设置 → 错误日志。
Q2界面白屏或样式异常？
A
多为 WebView2 运行时损坏。装一次「Microsoft Edge WebView2 Runtime」即可。
Q3右侧出现一个「奇怪的小窗」？
A
那是 Agent Companion 悬浮窗。关闭：托盘右键取消勾选，或 设置 → Agent Companion 关闭。若显示为「复制了一份侧栏」，说明
companion 资源缺失——用安装版不会出现。Q4点了广告没打开浏览器？
A
客户端通过系统浏览器打开链接；若系统 http / https 关联损坏，会打开失败。本程序已内置直接拉起 Chrome / Edge 的兜底逻辑。
Q5切换账号后 CLI 报未登录？
A
切换时会重启 CLI，重新打开即可；若仍异常，点「接入 CLI」重新写入。
Q6换电脑怎么迁移？
A
旧机「导出备份」→ 新机安装后「导入备份」；或直接拷贝
%APPDATA%\com.wbswitch.app。Q7安装包提示「未知发布者」？
A
安装包未做代码签名，属正常现象，允许运行即可。
12
数据与日志位置
| 内容 | 路径 |
|---|---|
| 应用数据（账号、悬浮窗配置等） | %APPDATA%\com.wbswitch.app\ |
| 悬浮窗开关 | %APPDATA%\com.wbswitch.app\agent-studio-enabled.json |
| 悬浮窗位置 | %APPDATA%\com.wbswitch.app\agent-studio-rail-position.json |
| 错误日志 | 设置 → 错误日志（可打开所在目录） |