posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
本节讲联机协议怎么选：对比 WebSocket 上的 JSON、MessagePack 二进制与自定义紧凑二进制的取舍，给出用 const 对象加 as const 定义消息类型（禁用 enum）的方式，用 DataView 实现读写定点数、变长整数与字符串的 L1 编解码器并用 vitest 做往返断言，附《方块冲刺》的 INPUT / SNAPSHOT / ROOM_STATE 消息格式表。
本节建立客户端侧联机的心智模型：讲清「权威」为什么默认在服务端、客户端只能决定输入与表现而不能决定胜负与伤害，对比 C/S、P2P、C/S 中继、主机制四种拓扑并说明《方块冲刺》双人竞速的选择，给出传输/会话/同步/表现四层与 assets/scripts/net/ 目录的对应，并写出 Transport 接口与可注入延迟丢包的假传输层完整实现。
命令不能直接改文档的内部结构，否则脏标记与重绘会被绕过。本节把命令接到第 8 章的文档模型上：文档是唯一编辑目标，命令经它落值、打脏标记、发变更通知；SetProperty 与 AddNode 两条命令演示属性与结构两种脏标，并附本机真跑结果。
一次「多选后一起改属性」必须整体撤销，一次拖拽滑条刷出的几十条微编辑却该合并成一步。本节实现带原子性的事务（任一子命令抛错就补偿回滚）、按时间窗合并的连续编辑判据，并讨论撤销栈的条数上限与字节预算，全部代码在本机真跑并附 9 条 vitest 用例。
编辑器最让人信任的能力是 Ctrl+Z。本节把一次编辑封装成带 do/undo 的 Command 对象，从零实现命令栈的撤销、重做与合并判定，并用 7 条 vitest 用例把 do/undo/redo、redo 链断裂、同目标合并与栈上限逐条钉死。
关卡怎么存盘才既好读又耐改？本节把 8.2 的场景文档写成《微光岛》的 JSON 关卡格式：节点之间用稳定 uid 互相引用而不是数组下标，文件头带 format 与 version，加载时按版本迁移、遇到更高的版本直接拒绝，并用一组用例真跑往返与迁移。
一份可编辑的场景文档长什么样？本节用扁平节点表存节点树，区分运行期句柄 id 与稳定标识 uid，把「改了一个节点，哪些东西要重算」交给脏标记来回答：任何改动沿父链向上标脏到根，刷新时按祖先先于后代的顺序处理。每次改动还追加一条变更记录，作为第 9 章撤销栈的接缝。
编辑器与运行时到底共用什么、隔离什么？本节用一份共享的场景数据模型，把编辑态与运行态拆成两份实例：进入 Play 时深拷贝文档，运行时只改副本，Stop 后编辑态原样恢复。最后用一组 vitest 用例把快照、暂停与幂等停止在本机真跑一遍，并说明为何场景文档用扁平节点表而不是 ECS。
本节不承诺真正的 HMR，只做「模块边界 + 数据与代码分离 + 状态迁移」的数据路径：可替换模块把状态导出成纯数据加版本戳，替换时沿迁移链升到新版本再灌进新实例。状态迁移逻辑用 vitest 真跑，浏览器里的动态 import 与真实刷新时序标为 L4。
脚本不是魔法，就是一组可选回调。本节把 onCreate / onUpdate / onDestroy 接到 ECS 实体的世代句柄上，用状态机挡住误用，让调度顺序由优先级与挂载次序决定，并把帧内卸载延迟到帧末以免遍历中改表；全部用 vitest 真跑。
组件字段要能被脚本与编辑器读写，就不能靠字符串硬编码。本节把内核的类型描述符接到组件实例上，实现带类型强制、只读标记与隐藏字段的属性绑定，并用 vitest 把类型强制、快照与变更比对在本机真跑一遍，给出可供撤销栈与多选编辑复用的最小变更集。
资产浏览器要把引擎眼里的扁平「路径→资产」解释成一棵可展开的树，关卡编辑则把《微光岛》的关卡数据装进编辑器并校验引用。本节实现资产树构建、类型判定、稳定 GUID、拖放载荷编解码与关卡加载，并在本机真跑 13 条 vitest 用例；拖放交互属 L4，需在浏览器中手动验证。
编辑器视口要同时画场景、网格与选择描边，还要支持多相机切换。本节把卷二渲染器接进编辑器：用同一份实例数据分别喂给主相机与顶视相机、在片元里给选中实例描边、再单独叠一层世界网格，并在 headless Chromium 里回读像素逐条核对是否生效。
视口要回答的是「鼠标点在画面上究竟选中了谁、拖动了多少」。本节把拾取射线与变换 gizmo 的几何抽成纯数学：像素→NDC→世界射线、射线与有限轴线的最短距离、轴手柄与面手柄判定、沿轴拖拽位移的求解，并在本机真跑 12 条 vitest 用例；真实鼠标拖拽属 L4，需在浏览器中手动验证。
同时选中多个对象时，属性面板该显示什么？本节实现多选编辑的纯数据部分：求公共属性、把值聚合成「全等」或「混合」两种状态、再生成只包含真正变化项的批量命令。公共属性、混合值判定与批量命令生成都在本机真跑并有 vitest 用例；面板渲染与交互属 L3/L4，需在浏览器中手动验证。
面板拿到字段后，该给它配哪种控件？本节写一张字段类型到控件种类的映射表：数值对应数字框、bool 对应勾选框、vec3 展开成三分量、句柄对应对象引用，再叠一个可覆写的控件注册表处理个别特例。映射与解析逻辑在本机真跑并有 vitest 用例；真实 DOM 控件的创建属 L3，需在浏览器中手动验证。
属性面板不该为每个组件手写 UI。本节把卷一第 16 章的反射描述符接进编辑器：从类型描述与实例展开出纯数据的「面板描述模型」——字段名、标签、类型、当前值、只读与枚举候选，不含任何 DOM。该数据模型在本机真跑并有 vitest 用例；DOM 渲染属 L3，需在浏览器中手动验证。
提示注入、工具越权、供应链投毒——Agent 的安全面比传统应用多出一整层「把不可信文本当指令用」。本节给出攻击面 × 防护措施对照表，并真跑两个最小防线：输入侧剥离注入指令行、工具侧按收件人白名单拦截越权调用，再用审计轨迹证明每一次拦截都留痕可查。
路由、缓存、并发上限、降级——成本与延迟治理的四个旋钮，任何一个拧过头都会伤质量。本节用本地假模型真跑一条完整治理链：语义缓存命中即跳过、预算耗尽自动降级到小模型、Semaphore 把在飞请求压到上限内，再用评测集证明「降级后分数会掉」，并如实说明假模型为何量不出真实成本与延迟。
pydantic-ai 原生就吐 OTel span，smolagents 与 minagent 却只有各自的内部轨迹。本节在装了 opentelemetry-sdk 1.44.0 的环境里真跑：把三种来源的 trace 归一到一张中间表示，再统一 emit 成 GenAI 语义约定的 OTel span 树，并给出三框架 span 字段到 OTel 属性的逐项映射表。