> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 裝置型號資料庫

macOS 伴隨應用程式的 **實例** UI 會將 Apple 型號識別碼對應到易讀名稱（`iPad16,6` -> "iPad Pro 13-inch (M4)"、`Mac16,6` -> "MacBook Pro (14-inch, 2024)"）。`DeviceModelCatalog` 也會使用識別碼前綴（回退到裝置系列）來為每個裝置選擇 SF Symbol。

`apps/macos/Sources/OpenClaw/Resources/DeviceModels/` 中的檔案：

| 檔案                                     | 用途                     |
| -------------------------------------- | ---------------------- |
| `ios-device-identifiers.json`          | iOS/iPadOS 識別碼 -> 名稱對應 |
| `mac-device-identifiers.json`          | Mac 識別碼 -> 名稱對應        |
| `NOTICE.md`                            | 固定的上游提交 SHA            |
| `LICENSE.apple-device-identifiers.txt` | 上游 MIT 授權條款            |

## 資料來源

隨附引入自採用 MIT 授權的 `kyle-seongwoo-jun/apple-device-identifiers` GitHub 儲存庫。JSON 檔案固定到記錄於 `NOTICE.md` 的提交 SHA，以維持建置可重現。

## 更新資料庫

1. 選擇要固定的上游提交 SHA（一個用於 iOS，一個用於 macOS）。
2. 使用新的 SHA 更新 `apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md`。
3. 重新下載固定到這些提交的 JSON 檔案：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
IOS_COMMIT="<commit sha for ios-device-identifiers.json>"
MAC_COMMIT="<commit sha for mac-device-identifiers.json>"

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${IOS_COMMIT}/ios-device-identifiers.json" \
  -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/ios-device-identifiers.json

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${MAC_COMMIT}/mac-device-identifiers.json" \
  -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/mac-device-identifiers.json
```

4. 確認 `LICENSE.apple-device-identifiers.txt` 仍與上游相符；如果上游授權條款已變更，請替換它。
5. 驗證 macOS 應用程式能順利建置：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
swift build --package-path apps/macos
```

## 相關

* [節點](/zh-TW/nodes)
* [節點疑難排解](/zh-TW/nodes/troubleshooting)