云端 Mac 使用手册

从订单字段到构建日志，按任务解决使用问题

这里不要求你先读完整本手册。按当前任务进入对应章节，依次核对租期、节点、连接信息、开发环境和日志证据；如果仍无法定位，再把完整上下文带进控制台工单。

立即租用云端 Mac 查看快速入门
5 类任务入口 2 档在售配置 5 个可选节点
RUN SHEET

首次使用检查顺序

资料就绪
01
核对订单 机型、租期、节点与附加存储
ORDER
02
确认连接 地址、账户、本地网络与凭据
ACCESS
03
准备工具链 Xcode、命令行工具、依赖与缓存
BUILD
04
保留诊断证据 发生时间、错误原文与脱敏日志
TRACE
独享 Apple Silicon 物理节点 365 DAYS
按当前任务开始

先告诉我们你卡在哪一步

输入任务、状态字段或错误现象，检索结果会直接指向本页对应检查单。也可以从五类入口开始，不需要按章节顺序阅读。

订单与实例字段

先确认订单定义了什么，再判断实例是否异常

订单决定芯片、内存、存储、节点和租用周期。控制台中的状态字段描述当前交付或运行阶段，两者不能混为一谈。目录内组合的实际可用性以控制台实时返回为准。

订单核对

五组字段必须逐项一致

ORDER PROFILE
租用周期
按天、周、月或季计费。核对当前周期与项目持续时间，不要把不同周期的金额混在同一预算里。
物理节点
新加坡、日本（东京）、韩国（首尔）、香港、美国东部共 5 个节点。优先考虑团队访问路径、代码源位置和数据流向。
基础配置
ArmVMS M4 为 M4、16GB RAM、256GB SSD；ArmVMS Pro（M4 Pro） 为 M4 Pro、64GB RAM、2TB SSD。
附加选项
独立核对 +1TB SSD、+2TB SSD 或 Thunderbolt 5 并联，确认附加项与基础配置出现在同一订单周期中。
结算方式
仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe），全部以美元（USD）结算；实际可用网关以后端返回为准。
常见状态

处理中与可连接

“处理中”通常表示订单资料仍在交付流程中；“可连接”表示连接信息已经生成。状态变更后先刷新订单详情，再使用详情页内的最新连接字段。

定位原则

订单正确不等于环境已就绪

配置和节点无误后，还要检查系统账户、磁盘余量、Xcode 版本与项目依赖。环境层问题不应通过重复创建订单来处理。

核对配置与价格
管理面板常见字段与检查动作
字段 表示内容 用户应检查 不一致时记录
ORDER ID 订单的唯一关联标识 工单、账单与实例是否引用同一编号 完整订单编号
REGION 物理节点所在区域 是否与下单时选择的节点一致 节点代码与可见名称
TERM 当前租用周期 日、周、月或季及其起止信息 周期名称与订单截图
ACCESS 连接资料是否已经生成 地址、账户与连接方式是否齐全 缺少的字段名称
STATE 实例当前运行阶段 刷新后状态是否变化、连接是否恢复 状态原文与发生时间
开发环境文档

让项目先可重复构建，再考虑进一步提速

迁入云端 Mac 时，优先恢复工具链、依赖和项目路径的一致性。不要一开始就复制整块旧环境；先用清单重建，能够减少架构不兼容、路径残留和缓存污染。

01

Xcode 项目准备

记录项目要求的 Xcode 大版本、工程或工作区入口、构建 Scheme、目标平台与最低系统版本。首次打开后先完成依赖解析，再执行完整构建。

  • 确认工程文件与子模块完整
  • 检查 Scheme 是否可用于命令行构建
  • 把签名配置与代码版本分开核对
02

命令行工具

先确认当前选择的开发者目录，再检查编译器、版本控制工具和脚本解释器。自动化任务应输出实际工具路径与版本，避免交互会话和执行器使用不同环境。

  • 记录当前 Xcode 选择结果
  • 确认 shell 初始化文件没有交互阻塞
  • 为脚本使用明确路径或可控环境变量
03

依赖管理

优先从锁定文件和软件清单恢复依赖。安装后检查 Apple Silicon 架构、二进制来源和命令解析路径，不要默认旧环境中的预编译文件仍然适用。

  • 保留依赖锁定文件与安装日志
  • 检查脚本是否写死旧机器目录
  • 将私有依赖凭据放入受控变量
04

构建缓存

缓存只保存可重建的数据。先用无缓存构建验证基线，再逐步恢复依赖缓存和派生数据；出现无法解释的编译差异时，优先清理当前任务缓存而不是删除全部项目数据。

  • 区分依赖缓存、编译缓存与最终产物
  • 缓存键包含工具链和依赖版本
  • 定期检查缓存体积与磁盘余量
CI/CD 接入

把执行器当作可审计的物理节点使用

