CodeGenie Toolbox

📖 目录

• 主要特性
• 构建和发布
• 下载和安装
• 常见问题
• 支持的平台
• 联系我们

✨ 主要特性

🎯 MCP安装

自动检测并一键配置MCP服务安装到各类主流 AI 编程助手及 IDE 中。 目前一键配置支持的范围包括：

• CodeBuddy CN
• Cursor
• OpenCode
• VS Code
• Trae CN
• Trae

其他IDE可通过复制mcp json的形式手动配置。

🎯 Skill安装

快速将相关Skill添加到指定路径，Skill持续更新中。

📦 构建和发布

发布流程

1. 版本管理

# 同步版本号到所有配置文件
node scripts/sync-version.js <version>

# 示例：同步到 0.1.11
node scripts/sync-version.js 0.1.11

2. 构建应用

⚠️ 注意：需要在对应平台上构建对应版本

# 构建生产版本（在对应平台上执行）
npm run tauri build

平台构建说明：

• Windows x64：在 Windows 系统上执行构建命令
• macOS ARM64：在 macOS Apple Silicon 系统上执行构建命令
• macOS x64：在 macOS Intel 系统上执行构建命令

构建完成后，安装包位于 src-tauri/target/release/bundle/ 目录中。

3. 准备发布

# 准备发布文件
npm run publish:prepare

# 或准备单个平台
npm run publish:prepare:win32          # Windows x64
npm run publish:prepare:darwin-arm64   # macOS ARM64
npm run publish:prepare:darwin-x64     # macOS x64

4. 发布到 npm

# 发布所有平台
npm run publish:npm

# 或发布单个平台
npm run publish:npm:win32          # Windows x64
npm run publish:npm:darwin-arm64   # macOS ARM64
npm run publish:npm:darwin-x64     # macOS x64

实用命令

查看版本信息

# 查看最新版本号
npm view codegenie-toolbox-win32 version

# 查看所有已发布版本
npm view codegenie-toolbox-win32 versions --json

# 查看标签信息
npm view codegenie-toolbox-win32 dist-tags

标签管理

# 为特定版本设置标签
npm dist-tag add [email protected] beta

下载特定版本

# 下载特定版本
npm pack [email protected]

📥 下载和安装

版本说明

当前提供 Beta 版本（版本号格式：0.x.x），包含最新功能和改进。

下载方式

方式一：npm install（推荐）

# Windows x64
npm install codegenie-toolbox-win32

# macOS ARM64
npm install codegenie-toolbox-darwin-arm64

# macOS x64
npm install codegenie-toolbox-darwin-x64

⚠️ 注意事项：

使用 npm install 下载后，安装包会保存在项目的 node_modules 目录中：

1. 查找安装包位置

# 查看包的安装路径
npm root

# 进入包目录（Windows x64）
cd node_modules\codegenie-toolbox-win32

# 查看目录内容
dir

2. 安装应用

• Windows：在 node_modules\codegenie-toolbox-win32 目录中找到 .exe 文件，双击运行安装
• macOS：在 node_modules\codegenie-toolbox-darwin-arm64 或 node_modules\codegenie-toolbox-darwin-x64 目录中找到 .dmg 文件，双击挂载后拖拽到 Applications 文件夹

3. 说明

• npm install 只是将安装包下载到本地，并不会自动安装应用程序
• 需要手动运行下载的安装包进行安装

方式二：npm pack（获取压缩包）

⚠️ 注意：npm pack 不支持 dist-tags，只能使用具体版本号

# Windows x64
npm pack [email protected]

# macOS ARM64
npm pack [email protected]

# macOS x64
npm pack [email protected]

方式三：curl 直接下载

# 1. 获取最新版本下载地址
npm view codegenie-toolbox-win32 dist.tarball

# 2. 使用 curl 下载
curl -o codegenie-toolbox-win32-0.1.11.tgz <下载地址>

安装步骤

Windows

1. 下载 Windows 版本的安装包（.exe 文件）
2. 双击安装包，按照安装向导进行安装
3. 安装完成后，在开始菜单找到 CodeGenie Toolbox 并启动

macOS

1. 下载 macOS 版本的安装包（.dmg 文件）
2. 双击 .dmg 文件挂载镜像
3. 将 CodeGenie Toolbox 拖拽到 Applications 文件夹
4. 打开 Applications 文件夹，双击 CodeGenie Toolbox 启动

更新方式

应用内更新（推荐）

1. 打开 CodeGenie Toolbox
2. 点击顶部菜单栏的「检查更新」
3. 等待下载完成，点击「重启应用」完成更新

手动更新

1. 卸载当前版本的 CodeGenie Toolbox
2. 按照上述下载和安装步骤安装新版本

❓ 常见问题

如何查看当前安装的版本？

在应用的「关于」页面，可以看到当前版本号和版本类型标签（BETA）。

如何更新到最新版本？

可以通过应用内的「检查更新」功能，或手动下载最新版本进行安装。

💻 支持的平台

| 平台 | 系统要求 | 架构 | | ----------- | ------------------ | ---------- | | Windows | Windows 10 及以上 | x64 | | macOS | macOS 10.15 及以上 | ARM64, x64 |

📞 联系我们

如果您在使用过程中遇到问题，请通过以下方式联系我们：

• 问题反馈：GitHub Issues