好的 API 设计三原则

1. 可预测

调用方不需要打开实现就能猜出行为。

2. 可组合

任何两个 API 拼在一起，结果是「两者结果之和」，没有副作用。

3. 可撤销

凡是改变状态的操作，都得能 undo。