Skip to content

提交与发布节奏 ​

分支与提交 ​

  • 主分支 main 始终可发布;
  • 功能改动走短分支,合并前本地跑一次 npm run build;
  • 提交信息用「动词 + 对象」:新增文本对比工具、修复手机版弹层遮挡、文档补充证书续期;
  • 一个提交只做一件事,避免「顺手改样式 + 加工具 + 改部署脚本」混在一起。

发布的三种粒度 ​

场景命令影响
新增 / 修改工具./deploy.sh pc、必要时加 mobile主站页面与资源
只写随笔./deploy.sh blog随笔站
只更新文档./deploy.sh docs文档站
改了 nginx 模板./deploy.sh nginx / ./deploy.sh sites服务器配置(会先备份 + nginx -t)

发布窗口 ​

  • 工具站用户以国内为主,晚上 20:00–23:00 是访问高峰,尽量避开;
  • 大版本(改路由、改缓存策略)选在早上,出问题有一整天可以回滚;
  • 彩票工具依赖构建期抓取的数据,每期开奖后数据会更新,发版时注意 fetch-lottery 的日志。

变更记录 ​

每次发布在 docs-site/changelog.md 追加一条,格式:

md
## 2026-11-20

- 新增 `docs.emphant.com` 与 `blog.emphant.com` 两个子站
- 发布脚本支持 `docs` / `blog` / `sites` 三个目标

只记录「用户能感知的变化」和「运维方式的变化」,内部重构不必逐条列。

回滚 ​

发布前脚本已经把旧版本打包到 /var/www/.releases/,回滚步骤见 备份与回滚。

文档随仓库一起更新,站点内容全部在浏览器本地运行。