《后端架构设计·架构基础与边界》12.3 质量属性场景与架构风险清单
卷一收口最后一步,把性能、可用性、安全与可维护性写成刺激-响应-度量的可测场景,再把未验证项整理成带概率、影响、owner 与可执行关闭条件的风险台账。本篇给出 Go 数据结构、属性覆盖与逾期校验测试,并明确所有阈值只是口径,不是压测结果。
tag
卷一收口最后一步,把性能、可用性、安全与可维护性写成刺激-响应-度量的可测场景,再把未验证项整理成带概率、影响、owner 与可执行关闭条件的风险台账。本篇给出 Go 数据结构、属性覆盖与逾期校验测试,并明确所有阈值只是口径,不是压测结果。
性能指标最容易在口径上失焦:同一个 LCP,均值、p75 与 p95 会讲出不同故事。本节把指标定义、采样边界、窗口聚合与主口径选择写进一个可运行的 TypeScript 指标字典,说明何时用分位、何时看均值,并用真实测试输出验证聚合结果与取舍。
埋点失败后直接丢弃,会让故障现场永远缺一块。本节实现一个带 TTL、容量上限、优先级淘汰与跨批次去重的补报队列,说明 p0 事件如何避免被噪声挤掉,以及补报失败后重试、稍后、返回三种用户可恢复操作的分工,最后复盘一次埋点风暴的全过程与容量参数。
卷一收口第二步,把 arch-lab 的模块清单、依赖方向、部署单元与数据 owner 冻成一份带指纹的快照。本篇给出可机器读取的 Go 结构、三者闭合校验器和黄金指纹测试,并说明唯一运行时单元、单库数据所有权与 PostgreSQL L3 核对步骤。
弱网下只有成功与失败两态是不够的,超时、失败、半成功需要不同兜底。本节给出缓存年龄、关键字段缺失与重试预算共同参与的决策函数,解释为什么超时先看缓存、失败先重试,并用注入时钟验证滑动窗口预算与降级内容展示,说明缓存写回与手动重试的风险边界。
白屏往往不是某个组件写错,而是错误没有被分类、边界没有被放置。本节把端上错误分成可恢复、可降级、致命三类,给出不依赖 DOM 的分类器与嵌套边界模型,用注入时钟验证恢复预算与升级路径,并复盘一次局部兜底反而扩大故障的白屏事故,最后整理成可执行的评审清单。
卷一收口的第一步,是把 arch-lab 的业务需求、技术与组织约束、延迟/可用性/容量/安全指标压成一份可机器校验的基线。本篇给出三种状态口径、一张标清目标与实测的 NFR 表,以及能拒收缺失 owner、目标与实测混用的 Go 校验器和真实基准输出。
以 arch-lab 的状态清单为例,区分事实来源、派生状态、缓存与临时状态,说明有状态服务为什么仍然可以部署;给出可运行的 stateinv 校验器,检查无主状态、来源无备份或恢复、派生状态无重建路径、本地盘持久化和破坏性迁移,并附本机真实 go test 输出。
以 arch-lab 的配置加载器为例,说明默认值、配置文件、环境变量与密钥的分层优先级,为什么未知键和危险默认值必须在启动时失败;给出可运行的 config 包与失败测试,覆盖缺失、非法、密钥入文件、生产环境误用假支付和沙箱地址,并附本机真实 go test 输出。
《游戏引擎实现原理》卷四《工程与实战》全 30 篇,是四卷本的收官卷:把前三卷写出的 helio 引擎与《微光岛》真正交付出去。从构建与资产管线起步——模块图与拓扑序、tree-shaking 判据、纹理压缩与 PSNR、分包与首包体;再到引擎自己的测试——NullRHI 与假对象、headless 黄金图像逐像素比对、确定性回放与状态哈希;然后是性能工程——帧时间分位数、GC 与分配追踪、GPU 计时与优化闭环;接着是跨端与降级、模块边界与特性裁剪、插件与版本稳定性、调试绘制与控制台与遥测;最后把《微光岛》做完——玩法装配与存档、关卡与内容管线、打磨与表现、性能预算达标、构建部署与上线清单,并以跨引擎对照与全书收官收束。每一节都写代码,每一节的代码都在本机真跑过,跑出来的是真实字节、真实耗时与真实像素。
以 arch-lab 订单系统的七个部署单元为例,说明哪些模块必须同进程、哪些可以独立发布,单点与故障域如何登记;给出可运行的 deploymap 校验器,把未声明单点、无超时或无降级的跨单元强依赖、故障域重叠变成 go test 能抓住的违规,并用同步闭包计算一次发布的影响面。
渲染模式不是一次选型就结束,而是持续核对前提的决策;本节给出退出判定函数、迁移成本矩阵与一次完整决策记录,用九组测试验证 SSR 何时退回 CSR、CSR 何时升级 SSG,并说明为什么没有触发条件时也要留下复核日期,判定不追求先进模式,只追问前提是否仍然成立。
《MMO 服务器开发》卷三《分布式与跨服》全 34 篇,把卷二那个能单服可玩的 aegis 推成一群机器上的集群:从分区分服与集群拓扑、什么时候该拆什么时候不该,到服务注册与健康检查、Leader 选举与服务所有权、etcd / NATS / Consul 三套中间件的本机真跑选型、RPC 超时预算与重试熔断背压、gRPC-Go 与 gRPC-Java 双栈对照、网关集群与会话粘性、连接排空、实例调度器与分配 Broker、崩溃恢复与状态重建、跨服报名匹配与跨服聊天路由、跨服资产归属与结算、雪花算法与号段模式、时钟回拨容错、Redis 缓存失效与击穿防护、读写分离与读模型、角色数据模型与脏写防护、分片与再均衡、跨服务事务补偿、对账与数据修复工单、事件溯源与审计,最后把跨服战场端到端跑通并给出集群承载数字。
《AI Agent 高级编程》全 34 篇,三卷本的收官卷:把卷二的研究助理服务 ResearchCopilot 改用主流框架重写一遍,再补齐生产化短板。从框架分层与统一抽象,经 PydanticAI、Claude Agent SDK、OpenAI Agents SDK 与 smolagents 的重写与对照,讲到三家框架的源码剖析、持久化执行与确定性重放、计算机使用与浏览器 Agent、A2A 跨 Agent 协议(含 TS 落点)、Agent 强化学习,最后做统一可观测、成本延迟治理、安全纵深与平台化收官。示例以 Python 3.14 与 Node 26 在本机实跑,默认走假模型,本页给出全书分章目录。
服务端与客户端首帧不一致通常来自时钟、随机数、本地状态与权限四个来源,本节用字段级帧对比把它们分开,给出可运行的 TypeScript 差异检测器与八组测试,检测器不依赖浏览器,只在进程内比较两棵字段树并标出可延后项,所有结论都由测试固定,方便照搬到自己的组件树。
把支付回调当作不可信外部输入:用 HMAC 覆盖 provider、kid、时间戳、nonce 与 body 哈希,按密钥有效期选择 kid,验签后查重放并核对订单金额与币种;附密钥轮换重叠窗、四类失败路径的测试与真实 go test 输出。
把 CSR、SSR、SSG 与流式放回成本与页面类型的约束里,用七项页面特征推导渲染模式,给出可运行的 TypeScript 选择器与七组测试,逐条说明每种模式被拒绝的理由,并复盘一次把商品详情页从 SSR 改成 SSG 的收益与回退边界,所有结论都用本机测试固定。
《AI Agent 工程实战》全 55 篇,把卷一手写的 Agent 引擎 minagent 装成一个能给别人用的研究助理服务 ResearchCopilot:从需求与架构、配置密钥、REST 与 SSE 接口、认证与租户隔离,经 Postgres 状态持久化、缓存限流、异步队列与并发控制,讲到 MCP 工具接入、记忆服务、评测质量门、可观测与 SLO、成本治理、安全护栏、容器部署与发布。示例以 Python 3.14 与 Node 26 在本机实跑,本页给出全书分章目录。
从内容哈希、缓存头语义、版本兼容窗口和旧资源退役四条线,给出可运行的 TypeScript 缓存决策函数与八组测试,解释 immutable 的前提、HTML 与 Service Worker 为什么必须回源校验,以及灰度窗口内旧哈希文件应该保留多久。
从订单 API 的 JSON 边界讲到业务边界:64 KiB 体积上限、未知字段拒绝、单对象校验、SKU/数量/金额/总额范围与重复项拒绝,再把日志字段分为 public/internal/pii/payment/secret 五类做脱敏,附表驱动测试与真实 go test 输出。