在 dev 預覽並推送到正式環境

兩個環境與分支的對應關係

分支	網站	是否被搜尋引擎索引
main	https://jenksguo.xyz	是
dev	https://dev.jenksguo.xyz	否（noindex）

每次推送到分支都會執行 CI：將變更的條目翻譯成所有語言、建置，並部署到該分支對應的網站。Admin 寫入預設到 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.xyz。

如果出了問題

• 在推送前：在 dev 以另一個提交修正，或在 git 中還原變更。
• 在推送後：直接將修正提交到 main，或在 dev 修正後再次推送。Git 會保留每一個版本，因此隨時可以還原到較早的檔案。
• 在推送時發生合併衝突：有人直接在 main 修改了同一個檔案。請在 git 中使 dev 與 main 同步，解決衝突後再推送。