OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Device Model Database

这页说明书讲的是一个“设备名字小帮手”。在苹果电脑的 OpenClaw 软件里,它会帮我们把那些像密码一样难懂的设备编号(比如 iPad16,6),变成我们一看就懂的名字,比如“iPad Pro”。这页主要是告诉大人们,如果想让软件认识更多新设备,可以怎么更新这个小帮手里的名单。如果你只是想用软件,不需要看这页哦。

五岁小孩版解释

这个“设备模型数据库”就像一本给软件用的“名字翻译字典”。苹果的每个设备都有一个像密码一样的代号,比如 Mac16,6,但我们在软件界面上想看到的是“MacBook Pro”这样好懂的名字。这本“字典”就负责把密码翻译成好名字。

这本“字典”是从一个叫 kyle-seongwoo-jun/apple-device-identifiers 的公共仓库借来的,并且是免费的(MIT 许可)。为了让每次软件做出来的样子都一样,我们用了这个仓库在某个特定时间的“快照”,这个时间点记录在一个叫 NOTICE.md 的文件里。

如果你想更新这本“字典”,让软件认识更多新设备,需要按顺序做下面几件事:

  1. 第一步,选两个“快照”时间点。 你需要去那个公共仓库,为 iPhone/iPad 名单选一个最新的、稳定的提交记录(commit sha),再为 Mac 电脑名单选一个。你可以把它们想成是两个固定的拍照时刻。
  2. 第二步,把新选的时刻记下来。 打开电脑里这个文件 apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md,把里面旧的“快照”编号(就是那两串长长的字母数字),换成你第一步选好的新编号。
  3. 第三步,下载新的名单文件。 打开电脑的“终端”,像念咒语一样输入下面两行命令。记得把 <commit sha for ...> 换成你第一步选好的真实编号哦!
    • 要下载新的 iPhone/iPad 名单,输入:curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/你选的编号/ios-device-identifiers.json" -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/ios-device-identifiers.json
    • 要下载新的 Mac 名单,输入:curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/你选的编号/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. 第五步,试试新字典好不好用。 最后,我们要检查一下软件用上新字典后,能不能顺利“造”出来。还是在“终端”里,输入这个命令:swift build --package-path apps/macos。如果它运行完没有出现红色的错误或黄色的警告,就说明一切顺利,更新成功啦!