Core ML 本地绘图：Mac 模型获取、转换与首图核对

资源类型与兼容准备

本题要解决的是：拥有 Apple Silicon Mac 后，怎样判断手中的模型能否交给本地程序加载，并把第一次出图留下可复查记录。不要仅因文件名带有 Core ML，就认定它与任意绘图程序兼容。

准备时把资源分为两栏：一栏登记原始模型权重及其配套配置，另一栏登记目标运行程序要求的 Core ML 资源格式与目录。二者不能仅凭名称认定可互换；是否需要转换、编译或额外配套文件，必须由所选实现的当前说明确认。不要尝试改扩展名来代替转换。

现有 Hugging Face 官方博客索引列出了 Using Stable Diffusion with Core ML on Apple Silicon，日期为 2022 年 12 月 1 日；以及 Faster Stable Diffusion with Core ML on iPhone, iPad, and Mac，日期为 2023 年 6 月 15 日。这只能确认历史文章条目存在，不能确认今天的安装方法、支持模型或加速效果。以下步骤是原创核对与实验设计，涉及具体实现的动作均须先补齐依据。

先确定一个运行实现及其固定版本，再填写下表。不要把来自不同项目、不同年份的要求拼成一套环境；存在关键未知项时，停在准备阶段。

资料包没有确认最低 macOS 版本、最低内存、可用模型名单或安装入口，因此这里不填统一门槛，也不承诺所有 Apple Silicon Mac 都能运行。

模型获取与转换路径

路径一：获取与加载端配套的模型包

1. 从已核对的运行实现说明中确定配套模型资源，登记发布者、修订和授权，不先凭模型热度选文件。
2. 核对资源清单及加载端要求的格式、目录层级和附属文件。确认当前程序接受的是哪一阶段的产物，而不是只检查下载是否完成。
3. 按发布方说明获取完整资源；有校验信息时进行核对。不要混用不同修订的组件，也不要随意重命名内部文件。
4. 将本地资源位置填入该版本已确认的加载入口，使用文档基线配置初始化。先保存加载日志，再提交生成任务。

路径二：从受支持的原始权重转换

1. 先查转换器是否明确支持目标模型架构、输入格式和拟用版本；没有明确支持依据时，不把转换当作通用补救手段。
2. 固定原始权重修订、配套配置、转换器版本和依赖，在独立环境中按对应说明准备输入。
3. 按照该实现的转换说明设置目标系统、输出位置及必要选项，保留完整配置与日志。本文不提供资料包未确认的转换命令。
4. 核对生成文件是否完整，再按加载端说明完成必要的后续处理。转换过程结束不等于本地推理已经通过。
5. 保留原始权重和转换产物的对应关系，用与路径一相同的加载、首图和验收流程检查，不覆盖原文件。

两条路径的共同终点是“加载端接受且能够完成生成”，不是“目录里出现模型文件”。首次部署可优先考察是否存在明确配套的资源包；没有配套资源时，再评估自行转换的前提。

首图任务与运行记录

下面是原创首图任务示例，不是官方推荐参数，也没有对应的已生成图片。尺寸、步数、引导设置和调度方式应先采用所选实现与模型明确支持的基线，不能从其他模型直接搬用。

1. 在新启动的进程中加载本地资源，分别记录加载开始与就绪时间；若日志无法分离加载和生成阶段，标为合并耗时。
2. 提交上述固定提示词，只生成一张候选图；保存原始输出和日志，先检查文件能否打开、尺寸是否正确及画面是否异常。
3. 不退出进程，在相同配置下重复生成三次，逐次记录耗时。确认模型确实被复用后，才将这些记录归为重复生成。
4. 首图失败时，保存失败阶段和错误信息，不把失败项写成零秒，也不把后续成功记录覆盖到原任务上。

固定提示词便于比较，但不保证模型一定准确画出所有细节。固定种子也不应被解释为跨实现、跨计算配置的逐像素一致承诺。

计算单元对照记录

先从当前实现确认哪些计算单元选项确实可用，再建立候选行。不要凭硬件拥有某个单元，就推断整条生成流程一定使用它；请求配置与实际执行证据应分开记录。

每组使用新进程，保持模型资源、提示词、尺寸、步数、调度配置和输出处理不变，只修改已确认可切换的计算单元配置。若切换还要求更换转换产物，应注明这是资源与计算配置的组合比较，不能将差异全部归因于单个选项。

内存记录同时写明观测工具、指标名称、单位、采样方式和阶段。只有进程内存读数时，就按该指标命名，不将其直接称为整机峰值或独立显存。还应记录电源状态与后台负载，避免把运行条件变化当成配置收益。上述表格尚无运行数据，不据此给出速度排名或加速比例。

加载与输出异常排查

以下是排查假设清单，不是资料包确认的故障发生记录。先找到日志中的失败阶段，再验证可能原因，一次只做一项修正。

发布前验收与交付记录

• 设备、系统、运行实现和依赖版本均已登记；模型支持与授权有对应说明，而非只引用历史索引。
• 现成资源或自行转换路径明确，模型修订、文件清单、转换配置与加载记录能够互相对应。
• 首图原始文件可以打开，尺寸和格式符合任务要求；黑图、噪点、颜色及主体异常已检查。
• 固定提示词、随机条件和全部有效生成配置已归档；无法固定的条件明确标注。
• 首次加载、首次生成、重复生成的计时范围一致；不能分离的耗时没有冒充单阶段数据。
• 计算单元对照只包含确认受支持的配置，实际执行单元没有证据时不作确定判断。
• 内存指标的工具、单位和观测范围清楚，失败记录未删除；已有可恢复的基线配置。
• 发布图片前复核用途与授权；发布部署结论前补齐当前实现说明和本地运行产物，不把本文待记录表格当作结果。

目前可交付的是准备清单、两条条件式路径和首图记录规范；当前兼容性、具体调用方法与运行表现仍待补证。下一步应补充所选实现的固定版本说明、模型卡与许可，再依照已确认入口执行首图任务并归档结果。