ESP32 視窗系統:Claude Fable 5.2 寫出 Bevel OS,從 VGA、FreeRTOS 到 39 筆人工介入紀錄怎麼看

ESP32 視窗系統:Claude Fable 5.2 寫出 Bevel OS(文章封面)

Claude Fable 5.2 實作案例 / 資料查證至 2026 年 11 月

一片 ESP32-S3 開發板、幾顆電阻、一台 VGA 螢幕,接上 USB 鍵盤和滑鼠,開機 0.7 秒後出現一個可以拖曳視窗、開檔案、看純文字網頁,甚至能玩 Doom 的桌面。這是開源專案 Bevel OS。它的 README 寫明:程式由 Claude Fable 5.2 在 Claude Code 裡以程式代理的方式撰寫,人類負責實體操作和部分決策。

比起成品畫面,這個專案更難得的是把過程攤開:交給 AI 的任務說明、每一次人類動手的紀錄、實板量測數據,全都放在 GitHub 倉庫裡。這篇照著這些文件,拆解 AI 代理做硬體專案的真實樣貌。

Bevel OS 桌面截圖:系統資訊視窗、鍵盤快捷鍵清單與 Alt+Tab 切換器
圖 1 Bevel OS 的桌面:系統資訊視窗、鍵盤快捷鍵清單與 Alt+Tab 切換器(圖片來源:Bevel OS GitHub 專案 docs/img,MIT 授權)

30 秒看重點

0.7 秒

從重置到第一個桌面畫面;原本的目標是 3 秒內

68 FPS

拖曳一個 488×357 的文字視窗,畫面不撕裂

約 32 FPS

Doom 第一關的幀率,遊戲引擎上限是 35

約 1.1 萬行

C 語言加少量組合語言,視窗與介面層從零寫起

39 筆

人類動手紀錄:插拔線材、接線、量測與做決定

資料:Bevel OS 的 README、docs/PERF.md、INTERVENTIONS.md(2026 年 11 月 20 日查閱)。

01先看清楚:AI 寫了什麼、沒寫什麼

Claude Fable 5.2 是什麼

Anthropic 在 2026 年 11 月 9 日發表 Claude Fable 5.2,官方定位是處理技術工作的模型:大型程式專案、代理式工作流程、科學研究與資料分析。Pro、Max、Ultra、Team、Enterprise 方案可以使用;開發者可透過 Claude 平台與 AWS、Google Cloud、Microsoft Foundry 呼叫,API 標準價格是每百萬輸入 tokens 8 美元、輸出 40 美元(比 Fable 5.1 的 10 美元、50 美元便宜)。Claude Code 則是能讀寫檔案、執行指令的代理式開發環境,Fable 5.2 是它可以選用的模型之一。

Anthropic 官方 Claude Fable 頁面,公告欄顯示 2026 年 11 月 9 日發表 Claude Fable 5.2
Anthropic 官方 Claude Fable 頁面,2026 年 11 月 9 日的公告就是 Fable 5.2(截圖:TempEDU,2026 年 11 月 21 日擷取自 anthropic.com)

標題雖然叫作業系統,精確一點說,Bevel OS 是建在樂鑫官方 ESP-IDF 5.5.3 之上的圖形桌面環境。開機、FreeRTOS 工作排程、USB 主機堆疊、FAT 檔案系統、Wi-Fi 與 TLS 加密都來自 ESP-IDF;AI 從零寫的是看得見的那幾層:VGA 畫面輸出、視窗合成、介面元件、應用程式介面和程式載入器。README 也特別註明,沒有用 LVGL 這類現成的介面函式庫。

