---

功能	说明	支持项目
🚀 一键构建	快捷键快速启动构建流程	hamsos (ZIP) / lams (WAR)
🌐 跨域解决	解决浏览器 API 调用跨域限制	全部
⚙️ 灵活配置	API 地址和 Token 可自定义	全部
📈 实时日志	VSCode 输出面板显示详细日志	全部
📅 构建历史	保存最近20条构建记录，数据持久化	全部
⏰ 状态监控	实时显示构建状态和进度	全部
📧 邮件通知	构建完成自动邮件通知	全部
🎨 友好界面	简洁美观的 WebView 操作界面	全部

1. 从 VSIX 安装（推荐）

   • 下载最新的 .vsix 文件
   • VSCode 中按 Ctrl+Shift+P
   • 输入 Extensions: Install from VSIX
   • 选择下载的 .vsix 文件

2. 从源码安装

   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 文件可见

按 Alt+Z Alt+Z 或通过命令面板打开构建面板

• API Token：填写访问令牌（必填）
• API 地址：默认已配置，可根据环境调整

• hamsos：构建 ZIP 安装包
• lams：构建 WAR 部署包

• 分支名称：如 main、develop
• 邮箱地址：接收构建结果通知

点击「开始构建」按钮，系统自动处理，50秒后开始轮询构建结果

• 插件会自动保存最近20条构建记录
• 显示构建状态：构建中、成功、失败、超时
• 成功构建可一键复制下载地址
• 支持删除单条记录或清空所有历史

在 VSCode 输出面板监控构建进度和结果

插件提供完善的构建历史管理功能：

• 自动保存：最夐20条构建记录，超出自动删除最旧记录
• 状态显示：构建中🔵 | 成功✅ | 失败❌ | 超时⚠️
• 详细信息：项目类型、分支名称、开始时间、完成时间

• 一键复制：成功构建可直接复制下载地址到剪贴板
• 删除记录：支持删除单条记录或清空所有历史
• 有效期提醒：构建产物12小时有效期提示

• 自动存储：利用VSCode全局状态，重启后自动加载
• 无缝体验：关闭插件重新打开，历史记录依然存在

---

状态	显示	描述
构建中	🔵	构建请求已发送，等待轮询结果
成功	✅	构建完成，可下载构建产物
失败	❌	构建过程出错，请查看日志获取详情
超时	⚠️	轮询5分钟后仍未完成，请手动检查

---

配置项	类型	必填	说明
API Token	string	✅	构建服务访问令牌
API 地址	string	✅	构建服务接口地址

💡 提示：Token 在会话期间会被保持，API 地址支持不同环境切换

参数	hamsos	lams	说明
分支名称	✅	✅	Git 分支，如 main、develop
邮箱地址	✅	✅	接收构建完成通知
构建类型	ZIP 包	WAR 包	自动根据项目选择

🌐 跨域错误

插件专门设计来解决跨域问题，如果仍遇到跨域错误：

• 检查网络连接
• 确认防火墙设置
• 验证 API 地址是否正确

🔑 Token 无效

• 确认 Token 格式正确
• 检查 Token 是否已过期
• 查看输出日志获取详细错误信息

🌍 网络连接失败

• 检查网络连接状态
• 确认防火墙和代理设置
• 尝试使用其他网络环境

⚠️ 构建失败

• 查看 VSCode 输出面板详细日志
• 确认分支名称和邮箱格式
• 检查构建服务状态

位置	用途	访问方式
输出面板	详细构建日志	VSCode → 输出 → "HWXT 构建插件"
命令面板	快速打开日志	Ctrl+Shift+P → "HWXT: 打开输出日志"

• 📝 问题反馈：Issues
• 📚 开发文档：查看 BUILD.md 了解构建发布详情
• 📧 联系我们：hwxt-dev@example.com

---