用途
toy 面向这样一种学习场景:用户已经无法仅靠阅读来掌握某事物的行为,需要亲手“驾驶”它,在每一步操作前后形成预测、观察实际结果,从而建立直觉。它的核心原则是“构建世界,由人来驾驶”,并且绝不自动化用户正在学习的那一步。
主要能力
- 一次一种行为:一个“世界”只呈现一种行为,裁掉所有与预测无关的控件和读数。
- 暴露隐藏状态:在每一步展示栈、队列、光标、中间值等隐藏内容,支持前后拖拽回看,每次操作都把结果重新渲染在原因旁边。
- 记录预测:在每个步进或触发控件旁留出空间,让用户在按下前写下预期;世界会把预测与实际结果并排展示,由人来判断是否吻合,世界本身不打分。预测落空时,会指出下一个该驾驶的对象。
- 步步留白:任意步骤旁都可以钉一条笔记。
- 真实优先:运行成本低时驱动真实系统;数据过重时使用玩具数据。系统未展示的动态在屏幕上标注为“近似”,绝不画成真实。
使用方式
根据用户缺乏的内容,toy 会构建对应的“案例”:
- 执行如何展开 → 步进器:沿时间拖拽,每一步都能看到内部状态。例如在单个输入上运行正则引擎,逐步查看光标与回溯栈。
- 迁移、移植或批量改动会做什么 → 指挥中心:由人逐步触发,前后对照。例如对四十个文件做重命名,每按一次处理一个文件,并排展示它的前后状态。
- 结构或算法如何运作 → 可移动的对象与实时数值。例如 B 树:拖入一个键,观察分裂。
- 参数或设计空间如何变化 → 带即时重渲染的滑块。例如限流器:桶大小与补充速率,每次微调都重绘流量曲线。
默认交付物是一个放在仓库之外的单页文件,命名为 YYYY-MM-DD-<slug>.html,并为用户打开(open <path>),然后退出。
适用场景
适合学习执行流程、批量改动、数据结构与算法行为、参数空间影响等需要动手建立直觉的内容。
限制
如果读者缺的是“它是什么”而非“它如何运作”,应改用 grasp 技能。如果要做的是游乐场、演示或 UI,则不属于 toy,应明确说明并停止。