FR-175 機制問答首腦：交接日誌（LOG）

append-only：每棒追加一個 block，寫完不改。發現舊 block 有誤，在新 block 的「推翻了什麼」寫更正。現況看 fr175-STATE.md。

做了什麼：PM 會議提出 23 條問題，回答其中機制題 Q5～Q9、Q11～Q20，加升級接力圖與「待討論」四條。成果發成 artifact，另有一份 10 張 PM 簡報。

commits：問答原檔與簡報收進 FR-167 briefing/（5a722fc50）。

決策：問答與簡報分開——簡報給 PM 看全貌，問答給逐題追問。

做了什麼：決策者連續追問，補 Q11 預簽網址兩則、Q12 主版號與授權、Q7 密碼三則（明文、加密、docker 身分與入侵處置）、Q6 公鑰位置與安裝目錄結構；發現的問題六條。

commits：fd173552a（在 feature/FR-139）。

決策：

• 2.0 授權模式「技術上兩種都接得住，等商業模式定」。
• 目錄結構改用樹狀文字圖（流程圖被嫌難看），主欄放寬到 1180px。

教訓：

• 讀主機設定檔只列鍵名不讀值，這條在問密碼時特別要守。
• 口頭先說「189 app.log 沒輪替」是錯的，查到 jedi-common 預設保留 30 天才改正——先查再說。

做了什麼：

• 問答頁改成左側選單、一題一頁；補問併回主題頁（決策者：「會看上下文」）。
• 升級觸發機制：更新單、systemd 監看、升級腳本組成、不用升級容器的完整論點與 PM 反問。
• 執行流程頁改正式標題與前言；draining 說明拆成背景工作與 Agent 兩件事；進度檔箭頭改「更新進度檔」。
• Q15 補資料庫停兩次；Q19 健康檢查更正；Q8 改寫成發版流程（現行＋改版後、CI 五 stage、四張圖）；新增 Q21 compose 與兩個設定檔。
• 發現的問題追加 7 條，最優先「升級失敗時錯誤原文進不了系統」，決策者裁另開卡。
• 修流程圖深色模式下看不見；問答頁改成本機可直接開、圖可點擊放大。
• 開 FR-175，問答頁從 FR-167 briefing/ 搬來，原位置留轉址頁。

commits（皆在 feature/FR-172）：2b8bb3075、304356adc、52eac6b8f、c95114006、4216e828a、5c48a5897、e0b796f94、1b6cbcaec、2e06df9a8、bb71df81d、23be81ec3、b6f21d053，以及本棒開 FR 的 commit。

決策：

• 問答頁只維護一支，本機與線上共用；畫圖用 FR 站共用的 _shared/mermaid.min.js，不轉成靜態 SVG（多一份要同步，與 FR 站做法不一致）。
• 放大檢視照抄 _shared/doc-diagram.js 的 open()，不改全站共用檔。
• 問答頁搬家不刪舊位置：FR-167 的 README、FINAL-SPEC 是首腦的文件，連結不能斷，所以留轉址頁。
• 標題要專業、不要口語（「一次升級的接力」被退）；Q18 維持原文。

教訓：

• flowchart 的 mermaid init 只給一半會在深色模式變黑：平台用自己的深色配色補上沒指定的變數。要帶 darkMode:false、mainBkg、nodeTextColor。
• 手寫 HTML 給 artifact 時本機打不開：平台發布時才補外殼、[hidden] 規則、畫圖程式。要本機能開就自帶這三樣，並讓畫圖程式偵測平台後讓位。
• 一頁一題時，隱藏的頁畫不出 mermaid（量不到寬高），要切到那頁才畫。
• README 的數字要實查：先寫的「25 段、15 條」實數是 29 段、13 條。
• 工作樹會被別的 session 切 branch：本區 commit 落在 feature/FR-172，交接要寫明。

推翻了什麼：

• 第 2 棒的交接檔寫「發現的問題 6 條＋11-02 追加 9 條」，實數是 6＋7＝13 條。
• 第 2 棒報告 Q19 寫「管理員登入帶 token 打三支各要 200」，程式實際不登入、驗 401。已在問答頁更正。

• 決策者：「#flow 這邊幫她重寫，寫成現在的本體跟 Agent 的流程；時間軸表那種呈現方式不用了，直接用循序圖」。
• #flow 主答案改寫：三張循序圖（主系統升級、主系統發動 Agent 升級、Agent 主控台發動）＋主系統與 Agent 兩張逐步表＋常見問題；適用 1.28.3／Agent 1.5.5。三欄時間軸表與其說明整段拿掉（頁內 .tl 樣式留著未用）。補問「升級觸發機制」原樣保留。選單題名改「線上升級執行流程（主系統與 Agent）」。
• 更新的事實：Agent 不再靠心跳派工而是直推、drain 時不推新工作給 Agent；主系統升完有相容 Agent 新版就自動建推送列；同版重套兩個開關；Agent 升級維護模式與主控台鎖畫面時機。
• 同一份內容另落 FR-172 upgrade-flow-guide.md（說明與手冊），互相連結。
• 驗證：border-left 0、標籤平衡 0／0；Playwright 無頭開 #flow 連網與離線各一次，3 張圖皆畫成 SVG、點圖放大、ESC 關閉。線上版發布前完整讀過（內容與 repo HEAD 一致，只多平台外殼），發布為第 29 版。