使用文档 - HotExe

一、快速开始

1. 打开打包面板

下载桌面客户端并双击运行。
注册账号并登录，免费版即可体验基础打包。
点击“新建打包”，进入项目配置页。

2. 配置打包参数

入口文件：选择 Python 主程序，例如 main.py。
打包类型：选择单 EXE、安装包或目录模式。
应用名称：生成 EXE 与安装包时使用的名称。
控制台：按应用类型选择是否显示命令行窗口。

二、热更新详解

启用热更新后，HotExe 会在构建产物中内置更新模块，并生成版本清单。用户端启动时会按策略检测新版本。

{
  "latest": "1.0.2",
  "releases": [{
    "version": "1.0.2",
    "download_url": "https://你的S3/HotExe_v1.0.2.exe",
    "sha256": "abc...",
    "release_notes": "修复登录闪退",
    "patches": [{
      "from": "1.0.1",
      "patch_url": "https://...",
      "patch_size": 765432
    }]
  }]
}

策略	行为
提示更新	弹窗询问，用户可以取消。
强制更新	自动下载并替换，不提供跳过。
静默更新	后台下载，下次启动替换。

三、S3 配置

配置对象存储后，HotExe 会把安装包、EXE、补丁包和版本清单上传到指定 Bucket。

服务商	Endpoint
阿里云 OSS	`https://oss-cn-hangzhou.aliyuncs.com`
腾讯云 COS	`https://cos.ap-guangzhou.myqcloud.com`
AWS S3	`https://s3.amazonaws.com`
雨云	`https://s3-cn-south-1.rainyun.com`
MinIO	`http://你的IP:9000`

四、命令行

hotexe
hotexe build
hotexe build --config 项目名
hotexe build --list
hotexe version

命令行适合复用已经在 GUI 中保存的配置，也方便后续接入自动化构建。

五、常见问题

EXE 通常有多大？

依赖决定体积，普通 Python GUI 应用通常在 50MB 到 100MB 左右。

支持哪些 Python 版本？

支持 Python 3.10 及以上，推荐使用 3.10 或 3.11。

增量更新能省多少？

取决于版本差异，常见场景可节省 95% 到 99% 下载流量。

六、更新日志

v1.0.30 2026-06-21

新增增量更新，显著减少分发流量。
新增 NSIS 安装包。
修复解释器覆盖问题。

v1.0.26

GUI 打包面板上线。
多版本支持。
新增三种更新策略。

5 分钟完成第一次打包与热更新