用途:把 TUI 设计当作产品设计产物来产出,要求渲染可复制粘贴的 ASCII TUI,并提供完整布局与样式令牌,同时给出可供 Pencil MCP 使用的 JSON 规格与 batch_design 操作(每次调用不超过 25 个操作)。
主要能力:按固定输出契约依次输出四个块——TUI_RENDER(仅等宽文本)、COMPONENT_SPEC(组件 id、名称、类型、bbox、zIndex、layout、style、typography、overflow、state、hotkeys)、PENCIL_SPEC(canvas、grid、nodes、components)、PENCIL_BATCH_DESIGN(分 CALL 的批量操作)。渲染规则包含字符网格与像素映射(默认 cellWidthPx=8、cellHeightPx=16,leftPx=col*cellWidthPx 等)、禁止制表符与超出行宽、溢出策略 truncate/wrap/clip、常用框线字符集与组件外壳(标题行、内容区、可选页脚 Keys)、默认不输出 ANSI 颜色且尊重 NO_COLOR=1、热键使用规范集合。
使用方式:调用 get_editor_state(include_schema=false) 获取活动 .pen 文件与选区;无活动文档时 open_document("new");用 batch_design(filePath, operations) 应用 PENCIL_BATCH_DESIGN,每次不超过 25 个操作且不同调用间不复用绑定名;用 snapshot_layout(filePath, maxDepth=2, problemsOnly=true) 校验布局,用 get_screenshot(filePath, nodeId) 做视觉检查。定位属性名可能因 schema 不同(如 x/y 与 left/top),未知时先取 get_guidelines(topic="design-system") 再调整更新键。
适用场景:需要产出 TUI 原型、组件规格与 Pencil 设计落地方案的界面设计流程。
限制:资料未说明收费标准、支持平台、性能与效果保证;颜色仅在明确要求时输出 ANSI TrueColor,且需提供 noColor 开关。