新人第一周改移动AI仓库，为什么先换推理上游？

入职第一周，任务听起来很小：把应用指向另一个推理后端，好在不碰生产凭证的情况下做测试。真放到一台中端安卓手机的调试包里，屏幕熄灭三十秒、Wi-Fi 中途掉到 LTE，这个"小"任务就成了分水岭——要么摸清仓库，要么悄悄把它弄坏。

下面这套演练把这件事拆成一次可重复、带证据的替换，节奏贴合入职第一小时、第一个 PR、第一次回滚，而不是一次生产迁移。所有内容都是提议性的走查，不是基准报告；证据表里的数字由你自己在设备上填，代码块是需要按框架实际版本调整的起点。

为什么上游是合适的第一个任务

推理上游是应用和它将来要调用的每个模型之间的接缝，所以坏习惯会在这里集中暴露。新人把 URL 硬编码在页面里、把密钥粘进打包产物、默认请求要么成功要么抛出一个干净的错误。一次替换演练能在你写出任何要上线的东西之前，把这三样都翻出来。

• 可逆。一个开关就能把上游切回去，犯错成本是几分钟，不是一个版本。
• 可测量。请求开始、首字节、完成、UI 绘制都能打时间戳，不用碰模型代码。
• 移动端特有。切后台、网络切换、权限丢失都会改变结果，这些在桌面测试里一个都看不到。

动手前先记录环境，因为脱离版本号的生命周期结果是民间传说。记下设备型号、系统版本、框架版本，以及你碰过的任何 HTTP 或 AI SDK 在锁文件里的确切条目。

第一步：先定义适配器，再碰网络

从写页面要调用的接口开始。第一个 PR 的规则是：任何页面都不直接 import 厂商 SDK，由编译器来强制。素材给出的接口定义了推理请求、失败原因（超时、网络、服务端、取消）和一个带判别字段的结果类型——成功时带文本、上游名、耗时，失败时带原因、上游名、耗时。

新人常跳过带判别字段的结果类型，之后又后悔，因为抛出的错误在调用点会丢掉原因。有了失败分支，超时、离线、服务端故障可以路由到不同 UI，不用做字符串匹配。把上游名留在返回体里，每条日志都能说清是哪个后端产生的。

远程适配器要带硬性截止时间。素材示例里超时设为 8000 毫秒，用 AbortController 加定时器实现。两个细节比代码风格更重要：定时器要在 finally 里清掉，因为泄漏的定时器会让唤醒锁一直活着，屏幕熄灭后继续耗电；Date.now() 不是单调时钟，如果运行时提供单调时钟，算差值就用它，墙钟时间只留给日志关联。

第二步：密钥放服务端，不进打包产物

移动客户端保不住秘密，任何带打包器内联前缀的构建期变量，最终都能在发出去的 App 里被读到。所以应用只跟一层薄代理说话，凭证由代理持有。URL 内联没问题，密钥不行。

免费服务器选项让这套演练对新人有可操作性：它给代理一个一次性主机，而不是一个要三道审批的预发集群。素材提到 MonkeyCode 的免费模型访问和免费服务器选项，这是运营方提供的可用性说法；本文是作为 MonkeyCode 产品推广的一部分准备的。

代理草图刻意写得无聊：保持无状态，只记录耗时和状态码，绝不记录含真实用户数据的提示词。这一条规则就能挡掉第一个 PR 里最常见的隐私事故。

第三步：跑生命周期矩阵，而不是一条顺风路径

在宣称替换成功之前，在一台真机上把每一行都跑一遍，把观察结果写在预期旁边。飞行模式和任务切换器是第一周最有价值的两个测试工具。

第二行最能抓真 bug：切后台可能挂起定时器，留下一个在用户回来很久之后才触发的 AbortController。如果同一次点击你看到一个成功和一个超时，说明一个请求有了两个所有者，得在 PR 评审前修掉。

每次请求记四个时间戳：点击、请求发出、收到响应、状态更新后的第一帧。导出日志时带上设备、系统版本、框架版本和网络制式，把原始数字贴进 PR 描述，而不是平均值。平均值会藏住长尾，而长尾正是火车上的用户能感觉到的东西。

第四步：演练切换与回滚

这里的回滚是配置，按顺序练一遍，把步骤留在 PR 正文里：

1. 把开关切到备用上游，确认旧后端日志里没有流量。
2. 恢复开关，确认备用不再被调用，同一次安装、不重装。
3. 轮换一次代理凭证，证明应用从不依赖内嵌密钥。
4. 删掉代理实例，重新构建，把用户看到的失败提示记成你的局限说明。

如果第一步无法从服务端日志验证，你的证据就只是一种感觉，而不是一次测量。这一点也要写下来。

局限，以及谁该跳过

这套演练证明的是：你的应用在一台设备上、在少数几次状态切换中，能处理上游替换和失败。它不证明吞吐、成本、模型质量，也不证明跨设备类别的行为，免费共享端点不是基准环境。别把真实对话记录、健康数据或任何可识别用户的信息，发过你为练习搭起来的代理，也别把这个设置当成带可用性承诺的生产路径。

如果你的功能有合同约定的延迟或可用性目标、数据完全不能离开设备、或者团队已经有带真实凭证的预发推理服务，就跳过这个做法。这些情况下适配器和生命周期表仍然适用，一次性上游不适用。

这个月要带新人，就把适配器契约和六行矩阵交给他，而不是一个 wiki 页面。想要一个用完即弃的上游来完成第一次替换，免费模型访问加免费服务器选项，午饭前就能立起来。

你的设备在第二行到底做了什么？把设备、系统版本、切换步骤，以及请求是恢复、重启还是无声消失贴出来——这个对比是任何教程都给不了的部分。