🔨 HWXT 自动构建插件
一键触发 hamsos 和 lams 项目构建的 VSCode 插件
解决浏览器跨域限制 | 支持可配置 API | 实时日志监控
✨ 核心功能
| 功能 |
说明 |
支持项目 |
| 🚀 一键构建 |
快捷键快速启动构建流程 |
hamsos (ZIP) / lams (WAR) |
| 🌐 跨域解决 |
解决浏览器 API 调用跨域限制 |
全部 |
| ⚙️ 灵活配置 |
API 地址和 Token 可自定义 |
全部 |
| 📊 实时日志 |
VSCode 输出面板显示详细日志 |
全部 |
| 📧 邮件通知 |
构建完成自动邮件通知 |
全部 |
| 🎨 友好界面 |
简洁美观的 WebView 操作界面 |
全部 |
🚀 快速开始
💾 安装插件
从 VSIX 安装（推荐）
- 下载最新的
.vsix 文件
- VSCode 中按
Ctrl+Shift+P
- 输入
Extensions: Install from VSIX
- 选择下载的
.vsix 文件
从源码安装
git clone https://cnb.cool/zrz2025/hwxt_build_vs_plugin.git
cd hwxt-build
npm install
# 按 F5 启动调试模式
📖 使用指南
🎯 启动方式
| 方式 |
操作 |
说明 |
| 快捷键 |
Alt+Z Alt+Z |
⭐ 推荐方式，快速启动 |
| 命令面板 |
Ctrl+Shift+P → HWXT: 打开构建面板 |
通过命令面板启动 |
| 编辑器按钮 |
文件编辑器右上角工具栏 |
JS/TS/JSON 文件可见 |
📋 操作步骤
graph TD
A[启动插件] --> B[配置 API]
B --> C[选择项目]
C --> D[填写参数]
D --> E[开始构建]
E --> F[查看日志]
1️⃣ 启动插件
按 Alt+Z Alt+Z 或通过命令面板打开构建面板
2️⃣ 配置 API
- API Token：填写访问令牌（必填）
- API 地址：默认已配置，可根据环境调整
3️⃣ 选择项目
- hamsos：构建 ZIP 安装包
- lams：构建 WAR 部署包
4️⃣ 填写参数
- 分支名称：如
main、develop
- 邮箱地址：接收构建结果通知
5️⃣ 开始构建
点击「开始构建」按钮，系统自动处理
6️⃣ 查看日志
在 VSCode 输出面板监控构建进度和结果
⚙️ 配置说明
🔑 API 配置
| 配置项 |
类型 |
必填 |
说明 |
| API Token |
string |
✅ |
构建服务访问令牌 |
| API 地址 |
string |
✅ |
构建服务接口地址 |
💡 提示：Token 在会话期间会被保持，API 地址支持不同环境切换
📝 构建参数
| 参数 |
hamsos |
lams |
说明 |
| 分支名称 |
✅ |
✅ |
Git 分支，如 main、develop |
| 邮箱地址 |
✅ |
✅ |
接收构建完成通知 |
| 构建类型 |
ZIP 包 |
WAR 包 |
自动根据项目选择 |
🌍 环境适配
- 开发环境：
https://dev-api.example.com/build
- 测试环境：
https://test-api.example.com/build
- 生产环境：
https://api.cnb.cool/zrz2025/lams_build/-/build/start
🛠️ 故障排除
❓ 常见问题
🌐 跨域错误
插件专门设计来解决跨域问题，如果仍遇到跨域错误：
- 检查网络连接
- 确认防火墙设置
- 验证 API 地址是否正确
🔑 Token 无效
- 确认 Token 格式正确
- 检查 Token 是否已过期
- 查看输出日志获取详细错误信息
🌍 网络连接失败
- 检查网络连接状态
- 确认防火墙和代理设置
- 尝试使用其他网络环境
⚠️ 构建失败
- 查看 VSCode 输出面板详细日志
- 确认分支名称和邮箱格式
- 检查构建服务状态
📊 日志查看
| 位置 |
用途 |
访问方式 |
| 输出面板 |
详细构建日志 |
VSCode → 输出 → "HWXT 构建插件" |
| 命令面板 |
快速打开日志 |
Ctrl+Shift+P → "HWXT: 打开输出日志" |
🤝 支持与反馈
| |
