用途:Breadboarding 把一段工作流描述转化为完整的可供性与关系地图,输出始终是一组表格,列出编号的 UI 可供性(U)与代码可供性(N)及其 Wires Out(控制流)和 Returns To(数据流)关系。表格是事实来源,Mermaid 图只是给人看的可选可视化。
主要能力:支持两种场景——映射现有系统(输入代码仓库与工作流描述,输出 UI 可供性表、代码可供性表,可选 Mermaid 图;跨前后端时做一张完整 breadboard 并标注所属系统)和基于 shaping 部件设计新系统(输入部件清单、目标 R、可选现有系统)。也支持两者混合,以及阅读白板手绘 breadboard(用堆叠格式而非表格)。
核心概念:Place 是交互的有界上下文,用“能否与背后内容交互”的阻塞测试判断;模态、确认弹窗、整屏编辑模式算不同 Place,复选框展开、下拉菜单、提示不算。Place 有 ID(P1、P2、P2.1 子 Place 等),导航时 wire 指向 Place 本身而非其内部可供性。可供性分 UI(输入、按钮、展示元素、滚动区)与代码(方法、订阅、数据存储、框架机制)。Wires Out 表示触发/调用/写入/导航,Returns To 表示返回值/读取。
使用方式:映射现有系统时,先确定要分析的具体用户旅程,列出涉及的所有 Place,从入口点追踪代码找到每个组件,逐个列出其 UI 与代码可供性,名称必须是代码中真实存在的东西(如 userRepo.save()),再填 Control、Wires Out、Returns To,把数据存储和框架机制也作为可供性加入,最后对照代码验证。输出包含 Places 表、UI 可供性表、代码可供性表、数据存储表,列包括 #、Place、Component、Affordance、Control、Wires Out、Returns To。
适用场景:理解现有系统具体细节、解释某事如何发生或为何不发生、把 shaping 部件细化为具体机制并展示其作为系统的交互、把白板 breadboard 转成标准表格。
限制:资料未提供具体安装命令、收费、价格、平台或效果信息;表格是唯一事实来源,图示仅为可选;可供性名称必须指向代码中真实存在的方法或元素,不能写抽象概念。