SuperAPI AI 工具集

tui-toast

前端与建站

查看项目

更新于 10-16 10:15

技能介绍

用途

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 个操作。

输出契约(强制)

每次必须输出以下四个块:

  1. OUTPUT: TUI_RENDER —— 仅等宽文本。
  2. OUTPUT: COMPONENT_SPEC —— 组件规格 JSON,包含 id、name、type、bbox、zIndex、layout、style、typography、overflow、state、hotkeys 等字段。
  3. OUTPUT: PENCIL_SPEC —— 画布、网格、节点与组件描述。
  4. 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。

限制

资料未提供具体收费、价格、平台支持范围或实际效果数据,相关内容暂未提供。