文档与 demo 是最便宜的设计审查

API 的设计缺陷，测试可能永远发现不了。文章以 turing-machine-js 引擎的 v4→v6 迭代为例，说明两种检查比测试更有效：

- 第一个真实消费者（demo）：暴露了钩子命名错误（onDebugBreak → onPause）和 halt 后事件丢失的交互问题。
- 文档（README）：当 dispatch 顺序无法用一句话说清时，揭示出形状本身有问题，最终将生命周期简化为 before(K)→step(K)→after(K)。

启发：发布 major 前先写 dispatch 段落；如果无法一句说明，设计就该改。

原文链接

#开发者 #工具

📢 频道：@DevToolboxHub