《互联网产品的客户端架构·端形态与体验基础》9.2 产物分析与体积预算
把构建产物的体积拆成产物、模块与包装开销三个口径,给出按模块归因、按预算阈值判定 pass/warn/fail 的 TypeScript 检查器与八组测试,讨论重复模块、贡献榜和超限后的处理顺序,并说明为什么抬高预算通常是最后而不是最先做的动作。
tag
把构建产物的体积拆成产物、模块与包装开销三个口径,给出按模块归因、按预算阈值判定 pass/warn/fail 的 TypeScript 检查器与八组测试,讨论重复模块、贡献榜和超限后的处理顺序,并说明为什么抬高预算通常是最后而不是最先做的动作。
《AI Agent 开发入门》全 61 篇,以从零手写的 Agent 运行时 minagent 为主线,从消息协议与可编程假模型起步,经工具调用、推理模式、上下文工程、记忆与检索、规划与编排、多 Agent 协作,讲到错误重试、可观测性、评测与测试、服务化交付。示例以 Python 3.14 在本机实跑,默认走零凭据、零成本的假模型路径,本页给出全书分章目录。
从「回声」首包翻倍的发布事故出发,把模块依赖图、静态闭包、懒加载边界与共享模块提升写成可运行的 TypeScript 分包算法,给出按路由与按交互分包的判定表、六组真实测试输出,并说明首包大小为什么必须和任务路径一起判断,而不能只看一个总数。
把用户身份与服务身份分开建模:用 HMAC 自签令牌区分 subject 与 actor,把订单归属校验写成纯函数策略,并用九个越权用例覆盖跨客户读取、服务无 actor、缺 scope、未知动作与资源类型,附 go test 实测输出与内部调用传递规则。
以 arch-lab 的最小治理流程为例,只保留 ADR、例外、季度复审和三个指标四个动作,并把规则写成可运行的 govcheck 校验器;表驱动测试覆盖 ADR 不完整、复审过期、替代失效、缺适应度测试、例外超期与指标越线,附真实运行输出。
以 arch-lab 的决策权矩阵为例,把谁决策、谁执行、谁验收写成 D/E/V/C 四类角色,并给出平台团队与业务团队的可验收契约字段;配套 decision 校验器用纯函数检查决策越权、缺咨询、自审、缺验收与破坏性变更通知,附真实测试输出。
以 arch-lab 的五团队十一模块映射为例,说明康威定律如何同时解释和塑造包边界;给出有向沟通通道模型与可运行的 orgmap 校验器,把无主模块、一人跨域、通道方向与依赖方向冲突变成 go test 能抓到的违规,并附本机真实运行输出。
《Cocos 游戏联机实战》全 30 篇,只写客户端侧联机:从网络分层与权威边界、协议选型与序列化、时钟与抖动起步,经确定性模拟与定点数、输入广播与帧对齐、回滚追帧、快照与增量同步、AOI 与带宽压缩、客户端预测与服务器和解、插值与外推,到断线重连、超时幂等、弱网降级、匹配与房间生命周期、观战回放、弱网模拟与机器人压测、客户端权威边界与防篡改,最后收在联机表现与双人竞速综合项目。服务端只给接口约定。本页给出全书分章目录。
可访问性不是上线前的一次性检查,而是可以被数据描述的交互边界。本节把「回声」的焦点顺序、键盘可达、角色与标签、触摸目标尺寸写成纯数据规则,用 TypeScript 实现不依赖 DOM 的检查器,并用真实测试说明正 tabIndex、图标按钮缺名称、小触摸目标分别怎样被拦住。
受控与非受控不是二选一,而是同一条状态转移链上的三种模式。本节以「回声」搜索框为例,用纯函数实现 value 接管、defaultValue 作为种子、受控移除后的回退,以及状态提升的四个判据,并用真实测试说明切换模式时哪些值会保留、哪些警告必须记录。
架构约束失效往往不是没人知道,而是没人执行。本篇把 arch-lab 的包边界写成 tools/fitfunc:用 go/parser 扫描依赖、类型命名、契约测试存在性和文件预算,违规时退出码非零;再给出干净树与故意改坏的树两次真实运行输出,并说明它与 deplint、依赖测试的分工。
组件契约不是一份文档,而是可以被校验的数据结构:props、事件、插槽、状态与可访问性各有明确边界。本节把「回声」搜索框的契约写成 TypeScript 结构,给出契约自检与调用校验两套规则,并用真实测试输出说明重复属性、必填默认值、受控缺处理器等问题如何在编码前被拦住。
从「回声」在地铁里发出的一条消息出发,把离线写入拆成落盘队列、严格重放、幂等键与冲突合并四步,给出可运行的 TypeScript 队列与九个真实测试,逐条说明 last-write-wins 的边界、字段级合并的判据,并复盘一次超时重试造成重复下单的事故。
双写最危险的不是写两次,而是两次写的顺序、失败语义和退出条件都没有定义。本篇在 arch-lab 用 Branch 抽象收窄新旧实现的契约,给出主写→意图→影子→确认的协调器、归一化后的双读比对与差异分类,并用可执行的退出判据说明什么时候才能停止双写,附真实运行输出。
把端上缓存拆成键设计、新鲜窗口、可陈旧窗口与离线回退四件事,给出「回声」四类资源的策略表和一个可运行的 TypeScript 读缓存实现,用九个不依赖真实时钟的测试验证 stale-while-revalidate、单飞刷新、持久化与淘汰,并复盘一次把订单状态缓存过久的事故。
《Go 语言编程实战》全 55 篇,以多租户任务协作平台 TaskHub 为主线,从单仓多模块与依赖治理、分层配置与密钥管理,讲到 REST 契约、JWT 与 RBAC 多租户隔离、连接池与事务边界、缓存与消息、限流熔断与 goroutine 泄漏,再到结构化日志、指标与链路追踪、分层测试与性能工程,最后覆盖对象存储、容器化、Kubernetes 部署、发布运维与安全加固。示例基于 Go 1.27 在本机实跑。
《Python编程入门》全 61 篇,是一套面向零基础的 Python 3 完整教材:从语言诞生史与执行模型讲起,依次覆盖开发环境、数据类型、函数与作用域、模块与包、面向对象、异常与资源管理、迭代器与装饰器、类型注解,再到标准库精要、并发与异步、测试与打包、Web 开发与数据处理,最后用一个完整项目收尾。本页给出全书分章目录。
《Go 语言编程入门》全 61 篇,以 TaskAPI 一个贯穿全书的项目为主线,从安装工具链、语言基础、结构体与接口、错误处理、包与模块、测试与泛型,讲到 goroutine 与 channel、同步与竞态、context 生命周期,再到用 net/http 搭服务、数据持久化、配置分层、可观测性、交叉编译与容器化交付。示例沿用 Go 1.27 主线,本页列出全书分章目录;代码与实验的复现范围以分节说明为准。
从「回声」发现页首屏同时发出的十七个请求出发,把并发上限、优先级、取消、总预算与指数退避放进同一张调度表,给出可运行的 TypeScript 调度器与九个注入手动时钟的确定性测试,说明去重键、超时竞速与协作式取消的边界,并复盘一次无上限重试把弱网彻底拖垮的事故。
《Python编程实战》全 55 篇,是一套面向已有 Python 基础的工程实战教材:从 uv/ruff/pyright 脚手架与可复现构建讲起,依次覆盖配置与日志、测试体系、Web 分层、数据访问、API 契约、缓存队列、认证授权、实时通信、数据处理、爬虫采集、办公自动化、CLI 与桌面、容器化部署、性能容量、可观测性运维,最后用一个生产级服务的完整交付收尾。本页给出全书分章目录。