Bevel OS 的分層:哪些是現成的、哪些是 AI 寫的現成元件AI 從零撰寫(約 11,000 行 C 與少量組合語言)應用程式(以 ELF 檔載入)檔案・文字編輯・終端機・純文字瀏覽器・Snake・Doom(引擎移植自 doomgeneric)Bevel OS 核心VGA 掃描輸出・視窗合成・介面元件・24 個函式的 App API・ELF 載入ESP-IDF 5.5.3(樂鑫官方開發框架)FreeRTOS 排程・USB 主機堆疊・FAT 檔案系統・Wi-Fi 與 TLS硬體ESP32-S3(16 MB Flash/8 MB PSRAM)・電阻 DAC・VGA 螢幕・USB 鍵鼠依 Bevel OS README 整理,TempEDU 繪製
圖 2 Bevel OS 的分層:灰色是現成元件,藍色是 AI 從零撰寫的部分

為什麼要分清楚

這不是在貶低成果。把現成底座和 AI 自寫的部分分開,讀者才知道哪些能力真的被驗證了:這個案例證明 AI 能在資源很緊的硬體上寫出完整的繪圖與視窗系統,而不是從電晶體開始造一台電腦。

02一片板子擠出 640×480、64 色的桌面

項目規格
主控板ESP32-S3(N16R8:16 MB Flash、8 MB PSRAM)
畫面640×480、59.9 Hz、64 色(紅綠藍各 2 位元,RGB222)
數位轉類比用 1 kΩ 與 440 Ω 電阻組成的簡易 DAC
輸入USB 鍵盤與滑鼠,經 USB-C 轉接板接到 GPIO 19/20
儲存沒有 SD 卡,從內建 Flash 切出 12 MB 的 FAT 分割區

資料:Bevel OS README(2026 年 11 月查閱)。

有個細節很能說明實機測試的價值:標準 VGA 的像素時脈是 25.175 MHz,但測試用的螢幕不接受板子產生的這個訊號,最後改用整數除頻得到的 26.67 MHz。這種問題在模擬器裡永遠遇不到。

Bevel OS 3D 列印外殼的爆炸圖渲染
圖 3 專案附的 3D 列印外殼爆炸圖(圖片來源:Bevel OS GitHub 專案 enclosure,MIT 授權)

功能上,視窗可以移動、縮放、最小化、最大化、關閉,有選單、對話框、Alt+Tab 和工作清單;內建檔案、文字編輯器、看圖、終端機、設定、系統資訊、網路與純文字瀏覽器。其他程式透過 24 個函式組成的 API 撰寫,編譯成可以放在任何記憶體位置執行的 ELF 檔,再由載入器執行;Snake 和 Doom 都是這樣跑起來的。

Bevel OS 的檔案管理員與文字編輯器視窗
圖 4 檔案管理員與文字編輯器(圖片來源:Bevel OS GitHub 專案 docs/img,MIT 授權)
Bevel OS 的純文字瀏覽器顯示 FrogFind 搜尋結果
圖 5 純文字瀏覽器透過 FrogFind 顯示搜尋結果(圖片來源:Bevel OS GitHub 專案 docs/img,MIT 授權)

Doom 是怎麼跑起來的

Doom 不是 AI 從零重寫的遊戲,而是移植開源的 doomgeneric 引擎,編譯成 ELF 程式由 Bevel OS 載入,畫面從 320×200 放大到 640×400 並做抖色處理。遊戲資料(共享版 WAD)不在倉庫裡,要另外下載。

03效能的祕密:PSRAM 太慢,所以不在 PSRAM 上畫

640×480 的畫面放在外接的 PSRAM。效能紀錄量到 PSRAM 寫入約 35 MB/s、讀取約 63 到 65 MB/s;晶片內部 RAM 用一般函式庫填色約 690 MB/s,改用 ESP32-S3 的 PIE 向量指令更可達約 3.4 GB/s,和 PSRAM 寫入差了將近百倍。所以設計原則很簡單:只重畫有變化的地方,而且先在內部 RAM 畫好再搬過去。

1

只畫有變化的區域

只重畫改變的矩形(dirty rectangles),一個 16×16 的小更新約 10 微秒

2

先畫在內部緩衝

每一條要更新的區域先畫進 20 KB 的內部 RAM,再一次搬進畫面記憶體

3

游標不寫畫面

