release.md

发版与热更新说明

返回：README ｜ 相关：部署与运行指南 ｜ 配置说明

当前仓库的 GitHub Actions 会在 push 到 main 后读取 static/version.txt。如果该版本对应的 Release 还不存在，则会自动生成 update_files.json 并创建同名 Release。

自动纳入热更新清单的文件

• 任意目录下的 .py 文件
• 任意目录下的 .html 文件
• static/ 目录下的静态资源，例如 .js、.css、.txt、.json、图片和字体文件
• static/ 目录下的前端源码文件，例如 .ts、.tsx、.jsx、.vue

默认排除的内容

• 用户配置和运行时目录，例如 global_config.yml、data/、logs/、browser_data/、update_backup/、venv/
• 发布和部署文件，例如 .github/、Dockerfile*、docker-compose*.yml、nginx/
• 文档、脚本、数据库和缓存文件，例如 .md、.sh、.sql

建议发版步骤

1. 修改代码或新增需要热更新的文件。

2. 更新 static/version.txt 为新的版本号。

3. 执行发布前检查：

   python3 release_precheck.py

4. 提交并 push 到 main。

5. 等待 Action 自动生成 Release 和 update_files.json。

热更新在覆盖和新增文件之外，还支持通过 manifest 的 deleted_files 清理旧文件。删除前会先备份原文件，再执行清理。