tuya/tuyaopen-ide-manifests/tuyaopen-miniapp-smart-ui

No tuyaopen-cli CLI coverage

tuyaopen-cli CLI 有 miniapp 命令组，但只覆盖构建 / 安装运行时 / 元数据 / DP schema 同步 / 预览 / 模板 / 上传等命令行操作（详见 the tuyaopen-start routing table）——具体的页面、组件、DP 交互编码不在其列。本技能的开发知识完全来自 references/ 与项目内文档，不经 tuyaopen-cli CLI。

概述 {#description}

本 skill 是 Ray 小程序 smart-ui 的专项开发入口，采用 meta-first 流程（先索引、再文档、最后输出），不使用任务分区。目标是在有据可查的前提下完成页面与组件的设计、改造与排障，避免对文档未载明的能力进行猜测。

适用场景 {#scene}

• 搭建或调整 smart-ui 页面、布局与组件组合。
• 表单、反馈类交互、导航与展示类 UI 的实现或改造。
• 图片转代码、参考稿落地为 smart-ui 结构。
• smart-ui 相关报错、样式或行为不符合预期时的定位与升级。

当前仅处理 smart-ui，不作为通用 Ray API 或设备能力开发总入口。若用户目标超出 smart-ui，应先说明超出当前范围，再给出最小必要的外部建议。

搭配使用 {#usage}

• 需求生成指南：超出 Smart UI 范围时查 tuyaopen-start 路由表。
• Ray API / 生命周期等通用开发知识：超出 Smart UI 范围时查 tuyaopen-start 路由表。

品类业务剧本与功能 SDK {#categories}

本技能聚合了涂鸦常用硬件品类的面板最佳实践剧本与专有 SDK：

工作流程 {#workflow}

1. 先读索引：读取 references/smart-ui/_meta.json，按 englishName、chineseName、category 初筛候选组件。
2. 再读文档：读取 1～2 个候选组件对应的 references/smart-ui/*.md；信息不足时再增量补读 1～2 个相关文档。不允许一次性扫完整个 references/smart-ui/ 目录，须按需增量读取。
3. 最后输出：先给结论，再给依据与实现建议；文档未覆盖时须显式说明「未在文档中找到」，禁止静默猜测。

输出时需区分两类信息：文档确认（明确来自当前已读文档）与经验推断（文档未覆盖、基于上下文的保守假设）。涉及能力说明时，优先引用组件文档中的 props、events、示例与注意事项。

默认约定：UI 优先 smart-ui；无法满足时再考虑 Ray 原生组件。页面生成默认放在 /pages，组件默认放在 /components。若涉及文案，提醒接入 i18n，避免在业务代码中硬编码中文。

注意事项 {#tip}

• 禁止使用小写 HTML 标签（如 div、span）。
• 禁止混入 wx.*、my.* 等非 Ray 业务 API。
• 禁止虚构 smart-ui 的 props、事件或版本能力。
• 禁止在未通过 _meta.json 定位前一次性加载大量文档。
• 禁止在业务代码中硬编码中文文案。