滑鼠游標在掃描輸出時直接疊上去,移動時不寫入任何畫面資料,穩定 60 FPS

4

追著掃描線搬

搬移時機配合螢幕掃描(beam racing),整張畫面從 6.9 毫秒降到 0.55 毫秒

5

被否決的方案

GDMA 硬體搬運實測 25 MB/s,比 CPU 的 35 MB/s 還慢,所以沒採用

實板上量到的幀率

640×480、60 Hz 輸出時,用序列埠指令 perf 量測

全畫面重繪(無撕裂)

76 FPS

拖曳 488×357 文字視窗(無撕裂)

68 FPS

滑鼠游標

60 FPS

Doom 第一關 E1M1

約 32 FPS

※ 關掉 beam racing 時,重繪可到 117 FPS、拖曳可到 127 FPS,但會有畫面撕裂。資料:docs/PERF.md。

Bevel OS 效能紀錄 PERF.md 的整機數據表:全畫面重繪 76 FPS、拖曳視窗各階段耗時、韌體大小 824 KB 等
圖 6 docs/PERF.md 的整機數據表(截圖:TempEDU,2026 年 11 月 21 日擷取自 GitHub)
整機數據實板結果
拖曳視窗的一格繪製 3.2 毫秒、搬進 PSRAM 0.9 毫秒、等待掃描 10.4 毫秒
介面文字每秒約 50 萬個字元
16×16 小區塊更新每秒約 9.99 萬次(例如按鈕、游標)
桌面待機時的記憶體內部 RAM 剩 242 KB、PSRAM 剩 7.1 MB
韌體大小824 KB(-O2 編譯)

資料:Bevel OS docs/PERF.md(2026 年 11 月查閱)。

試過但沒採用的做法

PERF.md 最有教學價值的一段,是把「試過、量過、最後決定不用」的方案也記下來。這正是工程判斷:數字比直覺可靠。

實驗結果決定
畫面輸出改放另一個核心拖曳可到 136 FPS,但兩個核心的計時不同步,追掃描線的做法失效不採用
改用 -Os 縮小韌體韌體從 824 KB 降到 779 KB,但繪製慢了約 27%維持 -O2
PSRAM 提高到 120 MHz寫入快約 59%,但樂鑫只說明在恆溫下穩定預設不開
GDMA 硬體搬運約 25 MB/s,比 CPU 搬還慢不採用

資料:Bevel OS docs/PERF.md 的 Experiments and what was kept 一節。

看懂這個數據

這些是作者在一片實板上量到的紀錄。作者自己也在限制清單裡寫明:畫面撕裂是用計數器檢查,不是用眼睛確認。換一片板子、換一台螢幕,結果可能不同。

04最值得學的部分:任務說明與 39 筆人工介入紀錄

規則先寫在任務說明裡

docs/OS-BUILD-PROMPT.md 是寫給 AI 代理的任務說明,開頭就把它當成接手一個已經能點亮的硬體專案。裡面最值得照抄的,是這幾條工作規則:

1

記錄人類動手

每一次人類的實體操作都要寫進 INTERVENTIONS.md

2

改線先問

任何重新接線都要先徵求人類同意

3

在真螢幕上驗證

功能要在實際螢幕上確認,不能只看編譯結果

4

效能要有量測

效能宣稱要附 docs/PERF.md 的數據;組合語言、DMA 等優化,只有量測證明需要時才做

5

鍵盤滑鼠都能用

每個功能都要能只用鍵盤、也能只用滑鼠完成

驗收項目任務說明的目標實板結果
開機到桌面3 秒內約 0.7 秒
滑鼠游標約 60 FPS60 FPS
拖曳視窗30 FPS 以上、不撕裂68 FPS、不撕裂
檔案瀏覽瀏覽 SD 卡上的檔案人類決定略過 SD 卡,改用內建 Flash 分割區

資料:docs/OS-BUILD-PROMPT.md、docs/PERF.md、INTERVENTIONS.md(2026 年 11 月查閱)。

