MCP Server.exe

# 版本发布指南 ## 自动发布流程 本项目可以通过 GitHub Actions 自动打包并发布可执行文件到 GitHub Releases（如已配置工作流）。 ### 如何发布新版本 1. 确保所有更改已经提交并推送到主分支 2. 为新版本创建一个标签并推送： ```bash # 更新版本号（例如从0.1.2到0.1.3） npm version patch # 小版本更新，例如 0.1.2 -> 0.1.3 # 或者 npm version minor # 中等版本更新，例如 0.1.2 -> 0.2.0 # 或者 npm version major # 主要版本更新，例如 0.1.2 -> 1.0.0 # 推送代码和标签到远程仓库 git push && git push --tags ``` 3. GitHub Actions 将自动执行以下操作（若已配置工作流）： - 构建项目（`npm run build`） - 为每个支持的平台打包可执行文件: - Windows x64（`npm run package-win`） - macOS Intel x64（`npm run package-mac-intel`） - macOS Apple Silicon（`npm run package-mac-arm`） - 创建一个新的 GitHub Release - 将可执行文件上传到该 Release 4. 发布完成后，可以在 GitHub 仓库的 Releases 页面查看和下载所有平台的可执行文件。 ### 支持的平台 - **Windows x64**: `executables/mcp_server-win-x64.exe` - **macOS Intel x64**: `executables/mcp_server-macos-x64` - **macOS Apple Silicon**: `executables/mcp_server-macos-arm64` ### 手动触发发布 如果需要手动触发发布流程，可以执行以下步骤： 1. 创建并推送一个带有 `v` 前缀的标签（例如 `v1.0.0`）： ```bash git tag v1.0.0 git push origin v1.0.0 ``` 2. GitHub Actions 将自动执行发布流程（如已配置）。 ### 本地打包（无需 CI） 如需本地构建可执行文件并手动上传 Release： ```bash # 安装依赖 npm install # 构建 npm run build # 打包 npm run package-win # Windows x64 npm run package-mac-intel # macOS Intel x64 npm run package-mac-arm # macOS ARM64 ``` 产物位于 `executables/` 目录。 ### 注意事项 - 发布前请更新 `package.json` 中的版本号 - 建议在发布前本地运行：`npm run build && npm test`（如有测试） - Windows 打包会在 `postbuild` 阶段复制 `node-notifier` 的二进制资源到 `executables/notifier/` - Actions 工作流需要访问 `secrets.GITHUB_TOKEN`