工作歷程
2026-10-01 Husarion 產品資料與控制架構比較
- 目標：新增 Panther 與 ROSbot XL 獨立產品章節，整理整車硬體、電腦與控制板互動、安裝擴充，並另寫控制架構 SWOT。
- 變更：新增
docs/30-products/產品索引與三篇章節；加入官方電腦配置截圖、兩款方塊圖與圖片來源／雜湊紀錄；新增可重生圖片的 Docker 瀏覽器程式；將產品入口納入 README 與網站導覽。 - 證據限制：內容來自官方手冊與官方儲存庫，未做整車實測。SWOT 的開發、維護及故障影響明列為工程分析；Panther 配置頁／主手冊的 Orin 儲存差異、USI 修訂版差異與 ROSbot XL 驅動遷移／通訊版本差異保留在正文。
- 驗證：4 份產品文件（含索引）共 39 個本機連結與章節錨點通過檢查；5 個 PNG 尺寸與 SHA-256 通過核對；網站導覽已重生並包含產品索引及三篇章節；繁體中文與檔案擁有權檢查通過，
git diff --check無錯誤。 - 清理與狀態：本次一次性容器均使用
--rm，專案相關容器無殘留，未發現 root-owned 產物或同名.md空目錄。修改保存在本機工作樹，未提交或推送；保留原本未追蹤的slam/資料。
2026-10-01 Husarion 文件行文修訂與版本控制
- 修訂：依使用者要求套用
humanizer技能中的繁體中文規則，修訂三篇 Husarion 章節與產品索引。減少整句加粗、重複提醒與抽象用語，直接說明元件職責、操作限制及開發維護的影響。 - 保留內容：規格數值、型號、版本差異、來源、程式介面與證據限制均保留；SWOT 仍區分官方資料、工程分析與待實測項目。
- 驗證：與修訂前快照比對，4 份文件的標題、程式碼區塊、行內程式碼、連結目標及數字全部一致；5 張圖片與來源紀錄的 SHA-256 未變。39 個本機連結、產品索引、網站導覽及檔案擁有權檢查通過，
git diff --check無錯誤。 - 提交範圍：本輪行文修訂與前述產品文件、圖片、擷取程式、README、導覽及工作紀錄一併納入；推送目標為
origin/main。原本未追蹤的slam/資料不在提交範圍。 - 容器清理：讀取與驗證均使用一次性
--rm容器；提交前再次檢查專案容器、root-owned 檔案及同名.md空目錄。
交付入口：產品專章。
2026-11-04 全站 review、圖片重繪與 Cloudflare 部署
- 目標：review 筆記現況、用 Codex 圖像生成重繪 2026-09-01 後新增的圖、部署到 Cloudflare。
- 機械檢查：從版控檔案建站後掃描產物，壞內部連結、壞錨點與孤兒頁都是 0。
- SVG 破版：以 Noto Sans CJK TC 與 WenQuanYi 量測全部 222 張，27 張有文字溢出或互疊，由 Codex 改原始碼修復。程式比對確認文字與幾何座標不變，修復後兩種字型的疑點都是 0。量測抓不到文字壓曲線與標籤脫離對象，所以另外逐張看圖核對，8 張回修一輪。
- 行文：Husarion 專章逐句人工修訂；
README.md與其餘 74 份文件由 Codex 修訂。破折號 1301 降到 98，「不是 X 而是 Y」66 降到 2，留下的是標題、連結文字、表格符號、文件名稱與確實在區分概念的對比。未處理_legacy、_refs、CONTEXT.md（術語格式）、PLAN.md與本檔。 - 行文驗證：程式比對標題、程式碼、公式、連結、數字、表格結構與「待查證」標記；兩處差異經人工確認無誤（
encoders刪掉段尾重述、lidar-landscape是比對規則誤判）。改動的句子全數由 agent 核對語意，回報 43 條輕度問題，複驗後全部修正。沒有逐句人工重讀全部 75 份。 - Husarion 審查：補上專章缺少的專家與學生審查。專家意見逐條回官方頁面複核後才套用，修正見
PLAN.mdR25。沒有套用的兩項也記在 R25。 - 圖片：20 張
nav2-*、ctl-*與 4 張 Husarion 圖重繪成img/*.webp，共 2.44 MiB。Husarion 兩張規格圖只重繪規格表，產品照與長段英文不重繪。原始 SVG 與官方 PNG 都留在img/。 - 圖片驗證：獨立 agent 逐條比對文字清單與完整參考圖；最後未通過的兩張重新生成後，由主迴圈放大確認。有比例意義的 8 張在圖下標示示意並連回 SVG。幾何只有目測估讀，沒有程式量測。
- 重做紀錄：第一版參考圖被瀏覽器視窗裁切，20 張全部重新生成，原因與修法見
PLAN.mdR26。 - 部署：新增
Gemfile、Gemfile.lock、.ruby-version、404.html，以 Git integration 部署到 https://robot-notes.pages.dev。_config.yml與.gitignore排除slam/。第一次建置因語系失敗，修正後成功。設定見 Cloudflare Pages 部署。 - 映像：這輪在主機新增
ruby:3.3-bookworm與ruby:3.4.4-bookworm兩個映像，容器都用--rm，沒有清理任何映像。 - 官方圖：五個官方 Husarion PNG 的轉載授權未查到，使用者決定保留在站上。