SuperAPI AI 工具集

aiui-dev

智能体与模型

查看项目

更新于 10-21 16:22

技能介绍

用途

AIUI 开发技能用于构建和调试 AIUI 智能体(agents)、页面(Page)、小组件(Widget)、Agent Worker、内置组件、WXSS 样式以及运行时 API。适用于生成或审查 AIUI 的 .ink 文件等开发任务。

该技能的核心原则是:依据本技能中的当前契约来构建 AIUI 智能体,不要仅因为某个 API、组件、CSS 属性、浏览器行为或生命周期存在于 Web 或微信小程序中,就假设它在 AIUI 中同样存在。

按需加载参考文档

技能要求只加载任务所需的内容,避免为窄任务加载全部参考:

  • 项目结构、app.json、Page、Widget、Agent Worker、SFC、模块、资源、打包或 TypeScript:阅读 framework.md。
  • 生命周期、交互、按键、焦点、语音唤醒、头部手势和环境感知事件:阅读 events.md。
  • 使用或审查内置组件及其属性或事件前:阅读 components.md。
  • 编写样式、布局、选择器、动画或自定义字体前:阅读 wxss.md。
  • 仅针对单色绿 Rokid Glasses 视觉语言:阅读 monochrome-green.md。
  • 使用运行时 API 前:先阅读 APIs 索引,再阅读对应领域文件。
  • Widget 或 Agent Worker 实例方法:阅读 Widget API 或 Agent Worker API。
  • 在声明生成或修改的 AIUI 智能体完成前:阅读并应用交付检查清单。

可从匹配的脚手架开始:最小 Page、最小 Widget 或最小 Agent Worker。例如,Agent Worker 通常需要 framework.md、events.md 和 apis/agent-worker.md,而不需要 Canvas 或完整组件目录。

核心编写规则

  • 使用 export default { ... }; 注册 App、Page、Widget、Component 和 Agent Worker 逻辑;不要使用 App()、Page()、Widget() 或类似注册函数。
  • 一个路由只能使用多文件 Page 或单个 .ink Page,不能同时使用两者。
  • .ink Page 使用 <script def>、<script setup>、<page> 和 <style>。Widget 用 <widget> 替换 <page>。
  • 使用前必须在相应配置中声明每个 Page、Widget、Agent Worker 和自定义组件。
  • 在 app.json.permissions 中声明所需能力;单独处理设备授权失败。
  • 将 Widget 系列视为尺寸类别。使用相对布局,绝不将根节点硬编码为当前 Glasses 像素尺寸。
  • 使用 agentWorkers,而不是已移除的 workers 字段。用 event.waitUntil(promise) 同步扩展异步 onOpen 工作。
  • 对渲染状态使用数据绑定,并用 this.setData() 更新。
  • 从项目路径解析打包资源;不要虚构目标未暴露的文件系统或网络访问。
  • 除非任务明确针对交互式全屏 Page 或 Widget,否则将对话流卡片视为仅展示。

目标与设计选择

在设置样式前,先确定预期表面:

  • 对话流卡片:紧凑、仅展示信息。
  • 全屏 Page:交互式智能体 UI。
  • Widget:紧凑的 1x1 或 1x2 表面,具有 Widget 生命周期。
  • 单色绿 Rokid Glasses:在通用 WXSS 规则之后应用 design/monochrome-green.md。
  • 其他显示设备:使用主题令牌和任务需求;不要自动应用单色绿视觉语言。

运行时 API 工作流

  1. 打开 references/apis/index.md 并选择领域。
  2. 在该领域参考中确认确切的构造函数或方法、参数、返回类型、事件、错误、权限和生命周期。
  3. 如果 API 缺失或请求的重载未记录,检查当前 Ink 类型或实现,而不是猜测。
  4. 将能力检查和清理放在获取资源的代码附近。

完成检查

运行 AIUI 智能体交付检查清单。报告运行了哪些可执行检查、证明了什么,以及哪些目标设备行为仍未验证。不要仅因为文件在结构上看起来正确就称智能体可运行。

限制

资料未提供该技能的具体收费、价格、平台支持范围、效果数据或完整安装步骤;上述内容均以技能文档中明确说明的规则与流程为准,未提及的部分暂未提供。