用途
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 工作流
- 打开 references/apis/index.md 并选择领域。
- 在该领域参考中确认确切的构造函数或方法、参数、返回类型、事件、错误、权限和生命周期。
- 如果 API 缺失或请求的重载未记录,检查当前 Ink 类型或实现,而不是猜测。
- 将能力检查和清理放在获取资源的代码附近。
完成检查
运行 AIUI 智能体交付检查清单。报告运行了哪些可执行检查、证明了什么,以及哪些目标设备行为仍未验证。不要仅因为文件在结构上看起来正确就称智能体可运行。
限制
资料未提供该技能的具体收费、价格、平台支持范围、效果数据或完整安装步骤;上述内容均以技能文档中明确说明的规则与流程为准,未提及的部分暂未提供。