SuperAPI AI 工具集

dot-canvas-designer

设计与创作

查看项目

更新于 10-16 01:16

技能介绍

本技能用于设计或修改 Dot. Canvas API 的卡片、仪表盘、状态面板或 windowData 布局。若只是把已有 payload 发送到设备,应改用 dot-device-openapi,本技能不处理 API key、设备 ID 或设备发送。

用途与流程:写布局前先阅读 content-design.md,确定核心事实、实际数据、目标、语言与状态行为;再读 display-design.md 了解层级、排版、图片处理和小屏构图。这些决策用于指导最终 Canvas payload,但不作为额外字段。对 Read Pico 或 Rand/0 请求,须先查产品与集成指南,Canvas 交付支持需单独确认。

主要能力:用 JSON 而非 JSX、JavaScript、原始 HTML、外部 CSS 或图片构建 windowData。根节点形如 {"default":[{"type":"div","props":{"tw":"flex flex-col flex-1 bg-white text-black","children":"Hello Dot."}}]}。元素 type 支持 div、span、img;props 支持 tw(Tailwind 类)、style(内联样式对象)、children(字符串、单个元素或元素数组)。动态值通过 {{get inputData "title" default="-"}} 这类简单表达式读取 Canvas 数据。支持 $for/$empty(列表)、$ifAny/$then/$else(结构条件)、if/else(内容分支)、compare(文本分支)、formatDate、formatCompactNumber、get 等稳定显示层 helper;公开 payload 中避免 imageSrc、stripHtml、math、regexMatch 等内部清洗或变换 helper,数据清洗与运算应提前完成。

布局建议:用带 flex、w-full、h-full 和明确背景/文字色的有界根容器;用固定槽位和文本裁剪控制阅读预算,仅在确有收缩、截断或裁剪需求时加 min-w-0、min-h-0、overflow-hidden;最外层通常不加 padding,设备间距来自 layoutFull,可用 layoutFull.tw 或 layoutFull.style 覆盖全幅渲染、背景或内边距;保持元素数量与嵌套较少。

限制:产出的是 Canvas payload 或 windowData 对象,不涉及设备发送;具体价格、平台范围与更多用法资料中暂未提供。