主题
提交与发布节奏
分支与提交
- 主分支
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/,回滚步骤见 备份与回滚。