---
presentation:
  theme: white.css
  width: 1600
  height: 800
  controls: true
  progress: true
  transition: slide
---

<!-- slide -->

# 🛠️ FWAuto 指令系統

> 韌體開發指令

<!-- slide -->

## ✅ 現有指令

- 📋: 規劃中
- 🚧: 開發中
- ❓: 待討論
- ✅: 已實現

<!-- slide -->

### 🔨 `build` - LLM 智能編譯

- **自動錯誤診斷與修復**: ✅ 編譯失敗時自動分析錯誤訊息，嘗試自動修正
- **智能重試機制**: ✅ 遇到編譯錯誤會自動重新 build 直到成功
- **過程回報**: ✅ 即時報告遇到的問題類型、處理方式，提供 solution
- **學習優化**: 📋 累積編譯問題經驗，提升後續處理效率

**執行產出**:

- ✅ 編譯成功的 HEX 檔案
- ✅ 詳細的編譯過程日誌
- ✅ 錯誤處理報告和建議方案

<!-- slide -->

### ⚡ `deploy` - LLM 智能部署

- **智能環境檢測**: ✅ Network Deployment 自動檢查 SSH 連接性
- **跨平台支援**: ✅ 支援 AM62X, Raspberry Pi, RISC-V（透過 SSH/SCP）
- **Scenario 支援**: ✅ 透過 `--scenario` 參數使用預定義場景
- **遠端日誌**: ✅ 支援遠端日誌路徑配置和自動記憶

**執行產出**:

- ✅ 部署狀態即時回報
- ✅ 環境連接診斷報告
- ✅ 遠端日誌路徑提示

<!-- slide -->

### 🔄 `run` - LLM 全流程智能

- **流程智能編排**: ✅ Build → Deploy 完整流程自動化
- **異常智能恢復**: ✅ Build 失敗時 AI 自動修復（最多 3 次重試）
- **Scenario 支援**: ✅ 支援 `--scenario` 參數使用預定義場景
- **Binary Args**: ✅ 支援 `--binary-args` 傳遞參數到部署的應用程式

**執行產出**:

- ✅ 完整流程執行報告（Build + Deploy）
- ✅ AI 自動修復記錄
- ✅ 部署成功狀態
- ✅ 遠端日誌路徑提示

<!-- slide -->

### 📊 `log` - AI 日誌分析

- **智能日誌解析**: ✅ 使用 Claude Code SDK 自動分析日誌
- **遠端日誌支援**: ✅ 透過 SSH/SCP 自動下載遠端裝置日誌
- **自動路徑檢測**: ✅ 自動檢測上次 deploy 的日誌路徑（v0.5.0）
- **路徑持久化**: ✅ Deploy 後自動儲存路徑到 config
- **問答式分析**: ✅ 自然語言提問，AI 自動搜尋並回答

**執行產出**:

- ✅ 日誌內容分析報告
- ✅ 錯誤模式識別
- ✅ 問題根因定位
- ✅ 自然語言回答

<!-- slide -->

### 🚀 `init` - 專案初始化

- **互動式設定精靈**: ✅ 引導使用者完成 .fwauto/ 目錄配置
- **SDK 自動偵測**: ✅ 偵測作業系統並篩選相容的 SDK
- **模板自動複製**: ✅ 根據選擇的 SDK 複製對應的 build/deploy 模板
- **零配置啟動**: ✅ 自動生成預設配置，開箱即用

**執行產出**:

- ✅ .fwauto/ 目錄結構
- ✅ config.toml 配置檔
- ✅ 平台特定的 build/deploy 腳本

<!-- slide -->

### 🚀 `feat` - AI 功能實作

- **自然語言描述**: ✅ 使用自然語言描述需求，AI 自動實作
- **程式碼生成**: ✅ 自動生成符合專案風格的程式碼
- **自動編譯驗證**: ✅ 生成後自動編譯，失敗時 AI 自動修復
- **整合部署**: ✅ 實作完成後可選擇自動部署到裝置

**執行產出**:

- ✅ 功能程式碼實作
- ✅ 自動編譯驗證
- ✅ 錯誤自動修復

<!-- slide -->

### 💬 `chat` - 互動式對話

- **上下文感知問答**: ✅ 基於當前專案狀態提供精準回答
- **程式碼生成**: ✅ 根據需求和專案慣例自動生成符合規範的程式碼
- **專案探索**: ✅ 分析程式碼結構，回答專案相關問題
- **知識庫整合**: ✅ 結合專案經驗提供綜合建議

**執行產出**:

- ✅ 上下文化技術回答
- ✅ 客製化程式碼片段
- ✅ 專案結構分析
- ✅ 最佳實踐建議

<!-- slide -->

### 💻 Interactive Mode

- **互動式介面**: ✅ 執行 `fwauto` 無參數進入互動模式
- **CJK 字符支援**: ✅ 支援中文、日文、韓文輸入
- **持續對話**: ✅ 無需重複啟動，連續執行多個指令

**使用範例**:

```bash
$ fwauto
fwauto> build
fwauto> deploy
fwauto> log "有任何 error 嗎?"
fwauto> exit
```

<!-- slide -->

## 🚀 未來擴展指令

<!-- slide -->

### 📚 `/fwauto:datasheet` - LLM 文檔智能

- **智能元件識別**: 自動掃描專案程式碼，識別所有使用的元件和協議
- **動態配置生成**: 基於使用情境自動生成最佳配置代碼
- **衝突智能檢測**: 跨元件分析，預防引腳、時鐘、資源衝突
- **版本相容性管理**: 自動檢查元件版本相容性，提供升級建議

**執行產出**:

- 元件使用分析報告
- 最佳化配置程式碼
- 衝突檢測警示
- 相容性升級方案

<!-- slide -->

## ❓更多韌體專業指令

### 🛡️ `/fwauto:security` - 資安檢查

- **漏洞掃描**: 📋 自動檢測常見韌體安全漏洞
- **加密驗證**: 📋 驗證加密實作和金鑰管理

### 📋 `/fwauto:compliance` - 合規檢查

- **ISO xxxxx**: 📋 功能安全標準檢查
- **IEC xxxxx**: 📋 安全完整性等級驗證

### ⚡ `/fwauto:power` - 功耗分析

- **功耗優化**: 📋 分析並建議低功耗設計
- **電池壽命**: 📋 預估電池使用時間

### 📊 `/fwauto:test` - 自動化測試

- **單元測試**: 📋 自動生成測試案例
- **硬體迴路**: 📋 HIL 測試整合
