从这里开始。

01. 开始之前

BushuTool 在本机运行。请先确认你的项目可以使用原有命令正常构建，并找到构建产物所在目录。

• Web 部署：准备 SSH / SFTP 访问方式、服务器主机指纹和目标目录。
• 小程序部署：准备对应账号的上传凭据与平台要求的白名单配置。
• HBuilderX 工程：先安装并配置本机的 HBuilderX 构建程序。

02. 桌面端使用

当前桌面构建目标为 Windows x64。公开发行包正在整理与验证，发布后可通过工具详情页获取。

首次使用时，在源项目中添加本地工程，然后创建发布环境。需要登录小程序后台时，按工具引导完成对应账号的登录。

03. 本地 Web 使用

适合已经取得项目源码、希望通过本地浏览器操作的用户。需要 Node.js ≥ 22.13，以及项目所需的构建工具。

npm ci
npm run build
npm start

启动后，在浏览器打开 http://127.0.0.1:4390。已安装依赖并生成生产构建时，也可以在 Windows 中运行项目提供的 start.bat。

04. 第一次部署

1. 添加源项目。填写项目目录、构建程序、参数与产物目录。
2. 创建部署环境。选择发布目标并填写访问配置，核对目标目录和主机指纹。
3. 先检查部署条件。确认依赖、路径、权限与产物配置正确。
4. 执行部署。填写版本号和备注，查看任务阶段与日志。
5. 核验最终结果。检查目标环境版本、实际页面与关键资源，保留失败原因以便处理。

第一次体验可以使用“环境总览 → 体验本地部署”，先熟悉构建与版本切换流程。

05. 支持范围与限制

历史产物重部署会复用归档内容，不会自动构建当前源代码。当前功能变化请以更新记录为准。