在 dev 上预览并推广到生产环境

两个环境如何映射到分支

分支	站点	被搜索引擎收录
main	https://jenksguo.xyz	是
dev	https://dev.jenksguo.xyz	否 (noindex)

每次向某个分支推送都会运行 CI：把改动的条目翻译为所有语言，构建，并部署到该分支对应的站点。Admin 的写入默认指向 main；传入 --branch dev（CLI）或 "branch": "dev"（REST/MCP）即可改为在暂存环境进行。

1. 在 dev 上进行更改

jenks admin put content/corpus/projects/smart-energy-meter.md smart-energy-meter.md \
  -m "Smart energy meter: add thesis link" --branch dev

根据需要重复进行任意多的更改。每次写入都会在 dev 上产生一个提交。

2. 等待部署

jenks admin deploys --branch dev

等待 dev 的最新一次运行成功。当改动的条目很多时，翻译会增加一些时间。

3. 检查预览

在 https://dev.jenksguo.xyz 上打开已更改的页面，以及至少一个翻译版本，例如 https://dev.jenksguo.xyz/ja/projects/smart-energy-meter。向开发助手提出一个涉及此次更改的问题，以确认机器人已获取到变更：

jenks ask "What was Jenks's final-year project?" --api https://dev.jenksguo.xyz

4. 推广

jenks admin promote

这会将 dev 合并到 main 并触发生产环境部署。再次运行 jenks admin deploys 以观察其完成，然后检查 https://jenksguo.xyz。

如果出现问题

• 在推广之前：在 dev 上再提交一次进行修复，或在 git 中回滚该更改。
• 在推广之后：直接向 main 提交修复，或在 dev 上修复后再次推广。Git 会保留每个版本，因此始终可以恢复到较早的文件。
• 推广时出现合并冲突：有人直接在 main 上更改了同一文件。在 git 中让 dev 与 main 同步至最新、解决冲突，然后再次推广。