39 筆紀錄裡,人做了什麼

INTERVENTIONS.md 的表格前段,逐筆記錄人類做了什麼與原因,例如接上序列埠、HDMI 擷取卡與 JetKVM
圖 7 INTERVENTIONS.md 的前 11 筆:每一筆都寫明人做了什麼、為什麼(截圖:TempEDU,2026 年 11 月 21 日擷取自 GitHub)

INTERVENTIONS.md 記錄了 2026 年 11 月 10 日與 12 日,每一次人類動手做的事,共 39 筆(編號 0 到 38)。依內容粗略分類如下,一筆可能同時屬於好幾類:

人類做了哪些事?

依 INTERVENTIONS.md 內容分類,數字為概數

插拔線材與裝置

約 14 筆

量測、測試與觀察

約 12 筆

接線與改硬體

約 6 筆

決策與核准

約 5 筆

外殼製作(3D 列印)

3 筆

幾個例子特別有代表性:一開始螢幕一直沒訊號,最後發現轉接器方向買反了,是 HDMI 轉 VGA,不是 VGA 轉 HDMI;另一個轉接器要額外接 USB 供電才會出畫面;人類也用三用電錶量導通、量電壓,決定略過 SD 卡,並核准下載 Doom 引擎與遊戲資料。最後一長串(第 30 到 38 筆)都在處理 USB 分接器、集線器和接收器,紀錄裡沒有寫到成功的鍵鼠組合。

AI 可以讀錯誤訊息、改程式、跑測試,但它摸不到線。

——TempEDU 讀完介入紀錄的觀察

AI 怎麼看到螢幕?

介入紀錄還回答了一個很多人好奇的問題:AI 代理沒有眼睛,它怎麼知道畫面對不對?紀錄顯示,人類先接上 HDMI 擷取卡,讓 AI 能看到 VGA 輸出;擷取卡沒被系統偵測到時,改用 JetKVM 這類網路 KVM 裝置讓 AI 遠端看畫面;在轉接器還沒搞定的階段,人類甚至是唯一看得到螢幕的人,只能把看到的內容回報給 AI。

另一面是 AI 怎麼看到實體板子。專案的工具腳本透過序列埠下指令:跑效能測試、只用鍵盤操作整套介面、在寫入檔案時隨機斷電,讓代理能自己驗證結果,而不是編譯成功就交差。鍵盤操作測試 34 步全部通過;12 次斷電重開,檔案系統都完好。

05限制:這是展示品,不是能直接商用的桌面

USB

同時接兩個 USB 裝置從沒成功過,集線器支援也沒確認;唯一一次實際拔插測試出過問題,修正後沒有再測。

網路與安全

瀏覽器只顯示純文字,Google 搜尋會失敗;Wi-Fi 密碼以明文儲存。

穩定度

可載入程式在系統呼叫裡出錯,仍可能讓整台重開;Doom 存檔、Doom 與瀏覽器同時開啟都沒測過。

授權

主程式 MIT;Doom 相關部分 GPL v2;elf_loader 與 usb_host_hid 是 Apache-2.0。Doom 共享版 WAD 不在倉庫裡,要用腳本另外下載並核對 MD5。

要記得

想在課堂上帶硬體專案,接線與供電一定要先依板子規格逐項核對,不要讓學生直接照 AI 的建議接線、通電。

常見問題

QBevel OS 是真正的作業系統嗎?

它是建在 ESP-IDF 與 FreeRTOS 之上的圖形桌面環境。開機、排程、USB、檔案系統與網路來自 ESP-IDF;AI 寫的是畫面輸出、視窗合成、介面、應用程式介面與程式載入器。說它是「微控制器上的視窗系統」最精確。

Q要準備哪些硬體?

README 列的是 ESP32-S3 N16R8 開發板、VGA 螢幕、幾顆電阻組成的 DAC、USB-C 轉接板、USB 鍵盤滑鼠,外殼可選擇 3D 列印。接線與供電務必依板子規格核對。

