Lesson 07 · 凭据与外部服务

钥匙链：登录如何点亮 SVN / Jenkins / COS

这个项目最反直觉的一条链路。不懂它，你会把「没登录」误判成「代码有 bug」。

为什么排在这个位置

这条链路已经在架构图 FIG.03 里画出来了，课 01 也提过一次。这一课把它讲透：每一段的代码在哪、失败时的表现是什么、怎么验证。

排在发布课之前，因为发布出的绝大多数问题根源都在这条链上，而不在发布逻辑本身。

前置

• 课 02 —— pcode 怎么参与请求
• 课 04 —— GameEvn store 与 WithOut 模式
• 依赖清单 —— 功能依赖那张传播图

会讲什么

1. 为什么 .env 里只有 11 个键。源码用到约 50 个 VITE_*，差额从哪来
2. initEnv() 逐行读。src/utils/extend/envOption.ts:8 —— userInfo.game 的每个字段被写到哪个键
3. 渠道名替换那一段。replaceChannelInUrls() 把 Jenkins job 名里的 channel 换成实际渠道 —— 这是「job 找不到」类问题的高发点
4. 落盘与恢复。GameEvn.ts:44-49 的深度 watch、刷新后 init() 从 localStorage 读回，以及凭据明文存储的风险
5. 四个消费端各自怎么取。axios 的 getPcode()、SVN 的 SvnOption()、Jenkins 的 initConfig()、COS 的 COS_Handler.init()
6. 选服如何改写 pcode。components/confirmServer/ 与各页面里那段「按版本拼 _dev 后缀」的重复代码
7. 静默失败的三种形态。可选链吞掉调用、try/catch 返回 false、请求带空 pcode 被服务端拒 —— 各自的排查手法
8. 三档评级。服务端下发配置（✅ 思路对）、凭据明文进 localStorage（❌）、静默失败（❌）、每个页面各自重复拼 pcode（⚠️ 应该收敛成一个函数）

学完之后你应该能

• 任何「点了没反应」的外部操作，能在一分钟内判定是不是凭据问题
• 能说清楚这个工具的凭据安全风险，以及规范做法是什么
• 知道选服这个动作到底改了什么，为什么它影响那么大
• 能给新的外部服务接入照着同一套模式，而不是又发明一遍

在正文出来之前，你可以先做这些

• 登录后在控制台敲 JSON.parse(localStorage.getItem("GameENV"))，把打出来的键和 envOption.ts 里的赋值逐条对上
• 做个对照实验：在控制台 localStorage.removeItem("GameENV") 然后刷新，观察哪些功能开始静默失效 —— 这是理解依赖传播最快的方式（做完重新登录即可恢复）
• 把 src/utils/extend/envOption.ts 整个读一遍，它只有 80 行左右
• 把「哪些 SVN / Jenkins / COS 环境可以安全操作」这个问题问出去。这是本课程唯一一条「优先级高于任何学习」的行动项