用途
tui-toast 用于为 Toast(u-toast,轻提示组件)生成 ASCII Text UI(TUI)表示。它的目标是产出一份像素级精确的文本界面草图,同时附带结构化的组件规格与可执行的设计批次计划。
主要能力
- 生成 ASCII TUI 渲染结果,使用等宽文本输出。
- 始终输出布局属性,包括 top/left/width/height、间距(spacing)、颜色、字体(typography)与 zIndex。
- 输出 Pencil MCP 可用的规格(PENCIL_SPEC)。
- 输出 batch_design 计划(PENCIL_BATCH_DESIGN),每次调用不超过 25 个操作。
输出契约(强制)
每次必须输出以下四个块:
- OUTPUT: TUI_RENDER —— 仅等宽文本。
- OUTPUT: COMPONENT_SPEC —— 组件规格 JSON,包含 id、name、type、bbox、zIndex、layout、style、typography、overflow、state、hotkeys 等字段。
- OUTPUT: PENCIL_SPEC —— 画布、网格、节点与组件描述。
- OUTPUT: PENCIL_BATCH_DESIGN —— 分批 CALL 的批量设计操作。
输入模型(推荐)
输入以 JSON 形式提供,包含:
- widthCols:列宽,如 70
- grid:cellWidthPx、cellHeightPx
- props、modelValue
- state:focused、disabled、loading、error
- style:fillColor、textColor、strokeColor、strokeThickness、cornerRadius
- typography:fontFamily、fontSize、fontWeight、lineHeight
- layout:paddingPx、gapPx
- hotkeys
使用方式
按输入模型传入组件参数,技能将输出四个固定块。渲染规则遵循 tui-front-ui 的共享规则:
- 不使用 TAB 字符。
- 不超出 widthCols。
- 提供表头行、内容区,若可交互则提供最小快捷键提示。
- disabled=true 时必须隐藏交互提示。
- loading=true 时必须显示稳定的占位符。
- error!=null 时必须打印在单行页脚,并按宽度截断。
示例结构
资料中给出了三种示例(最小默认、样式化、禁用/错误边界),每个示例均包含 TUI_RENDER、COMPONENT_SPEC、PENCIL_SPEC、PENCIL_BATCH_DESIGN 四个输出块。PENCIL_BATCH_DESIGN 中会分两次 CALL:先创建 root 与 Screen frame,再创建 Toast/Background 矩形与 Toast/Text 文本节点。
源文档说明
该技能有意不内嵌外部文档链接。如需规范参考,请使用团队自身的组件文档或设计系统源。
组件汇总行
为便于页面聚合,提供一行汇总:id、name、top、left、width、height、z、keyProps、state、hotkeys。
限制
资料未提供具体收费、价格、平台支持范围或实际效果数据,相关内容暂未提供。