Files
openclaw/docs/zh-CN/reference/device-models.md
2026-02-02 16:38:25 +01:00

55 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
read_when:
- 更新设备型号标识符映射或 NOTICE/许可证文件
- 更改实例 UI 中设备名称的显示方式
summary: OpenClaw 如何内置 Apple 设备型号标识符以在 macOS 应用中显示友好名称。
title: 设备型号数据库
x-i18n:
generated_at: "2026-02-01T21:37:07Z"
model: claude-opus-4-5
provider: pi
source_hash: 1d99c2538a0d8fdd80fa468fa402f63479ef2522e83745a0a46527a86238aeb2
source_path: reference/device-models.md
workflow: 15
---
# 设备型号数据库(友好名称)
macOS 配套应用通过将 Apple 型号标识符(例如 `iPad16,6``Mac16,6`)映射为人类可读的名称,在**实例** UI 中显示友好的 Apple 设备型号名称。
该映射以 JSON 形式内置于:
- `apps/macos/Sources/OpenClaw/Resources/DeviceModels/`
## 数据来源
我们目前内置的映射来自 MIT 许可的仓库:
- `kyle-seongwoo-jun/apple-device-identifiers`
为保持构建的确定性JSON 文件固定到特定的上游提交(记录在 `apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md` 中)。
## 更新数据库
1. 选择要固定的上游提交iOS 和 macOS 各一个)。
2. 更新 `apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md` 中的提交哈希。
3. 重新下载固定到这些提交的 JSON 文件:
```bash
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. 确保 `apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt` 仍与上游一致(如果上游许可证发生变更,请替换该文件)。
5. 验证 macOS 应用能够正常构建(无警告):
```bash
swift build --package-path apps/macos
```