免费做出小米手表表盘：开源工具一篇搞定
【免费下载链接】Mi-CreateUnofficial watchface creator for Xiaomi wearables ~2021 and above项目地址: https://gitcode.com/gh_mirrors/mi/Mi-Create
如果你手上有一块 2021 年以后的小米手表或手环，想给它换一张自己设计的表盘，Mi-Create 是目前少数能免费把这件事做完的开源表盘设计工具。从新建项目、拖拽组件到导出可安装的表盘包，全程图形界面，不需要写代码。
🎯 它替你把三件麻烦事做掉了
- 设备参数不用查：内置 22 款机型数据库（src/data/devices.json），从 454×454 的 Xiaomi Watch Color 到 192×490 的 Mi Band 8，新建项目选型号即可，画布自动匹配尺寸与圆角
- 编译不用学：编译器随程序打包在 compiler/compile.exe，点一次 Build 就出安装包
- 效果不用猜：画布中央实时预览，指针和数字随系统时间走动，改参数立刻可见
对新手来说，这三点省掉的是查资料、配环境、反复试错的时间。
⏱️ 四步装好并启动小米表盘设计工具
前置要求只有一个：Python 3.12 或更高版本。
第一步，克隆仓库：
git clone https://gitcode.com/gh_mirrors/mi/Mi-Create cd Mi-Create第二步，安装依赖，国内网络可追加清华源参数 -i https://pypi.tuna.tsinghua.edu.cn/simple：
pip install -r requirements.txt第三步，启动（当前源码版本 v1.1.2）：
python src/main.py依赖清单与各平台运行方式
| 依赖 | 作用 |
|---|---|
| PyQt6 | 图形界面框架，整个窗口都靠它 |
| PyQt6-QScintilla | 内置编辑器，查看项目 XML/JSON 用 |
| BeautifulSoup4 + lxml | 解析表盘项目的 XML 结构 |
| pillow | 处理导入的图片资源 |
| xmltodict | XML 与 JSON 互转 |
| requests | 联网更新编译器 |
| pywin32 / pyobjc 系列 | 按系统自动装，互不冲突 |
| 平台 | 运行方式 | 说明 |
|---|---|---|
| Windows | 安装包或源码 | 需 64 位 Win10 1809+ 或 Win11 |
| Linux | 仅源码 | 官方未提供 Linux 安装包 |
| macOS | 源码 | 可编辑预览，暂不支持 Build 导出 |
🛠️ 从新建项目到导出表盘：完整走一遍
左：资源列表，中：实时预览画布，右：属性面板
第 1 步：新建项目。启动后在欢迎界面选 New Project，填设备型号、项目名称、保存位置。配置页还会让你填一个 9 位数字的表盘 ID，这是设备识别表盘用的编号。
第 2 步：放组件。点插入按钮，菜单按项目格式给出可用组件：
| 组件 | 用途 |
|---|---|
| Image / Image List | 单张图片，或可切换的多图列表 |
| Digital Number | 数字时间 |
| Analog Display | 指针表盘，自带时/分/秒针素材 |
| Arc Progress | 圆弧进度，适合步数、电量 |
| Container | 容器，把多个组件打包管理 |
第 3 步：调属性。右侧属性面板改位置、大小、旋转，图层顺序随时可调，操作可撤销，中央画布缩放旋转实时看效果。
第 4 步：导出。点 Build，结果输出到项目旁的 output 文件夹，状态栏给出 .face 表盘文件的完整路径，再经小米运动健康 App 导入设备。
支持息屏的机型还能用 Quick AOD 快速生成息屏版本，工具会在当前项目里自动生成一套 AOD 子工程，不用单独配资源。
🧩 装插件、换语言、接 GMF 项目：扩展你的工作台
插件系统。设置页有 Install Plugin from File 和 Open Plugins Folder 两个入口，插件放在 src/plugins/ 目录，API 在 plugins/libs/plugin_api 里，写一个 Python 文件就能给编辑器加自定义功能。
三种项目格式。
| 格式 | 状态 | 适合谁 |
|---|---|---|
| .fprj（XML） | 完整支持，组件种类最全 | 绝大多数用户 |
| 中国区 GMF（wfDef.json） | 实验性支持，组件含 Pointer 指针 | 国内生态项目 |
| 快速息屏 AOD | 内置 | 只做息屏显示 |
多语言界面。内置英、中、俄、西、意、葡、乌 7 种语言，配置在 src/locales/，每种语言一个目录，改 .po 文件再编译即可扩充。
明暗主题。src/themes/ 下分 Dark 和 Light 两套配色与图标，设置里一键切换。
启动画面，标题栏显示当前版本与编译器版本
⚠️ 绕过四个最常见的报错：现象、原因与解法
坑 1：macOS 上点 Build 没反应。
- 现象：弹窗提示编译支持即将添加
- 原因：编译器是 Windows 可执行文件，macOS 没有对应实现
- 解法：导出环节换 Windows 机器，macOS 上正常做设计
坑 2：Linux 上点 Build 报 "Wine was not found"。
- 现象：弹窗直接报错
- 原因：编译走 Windows 二进制，Linux 下需要 Wine 模拟
- 解法：先装好 Wine 再点 Build
坑 3：源码方式运行，找不到日志文件。
- 现象：想排查问题却翻不到 app.log
- 原因：只有编译安装版才写日志文件，源码运行的日志全部打到控制台
- 解法：直接看终端输出；Windows 安装版的日志在 C:\Users\用户名\AppData\Local\Programs\Mi Create\data\app.log
坑 4：装依赖或启动时报版本错误。
- 现象：import 失败或界面起不来
- 原因：程序要求 Python 3.12 及以上
- 解法：先用 python --version 确认，低版本换 3.12 再重装依赖
一句提醒：仓库的 next 分支是功能测试区，代码不稳定，日常使用认准 main 分支。
🚀 一个晚上做出并安装第一张表盘
Mi-Create 面向 2021 年后的全量小米穿戴设备
按这个顺序走，第一张成品一个晚上能出来：
| 步骤 | 动作 | 耗时 |
|---|---|---|
| 1 | 按四步装好并启动 | 15 分钟 |
| 2 | 新建项目，选对设备型号 | 5 分钟 |
| 3 | 放 1 张背景图 + 1 个 Digital Number，调到居中 | 20 分钟 |
| 4 | 点 Build，把 output 里的表盘装到手表上 | 10 分钟 |
跑通后再加 Arc Progress 和 Container，试 Quick AOD，写第一个插件。遇到问题先翻终端日志，再到项目仓库的讨论区提问、给 bug 提 issue，附上 app.log 文件，维护者会跟进。
最后一句提醒：程序本体是 GPL-3 开源协议，内置编译器是第三方闭源程序，再分发时保留仓库链接即可。
【免费下载链接】Mi-CreateUnofficial watchface creator for Xiaomi wearables ~2021 and above项目地址: https://gitcode.com/gh_mirrors/mi/Mi-Create
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)