用途:把一次自然语言请求加可选显式选项,转换为 ProductSpec v4 与规范化的 ThemeSpec v1,生成确定性的本地智能家居应用;不适用于在生成应用中添加 AI/聊天行为。
主要能力:仅生成所选模块、设备族、路由与对话框;只检查所选模块需要的 Runtime 能力;使用只读 CLI 与 --preview-only 探针(须报告 persistentWrites=false);支持 12 个主题家族、24 个生产预设,支持自定义品牌主题(继承已验证预设并覆盖受控语义字段);支持 strict 默认生成、--capability-report 报告模式、--skip-modules、--allow-partial、--mock-home 等确定性路径;提供 validate-app、validate-slice 校验与 Mock 端到端验证。
使用方式:环境要求 yeelight-home 0.1.21 或更新版本。先运行环境检查:node scripts/doctor.mjs --json --output-dir /absolute/output/path。直接构建:node scripts/build-app.mjs --request "..." --title "..." --home-id 200171 --region dev --out /absolute/output/path。设备覆盖或 Runtime 稳定性不确定时用 --capability-report 只做报告。校验:node scripts/validate-app.mjs /absolute/output/path。安装运行:npm ci --prefix /absolute/output/path;npm run build --prefix /absolute/output/path;npm run dev --prefix /absolute/output/path,须等 npm ci 完成后再 build,不可并发。
适用场景:客厅灯光控制等移动端/墙屏应用生成;全屋空间、设备、情景与自动化管理;需要确定性设计和 Mock E2E 验证的场景。
限制:生成严格失败为默认,任何请求模块不可用即停止并给出原因与显式选择,不自动选择 partial 或 Mock,不生成空应用;请求不清晰时不回退到一体化应用;scene.launcher 默认仅执行,只有用户明确要求维护情景时才启用 scene detail/create/edit/test/delete;installer.maintenance 为工作区外壳,必须显式选择 gateway.overview、panel.manager 或两者,不得隐式添加;ThemeSpec 中不得包含 CSS、JavaScript、HTML、URL 或字体文件/远程字体引用;不得在生成的浏览器代码中放置凭据、原始云主机、请求头或任意 CLI 命令;不显示 Runtime、CLI、Bridge、能力或审计术语,使用“家庭系统”等产品语言;未经用户确认不得执行真实云端写操作;默认 access=single-user、本地 Bridge、LAN 禁用。legacy --theme-pack 与 --palette 仅为迁移兼容,新应用应使用 --theme-preset 或 --theme-file。报告模式不创建 --out 目录。Mock 路径不证明真实家庭具备相同能力;reference-home-degraded 仅用于验证严格失败与只读模板闭合。具体收费标准、价格和平台支持情况,资料暂未提供。