embedist

embedist 是什麼？

embedist 是一款 Windows 桌面應用程式，將 AI 協助與嵌入式韌體開發結合。設計目的是讓您在單一環境中進行 AI 輔助除錯、序列監控，以及建置/上傳韌體——利用目標硬體的上下文資訊。

專案使用 Tauri 2、React 和 TypeScript 建置。其目標是讓您開啟嵌入式專案資料夾（例如 ESP32 或 Arduino 程式碼庫），在編輯、建置、上傳和監控裝置輸出時獲得板卡感知的 AI 支援。

主要功能

• AI 模式支援聊天、規劃、代理執行與除錯聊天：提供多種互動風格（Chat、Plan、Agent、Debug Chat），適用於嵌入式工作的不同階段。
• 多供應商 AI 支援：使用 OpenAI、Anthropic、Google、DeepSeek、Ollama、NVIDIA NIM 和自訂 vLLM 端點等 AI 供應商。
• 板卡感知的除錯上下文：AI 除錯利用偵測到的板卡資訊（例如 ESP32 變體和 Arduino 板卡）提供硬體特定的修正。
• 即時序列監控：串流裝置通訊，支援可設定波特率與自動連線行為。
• PlatformIO 建置與上傳整合：使用 PlatformIO CLI 並串流即時輸出，將錯誤/警告解析至 Problems 面板，並包含停止建置按鈕。
• 程式碼編輯器與專案導航：包含檔案總管（支援麵包屑、最近檔案、內聯重新命名、多選取），以及基於 Monaco 的編輯器（支援分頁管理與髒檔指示）。
• VS Code 風格的鍵盤快捷鍵與命令面板：支援 Ctrl 快捷鍵執行常見操作，以及命令面板（Ctrl+Shift+P）。
• 輕量 Windows 可執行檔：使用 Tauri 2 Rust 後端；儲存庫描述可執行檔大小約 5.7 MB。
• 持久化自訂端點 API 金鑰：自訂端點的 API 金鑰可在應用程式重啟後保留。

如何使用 embedist

1. 下載並執行：從 Releases 下載 embedist.exe 並在 Windows 上執行。
2. 開啟專案資料夾：按 Ctrl+O 或使用 File > Open Folder 開啟包含嵌入式程式碼的資料夾。
3. 設定 AI 與供應商：在 Settings（Ctrl+,）中設定 AI 供應商與必要憑證。
4. （建置/上傳選用）：若需建置與上傳功能，請確保已安裝 PlatformIO。
5. 建置、上傳與監控：使用 Build 面板執行 PlatformIO 建置/上傳，然後在 Serial Monitor 查看執行時輸出。

若出現 Windows SmartScreen 未簽署應用程式的警告，儲存庫指出這是 Windows 對未簽署應用程式的標準安全警示，請點選 More info 後選擇 Run anyway。

使用情境

• 使用板卡感知 AI 除錯韌體：當專案針對已知板卡（例如 ESP32 Dev Module 或 Arduino Uno）時，使用 AI Debug 模式詢問基於偵測硬體的修正。
• 編碼前的規劃：使用 Plan 模式在實作程式碼變更前協作專案計劃，然後在整合編輯器中進行編輯。
• 具活動追蹤的自主迭代：在 Agent 模式中委派實作步驟，並檢視即時活動記錄，同時變更正在套用。
• 透過序列監控裝置行為：連線至裝置，使用序列監控檢視即時輸出，調整波特率並依賴自動連線減少手動設定。
• 建置與分類編譯/上傳錯誤：執行 PlatformIO 建置並串流輸出，將解析的錯誤/警告顯示在 Problems 面板，以加速迭代。

常見問題

embedist 是否支援非 Windows 平台？
儲存庫描述為 Windows 桌面應用程式，並列出 Windows 10/11（64 位元）為必要條件。

我需要 PlatformIO 嗎？
PlatformIO 列為選用必要條件，但建置與上傳功能需要它。

使用應用程式需要 AI API 金鑰嗎？
必要條件列出選用的「AI API Key」，AI 除錯功能需要它。若僅需非 AI 工作流程，應用程式仍可使用，但 AI 除錯需金鑰。

支援哪些板卡？
支援 ESP32 系列板卡（例如 ESP32 Dev Module、ESP32 WROOM/WROVER、ESP32 S3、ESP32 C3/C6 和 ESP32 CAM）以及 Arduino 系列板卡（Uno/Nano/Mega、Pro Mini、Leonardo、Due 和 Zero），另提及 ESP8266。

embedist 如何處理自訂 AI 端點？
支援編輯自訂端點，並表示自訂端點 API 金鑰可在重啟後保留。

替代方案

• 編輯器/IDE 中的 PlatformIO（搭配獨立的 AI 助理）：如果您主要需要建置/上傳與錯誤解析，將 PlatformIO 整合至現有 IDE 可涵蓋建置工作流程，而 AI 協助則來自另一工具。
• VS Code 搭配嵌入式開發擴充套件 + AI 工具：常見設定是使用 VS Code 進行編輯與類似 PlatformIO 的擴充套件處理嵌入式工作流程，並搭配外部 AI 聊天/除錯工具。
• 通用序列終端工具：如果主要需求是序列監控，專用序列終端應用程式可提供串流與波特率設定，但不會包含板卡感知 AI 除錯與整合建置/上傳。
• 具專案脈絡的 AI 程式碼/聊天工具：對於已有偏好嵌入式工具鏈但想使用 AI 協助的使用者，通用 AI 程式碼助理可提供幫助，但可能無法提供 embedist 所述的相同板卡感知除錯與嵌入式專屬序列/建置整合。