复用下载结果，不复用未知状态。
依赖缓存可以按锁文件摘要、Xcode 版本和架构复用。DerivedData、临时钥匙串、导出目录和未提交改动不应跨仓库直接复用。
可复现的工程工作流
把提交、构建、签名与产物交付放到独享云端 Mac。
MiniDebug M4 是一台独享物理机，不与其他订单共享设备算力。下面按真实任务拆解输入、执行步骤、输出和常见失败点，帮助你判断它是否适合现有的 iOS、CI、AI 或创作流程。
M4 / 16GB / 256GB
按天、周、月、季租用
5 个可选节点
物理节点在线
MiniDebug M4
01
拉取提交
固定提交哈希与依赖锁文件
02
执行构建
归档日志、退出码与耗时
03
交付产物
校验文件并写入任务记录
iOS 自动化打包
从 Git 提交到可归档产物，每一步都留下可追踪结果。
稳定的自动化打包不只是一条命令。需要同时固定源码版本、依赖状态、Xcode 选择、签名输入、导出参数和产物去向，任何一步失败都应能从日志定位。
-
01 · 触发
锁定提交与任务输入
输入：仓库地址、分支、提交哈希、构建配置和目标 Scheme。Webhook 或队列任务只传递标识，不在脚本里临时猜测分支。
失败点：提交不存在、子模块未同步、权限不足，或同一任务读取了变化中的分支头。
-
02 · 依赖
恢复缓存并安装依赖
输入：Package.resolved、Podfile.lock 或其他锁文件。缓存键至少包含依赖锁摘要、Xcode 版本与目标架构。
失败点：锁文件漂移、缓存与工具链不匹配、私有依赖凭据失效，或磁盘空间不足。
-
03 · 归档
运行 xcodebuild archive
输入：Workspace 或 Project 路径、Scheme、Configuration、Destination 与归档路径。先输出工具版本，再执行归档。
失败点：编译错误、测试失败、目标版本不兼容、派生数据污染，或构建脚本依赖本地绝对路径。
-
04 · 签名
按任务注入签名材料
输入：最小范围的证书、描述文件和必要环境变量。材料应在任务开始时注入，在任务结束后移除。
失败点：证书与描述文件不匹配、权限范围错误、有效期问题，或多个任务误用同一临时钥匙串。
-
05 · 导出
导出并校验文件
输入：归档文件与 ExportOptions 配置。导出后记录文件名、大小、校验摘要和生成时间，而不是只判断目录是否存在。
失败点：导出方法与签名配置冲突、输出目录无权限，或脚本吞掉了非零退出码。
-
06 · 归档
汇总日志与产物
输出：构建产物、归档文件、测试报告、构建日志、提交哈希与任务编号。上传成功后再清理工作目录。
失败点：上传中断、产物命名冲突、日志包含敏感字段，或清理动作早于结果确认。
构建农场编排
多个仓库共享队列，但不共享未受控的工作目录与签名材料。
构建农场的核心不是让任务同时运行，而是让队列、节点标签、缓存边界和结果回传都可解释。单台 MiniDebug M4 适合承载一条受控执行通道；更多并发任务应分配到不同订单对应的物理节点。
队列调度示例
1 任务 = 1 工作目录
仓库、任务与节点的分配顺序
mobile-app
release / archive
分配 M4 节点
shared-sdk
main / test
等待归档任务结束
demo-client
feature / build
按优先级排队
- 入队：保存仓库、提交、优先级、预计超时和所需标签。
- 匹配：按 Xcode 版本、节点状态、任务类型与占用情况选择执行节点。
- 执行：创建独立工作目录，恢复符合缓存键的依赖，再注入本次任务所需材料。
- 收尾：回传状态、日志、产物和耗时，确认上传后销毁临时目录与临时凭据。
让队列状态与构建结果分开。
排队、执行、上传和完成是调度状态；编译通过、测试失败、签名失败是任务结果。两者分开记录，才能判断是容量问题还是项目问题。
GitHub Actions 自托管 Runner
先设计标签和清理策略，再让工作流落到 Mac 节点。
Runner 注册只是接入动作。真正决定稳定性的，是标签是否精确、单机并发是否受控、任务结束是否清理，以及失败日志能否回到对应的工作流运行记录。
标签规划
标签只描述稳定能力。
建议保留系统标签，并增加可长期维护的能力标签，例如 macos、arm64、xcode-current 和 signing-ready。不要把临时项目名或短期分支写进节点标签。
runs-on:
- self-hosted
- macos
- arm64
- xcode-current
注册与权限
使用专用运行账户承载任务。
注册前确认 Runner 所属范围、仓库访问边界和工作目录。运行账户只获得执行构建所需权限，不与日常远程操作混用，也不把长期凭据直接写入脚本文件。
- 记录 Runner 名称、节点和用途
- 限制可调用它的仓库或组织范围
- 检查工作目录和缓存目录权限
- 注册完成后运行最小构建验证
清理与并发
单通道执行，任务之间显式清理。
同一工作目录不要同时跑两个写入型任务。任务开始前检查残留进程和磁盘空间，任务结束后清理源码副本、临时导出文件、临时钥匙串和项目级环境变量。
需要并发时，将不同任务分配到不同物理节点，而不是让签名、归档和清理步骤在同一目录互相覆盖。
失败回传
即使构建失败，也要上传诊断材料。
日志收集步骤应在失败条件下继续运行，至少回传 xcodebuild 输出、测试结果、磁盘余量、工具版本和任务标识。上传前移除令牌、私钥内容、证书密码与仓库敏感变量。
区分 Runner 离线、任务超时、脚本退出和产物上传失败，避免所有问题只显示为“构建失败”。
独立开发者发布流
图形界面处理少量人工确认，命令行负责可重复的构建与归档。
独立开发者通常不需要把所有步骤一次性自动化。更稳妥的方式是明确图形操作与命令行任务的交接点，让修复、验证、归档和 TestFlight 前产物准备都能回退。
本地开发环境
修复与提交
完成代码修改、基础测试和提交，推送固定分支，并记录需要验证的设备条件与预期结果。
输出：提交哈希、变更说明、测试范围
远程图形界面
Xcode 人工确认
检查 Scheme、目标版本和工程设置，处理需要视觉判断的告警，并确认签名配置指向本次发布所需范围。
输出：确认后的工程状态与发布参数
命令行任务
归档与导出
执行脚本化归档、导出和校验，保留完整日志。出现问题时回到对应输入，不在失败机器上反复手动修改未知状态。
输出：归档文件、导出包、校验摘要
建议的交接规则
图形界面只负责必须人工判断的配置与检查；归档、导出、重试和产物命名交给脚本。每次人工调整后提交工程变更或记录差异，避免下一次构建无法复现。
AI 推理实验
在 Apple Silicon 上比较模型版本，而不是只记录一次运行结果。
MiniDebug M4 配置为 M4、16GB RAM 和 256GB SSD。实验设计应先核对模型与数据是否适合该资源边界，再记录加载、内存、持续推理和输出质量，避免把不同参数的结果混在一起。
固定模型与运行环境
记录模型格式、量化版本、运行时版本、提交哈希、输入样本和随机参数。模型文件使用校验摘要标识，避免同名文件实际内容不同。
- 必须记录
- 模型版本与量化方式
- 资源边界
- 16GB RAM / 256GB SSD
分开测冷启动与持续推理
首次加载包含模型读取和初始化，不能与稳定运行阶段混算。每组测试使用相同输入长度、批量大小、重复次数和采样参数。
- 时间指标
- 加载耗时、首个输出、总耗时
- 资源指标
- 峰值内存与稳定内存
比较速度、内存与结果偏差
量化版本不只比较速度。还应保存相同输入的输出、任务质量判断、错误样本和环境信息，最后导出机器可读结果与人工结论。
- 对比维度
- 延迟、吞吐、内存、输出质量
- 实验输出
- CSV、日志、配置与结论
{
"machine": "MiniDebug M4 / M4 / 16GB / 256GB",
"model_variant": "project-defined",
"input_set": "fixed-evaluation-set",
"measurements": [
"load_time",
"first_output_time",
"total_time",
"peak_memory"
],
"artifacts": ["result.csv", "runtime.log", "notes.md"]
}音视频工作流
把大文件同步、远程编辑和批量导出拆成独立阶段。
音视频任务的瓶颈可能来自素材传输、插件兼容、远程画面、磁盘容量或导出参数。将这些环节分开，可以避免把连接卡顿误判为主机计算问题。
同步工程与素材
先生成素材清单，记录文件数量、总大小、目录结构和校验摘要。只同步当前阶段需要的代理文件或源素材，完成后验证缺失项。
检查点：项目路径不依赖本地盘符，媒体引用可重新定位，256GB 基础 SSD 留出工程缓存和导出空间。
远程打开并检查工程
通过图形连接打开工程，检查字体、插件、媒体链接、采样设置和输出目标。弱网环境优先降低远程画质与分辨率，不改变工程输出参数。
检查点：区分远程预览质量与最终文件质量；缺少插件时先停止批量任务，避免生成不完整结果。
执行批量导出
固定导出预设、文件命名和目标目录，再按任务列表执行。每个任务保存退出状态、持续时间、输出大小和错误信息。
检查点：长任务开始前核对磁盘余量；并行数量应根据内存、素材读取和编码负载逐步验证。
验收并回传产物
抽检画面、音轨、时长、分辨率和文件头信息，再生成校验摘要。确认本地已完整接收后，清理云端临时文件。
输出：最终文件、导出日志、失败清单、校验摘要和本地接收记录。
节点选择建议
在新加坡、日本（东京）、韩国（首尔）、香港、美国东部之间按数据路径选择。
节点不是只看团队所在地。还要同时考虑代码仓库、依赖源、远程操作者和最终交付目标。以下是选择方向，不代表固定网络结果；实际连接表现取决于用户本地网络与跨地区链路。
| 节点 | 优先考虑的团队位置 | 仓库与依赖位置 | 典型交付方向 | 下单前验证 |
|---|---|---|---|---|
| 新加坡 | 东南亚团队或跨东南亚协作成员 | 仓库、制品或依赖服务主要位于东南亚时优先测试 | 面向东南亚团队的日常构建、远程开发和结果回传 | 测试仓库拉取、依赖下载与远程图形连接 |
| 日本（东京） | 日本及邻近东亚团队 | 代码与依赖访问路径主要靠近日本时优先测试 | 日本团队的 iOS 构建、签名检查和远程 Xcode 操作 | 验证本地到节点的交互稳定性与大文件上传 |
| 韩国（首尔） | 韩国及东北亚协作团队 | 仓库和内部资源访问从韩国方向更直接时考虑 | 持续集成、自托管 Runner 与区域内产物分发 | 验证 Runner 回连、依赖获取与日志上传 |
| 香港 | 华南与东南亚之间协作的团队 | 代码、素材和操作者分布在华南及东南亚时可优先比较 | 跨地区开发协作、远程图形任务和素材处理 | 分别测试办公网络与家庭网络的连接路径 |
| 美国东部 | 北美东部及与西欧协作的团队 | 仓库、CI 控制面或交付系统主要位于北美东部时考虑 | 北美工作时区内的构建队列、结果回传和协作检查 | 测试仓库、制品存储和远程操作者三条路径 |
工作流模板
从最小结构开始，再替换项目版本、证书与路径。
下面的片段用于搭建脚本结构，不是可直接用于所有项目的完整配置。保存到仓库前，应按工程类型核对 Workspace、Scheme、Xcode 版本、导出配置、签名材料、Runner 标签和产物目录。
set -euo pipefail
PROJECT_ROOT="/path/to/project"
WORKSPACE="$PROJECT_ROOT/Example.xcworkspace"
SCHEME="Example"
ARCHIVE_PATH="$PROJECT_ROOT/output/Example.xcarchive"
xcodebuild -version
xcodebuild \
-workspace "$WORKSPACE" \
-scheme "$SCHEME" \
-configuration Release \
-destination "generic/platform=iOS" \
-archivePath "$ARCHIVE_PATH" \
clean archive
修改项
替换工程路径、Workspace、Scheme、Configuration、Destination 和归档目录。脚本应保留非零退出码，并在执行前确认所需 Xcode 版本。
lane :build_release do
setup_ci
build_app(
workspace: "Example.xcworkspace",
scheme: "Example",
configuration: "Release",
output_directory: "output"
)
sh("shasum -a 256 output/*")
end
修改项
按项目替换 Workspace、Scheme、输出目录和导出设置。签名材料应通过受控变量或任务级注入提供，不要直接写入 Fastfile。
name: ios-build
on:
workflow_dispatch:
jobs:
archive:
runs-on:
- self-hosted
- macos
- arm64
- xcode-current
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Build
run: ./scripts/archive.sh
- name: Collect diagnostics
if: always()
run: ./scripts/collect-diagnostics.sh
修改项
按 Runner 实际标签、仓库策略和脚本路径调整。固定所用动作版本，设置任务超时，并让诊断收集在构建失败时继续执行。
开始验证现有流程
选择一台 MiniDebug M4，先跑通最小构建闭环。
从固定提交、单任务执行、日志归档和产物校验开始，再逐步加入缓存、签名注入与队列调度。支持按天、周、月、季租用，订单以美元（USD）结算。
付款仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe），实际可用网关以后台返回为准。