🤖

CodeBuddy Tools

版本 v0.0.1

专为 CodeBuddy AI 代码助手打造的高效管理工具。提供完善的账号管理、令牌自动刷新、批量操作、数据导入导出等功能。支持多种认证方式,界面简洁美观,操作流畅便捷,是 CodeBuddy 用户的最佳伴侣工具。

核心功能

👤 多账号统一管理

  • 支持添加、编辑、删除多个账号
  • 账号信息本地加密存储
  • 快速切换和查看账号状态
  • 批量操作,提升效率

🔄 智能令牌管理

  • 自动检测令牌过期状态
  • 一键刷新所有账号令牌
  • 支持手动和自动刷新模式
  • 实时显示令牌有效期

📦 批量数据操作

  • 支持 JSON 格式批量导入
  • 一键导出所有账号数据
  • 数据备份与恢复功能
  • 智能去重和数据验证

🎯 用户体验优先

  • 现代化的 Material Design 界面
  • 深色/浅色主题自由切换
  • 响应式设计,适配各种屏幕
  • 丰富的快捷键支持

🖼️ 软件预览

CodeBuddy Tools 软件界面截图

💡 提示:以上为软件界面示例,实际界面可能会有所不同

💻 系统要求

操作系统

  • Windows 10/11 (推荐 64 位)

软件依赖

  • Python 3.9 或更高版本
  • PyQt6 或 PySide6 >= 6.5.0
  • requests >= 2.31.0
  • cryptography >= 41.0.0

推荐配置

  • RAM: 至少 4GB,推荐 8GB
  • 磁盘空间: 150MB 可用空间
  • 网络: 稳定的互联网连接(用于令牌刷新)

🚀 快速开始

方法一:使用预编译版本(推荐)

下载 Windows 安装包,直接运行即可使用,无需安装任何依赖。

✨ 无需安装 Python 环境

CodeBuddy Tools 已打包为独立可执行文件,无需安装 Python 或任何依赖库,下载即用
专为 Windows 10/11 系统优化。

📖 功能详解

📊 仪表盘功能

系统监控卡片:

CPU 使用率:实时显示 CPU 使用百分比,每秒自动刷新

内存使用率:显示已用内存和总内存,以及使用百分比

磁盘使用率:显示系统磁盘占用情况


快速操作:

• 管理账号:快速跳转到账号管理页面

• 备份配置:快速跳转到配置备份页面

• 清理工具:快速跳转到实用工具页面


已保存账号:

• 显示已保存的 CodeBuddy 账号列表

• 一键切换到 CodeBuddy 软件(需重启 CodeBuddy)

• 复制账号令牌到剪贴板

👥 账号管理系统

1. 添加账号

• 点击"添加账号"按钮,填写账号信息

• 必填项:账号ID、邮箱、Token、Refresh Token

• 可选项:昵称、套餐类型、备注

• 系统会自动生成缺失的机器码信息


2. 从 CodeBuddy 读取(推荐)

• 点击"📖 从CodeBuddy读取"按钮

• 软件自动扫描 CodeBuddy 配置文件

• 获取当前登录账号的完整信息

• 支持 planning-genie 和 completing-genie 扩展


3. 编辑和删除

• 双击账号行或点击"编辑"按钮修改信息

• 可编辑字段:Token、昵称、备注等

• 点击"删除"按钮移除不需要的账号

⚠️ 删除操作不可恢复,建议先导出备份


4. 切换账号

• 点击账号行的"🔄 切换"按钮

• 系统自动将账号信息写入 CodeBuddy 配置文件

• 关闭 CodeBuddy 软件(如果正在运行)

• 重新启动 CodeBuddy 软件,新账号即可生效


5. 批量导入/导出

导出:点击"📤 导出"按钮,保存为 JSON 格式

导入:点击"📥 导入"按钮,选择 JSON 文件

• 支持跨设备同步账号信息

• 用途:数据备份、多设备同步、团队共享

💾 配置备份与还原

支持的配置类型:

1. 用户设置 (settings.json)

• 编辑器设置(字体、主题、缩进等)

• 快捷键配置

• 扩展设置

• 工作区配置


2. MCP 配置 (codebuddy_mcp_settings.json)

• MCP 服务器配置

• AI 模型设置

• 提示词模板

• 自定义规则


创建备份:

1. 点击"创建备份"按钮

2. 输入备份名称(建议格式:备份名称-日期-版本号)

3. 选择要备份的配置类型

4. 系统自动备份文件到本地


还原备份:

1. 在备份列表中选择要还原的备份

2. 点击"还原"按钮

3. 确认还原操作(会覆盖当前配置)

4. 重启 CodeBuddy 软件使配置生效

⚠️ 建议在还原前先创建当前配置的备份

🛠️ 软件初始化工具

功能描述:

清理 CodeBuddy 相关的所有目录和配置文件,重置软件到全新状态。


使用场景:

✅ CodeBuddy 出现无法修复的错误

✅ 需要重新安装 CodeBuddy

✅ 清理旧版本残留文件

✅ 重置软件到初始状态

✅ 解决插件冲突问题


操作步骤:

1. 进入"实用工具"页面,切换到"软件初始化"标签

2. 查看待清理目录列表和文件大小

3. 点击"开始初始化"按钮

4. 在确认对话框中仔细阅读警告信息

5. 查看实时清理进度和详细日志


清理内容:

• %APPDATA%\CodeBuddy - 主配置目录

• %USERPROFILE%\.codebuddy - 用户级配置

• %USERPROFILE%\CodeBuddy - 项目文件


⚠️ 严重警告

• 此操作会删除所有 CodeBuddy 配置和数据

• 包括用户设置、扩展配置、历史记录等

• 操作不可恢复

强烈建议在操作前使用配置备份功能备份重要配置

🔒 数据安全

双重加密保护:

Windows DPAPI:系统级加密,使用当前用户的登录凭据

AES-256-GCM:应用级加密,256位密钥长度,认证加密模式


加密数据:

✅ 账号 Token

✅ Refresh Token

✅ Access Token

✅ 其他敏感配置


本地存储:

• 所有数据完全存储在本地

Windows: %APPDATA%\CodeBuddyTools\

macOS: ~/Library/Application Support/CodeBuddyTools/

Linux: ~/.config/CodeBuddyTools/


隐私保护:

❌ 不收集个人身份信息

❌ 不收集浏览历史

❌ 不收集使用统计

❌ 不上传任何数据到远程服务器

✅ 软件完全开源透明