posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
从 spring.factories 到 AutoConfiguration.imports，逐层拆开 Spring Boot 4 自动配置类的发现、过滤与排序：AutoConfigurationSorter 如何在 @AutoConfigureBefore/@AutoConfigureAfter 与 @AutoConfigureOrder 之上做拓扑排序，以及为何还要用全限定名做兜底。
讲清 @Async 的代理前提与自调用失效，说明默认 SimpleAsyncTaskExecutor 为何不能上生产，给出自定义 ThreadPoolTaskExecutor、TaskDecorator 上下文传递、有界队列与拒绝策略、CompletableFuture 异常的落地写法，并分析虚拟线程对线程池选型的影响。
图书、作者、分类之间天然存在关联。本节用图书服务演示 @OneToOne、@OneToMany、@ManyToOne、@ManyToMany 四种映射，讲清 mappedBy 与关系维护方、@JoinColumn 指定外键、级联与 orphanRemoval 的取舍，并用 show-sql 直观演示 N+1 问题。
本节从字符串拼接式的代码生成升级到 AST 变换：用 compile() 的三种模式、ast.NodeTransformer 与 fix_missing_locations 把 assert 改写成显式检查，并注入函数计时。实测改写前后的 dis 字节码差异，以及为什么改写版能在 python -O 下继续生效，而原始 assert 会被剥离。
本节讲透类装饰器与 __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 只停止回放，不能取消已经完成的工具，也不对上游模型形成背压；模型首字延迟不会降低。