酷家乐智能设计

要解决的问题

传统的室内设计流程，从寻找户型、选择风格到生成布局和效果图，涉及多个独立步骤和工具切换，手动操作繁琐且耗时。对于希望快速获得专业设计参考的用户而言，存在一个明确的断点：如何将文字描述或一张户型图，自动化地转化为一套包含完整布局、多种渲染图和全景图的设计方案？

技能如何工作

酷家乐智能设计技能将上述流程封装为一个自动化的执行链，通过调用酷家乐平台的一系列 API 来实现。它严格遵循预设的四个阶段：

核心能力与关键步骤

1. 户型获取与方案创建：支持两种输入方式。

文字搜索：通过城市、小区名等信息，调用户型搜索接口（planSearch）获取匹配结果，用户确认后调用 createDesign 创建设计方案。
图片识别：监听图片上传目录，调用上传（upload）和临摹导入（planUrlCreate）接口，通过轮询（planUrlCreateResult）识别户型并生成设计基础。

1. 智能风格与布局：基于用户选择的偏好标签（customTag）和匹配到的硬装风格（hardStyle），技能会触发后端的“智能布局”（layout）功能。此步骤会消耗账户额度，系统会进行提示和确认。布局完成后，通过轮询（layoutResult）获取各房间的家具摆放结果。
2. 自动渲染与输出：布局确认后，立即触发渲染任务。系统异步生成渲染图和全景图，技能会持续轮询（renderResult）直到完成，或达到超时上限（约5分钟）。
3. 结构化结果交付：最终输出严格遵循 result.md 格式，包括基于首张渲染图总结的设计亮点、按优先级排序（客餐厅 -> 主卧 -> 次卧 -> 其他）的渲染图、全景图链接以及方案详情链接，确保结果可直接用于展示。

整个过程通过 message(action=send) 实时同步进度，并严格校验脚本版本（versionCheck），确保执行环境的一致性。

适用边界与注意点

• 流程刚性：技能必须严格按文档流程执行，无法处理自定义的复杂指令或跳过中间步骤（如跳过风格选择直接布局）。
• 账户依赖：核心功能（如智能布局、渲染）依赖关联的酷家乐账户权限和额度（“核豆”），额度不足或接口调用异常会导致流程中断。
• 输入要求：图片识别路径要求图片放置于特定目录（~\.openclaw\media\inbound），且需要一定时间（5秒检查间隔）被检测到。户型搜索的准确性依赖于酷家乐户型库的覆盖范围。
• 结果依赖：最终效果图的质量取决于酷家乐平台的渲染引擎和模板库，技能本身不修改渲染算法。结果输出会根据 pictype 字段过滤，仅展示标准渲染图（pictype=0）和全景图（pictype=1）。