posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
本节讲透类装饰器与 __set_name__ 的执行时机：类装饰器在元类 __init__ 之后运行，看到的是已经完成 __set_name__ 的类对象；__set_name__ 按定义顺序为每个描述符调用一次，且 3.12 起异常不再被包装成 RuntimeError。再用属性工厂与 __init_subclass__ 组合实测一个字段收集框架，并对照标准库 cached_property。
本节从 CPython 实现角度拆解 class 语句：它如何脱糖成 __build_class__ 与 type() 三参数调用，元类的 __prepare__、__new__、__init__ 与 __set_name__、__init_subclass__ 的精确执行顺序，元类冲突背后的 MRO 规则，以及何时该用 __init_subclass__ 替代元类。附实测时序与性能数据。
长连接上线后真正难的三件事：用 ping/pong 心跳及时剔除假死连接、用指数退避加抖动做健壮重连、用并发安全的 ConnectionManager 广播并给慢消费者做有界队列背压，每一步都附真实运行输出与取舍分析，并给出可对照的上线检查清单。
用一条只读 HTTP 流做服务端推送：真跑 text/event-stream 的 data/event/id 字段、StreamingResponse 流式输出与 Last-Event-ID 断线续传，并给出 SSE 与 WebSocket 的选型对照。
从轮询到双向长连接：用标准库真跑一遍 WebSocket 握手与帧格式，掌握 FastAPI 的 @app.websocket 与 WebSocketDisconnect，并设计带类型字段与版本协商的 JSON 消息信封，最后讲清文本 JSON 与二进制的取舍。
本节给 TaskAPI 的 Service 层做依赖隔离：先区分 dummy/stub/spy/fake/mock 五种测试替身，再说明 Go 如何用「接口即接缝」天然支持替换，然后手写一个记录调用并能注入错误的 fakeStore，用它验证标题校验、ID 回读与错误透传三条路径，并讨论为什么 Go 社区更推崇手写 fake 而非生成式 mock。
本节把 TaskAPI 的测试从「对不对」推进到「快不快、测没测到」：用 testing.B 写基准、用 Go 1.24 起的 b.Loop 取代手写 b.N 循环，读懂 -benchmem 的 ns/op 与 B/op，用 go test -cover 与 go tool cover 量出未覆盖分支，并说明为什么 100% 覆盖率不等于正确。
本节给 TaskAPI 的标题校验与内存存储补上第一批测试：从 Go 测试的三个约定讲起，搭出表驱动测试的骨架，用 t.Run 组织子测试，讲清 t.Error 与 t.Fatal 的取舍、t.Helper 如何修好报错行号，再用实测覆盖 MemStore 的命中与未命中两条路径，最后给出 go test 常用参数表。
对象能组装、能跑了，但关卡数值还写死在代码里。本节为 mini2d 引入组件字段描述符（类型与默认值），实现 serializeComponent / deserializeGameObject 双向管线，用 JSON 配置驱动《方块冲刺》的敌人实例化；末节给出 Cocos Creator 3.8 的 _decorator、Prefab 与 JsonAsset 完整对照。
组件挂上去之后还什么都不会发生，本节把 mini2d 的组件系统接进主循环，定义 onLoad/onEnable/start/update/lateUpdate/onDisable/onDestroy 七个回调的固定顺序，用状态位保证只调用一次，讲清启用状态如何向子节点传播，并实现一套带订阅与退订的事件总线，末节给出 Cocos Creator 3.8 的生命周期与 EventTarget 对照。
前五章的渲染、时间、输入能力还散在几个类里，要让《方块冲刺》的玩家、敌人、金币各自动起来，还缺一层组织方式。本节从深继承的三个硬伤讲起，亲手为 mini2d 写出 GameObject 持有 Component 的实体-组件结构，实现 addComponent/getComponent 与组件注册表，最后给出 Cocos Creator 3.8 的 Component 对照。
本节用 Pointer Events 统一鼠标与触摸，讲清 client、canvas、device、screen、world 五种坐标空间的换算：getBoundingClientRect 校正画布偏移、DPR 对齐位图与 CSS 尺寸、相机逆矩阵把屏幕坐标还原成世界坐标，并用 vitest 断言往返一致，最后对照 Cocos 3.8 的 input 与 screenToWorld。
本节从浏览器原生 fillRect 起步，讲清 Canvas2D 的 y 轴向下坐标系这个新手第一坑；随后手写 2×3 仿射矩阵，用纯 TypeScript 实现平移、旋转、缩放与矩阵乘法，解释变换顺序为何不可交换，并深入 ctx.save/restore 的状态栈；最后把变换接进 mini2d 的节点渲染，并给出 Cocos Creator 3.8 中 Node 变换的对照写法。
本节只证明固定脚本在完整工具轮次后保存、恢复并继续运行。恢复时校验版本、脚本指纹、游标和工具结果配对。模型游标属于 FakeModel，不能推广为真实供应商游标。真实模型即使看到完整历史，也可能再请求相同工具；已发生副作用不能靠历史完整性保证不重做。
history 焊在 Agent 实例里，一个 Agent 只服务一段对话，也无法把对话存下来或跨进程搬走。本节引入 Session 状态对象，持有 messages、session_id、metadata、created_at，提供 append/snapshot/restore，把 history 剥出 Agent。用假模型跑两轮对话，验证 history 累积与 session_id 稳定。
本节建立工具、步骤、文本与终态的事件契约，供日志和 HTTP 层复用。修订版复用第三章循环，不另写一套丢失保护的 Agent.stream。这个生成器在第一次拉取时先执行完整同步循环，再回放队列。因此消费侧 break 只停止回放，不能取消已经完成的工具，也不对上游模型形成背压；模型首字延迟不会降低。
大模型训练离不开多卡分布式，本文系统讲解 DDP 数据并行原理与 AllReduce、混合精度训练（FP16/BF16）、梯度累积与梯度裁剪、ZeRO 分片（ZeRO-1/2/3）、FSDP 全分片数据并行、张量并行与流水线并行、checkpoint 与断点续训、以及分布式训练排错（NCCL 超时/OOM/收敛异常）的完整工程方法论。
深入解析数据管道编排（Pipeline Orchestration）：编排与调度的区别、Airflow/Dagster/Prefect 三大框架对比与选型、DAG 设计模式（依赖管理/幂等/重试/超时）、动态任务与数据感知调度、编排中的资源与并发控制、失败重试与告警、可观测性与可测试性，以及端到端数据编排平台的生产架构。
深入 MCP 协议底层：JSON-RPC 2.0 在 MCP 中的落地、请求/响应/通知三类消息、id 语义与错误码规范、消息帧与批量、MCP 方法命名空间（initialize/tools/call/resources/read）、协议能力协商（protocolVersion/capabilities）、服务器与客户端握手流程、扩展协议边界与版本演进。
系统讲解 Kafka 消费组与再平衡机制：消费组模型与心跳协议、Eager 与 CooperativeSticky 两代再平衡协议、JoinGroup/SyncGroup/Heartbeat 完整流程、四种分区分配策略（Range/RoundRobin/Sticky/CooperativeSticky）、再平衡频繁的根因排查（max.poll.interval/session.timeout/处理耗时）、静态成员与滚动重启、以及位移提交与再平衡配合的稳定性工程实践