《互联网产品的客户端架构·规模化与架构演进》6.1 Monorepo 与包边界
Monorepo 的难点不是把代码放进一个仓库,而是让包边界可执行。本节把包声明、依赖、公开与内部可见性、子路径导出写成一张依赖图,用拓扑排序与环检测给出构建顺序,再用纯函数判断跨包引用是否合法,并复盘一次深路径引用绕过评审的事故。边界一旦只写在文档里,就会在第一次赶工期时失效。
category
Monorepo 的难点不是把代码放进一个仓库,而是让包边界可执行。本节把包声明、依赖、公开与内部可见性、子路径导出写成一张依赖图,用拓扑排序与环检测给出构建顺序,再用纯函数判断跨包引用是否合法,并复盘一次深路径引用绕过评审的事故。边界一旦只写在文档里,就会在第一次赶工期时失效。
一键领取看似只是循环调用单封领取,真正的问题是部分成功如何表达、失败要不要回滚、补偿怎样避免重复,以及红点计数怎样和邮件列表保持一致。《裂隙战场》的赛季结算、《群岛纪元》的全服补偿、《泡泡工坊》的日常奖励,都需要同一套批量语义。本节给出批量领取结果模型、补偿幂等键与审计日志,以及由同一份列表派生的红点聚合。
刘海屏毁掉的第一版 HUD,往往不是按钮太小,而是顶部状态栏压住了暂停键。本节把逻辑分辨率、cover 缩放、安全区映射与九宫格锚点写成无头布局模型,用四种屏幕形状验证矩形不越界、触控目标不低于 44pt,并明确它只是布局计算,不是渲染验证。
演练最容易通过的部分是注入,最容易造假的部分是恢复。若没有恢复断言与未通过项记录,「演练成功」只是一句口号。本节把演练场景、注入步骤、恢复断言与报告判定写成可运行的 TypeScript 模型,并说明 incomplete 与 fail 的区别、中止条件与报告评审判据。
用户在评论里写下「忽略前面的指令」,检索文档里又藏着角色伪造。「回声」的这次事故说明,提示注入不是句子黑名单问题,而是信任边界问题。本篇把系统指令、用户内容、检索内容与工具输出分成四层,给出可断言的信号评分、隔离策略和工具参数二次校验,并说明为什么正则只能是信号而不能是唯一防线。
从 arch-lab 订单系统一次按实例比例审批、却在网络层故障中放大到全链路的事故切入,区分进程、网络、依赖与区域四层注入各能证明什么,给出按拓扑计算真实爆炸半径、检查关键状态转换损失并在超预算时拒绝执行的 Go 实现与表驱动测试,全部代码在本机跑通。
邮件正文可以永久可读,附件却是有归属、有期限的资产。《裂隙战场》的赛季奖励、《群岛纪元》的联盟补给、《泡泡工坊》的限时礼包,都要回答领取是否原子、过期后归谁、背包满时怎么办。本节给出附件状态机、过期扫描与宽限期、三种结算策略,并附可运行的领取幂等与流拍结算代码。
开关越多,事故时越容易互相打架:用户级、实验级、端级与全局规则同时命中时,必须有一个确定的赢家。本节把开关层级、冲突检测、降级动作与兜底内容写成可测试的 TypeScript 模块,并给出优先级判据、常见反例与发布前的审计清单,让每一次关闭都有据可查。
关掉涌现不该是一次性动作,而是四级台阶:限流、脚本接管、关功能。本节用事件率、关系漂移、举报率三个独立信号决定档位,两个信号才升级,30 分钟安静期才允许逐级恢复,并说明为什么降级要一次一级、以及定期演练拉闸比写好预案更重要,最后把拉闸权限与演练纳入同一套机制。
涌现的收益是玩家看到设计者没写过的行为,风险是这些行为无法解释、无法复现、无法撤销。本节把失控收敛为三类:事件率过高、事件率过低、单派系占比过高,给出 3 倍、0.2 倍与 80% 三条判据与 5 分钟滚动窗口,并说明健康分只能做看板,不能替代判据。
多 Agent 的复杂度不是随数量线性增长,而是随连接数增长。本节给出四条最小规则:本地感知、错峰决策、消息预算、提案不直写状态,并用方舟 8 个常驻 NPC、3 个派系、1 Hz 与每 30 tick 一次的设定,说明规则怎么写成可运行判定、又怎么保持结果可复现。
付费公平的冲突只有三类可验证的泄漏:多出动作、更远射程、更低消耗。本节把免费与付费玩家的动作集合逐项对比写成可执行判定,说明为什么外观付费安全、便利付费是灰色地带,并给出排位门槛、标签披露、用胜率差和投诉率验证公平性的实验口径,以及边界争议的拍板机制。
支付回调超时后,Cancel 可能先于 Try 到达,造成空回滚;迟到的 Try 又可能永久占住库存,形成悬挂。本文用订单预占场景实现带墓碑与状态机的 TCC,并用同库本地消息表让 TRYING、CONFIRMED、CANCELLED 对下游可见,给出空回滚、悬挂、幂等与中间态查询的可运行测试。
Agent 能力可以卖,但不能什么都卖。本节把变现方式分成卖能力、卖内容、卖陪伴三类,给出四条硬规则:不卖影响排位的能力、不卖锁住关系进度的陪伴、不把剧透做成付费墙、成本未知不许上线,并给出每产品最多三个付费点的限制与按毛利率倒推的价格下限。
Agent 成本要能三层互推:单次调用 0.0048 元、每玩家每天、每月总额,任何一层单独汇报都会掩盖失控。本节用消消与方舟的实际调用量算出 34,560 元与 194,400 元的月成本,说明人均 0.0432 元与 0.7776 元的差别,并给出调用构成、缓存命中与预警线的算法。
订单 Saga 失败时,“把前面的步骤反向调用一遍”看似简单,实际补偿是新业务动作,可能失败、可能不幂等,也挡不住并发请求读到中间态。本文用库存预留、支付扣款与发券场景,给出带语义锁、逆序补偿和不可补偿步骤校验的可运行 Go 实现,并列出把不可逆动作前移或改为可重试的判据。
举报处理的核心不是回复玩家,而是定级、回滚范围与证据链三件事。本节按内容类别与可见范围给出四级定级,配 1 小时到 24 小时的首响时限,说明一二级按模板整体隔离、三级按批次、四级单条撤回的差别,并给出证据链四要素与误报、恶意举报的处理边界。
订单与库存、支付分库后,两阶段提交常被当成“分布式事务的标准答案”。本文用一次下单说明它真正保证的是原子提交而不是不阻塞,给出参与者日志、协调者决策日志与崩溃恢复的可运行 Go 实现,复现 in-doubt 窗口,并用判据表比较 2PC、3PC 与补偿型方案。
端上故障很少只坏一个按钮:一个共享依赖失效,可能同时带走首页、下单与通知。本节把依赖图、故障域、单点与爆炸半径写成可运行的 TypeScript 模型,用受影响功能比例量化一次故障的波及面,并给出评审判据与常见反例,让「影响面多大」从口头争论变成可计算的数字。
从「回声」把合作方租户私信送进主站模型的事故出发,拆解密钥分级与轮换、租户隔离、出域字段白名单和区域路由四道边界,给出可运行的 TypeScript 实现与 11 条测试,说明每次放行为什么都要留下可追溯的决策记录,再复盘一次跨租户调用为什么会同时穿过四道默认值。