发生时间
写明当地时区与大致时间,说明问题是首次出现、每次出现还是间歇出现。
节点怎么选、租多久更合适、现有开发环境如何迁移、self-hosted runner 怎样接入,适合通过支持邮箱说明需求。已经产生订单、账单或运行中的实例问题,登录控制台提交工单,并附上订单号、节点与复现信息。
选择入口后,下方生成器会切换对应的必填字段。这样能减少来回追问,也能避免把订单问题写成没有设备上下文的泛化描述。
填写后会在本机生成邮件主题和正文,并交给系统邮件应用打开。页面不会把内容提交到其他接收端;发送前仍可在邮件应用中检查和修改。
“无法构建”或“连接很慢”不足以定位问题。下面每一格都应给出可复核内容;如果某项不适用,明确写“不适用”,不要留给接收方猜测。
写明当地时区与大致时间,说明问题是首次出现、每次出现还是间歇出现。
记录完整 macOS 版本,以及问题发生前是否刚完成系统、Xcode 或依赖调整。
列出 Xcode、Command Line Tools、Homebrew、Git、Fastlane、runner 或相关 SDK 的版本。
从可工作的初始状态开始,按顺序写命令、界面操作、输入条件和首次出现异常的位置。
把预期产物、状态或耗时与实际观察分开描述,不要只粘贴最后一行报错。
保留错误前后的必要上下文,删除密码、私钥、完整令牌、业务数据和不必要的个人路径。
先写环境,再写动作,最后写结果。这样接收方能按同一路径复现。
环境:macOS 完整版本 / 工具完整版本 / 节点
动作:从初始状态开始的复现步骤
期望:应该生成的产物或应该出现的状态
实际:报错、异常状态与出现频率
日志:已脱敏的必要片段
订单与账单协助需要能定位到具体记录。请提供控制台订单号、所选节点、机型、租用周期、当前显示状态和希望核对的项目。
写明订单号与发生问题的节点。如果同一团队有多笔订单,逐笔列出,不要只给团队名称或付款时间。
无需提交卡片完整信息、加密资产密钥或登录密码。只需说明采用哪一类支付方式,以及控制台显示的订单状态。
首次回复的目标是确认问题范围、缺失信息和下一步动作,不等同于所有问题都能在首次往来中完成处理。信息越完整,越容易直接进入复现或订单核对。
邮件主题会包含问题类型、节点与机型;控制台工单则保留订单上下文。接收方先核对是否具备开始处理所需的信息。
售前与合作邮件通常以 1 个工作日内首次回复为目标;已有订单的控制台工单通常以 4 个工作小时内首次回复为目标。复杂复现会在回复中说明下一项需要执行的检查。
不要为同一问题反复新建邮件或工单。沿原记录补充测试结果、脱敏日志和变更时间,才能保持诊断链路连续。
| 渠道 | 适合问题 | 应附信息 | 首次回复目标 |
|---|---|---|---|
| 支持邮箱 | 售前选型、环境迁移规划、CI/CD 接入、合作咨询 | 用途、节点、机型、周期、工具链和明确问题 | 1 个工作日内 |
| 控制台工单 | 现有订单、账单识别、运行中实例与连续技术排查 | 订单号、节点、发生时间、版本、复现步骤和脱敏日志 | 4 个工作小时内 |