硬件验收
核对 M4、16GB RAM 与基础 256GB SSD。若订单包含存储附加项，再单独检查可用容量和挂载位置。
按任务推进
准备、连接、运行，再定位问题
这不是一组零散命令。先在控制台核对订单与节点，再建立连接、复现工具链，最后用可保留的日志验收任务。适用于 NowMini M4、16GB RAM、256GB SSD 的独享物理机。
- 4 类任务
- 准备、连接、运行、排查
- 4 个节点
- 新加坡、日本（东京）、韩国（首尔）、香港
- 1 档配置
- NowMini M4 独享物理节点
快速定位
先描述你正在做的任务
输入“Xcode”“SSH”“runner”“磁盘”等词，页面会保留相关步骤。也可以直接选择下面的任务入口。
首次开通
连接前先完成六项确认
不要把订单确认、网络放行和系统初始化混在一次连接里。按顺序记录结果，认证失败时才能快速定位边界。
开通检查单
从控制台信息到首次会话
以控制台实时返回的订单和节点信息为准。不要从旧工单或团队聊天记录复制主机地址。
01
确认订单标识
记录订单标识、租期和 NowMini M4 配置，确认当前操作的是目标订单。
02
核对节点区域
确认新加坡、日本（东京）、韩国（首尔）或香港，并让团队成员使用同一地区名称沟通。
03
读取系统凭据
核对用户名、主机地址和密钥要求。凭据只存放在受控密码库，不写入代码仓库。
04
确认访问来源
记录办公网络、固定出口或 runner 的来源地址，避免在未知公共网络上进行首次初始化。
05
建立首次连接
先验证网络可达，再验证主机指纹和密钥权限。不要连续修改多个变量后重复尝试。
06
完成账户初始化
创建任务所需的最小权限环境，设置工作目录和日志目录，并保存一份不含秘密的验收记录。
会话验收
分别记录 SSH 与图形会话能否建立、首次连接耗时、键盘输入和剪贴板是否符合任务需要。
打开连接说明
开发环境
按依赖关系复现工具链
先固定工具版本，再接入凭据、缓存和签名材料。顺序反过来，往往会把版本问题误判为权限问题。
固定 Xcode 工具链
先确认当前选择的开发者目录，再记录 Xcode 与 SDK 版本。团队流水线应把版本作为构建输入，而不是依赖交互式选择。
- 检查命令行工具路径
- 记录编译器与 SDK 版本
- 用最小工程完成一次基线构建
配置 Git 凭据
为节点或自动化账户配置独立密钥，只授予所需仓库权限。首次拉取后记录远端地址、分支和提交基线。
- 验证密钥文件权限
- 核对仓库读写边界
- 避免在脚本参数中暴露秘密
划分依赖与缓存
把可重建依赖、编译缓存和最终产物分开。缓存键至少包含工具版本、锁文件摘要和目标平台。
- 锁定依赖解析结果
- 限制缓存目录增长
- 保留清缓存后的基线构建方式
最后导入签名材料
证书、描述文件和解锁信息应在工具链验证后导入。使用受控目录，任务结束后清理临时副本。
- 记录证书有效范围
- 限制钥匙串访问主体
- 用归档任务验证签名链
验收标准
同一提交在干净工作目录中能够完成依赖解析、编译、测试与归档；失败时能从日志看出具体阶段，而不是只留下“构建失败”的最终状态。
CI/CD 接入
把物理节点接入现有队列
runner 是执行入口，不应同时承担秘密仓库、长期产物库和团队共享目录。先划清目录与权限，再追求并发。
执行链路
五个环节，一条可审计时间线
每次任务至少记录提交、runner、开始时间、结束状态和产物位置。节点全年 365 天正常运行，不设置计划停机时段。
注册 runner
使用独立自动化账户注册执行器，标签只表达系统和任务能力，不包含秘密或个人名称。
隔离工作目录
每个流水线使用独立工作路径。任务结束后删除临时文件，避免上一任务污染下一次构建。
定义缓存策略
缓存按锁文件和工具版本命名，设置容量上限，并保留不命中缓存时的完整执行路径。
回传构建产物
归档文件、符号文件和测试报告回传到团队既有存储，节点工作目录不作为唯一副本。
留存失败日志
保留失败阶段、退出码和关键上下文。提交支持请求前移除令牌、密钥和签名材料。
并发控制
先以单任务完成基线，再逐步增加队列并发。16GB RAM 下应按实际任务峰值拆分测试、归档和推理作业。
重试边界
只对网络瞬断等可恢复步骤重试。编译、测试或签名失败应保留原始结果，避免重试覆盖首个错误现场。
产物校验
回传后核对文件大小、摘要和任务标识。团队成员应能从流水线记录追溯到对应提交与构建环境。
MLX 实验
先验证环境，再扩大推理任务
NowMini M4 适合建立可复现的小型 MLX 实验。模型文件、运行参数和结果记录应彼此分离，便于清理与复跑。
MLX CHECKPOINTS
NOWMINI M4
环境验证
记录 Python、MLX 与关键依赖版本，用小型张量操作确认环境可执行。
模型放置
模型文件进入独立数据目录，校验文件摘要，不与源码仓库或临时缓存混放。
任务运行
固定模型、输入、采样参数和随机种子；先跑小批量，再观察内存和输出稳定性。
资源监控
记录峰值内存、磁盘增长、运行时长和退出状态，防止日志或中间结果占满空间。
一次实验至少保留什么
- 输入
- 模型标识、文件摘要、提示或数据集版本
- 环境
- 系统、Python、MLX 与依赖版本
- 参数
- 批量大小、生成长度、采样设置
- 结果
- 运行时长、峰值资源、输出摘要、退出状态
存储边界
基础方案包含 256GB SSD。下载模型前先核对可用空间；大型模型、中间结果和多版本权重应纳入清理计划，或在订购时选择固定存储附加项。
查看方案与存储
故障树
从边界条件开始，不要随机改配置
先判断问题发生在本地网络、访问控制、认证、工具链还是资源层。每次只改变一个变量，并记录结果。
无法连接节点：先检查哪一层
- 确认本地网络可以访问外部服务，关闭会改变路由的临时代理后再测试。
- 从控制台重新核对主机地址和节点区域，不使用旧截图中的地址。
- 确认当前访问来源符合限制，并检查本地防火墙是否拦截目标端口。
- 分别记录 DNS 解析、网络可达和协议握手结果，避免只提供“连不上”的结论。
认证失败：如何区分用户名和密钥问题
- 核对用户名是否对应当前节点，不要沿用其他服务器的账户名。
- 检查私钥文件权限、文件格式和客户端实际加载的密钥路径。
- 验证主机指纹是否与首次记录一致；出现变化时先停止连接并提交工单核对。
- 开启客户端详细日志，保留认证方法协商和服务端拒绝阶段，提交前移除敏感内容。
构建异常：从版本、依赖还是签名开始
- 先确认 Xcode、SDK 和命令行工具路径与基线一致。
- 在干净工作目录中重新解析锁定依赖，判断是否为缓存污染。
- 将编译问题与签名问题分开：先完成不依赖发布签名的构建，再验证归档。
- 保留第一处错误及其上下文，不要只截取日志末尾的汇总信息。
磁盘空间不足：哪些目录优先检查
- 记录总容量、已用容量和任务开始前后的变化，不要立即删除全部文件。
- 依次检查构建缓存、归档、测试结果、下载模型和长期增长的日志目录。
- 确认产物已经回传后再清理节点副本，避免把唯一可恢复文件一起删除。
- 为缓存和日志设置容量上限，把清理动作纳入任务结束流程。
任务超时：如何判断是慢还是已阻塞
- 对照最后一条有效日志，判断任务仍在计算、等待网络还是等待子进程。
- 检查同一节点是否有其他任务竞争内存、磁盘或工作目录锁。
- 为下载、构建、测试和上传设置独立超时，不使用一个总超时覆盖所有阶段。
- 重试前保存进程状态和失败日志；若可稳定复现，附上最小任务提交工单。
诊断记录
一次有效排查应留下五项信息
- 发生时间包含时区
- 节点区域四个在售节点之一
- 操作步骤可重复执行
- 预期与实际说明差异
- 脱敏日志保留错误上下文
安全操作
把访问权限纳入任务生命周期
凭据不是一次配置后永久不动的文件。人员、runner、网络来源或项目发生变化时，都要重新检查权限边界。
轮换凭据
成员变更、密钥外泄疑虑或自动化账户调整后立即轮换。停用旧凭据后再验证新凭据，避免同时保留多套未知入口。
限制访问来源
优先使用可识别的固定出口。临时放开的来源在任务结束后撤销，并记录变更人、用途和撤销结果。
最小化自动化权限
runner 使用独立账户和独立密钥，只访问目标仓库、工作目录和产物位置。不要让构建脚本继承个人长期权限。
迁移与交接清理
先回传源码、模型和产物，再删除临时证书、密钥、缓存与包含敏感字段的日志。由接收人按清单重新验收。
交接完成的判定
新负责人能够使用自己的授权建立连接、运行基线任务并读取日志；旧负责人凭据已撤销；节点上不存在无人负责的临时账户和秘密副本。
人工支持
把问题整理成可以立即执行的工单
已有订单问题优先在控制台提交工单；售前、批量工作流评估或无法登录时，可发送邮件。对外联系渠道仅限这两种。
工单字段
提交前准备六项内容
信息越接近可复现条件，越容易直接进入诊断，而不是来回确认基础事实。
- 订单标识
- 控制台显示的当前订单标识
- 节点区域
- 新加坡、日本（东京）、韩国（首尔）或香港
- 发生时间
- 写明日期、时间和时区
- 复现步骤
- 从正常状态到错误出现的操作顺序
- 实际结果
- 错误文本、退出码或异常行为
- 脱敏日志
- 保留上下文，移除密码、密钥和令牌
不要提交敏感材料
工单和邮件中不要附带密码、私钥、完整支付凭据、签名材料或可直接访问代码仓库的令牌。
已有订单问题
登录控制台提交工单，可将问题与订单和节点关联。适合连接异常、计费核对、节点状态和现有任务问题。
提交控制台工单售前与登录协助
发送邮件至 support@nowmini.com，说明工作流、目标区域、预计租期和可复现问题。邮箱地址可直接换行显示。
发送邮件至 support@nowmini.com
下一步
配置明确后，直接开始使用
选择 NowMini M4 独享物理机，在新加坡、日本（东京）、韩国（首尔）或香港运行构建、自动化与 MLX 任务。实际可用性以控制台实时返回为准。