发布与回退

笔记在本地写作，GitHub 保存版本，Cloudflare Pages 将正式分支生成网站。

日常更新

推荐先在 GitHub Desktop 中查看 Changes，确认本次修改，再填写简短说明，点击 Commit to main 和 Push origin。也可以在项目文件夹中执行：

npm run check
git add docs
git commit -m "更新学习笔记"
git push origin main

每次推送到 main，GitHub Actions 会先检查笔记与构建；检查通过后自动通知 Cloudflare Pages 发布。可以先在 GitHub 仓库的 Actions 查看检查结果，再到 Cloudflare 的 Workers & Pages → 对应项目 → Deployments 查看上线状态。只有构建成功的版本才会替换线上页面。

确认已经更新

1. 等待部署状态显示成功。
2. 打开 https://notes.turtleneck.top，检查本次修改的文章。
3. 搜索文章中的关键词，并尝试直接刷新文章链接。

如果仍看到旧内容，先确认对应提交已经部署成功，再刷新页面。

构建失败时

如果没有出现新的部署，先检查 GitHub Actions 中的最新任务；若 Cloudflare 已开始构建，则在部署详情中查看日志。优先检查报错提到的文件：

• 内部链接是否指向存在的文件。
• Markdown 顶部的 --- 是否配对，元信息的缩进是否正确。
• 数学公式的括号、环境是否成对。
• 是否已经提交图片、配置文件和依赖锁文件。

先在本地执行 npm ci 和 npm run check，修复后再次提交。构建失败时，网站继续提供此前成功的版本。

撤回一篇笔记的修改

先在 GitHub Desktop 的 History 中找到需要撤销的提交，使用 Revert Changes in Commit，然后推送。这个操作产生一条新的撤销记录，保留历史，适合日常纠错。

命令行的等价方式：先用 git log --oneline 找到要撤销的提交，再用实际编号替换下方的 COMMIT_ID：

git revert COMMIT_ID
git push origin main

如需立即恢复线上版本，可在 Cloudflare Pages 的 Deployments 选择上一条成功的正式部署并执行 Rollback。随后也要撤销 GitHub 中相应的修改，避免下次发布再次带回错误内容。

换电脑与备份

将仓库克隆到新电脑，安装 Node.js 22，再执行 npm ci 即可继续写作。两台电脑交替使用时，开始写作前先同步最新版本，结束时提交并推送。

闲置 Windows 笔记本可以保留一份仓库副本，但网站托管不依赖它开机。重要笔记还可以定期另存到独立硬盘。