ai-kujiale-design

核心用法

酷家乐AI设计是一款面向普通用户和专业设计师的智能化室内设计工具，通过分步式对话完成从户型获取到渲染出图的全流程。用户可通过两种路径启动：输入小区名搜索现成户型库，或上传手绘/纸质户型图进行AI临摹识别。系统支持全国主要城市的住宅户型数据，识别准确率高。

选定户型后，用户需完成「偏好标签选择→硬装风格匹配→智能布局生成」三步配置。系统基于用户选择的风格标签（如"现代简约""轻奢""原木风"等）自动推荐硬装方案，并消耗账户内的"智能布局额度"生成房间级家具布置。最终输出包含：各房间渲染图（按客餐厅→主卧→次卧优先级排序）、360°全景漫游链接、设计亮点总结及方案详情页。

显著优点

1. 全流程自动化：覆盖户型获取、风格匹配、布局生成、渲染输出四大环节，传统需数天的设计流程压缩至分钟级
2. 零门槛操作：对话式交互降低专业软件学习成本，非设计背景用户亦可独立完成
3. 酷家乐生态背书：直接调用酷家乐（Coohom）官方户型库与素材库，硬装/家具模型专业可落地
4. 双路径灵活输入：既支持结构化搜索，也支持非结构化图片上传，适配不同用户场景
5. 实时进度反馈：通过message(action=send)机制持续同步执行状态，体验友好

潜在缺点与局限性

• 额度消耗机制：智能布局阶段明确消耗用户账户"核豆/额度"，频繁试错成本较高
• 风格覆盖边界：硬装风格库为预设选项，高度个性化需求可能无法完全满足
• 渲染等待时间：最终渲染需轮询等待，高峰期可能超过5分钟超时阈值
• 户型识别容错：上传图片质量（清晰度、标注完整性）直接影响临摹成功率
• 渠道差异化：Webchat与飞书平台的图片展示格式存在差异，跨平台体验不完全一致

适合人群

• 装修业主：快速获取自家户型的可视化设计方案，用于装修决策参考
• 房产经纪人：为客户快速生成房源装修效果图，提升带看转化
• 室内设计新手：通过AI辅助理解空间布局逻辑，作为专业软件学习过渡
• 软装设计师：硬装方案快速打底，聚焦软装搭配创意

常规风险

• Token安全风险：需本地存储access_token，建议用户妥善保管配置文件
• 版本兼容性：强制版本校验机制，过时版本可能被终止服务
• 数据隐私：户型图片、偏好标签等用户数据上传至酷家乐服务端处理
• 输出结果局限性：AI生成方案为参考用途，实际施工需专业设计师复核尺寸与工艺

核心用法

ai-kujiale-design 是酷家乐（Kujiale/Coohom）官方推出的智能室内设计 Skill，采用四阶分步式交互流程：

1. 户型获取与确认

• 支持两种路径：文字搜索小区户型（覆盖主流城市小区数据库）或上传户型图AI识别临摹
• 自动解析生成标准化户型图，用户可视化确认后进入下一阶段

2. 风格选择（标签+硬装风格）

• 基于用户偏好标签（如家庭结构、功能需求）智能推荐硬装风格库
• 多风格预览对比，单选确认后锁定 designId

3. 智能布局生成

• 消耗用户账号智能布局额度，触发 AI 自动摆场与硬装匹配
• 实时反馈布局进度，生成各房间家具配置清单

4. 渲染出图

• 自动触发云端渲染引擎，生成高清效果图（pictype=0）与 360° 全景漫游链接（pictype=1）
• 按「客餐厅→主卧→次卧→其他」优先级输出，附带设计亮点总结与方案详情链接

技术特性：纯 Node.js 内置模块实现，零外部 npm 依赖；全链路 HTTPS 加密对接酷家乐官方 API；本地 .kjlconfig.json 存储 access_token，符合 OAuth 标准授权流程。

显著优点

• 官方生态深度整合：直接调用酷家乐千万级户型库与专业渲染农场，输出质量达到室内设计行业标准
• 零配置学习成本：对话式引导完成全流程，非专业用户也能快速上手
• 双路径灵活输入：既支持精准搜索现有小区户型，也支持手绘/拍照户型图 AI 识别，覆盖全场景需求
• 安全架构简洁：无代码混淆、无危险函数、无第三方数据上报，依赖审计干净
• 版本生命周期管理：内置版本检查机制，自动提示更新或终止废弃版本使用

潜在缺点与局限性

• 账号额度依赖：智能布局功能需消耗用户酷家乐账号内的「智能布局额度/核豆」，非完全免费
• 本地凭证风险：access_token 以明文形式存储于 .kjlconfig.json，存在被其他程序读取的可能（需用户自行配置 .gitignore 防护）
• 网络环境要求：全流程依赖酷家乐官方 API，需稳定连接国内服务器，海外用户可能体验受限
• 风格定制深度有限：硬装风格库为预设模板，高阶个性化定制仍需人工介入酷家乐专业版
• 渲染排队等待：高峰期云端渲染可能存在数分钟等待时间

适合人群

| 用户类型 | 场景价值 |

|---------|---------|

| 装修业主 | 快速获取自家户型的多套专业设计方案，辅助决策 |

| 房产经纪人 | 为房源快速生成虚拟装修效果图，提升展示吸引力 |

| 室内设计师 | 自动化前期方案草稿，节省户型建模与初版布局时间 |

| 家居品牌销售 | 为客户提供「未来家」可视化预览，促进转化 |

| 租房改造者 | 低成本预览空间改造可能性，避免踩坑 |

常规风险

• Token 泄露风险：access_token 相当于酷家乐账号的 API 权限凭证，若配置文件被误提交至公开仓库或共享给他人，可能导致账号被滥用
• 额度消耗不可逆：智能布局触发后即扣减额度，建议在阶段3前明确告知用户确认
• 渲染结果波动：AI 布局与渲染存在随机性，同一条件可能产生不同结果，重要方案建议多次生成对比
• 户型识别误差：上传图片路径依赖 AI 临摹精度，复杂异形户型可能存在识别偏差，需人工复核关键尺寸