自动化任务应能够说明谁触发、使用什么代码版本、读取哪些凭据、生成什么产物，以及任务结束后清理了什么。独享资源减少了资源竞争，但不会替代流水线自身的权限控制。

  1. 01

    注入最小凭据

    按仓库、依赖源和分发目标拆分凭据，只给当前任务必要权限。凭据通过受控变量传入，不写进仓库、构建脚本或日志。

    CREDENTIALS
  2. 02

    固定执行上下文

    记录提交版本、分支、Scheme、目标平台、Xcode 版本和依赖摘要。并行任务使用独立工作目录，避免共享派生数据互相覆盖。

    CONTEXT
  3. 03

    导出可追溯产物

    归档文件、测试报告、符号文件和构建日志应带任务标识，并在导出前检查完整性。失败任务也要保留足够日志供定位。

    ARTIFACTS
  4. 04

    清理任务环境

    移除临时凭据、挂载文件、临时工作区和不再需要的中间产物。长期复用的缓存进入指定目录，不与项目源码或敏感资料混放。

    CLEANUP
失败任务最少保留四项证据 任务编号、提交版本、失败步骤、错误日志原文
查看首次构建清单
AI 实验指南

先规划模型、存储和会话，再启动长任务

AI 实验的主要风险通常不是启动命令，而是模型文件重复、磁盘增长、会话中断和结果没有及时导出。开始前建立数据边界，能够减少任务运行到一半才发现空间不足。

容量规划

模型文件按三层目录组织

SOURCE 原始模型

保留来源、版本、许可信息和校验摘要。原始文件只保存一份，避免不同实验目录重复复制。

CACHE 可重建缓存

下载缓存、转换缓存和临时分片放入独立目录，空间紧张时可以清理并重新生成。

OUTPUT 实验结果

检查点、指标、日志和导出文件按任务编号归档，并在任务完成后转移到长期保存位置。

长任务会话

训练、转换或批量推理任务应脱离临时图形会话运行。启动后记录进程标识、工作目录、日志路径和恢复方式，再测试断开连接后任务是否继续。

  • 日志持续写入文件
  • 检查点使用明确间隔
  • 输出目录预留增长空间

备份边界

代码、模型来源信息、不可重建的检查点和最终结果需要独立备份。下载缓存、临时分片和可重复生成的中间文件不应占用同等备份资源。

咨询 AI 工作负载选型
排查决策树

按层检查，不要同时改动多个变量

每完成一层检查，只改变一个条件并记录结果。网络、凭据、系统、磁盘和构建日志有明确先后顺序；跳过前置检查，容易把连接问题误判为开发环境问题。

01

本地网络是否能到达连接地址

核对地址是否完整、当前网络是否限制相关连接、切换网络后现象是否一致。记录客户端系统、网络类型和错误发生时间。

失败 保留地址字段与网络错误原文
02

连接凭据是否来自当前订单详情

重新打开控制台订单详情，逐字核对账户、地址和凭据输入方式。不要使用旧截图、浏览器历史或其他实例的连接资料。

失败 记录缺失字段，不提交凭据原文
03

实例状态是否允许建立会话

刷新实例详情，确认状态字段是否变化。若状态与实际连接结果不一致，记录订单编号、节点、状态原文和首次发现时间。

异常 提交状态字段与复现步骤
04

磁盘是否有足够工作空间

检查项目目录、派生数据、依赖缓存、模型文件和临时产物。确认空间问题后，优先清理可重建缓存，不要删除尚未导出的构建结果。

不足 记录总量、可用量和主要目录
05

构建日志能否定位到首个真实错误

从任务退出状态向前查找首个错误，不要只截取最后一行。保留命令、工具链版本、提交版本和错误上下文，并移除令牌、私钥与其他敏感信息。

未解决 整理脱敏日志后提交工单
升级支持

无法自助解决时，提交一份可直接进入排查的上下文

已有订单的问题优先通过控制台工单关联订单。售前配置咨询或无法进入控制台时，可发送邮件至 support@armvms.com。请在同一会话继续补充材料，避免为同一问题重复创建请求。

必须提供

订单与节点信息

提供完整订单编号、节点名称、基础配置和附加选项。若问题发生在特定实例，说明控制台中看到的当前状态字段。

时间与复现

描述第一次失败的动作

写明发生时间、操作步骤、预期结果与实际结果。若多次尝试，请说明哪些条件改变过，哪些条件保持不变。

诊断附件

附上错误原文与脱敏日志

复制完整错误信息，附相关构建步骤和上下文。截图应包含字段名称，但必须遮盖所有敏感凭据和项目秘密。

提交后怎样补充新的日志或复现结果？

在同一工单或同一邮件会话中继续回复，注明新增测试发生的时间、改变了哪个条件以及结果。这样服务团队可以按时间线比较，不必重新建立上下文。

什么时候应优先使用控制台工单？

订单状态、账单、节点、实例连接和交付字段等已有订单问题，应优先使用控制台工单。工单能够关联订单编号，减少往返确认。

售前选型咨询需要准备哪些信息？

说明项目类型、并发任务数量、所需 Xcode 环境、预计存储、租用周期和目标节点。大型工程或大模型推理可重点说明峰值内存与模型文件规模。

准备好排查材料

关联订单提交工单，让问题直接进入正确上下文

带上订单编号、节点、发生时间、复现步骤和脱敏日志。售前咨询也可以先查看两档配置，再提交项目持续时间与资源需求。

登录控制台提交工单 联系服务团队