{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到從無到有打造 A I 機器人。這是最後一章,期末專題:自主導覽與巡邏任務。我們要把前面九章學的東西整合起來,規劃專題、寫巡邏任務,還要學怎麼設計驗收,證明它是安全且可用的。", "item": 0 }
  ],
  "原理:狀態機、可靠度與驗收的統計#1": [
   { "say": "先用生活的例子開始,駕照路考。", "item": 0 },
   { "say": "駕照路考不是看你開得很帥,而是檢查你在每種情況下,像起步、轉彎、停車、遇到行人,是否都做出正確反應。而且考官不會只看一次,一次順利,不代表你一直安全。", "item": 1 },
   { "say": "機器人專題的驗收,就是設計一份路考:列出情境、定義通過標準、重複測試並記錄。", "item": 1 }
  ],
  "原理:狀態機、可靠度與驗收的統計#2": [
   { "say": "接著是狀態機,讓行為可預測。", "item": 0 },
   { "say": "有限狀態機,把系統行為拆成有限個狀態,和明確的轉換條件。好處是,每個時刻只可能處在一個狀態,行為可以列舉、可以測試。", "item": 1 },
   { "say": "設計原則有三個。每個狀態都有逾時,避免永遠卡住;所有異常都導向同一個安全狀態,叫 FAIL SAFE;安全狀態不自動恢復。", "item": 1 },
   { "say": "你可以對照狀態圖,檢查每個狀態的每個可能事件,是否都有定義好的下一步。沒有定義的,就是潛在的漏洞。", "item": 1 }
  ],
  "原理:狀態機、可靠度與驗收的統計#3": [
   { "say": "再來是故障樹式思考,先列故障,再設計反應。", "item": 0 },
   { "say": "把可能壞掉的東西逐一列出來:感測器逾時、定位發散、導航連續失敗、電量低、急停、網路斷線。對每一項寫下,怎麼偵測,預期的反應是什麼。這樣的表格,直接就是你的測試案例。", "item": 1 }
  ],
  "原理:狀態機、可靠度與驗收的統計#4": [
   { "say": "這是故障與反應對照表。", "item": 0 },
   { "say": "表裡列了雷達逾時、定位發散、導航連續失敗、電量低,和急停,每一項各自有偵測方式,以及預期的安全反應。你的專題,也可以照這個格式做一份自己的表。", "item": 1 }
  ],
  "原理:狀態機、可靠度與驗收的統計#5": [
   { "say": "接著是可靠度,為什麼要重複測試?", "item": 0 },
   { "say": "十次成功九次,就是百分之九十嗎?它只是一個估計。用 Wilson 百分之九十五信賴區間,粗略看真實成功率可能的範圍。", "item": 1 },
   { "say": "九次成功、共十次,範圍大約零點六到零點九八,很寬。九十次成功、共一百次,約零點八三到零點九四。十次全成功,下界也只有約零點七二。次數越多,區間越窄。", "item": 1 },
   { "say": "另一個直覺是,如果連續三十次都沒有失敗,依三之法則,失敗率的百分之九十五上界,約三除以三十,也就是百分之十。這些數字說明,要宣稱很可靠,需要足夠多的測試,而且要記錄原始次數與失敗原因。", "item": 1 }
  ],
  "原理:狀態機、可靠度與驗收的統計#6": [
   { "say": "這是成功率的信賴區間圖。", "item": 0 },
   { "say": "圖裡畫了九比十、九十比一百,還有十比十的區間。可以看到,樣本越多,區間越窄;而且即使十次全成功,下界仍然只有約百分之七十二。", "item": 1 }
  ],
  "原理:狀態機、可靠度與驗收的統計#7": [
   { "say": "最後,算一個急停距離的例子。", "item": 0 },
   { "say": "急停距離,約等於反應期間走的距離,加上煞車距離。也就是 s 等於速度乘反應延遲,再加速度平方除以二倍減速度。", "item": 1 },
   { "say": "取速度每秒零點二公尺,反應延遲零點三秒,減速度每秒零點五公尺平方。算出來是零點零六加零點零四,等於零點一公尺。如果速度加倍到每秒零點四公尺,變成零點一二加零點一六,等於零點二八公尺,煞車的部分成長四倍。", "item": 1 },
   { "say": "所以降低速度上限,是最有效的安全手段之一,而且實測的最壞值,比理論值更重要。", "item": 1 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#1": [
   { "say": "好,進入專題規劃。先看專題目標。", "item": 0 },
   { "say": "你要把前九章整合成一個完整系統。機器人在已建好的地圖上,依序前往多個指定地點,例如教室的三個展示點,在每個點停留一小段時間,完成一圈後回到起點或充電座。", "item": 1 },
   { "say": "過程中遇到障礙會繞行、卡住會恢復,連續失敗或電量低,就安全停下並通知人員。可以用 TurtleBot 三類的實體機器人,也可以全程用 Gazebo。", "item": 1 },
   { "say": "選配的部分,可以加入第八章的影像偵測,例如在展示點確認目標物,或是第九章的 L L M 規劃器,把去展示點 A 再去 B,變成經過驗證的計畫。特別注意,選配功能都不得削弱急停與驗證。", "item": 1 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#2": [
   { "say": "這是專題進度的甘特圖。", "item": 0 },
   { "say": "圖上依週次,排了需求、模擬、導航、狀態機、安全層、驗收與報告這幾項工作。建議你照這個順序推進,先模擬,再做安全層,最後留時間驗收與寫報告。", "item": 1 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#3": [
   { "say": "做專題要先寫需求,而不是直接寫程式。", "item": 0 },
   { "say": "先寫一頁需求,每一條都要能被測試。一共有七條,後面兩頁會逐條說明。", "item": 1 },
   { "say": "要記得,數字是範例,請依場地與機器人調整,但要寫下來,並在驗收時照做。", "item": 2 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#4": [
   { "say": "先看前四條需求。", "item": 0 },
   { "say": "第一條,系統可以在一分鐘內完成定位,並進入待命。", "item": 1 },
   { "say": "第二條,依序前往三個命名地點,每點停留五秒。", "item": 2 },
   { "say": "第三條,單點導航成功率大於等於百分之九十,十次嘗試,零碰撞。", "item": 3 },
   { "say": "第四條,前方出現障礙時,機器人停下或繞行,不碰撞。", "item": 4 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#5": [
   { "say": "後面三條,都和安全有關。", "item": 0 },
   { "say": "第五條,急停按下之後,機器人在你定義的距離內停止,而且不自動恢復。", "item": 1 },
   { "say": "第六條,電量低於門檻時,中止巡邏並返回起點,或待命。", "item": 2 },
   { "say": "第七條,任何一個關鍵 node,包括定位、導航、感測器,失效時,機器人停止並通知。", "item": 3 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#6": [
   { "say": "接著看系統架構。", "item": 0 },
   { "say": "最底層是感測與底層,機器人驅動或 Gazebo,提供 scan、odom、T F、電池狀態等 topic,名稱依機型而異。上面是定位與導航,包括 map server、AMCL 和 Nav 二。", "item": 1 },
   { "say": "再上面是任務層,patrol node,也就是巡邏狀態機,使用 nav2 simple commander。", "item": 1 },
   { "say": "安全層包括 twist mux、限速與看門狗、獨立的急停,以及感測器逾時監看。人機介面,有啟動、暫停、取消,可以用終端機指令、遙控器或簡單按鈕,還要有狀態顯示。選配的是感知 node 與 L L M 規劃器,它們的輸出要經過驗證器與人工確認。", "item": 1 },
   { "say": "重點是,任務層只能透過 Nav 二的動作和允許的 topic 控制機器人,不直接寫 cmd vel。急停與限速都在任務層之外。", "item": 1 }
  ],
  "專題規劃:需求、系統架構與巡邏狀態機#7": [
   { "say": "畫面上是架構的前三層。", "item": 0 },
   { "say": "感測與底層,機器人驅動或 Gazebo,輸出 scan、odom、T F 和電池狀態。", "item": 1 },
   { "say": "定位與導航,是 map server、AMCL 和 Nav 二。", "item": 2 },
   { "say": "任務層是 patrol node,巡邏狀態機,使用 nav2 simple commander。", "item": 3 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#1": [
   { "say": "接下來,用 nav2 simple commander,寫巡邏任務的 node。", "item": 0 },
   { "say": "Nav 二提供一個 Python 套件,叫 nav2 simple commander,Humble 用 apt 安裝,依發行版而異。它把導航動作包成簡單的 BasicNavigator 類別。常用方法有幾個。", "item": 0 },
   { "say": "set initial pose,設定初始位姿。", "item": 1 },
   { "say": "wait until nav2 active,等待 Nav 二各個 node 啟動。", "item": 2 },
   { "say": "go to pose,送出單點目標,它是非阻塞的。", "item": 3 },
   { "say": "follow waypoints,依序走多個點。", "item": 4 },
   { "say": "is task complete,任務是否結束;get feedback 取得回饋;get result 取得結果,結果有成功、被取消、失敗三種。", "item": 5 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#2": [
   { "say": "還有最後一個方法。", "item": 0 },
   { "say": "cancel task,取消目前任務。方法名稱與細節依 Nav 二版本而異,請以你安裝的版本說明為準。", "item": 1 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#3": [
   { "say": "我們來看一個範例,有逾時、重試與停留的巡邏。", "item": 0 },
   { "say": "先是航點清單,每個航點有名稱、x、y、朝向角度和停留秒數。範例有 station a、station b,以及回到 start,座標都是範例。", "item": 1 },
   { "say": "make pose 這個函式,把 x、y 和角度,轉成 Nav 二需要的位姿,框架是 map,朝向用四元數表示。", "item": 2 },
   { "say": "go 這個函式負責走到一個航點,回傳真表示抵達,假表示失敗或逾時,已經取消。做法是,在重試次數內,送出目標,迴圈等待任務完成,如果超過逾時秒數,就取消任務。結果成功就回傳真,否則印出警告,再試一次。逾時是九十秒,最多重試兩次。", "item": 3 },
   { "say": "主程式,初始化 R C L py,建立導航器,設定初始位姿,可以由人在 R viz 二設定,然後等 Nav 二啟動,再逐一走每個航點。如果一個航點連續失敗,就記錄錯誤,進入 FAIL SAFE,停止巡邏。每到一個點,停留指定秒數。", "item": 4 },
   { "say": "說明有幾點。is task complete 通常也會處理動作回呼,所以迴圈內要持續呼叫並稍作等待。逾時後要 cancel task。重試次數有上限,失敗就跳出,不是無限重試。這段程式只是示意,真正的專題還要加入預檢、急停旗標、電量檢查、啟動確認與日誌。", "item": 4 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#4": [
   { "say": "這是程式的第一段,匯入。", "item": 0 },
   { "say": "匯入 math 和 time。", "item": 1 },
   { "say": "匯入 R C L py。", "item": 2 },
   { "say": "匯入位姿訊息 PoseStamped。", "item": 3 },
   { "say": "匯入 BasicNavigator 與 TaskResult。", "item": 4 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#5": [
   { "say": "第二段是設定值。", "item": 0 },
   { "say": "WAYPOINTS 是航點清單,每項依序是名稱、x、y、朝向角度,和停留秒數,座標為範例。", "item": 1 },
   { "say": "清單到這裡結束。", "item": 2 },
   { "say": "GOAL TIMEOUT 是九十秒,單點目標最多等九十秒。", "item": 3 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#6": [
   { "say": "第三段是重試次數與兩個函式。", "item": 0 },
   { "say": "MAX RETRY 是二,最多重試兩次。", "item": 1 },
   { "say": "make pose,把座標與角度轉成位姿。", "item": 2 },
   { "say": "go,走到一個航點,內含逾時與重試。", "item": 3 }
  ],
  "用 nav2_simple_commander 寫巡邏任務節點#7": [
   { "say": "最後是主函式。", "item": 0 },
   { "say": "main 函式,初始化、設定初始位姿、等待 Nav 二啟動,再依序走每個航點,失敗就 FAIL SAFE,最後關閉 R C L py。", "item": 1 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#1": [
   { "say": "最後一個單元,驗收與測試計畫,怎麼證明它是安全且可用的?", "item": 0 },
   { "say": "展示時成功一次很容易,真實環境要的是穩定與安全。驗收測試要有計畫、可重複、有紀錄。", "item": 1 },
   { "say": "下一頁是範例矩陣。通過標準請依專題需求與場地自行訂定並記錄,不要把示例的數字當成通用標準。", "item": 1 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#2": [
   { "say": "這是驗收測試矩陣。", "item": 0 },
   { "say": "矩陣列了六項測試,定位、單點導航、動態障礙、急停、低電量、斷線與 node 死亡,每一項都有通過標準的範例。你可以拿來當自己專題的起點,再依實際需求修改。", "item": 1 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#3": [
   { "say": "來看測試設計。每個測試都要寫清楚,前提條件、步驟、預期結果、實際結果、通過與否,和備註。", "item": 0 },
   { "say": "T 一,定位。開機,設定初始位姿,在規定時間內 AMCL 收斂,也就是粒子集中,點雲和牆重合。", "item": 1 },
   { "say": "T 二,單點導航。同一個目標連續十次,記錄成功次數、抵達誤差、所需時間和失敗原因。以九次成功為例,代表百分之九十,但小樣本的百分比有很大的不確定性,所以要記錄原始次數,不只看百分比。", "item": 2 },
   { "say": "T 三,動態障礙。路徑上放紙箱,或有人走過,要在安全距離內,機器人要停下或繞行,不碰撞。", "item": 3 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#4": [
   { "say": "測試設計的後四項。", "item": 0 },
   { "say": "T 四,急停。行進中觸發急停五次,每次量測從觸發到完全停止的時間與距離,取最大值作為你的最壞情況。", "item": 1 },
   { "say": "T 五,低電量。用設定降低門檻,或模擬電量資料,確認中止巡邏,並返回或待命。", "item": 2 },
   { "say": "T 六,故障注入。依序中止雷達 node、AMCL、Nav 二其中之一,機器人應該停止並通知,不亂動。", "item": 3 },
   { "say": "T 七,若有選配,壞輸入。對 L L M 規劃器的驗證器,執行第九章的壞輸入測試集。", "item": 4 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#5": [
   { "say": "接著是量測方法。", "item": 0 },
   { "say": "成功率,是成功次數除以總次數,同時記錄信賴程度,次數少時別過度解讀。", "item": 1 },
   { "say": "抵達誤差,用捲尺量機器人停止位置,與目標點的距離。", "item": 2 },
   { "say": "時間,用 bag 的時間戳或日誌;急停時間可以用慢動作錄影,與日誌時間戳交叉驗證。", "item": 3 },
   { "say": "碰撞,要有人觀察並記錄;模擬的話可以看碰撞日誌。", "item": 4 },
   { "say": "全程錄 bag,只錄 cmd vel、odom、scan、T F 等必要的 topic,方便事後分析失敗。", "item": 5 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#6": [
   { "say": "最後談失敗分析。", "item": 0 },
   { "say": "失敗不是壞事,是改進的資料。每次失敗都要歸類。定位問題,像初始位姿、地圖過期,就重新建圖或調 AMCL 參數。", "item": 1 },
   { "say": "規劃問題,像目標位置、膨脹,就調整地點與代價地圖。控制問題,像振盪、卡住,就調控制器與容許誤差。感測問題,像雜訊、遮擋,就檢查安裝與參數。系統問題,像 T F、時間、QoS,就回顧第二、四、五章。", "item": 1 },
   { "say": "修改一個因素之後,要重跑同一批測試,才知道是否真的改善,這叫控制變因。", "item": 2 }
  ],
  "驗收與測試計畫:怎麼證明它是安全且可用的#7": [
   { "say": "失敗要歸類,對應五種處理。", "item": 0 },
   { "say": "定位問題,重新建圖或調 AMCL 參數。", "item": 1 },
   { "say": "規劃問題,調整地點與代價地圖。", "item": 2 },
   { "say": "控制問題,調控制器與容許誤差。", "item": 3 },
   { "say": "感測問題,檢查安裝與參數。另外,系統問題,像 T F、時間、QoS,回顧第二、四、五章。", "item": 4 }
  ],
  "課程總整理與下一步#1": [
   { "say": "好,我們來做整門課的總整理。你完成了什麼?", "item": 0 },
   { "say": "這門課從 R O S 二的全貌開始,走過整條機器人軟體鏈。接下來幾頁,會依章節回顧。", "item": 1 },
   { "say": "也請帶走貫穿全課的六條原則,後面會逐一說明。", "item": 2 }
  ],
  "課程總整理與下一步#2": [
   { "say": "先回顧前三章。", "item": 0 },
   { "say": "第一章,R O S 二是什麼、版本與環境,Humble、Jazzy 與 Docker、虛擬機的取捨。", "item": 1 },
   { "say": "第二章,node、topic、服務、動作、參數與 QoS,還有 R C L py 的發布者與訂閱者。", "item": 2 },
   { "say": "第三章,cmd vel、差速運動學、遙控、速度指令鏈、看門狗與 rosbag 二。", "item": 3 }
  ],
  "課程總整理與下一步#3": [
   { "say": "第四到第六章。", "item": 0 },
   { "say": "第四章,T F 二、U R D F,與雷達、I M U、影像的資料格式。", "item": 1 },
   { "say": "第五章,Gazebo 與 R viz 二、use sim time、launch 檔。", "item": 2 },
   { "say": "第六章,SLAM 概念、slam toolbox、佔據格地圖與存圖。", "item": 3 }
  ],
  "課程總整理與下一步#4": [
   { "say": "第七到第九章。", "item": 0 },
   { "say": "第七章,Nav 二的架構、AMCL、代價地圖、規劃器、控制器、行為樹與常見失敗。", "item": 1 },
   { "say": "第八章,影像偵測 node、延遲與 QoS、與行動整合、隱私。", "item": 2 },
   { "say": "第九章,L L M 任務規劃器:白名單、驗證、人工確認,急停獨立。", "item": 3 }
  ],
  "課程總整理與下一步#5": [
   { "say": "最後是第十章,還有第一條原則。", "item": 0 },
   { "say": "第十章,把以上整合成可驗收的自主巡邏專題。", "item": 1 },
   { "say": "第一條原則,分層與解耦。每個 node 做一件事,感知、規劃、控制、安全分開。", "item": 2 }
  ],
  "課程總整理與下一步#6": [
   { "say": "再來三條原則。", "item": 0 },
   { "say": "第二,回授勝過猜測。用感測器和里程計決定下一步,而不是只靠時間。", "item": 1 },
   { "say": "第三,時間與座標要一致。T F、use sim time、QoS,是最常見的隱形錯誤。", "item": 2 },
   { "say": "第四,先模擬再真機,但真機一定要重新驗證。", "item": 3 }
  ],
  "課程總整理與下一步#7": [
   { "say": "最後兩條原則,也是最重要的兩條。", "item": 0 },
   { "say": "第五,安全是設計,不是附加。包括限速、看門狗、逾時、獨立急停、FAIL SAFE、電池規範和隱私。", "item": 1 },
   { "say": "第六,A I 只是建議者。L L M 和偵測的輸出,都要經過確定性檢查,急停永遠獨立於 A I。", "item": 2 }
  ],
  "closing": [
   { "say": "好,整門課到這裡就告一段落了。從 R O S 二的全貌,到節點通訊、控制、座標、模擬、SLAM、Nav 二、感知、L L M 規劃器,最後整合成一個可驗收的巡邏專題。希望你帶走的,不只是指令,還有分層、回授與安全設計的思維。", "item": 0 },
   { "say": "請先完成本章的實作與章末小測驗。後面還有期末總複習,幫你把整門課再串過一遍,我們到時候見。", "item": 1, "pause": 1 }
  ]
 }
}
