建置 DuDuClaw OS image
已搬移（2026-09）。 OS image 不再從這個 repo 建置。這頁原本描述的 Yocto layer、release pipeline，以及已凍結的 Debian/mkosi 值班機 recipe，現在全部都在獨立的 DuDuClaw-OS repo 裡。這頁保留下來，作為平台文件的穩定入口，告訴你該往哪裡去。
DuDuClaw OS 是把一台小型 x86-64 PC 變成無頭（headless）DuDuClaw 值班機的 開機 image（成品從使用者角度長什麼樣，見 值班機功能總覽）。你現在 讀的這個平台 repo，放的是 OS 拿去 vendor 成精簡快照的 Rust workspace； OS 本身有自己的 repo、自己的 release 線、自己的 changelog。
1. 取得 image
Section titled “1. 取得 image”有兩條路：
- 下載已簽章的 release。 DuDuClaw-OS Releases
上每個 release 都會依機型發布一份整碟 image
（
duduclaw-os-<machine>-v<ver>.wic.zst）與兩份 live 安裝器 ISO——基礎版 （duduclaw-os-installer-<machine>-v<ver>.iso）與桌面版 （duduclaw-os-installer-desktop-<machine>-v<ver>.iso），各自附上.sha256與 minisign.minisig。燒錄前務必驗證；公鑰與確切指令見 文件站上的 OS README 與 SECURITY 說明 （「快速開始」／“Quick start”）。 - 從原始碼建置。 把 DuDuClaw-OS clone 到這個 repo 旁邊，照它的 README
（「從原始碼建置」／“Build from source”）與
meta-duduclaw/README.md（“Usage”）走：一個 Docker builder 容器、kas build，以及scripts/release-os.sh build → smoke → package → publish這條 pipeline。 只有在需要刷新 vendor 進去的 Rust 快照時，才需要這個平台 repo 的 sibling checkout。
2. 你在建置什麼
Section titled “2. 你在建置什麼”出貨的 image 是 meta-duduclaw/ 這個 Yocto layer（Yocto 6.0
“wrynose”，kernel 6.18）產出的 duduclaw-image-appliance——桌面版：A/B
雙槽配置、支援原子更新與回滾、唯讀 root、DuDuClaw 自己的桌面（compositor
＋ shell）搭配 gateway ＋ dashboard、預載應用程式，以及 app 相容層。
Secure Boot 簽章、dm-verity root 驗證與 TPM2 金鑰封裝在這個 layer 裡都是
建置期的 overlay 選項（kas/sb-signing.yml、kas/tpm-luks.yml），但截至
現行 v0.4.0（內嵌平台 v1.73.4）仍然沒有啟用，開機時 Secure Boot 依舊
是關閉的。release-os.sh 每次建置只疊一個 release overlay（預設
serial1.yml，v0.3.0 用 release-linux-builder.yml），兩者都不會開啟簽章、
verity 或 TPM。從 v0.4.0 起，gateway 以非 root 帳號執行、容器改用 rootless
Podman、SSH 預設關閉；開機成功過 v0.4.0 的裝置回不去 v0.3.0 以前的版本。
安裝器 ISO 寫入的是基礎版 duduclaw-image-ab（同樣的架構與桌面殼層，v0.4.0
起也有防火牆，但沒有 app 層）；桌面版專屬的安裝器 ISO
（duduclaw-os-installer-desktop-…）自 v0.1.0（2026-09-04）起就與它一起
出貨。目前定義了兩個機型：duduclaw-qemux86-64（QEMU bring-up 目標，已
驗證可開機）與 duduclaw-genericx86-64（真實 x86-64 硬體，已做設定審查；
真實硬體開機仍是待驗證項目）。每個 image 的角色分工與分割區／開機鏈細節
記載在 OS repo 裡，這裡不重複。
3. Debian/mkosi 那條線
Section titled “3. Debian/mkosi 那條線”這頁原本記載的 appliance/ recipe（Debian 13 ＋ mkosi、自安裝 USB
image）已凍結：它保留在 DuDuClaw-OS repo 的 appliance/ 底下，作為
參考與過渡期產物，不出貨、也不再收修正。它自己的 README 仍留著完整開機
流程與待解項目，供想查歷史的人參考。
- DuDuClaw OS 值班機： 成品從使用者角度長什麼樣、做什麼。
- 硬體需求與相容性 —— 能跑在什麼硬體上、怎麼 燒錄開機媒體。
- DuDuClaw-OS repo：layer、
pipeline、changelog，以及文件索引（
docs/README.md）。