在 dev 上預覽並推升到正式環境

兩個環境如何對應到分支

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

每次推送到某個分支都會執行 CI：將變更的條目翻譯成所有語言、建置，並部署到該分支對應的網站。Admin 的寫入預設到 main；若要改為暫存在 dev，請在 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。向 dev 助理提出一個涉及該變更的問題，以確認機器人已經讀取到更新：

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 同步、解決衝突後再推升一次。