↑ 需求首頁 ⌂ 需求中心

FR-072 子需求 B（六支安裝教學影片＋合併）收口 SUMMARY

2026-09-03 收尾｜user 親審通過（「非常完美」）｜B 段 7 卡 CM-1524～1529、1532 收 Done 母案 CM-1517 仍開（C 段 install-test 模式尚未啟動）

§1

交付物

compliance-manager-test/reports/training-videos/GuidantAI-落地版安裝教學-v1.19/（不入版控）

檔 長度
GuidantAI-落地版安裝教學-完整版.mp4（開場＋六段＋結尾，八個章節標記） 21:29
GuidantAI-安裝教學-01-系統基本需求.mp4 2:23
GuidantAI-安裝教學-02-主產品安裝.mp4 5:30
GuidantAI-安裝教學-03-首次設定與授權開通.mp4 2:25
GuidantAI-安裝教學-04-檢測Agent安裝.mp4 4:25（Agent 1.0.0，剪掉舊「資料夾不要刪」卡）
GuidantAI-安裝教學-05-日常登入與系統核對.mp4 1:43
GuidantAI-安裝教學-06-日常維運指令.mp4 3:43

重出方式：training/scripts/console/merge-install-videos.sh（自動抓每支 scenario 最新 passed mp4、逐支偵測片頭白幀裁掉、裁尾 1.5s、無損串接、內嵌 chapter）→ 輸出 reports/training-videos/install/，再手動改名搬到交付資料夾。

§2

commits（test repo feature/FR-069.5，未 push）

第一棒（2026-09-02）：2fd60ed B1、bd8f068 混排基礎＋B4/B5/B7 初稿、bd8f068、3539a92 B3、0cff77c 去 E2E 文案 第二棒（2026-09-02 夜～09-03）：

commit 內容
9071879 B4 首版（config 模式＋read -s 遮 token）——作廢
94c9deb B4 改互動四題、token 明碼重錄（user 裁示）
7b0468f merge-install-videos.sh（按 scenario 取最新、無損 concat、chapter metadata）
fa8cd6d reset-190.sh 重放片移到 replay/（否則污染合併）
bbffaf0 開場／結尾字卡 feature＋修 helper 兩 bug（流程卡接說明頁空白、六格切邊）
5bc7bb2 guide §五之二 分工與派工模式
bac010a 片尾 Reconnect：console After 先關 page 再停 ttyd；舊片裁尾
a8679e9 字卡 box-sizing 跑版、片頭裁白、outro 去「Agent 資料夾不要刪」
36aaf93 片頭改逐支偵測非白幀
0087529 ⑥ 拿掉 credentials／rotate-credentials 段重錄；⑤／開場／結尾去「查密碼」
d261f25 ④ 以 Agent 1.0.0（/srv/guidant-ai-agent）重錄
149f96d ④ 剪掉「解開的資料夾不要刪」說明卡（96.5–107.3s），feature 同步移除

BE repo 本次僅本 SUMMARY＋README 一列，無程式碼異動。

§3

user 裁示（影響後續錄影的決策）

  1. Agent 安裝走互動問答、token 明碼入鏡：教學片要讓觀眾看到每一題填什麼；190 是臨時機、token 可撤銷。config 檔模式客戶不會用，不拍。
  2. 不拆主產品／Agent 兩份，六段合一。
  3. guidant credentials 是資安漏洞：使用者不該有查密碼指令，只需知道設定檔在哪。CLI 已移除（BE e8d04ba5），影片⑥重錄，rotate-credentials 雖仍在但不教。
  4. 「Agent 資料夾不要刪」不寫進影片：那是設計缺陷，另開 FR-073 讓 Agent 比照主產品落系統路徑。影片④等 FR-073 出包後需重錄（Agent 0.3.0 落點不同）。
  5. Agent installer 那行 start: command not found（heredoc 反引號被執行）已另派工修；影片裡找不到在哪，不重錄。
  6. 主機名 guidant-ai-e2e、license issued_to「Billows E2E」維持不動。
§4

行為差異（相對第一棒交接時）

  • console 場景影片片尾不再有 xterm「Press ⏎ to Reconnect」（hook 順序修正，全系列生效）
  • 全螢幕字卡置中修正（box-sizing），六格流程卡不再切邊
  • 流程卡→全螢幕說明連續呼叫不再空白
  • reset-190.sh to <cp> 重放產生的影片自動隔離到 videos/training/replay/
§5

教訓（已固化位置）

教訓 落點
劇本與製片同一棒、不拆兩 runner；停手線＝改動是否外溢共用層；model 新題材 Opus／重錄 Sonnet 5／不用 Haiku guide §五之二、memory feedback_training_video_script_and_production_same_runner
抽幀 contact sheet 每 3～4 秒一幀會漏掉首尾 1～2 秒的瑕疵（白幀、Reconnect），出片清單要單獨抽首幀與末幀 guide §五清單（本次補）
Cucumber After 後定義先執行：tag-scoped After 會跑在通用 After 之前，停外部服務要放在 page.close 之後 console.steps.js 註解
全速重放與實錄共用 passed/ 目錄，按時間取最新會抓錯 reset-190.sh 註解
⑥ 的 stop/start 撞 Agent 五分鐘心跳，probe 短暫回 licensed；⑥ 接 ⑤ 中間留五分鐘 CM-1532 卡
§6

待辦／follow-up

  • C 段（@install-test 模式掛出包驗收 gate）未啟動，母卡 CM-1517 保持開。
  • 影片④重錄：已完成（2026-09-03 下午以 Agent 1.0.0 重錄 d261f25，再剪掉過時說明卡 149f96d，完整版 21:29，user 最終確認）。
  • 使用手冊 docs/user-manual/onprem/04-operations.md §4.6 仍有 rotate-credentials 章節與 credentials 相關描述，是否同步收斂由 credentials 移除那個 FR 處理。
  • A 段三卡（CM-1521～1523）仍停「修正待驗證」，實質已由 B 段六支驗證，收不收 Done 待 user 拍板。
  • push：test repo 14 commits（2fd60ed..149f96d）、BE 3 commits，等 user 指示。