酷家乐 AI 室内设计 LITE

基于酷家乐开放能力,通过分步式对话完成户型搜索、风格选择、布局生成与渲染出图的基础流程。仅支持文字搜索户型与静态效果图输出。必须严格按本文档流程执行. 范围外(本技能不做): 户型图上传与临摹识别、全景图输出、多风格批量对比、户型结构改造(需升级 ai-kujiale-design 专业版).

输入参数

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

主要能力

输出规则

• 进度反馈通过 message(action=send) 发送
• 最终结果只输出渲染图与设计亮点,严格按 ./outputs/result.md 格式
• 已发送的消息不重复输出

设计流程

阶段一: 户型搜索与确认

触发条件: 用户提到要做室内设计/装修设计. 询问城市与小区(可一并告知户型结构、面积):

node （请参考skill目录中的脚本文件） --token=$TOKEN --query="小区名" --areaId="城市id" --start=0 --num=20

展示结果供用户选择,获得 planId 后获取户型图:

实操说明

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

初始化配置

首次使用需在项目根目录创建 .kjlconfig.json(参考 .kjlconfig-example.json):

{
  "access_token": "用户从酷家乐复制的 token"
}

若无 token,引导用户访问 https://www.kujiale.com/skills 生成,并将配置文件保存在 .kjlconfig-example.json 同一目录下。所有脚本调用前先从该文件读取 access_token 作为 $TOKEN.

版本校验

每次执行前校验版本:

node （请参考skill目录中的脚本文件） --token=$TOKEN --version=1.0.0

action=1 继续;action=2 提示"版本已过时,建议更新";action=3 终止并提示重新安装.

输出规则(补充)

设计流程(补充)

阶段一: 户型搜索与确认(补充)

node （请参考skill目录中的脚本文件） --token=$TOKEN --query="小区名" --areaId="城市id" --start=0 --num=20

node （请参考skill目录中的脚本文件） --planId=$PLAN_ID

解析返回:

• floorplanInfos 为空 → 提示"户型图获取失败,请重新选择",重新搜索
• 有数据 → 取 floorplanInfos[0].planImage 展示给用户,附带面积 realArea

用户确认后创建方案:

node （请参考skill目录中的脚本文件） --token=$TOKEN --planId=$PLAN_ID

获得 designId,提示用户进入风格选择.

升级提示: 上传户型图临摹识别(适用于搜不到小区或已改造户型)仅在专业版中提供.

阶段二: 风格选择

触发条件: 户型已确认.

node （请参考skill目录中的脚本文件） --token=$TOKEN

展示标签列表供用户单选,获得 tagItemIds。查询硬装风格:

node （请参考skill目录中的脚本文件） --token=$TOKEN --tagItemIds=$TAG_IDS

返回多个风格时展示 coverUrl 与 styleName 供用户选择;返回单个风格则默认选择。获得 styleId 进入布局阶段.

阶段三: 布局生成与确认

触发条件: 风格已确认. 先与用户确认本次布局会消耗账号内智能布局额度/核豆,确认知晓后执行:

node （请参考skill目录中的脚本文件） --token=$TOKEN --designId=$DESIGN_ID \
  --tagIds=$TAG_IDS --styleId=$STYLE_ID \
  --applyDecorationStyle=true --buildCeiling=true --autoDesign=true

查询布局结果,若 c!=0 每 10 秒重复查询:

node （请参考skill目录中的脚本文件） --token=$TOKEN --designId=$DESIGN_ID

通过 message(action=send) 发送各房间布局(房间名 + 家具列表),进入渲染阶段.

阶段四: 渲染出图

触发条件: 布局已确认. 发送"开始渲染,请稍等"并触发渲染:

node （请参考skill目录中的脚本文件） --obsDesignId=$DESIGN_ID --xToken=$TOKEN

等待 10 秒后查询渲染结果:

node （请参考skill目录中的脚本文件） --token=$TOKEN --designId=$DESIGN_ID

提取 pictype=0 的 img(渲染图)。若为空每分钟重试,超 5 分钟反馈失败。最终按 ./outputs/result.md 输出设计亮点与渲染图.

升级提示: 360 度全景图(panoLink)与多风格批量对比仅在专业版中提供.

典型场景

不适用于: 户型图上传识别、全景图输出、多风格批量对比、户型结构改造(需升级专业版).

案例展示

案例一： 业主三居室基础设计

场景: 业主提供小区名,希望快速预览装修效果

# 搜索户型
node （请参考skill目录中的脚本文件） --token=$TOKEN --query="阳光花园" --areaId="330100" --start=0 --num=20
# ...
# 获取户型图
node （请参考skill目录中的脚本文件） --planId=$PLAN_ID
# ...
# 创建方案
node （请参考skill目录中的脚本文件） --token=$TOKEN --planId=$PLAN_ID
# ...
# 风格选择
node （请参考skill目录中的脚本文件） --token=$TOKEN
node （请参考skill目录中的脚本文件） --token=$TOKEN --tagItemIds=$TAG_IDS
# ...
# 布局与渲染
node （请参考skill目录中的脚本文件） --token=$TOKEN --designId=$DESIGN_ID \
  --tagIds=$TAG_IDS --styleId=$STYLE_ID \
  --applyDecorationStyle=true --buildCeiling=true --autoDesign=true
node （请参考skill目录中的脚本文件） --obsDesignId=$DESIGN_ID --xToken=$TOKEN
node （请参考skill目录中的脚本文件） --token=$TOKEN --designId=$DESIGN_ID

输出: 户型图、各房间布局说明、渲染图

说明: 基础版覆盖搜索到渲染的核心流程,业主在户型确认、风格选择、布局确认三个节点交互即可完成。仅输出静态渲染图,全景图需升级专业版.

异常应对

异常修复

功能边界

1. 仅文字搜索户型: 不支持上传户型图与临摹识别(需升级专业版)
2. 仅静态渲染图: 不支持 360 度全景图输出(需升级专业版)
3. 需 access_token: 必须配置酷家乐 token
4. 智能布局消耗额度: 每次布局扣减账号额度/核豆,需用户确认
5. 风格库以酷家乐为准: 可选风格取决于 getStyles 返回,无法自定义

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

想要上传户型图识别、360 度全景图、多风格批量对比? 升级到 ai-kujiale-design 专业版解锁全部高级能力.

技术创新

效率提升量化分析

差异化对比

核心痛点解决

排障手册

安全守则

1. 确保API Key安全，避免泄露到公共或版本控制系统中。
2. 限制技能的使用范围，避免未经授权的使用。
3. 定期更新技能版本，修复已知的安全漏洞。
4. 对用户输入进行验证，防止恶意输入导致系统异常。
5. 严格遵循数据保护法规，保护用户隐私和数据安全。

安全风险防范

关键特性

• 自动化执行: 酷家乐室内设计基础版,文字搜索户型、风格选择、布局与渲染出图。基于酷家乐(Kujiale)开放能力的室内智能设计基础版(
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

常见疑问速答

Q1: 酷家乐AI室内设计LITE支持哪些输入格式？

A1: 酷家乐室内设计基础版,文字搜索户型、风格选择、布局与渲染出图。基于酷家乐(Kujiale)开放能力的室内智能设计基础版(免费),通过分步式对话完成 户型搜索、风。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

酷家乐AI室内设计LITE通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

协助指南

异常处置

针对酷家乐AI室内设计LITE使用中可能遇到的常见问题,提供以下排查方案:

功能特点

基于酷家乐(Kujiale)开放能力的室内智能设计基础版(

• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据