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

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

## 交付物

`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/`，再手動改名搬到交付資料夾。

## 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 一列，無程式碼異動。

## 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」維持不動。

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

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

## 教訓（已固化位置）

| 教訓 | 落點 |
|------|------|
| 劇本與製片同一棒、不拆兩 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 卡 |

## 待辦／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 指示。