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

两个环境与分支的对应关系

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

每次向某个分支推送都会运行 CI：将变更的条目翻译为所有语言、构建并部署到该 分支对应的站点。管理写入默认指向 main；要改为在预演环境进行，CLI 传 --branch dev，或在 REST/MCP 传 "branch": "dev"。

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.pages.dev。

如果出现问题

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