QAI 寫了多少程式?

依 README,視窗、介面與應用程式層約 11,000 行 C 與少量組合語言;Doom 引擎、ESP-IDF 與部分元件是現成的開源程式。

Q這套系統可以直接拿來用在產品上嗎?

不建議。作者自己列出 USB 多裝置、明文儲存 Wi-Fi 密碼、部分功能沒測過等限制,它是展示 AI 代理工程能力的開源專案,不是商用產品。

Q我也可以用 Claude Code 做硬體專案嗎?

可以,但建議照這個專案的做法:先寫好任務說明與驗收標準、讓 AI 能透過序列埠自我測試、把每一次人工介入記錄下來,並從 LED、色條這類小任務開始。

自己試一次:先定驗收,再讓 AI 寫

Bevel OS 的做法可以縮小成一個課堂專題。把下面這段提示詞貼給 Claude Code,先讓它把驗收標準和人工步驟寫清楚,再開始寫程式:

提示詞/ESP32 小專案的驗收與介入紀錄

我要用 Claude Code 帶一個 ESP32-S3 的小專案:在 VGA 螢幕上顯示 8 條彩色色條,並能用序列埠指令切換色條順序。

請先不要寫程式,依序完成:
1. 列出這個任務的驗收標準:畫面、序列埠指令、穩定度各至少一條,而且要能量測或觀察。
2. 列出所有需要人類動手的步驟(接線、插拔、量測、決策),每一項寫明要量什麼、預期數值與安全注意事項。
3. 建立一個 INTERVENTIONS.md 範本,欄位包含:編號、日期、誰做的、做了什麼、為什麼、結果。
4. 說明你會如何透過序列埠自己驗證結果,而不是只確認編譯成功。

接線與供電的部分,請標註「需依實際板子規格核對」,不要自行假設腳位。
1

先讀任務說明

打開 Bevel OS 的 docs/OS-BUILD-PROMPT.md,看作者怎麼描述目標與限制

2

從小任務驗證

LED 閃爍、VGA 色條、序列埠選單,每一步都能量測再往下

3

寫自己的紀錄

每次動手就記一筆,專案結束後回頭看人和 AI 各做了什麼

本文重點

  1. Bevel OS 是 Claude Fable 5.2 在 Claude Code 裡寫的 ESP32-S3 桌面系統,建在 ESP-IDF 與 FreeRTOS 之上。
  2. 效能關鍵是避開 PSRAM 瓶頸:只畫有變化的區域、先畫在內部 RAM、游標不寫畫面。
  3. 39 筆人工介入紀錄顯示,接線、插拔、量測與決策仍是人的工作;AI 透過擷取卡或 KVM 才看得到螢幕。
  4. PERF.md 連沒採用的方案都記錄下來,示範用量測數據做工程決策。
  5. 能透過序列埠自我測試,是 AI 代理做硬體專案能不能被信任的關鍵。

想一想

如果有人說某個專案是 AI 寫的,除了看成品影片,你會請對方拿出哪三份文件來證明?

資料來源

  1. andrisgauracs(2026)。Bevel OS GitHub 專案與 README
  2. andrisgauracs(2026)。交給 AI 的任務說明 docs/OS-BUILD-PROMPT.md
  3. andrisgauracs(2026 年 11 月 10–12 日)。人類介入紀錄 INTERVENTIONS.md
  4. andrisgauracs(2026)。實板效能量測 docs/PERF.md
  5. Anthropic(2026 年 11 月 9 日)。Claude Fable 5.2

本文封面為 AI 生成的示意圖;圖 1、圖 3、圖 4、圖 5 取自 Bevel OS GitHub 專案(MIT 授權);圖 6、圖 7 與 Anthropic 頁面為 TempEDU 於 2026 年 11 月 21 日擷取的來源截圖;圖 2 與長條圖由 TempEDU 依專案文件整理繪製。


Edit with Tr.Bug

Follow me on:LinkedIn | 探教育TempEDU