Kujiale Design Tool Free

分步式室内设计工具,完成户型确认到渲染出图,适合个人用户快速生成装修方案。

Install

openclaw skills install @thcjp/kujiale-design-tool-free

酷家乐设计工具 - 免费版

概述

酷家乐设计免费版是一款面向个人用户的分步式室内智能设计工具。通过自然语言对话完成户型确认、风格选择、布局生成与渲染出图全流程,无需专业设计软件操作经验,即可快速获得装修方案预览。

本版本依托酷家乐设计平台能力,提供基础的户型搜索、风格选择、智能布局与渲染功能,适合个人业主、室内设计初学者及装修灵感探索者。

核心能力

能力项	免费版支持	说明
户型文字搜索	是	按城市小区搜索
户型图上传识别	是	图片临摹识别
硬装风格选择	是	基础风格库
智能布局	是	自动家具布局
渲染图生成	是	标准画质
全景图链接	是	360度全景
多方案对比	否	PRO 版支持
批量渲染	否	PRO 版支持
自定义风格	否	PRO 版支持
技术实现要点：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：分步式室内设计工、完成户型确认到渲、染出图、适合个人用户快速、生成装修方案、酷家乐设计免费版、面向个人用户的分、步式室内智能设计、分步对话完成户型、布局确认、渲染出图、支持文字搜索小区、户型或上传户型图、提供基础硬装风格、库与智能布局、生成渲染图与全景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:业主装修方案预览

业主拿到新房户型,希望快速预览不同风格的装修效果。

text

用户: 帮我设计一下我家新房,在杭州,小区是万科未来城

流程:
1. 系统询问城市与小区
2. 搜索户型并展示户型图
3. 用户确认户型后选择风格(如现代简约)
4. 触发智能布局生成
5. 渲染出图展示效果

命令示例:
node ./scripts/searchPlan.js --token=<token> --query="万科未来城" --areaId=<杭州id> --start=0 --num=20
node ./scripts/getFloorplanInfo.js --planId=<planId>
node ./scripts/createDesign.js --token=<token> --planId=<planId>
node ./scripts/getTags.js --token=<token>
node ./scripts/getStyles.js --token=<token> --tagItemIds=<id1,id2>
node ./scripts/triggerLayout.js --token=<token> --designId=<designId> --tagIds=<id1> --styleId=<styleId> --applyDecorationStyle=true --buildCeiling=true --autoDesign=true
node ./scripts/trigger-render.js --obsDesignId=<designId> --xToken=<token>

场景二:上传户型图识别设计

用户已有户型图图片,希望基于图片进行设计。

text

用户: 我有一张户型图照片,帮我设计

流程:
1. 系统检测到上传图片
2. 上传图片并创建临摹任务
3. 轮询识别结果获取 planId
4. 后续流程同场景一

命令示例:
node ./scripts/getUploadToken.js --token=<token>
node ./scripts/createBitmapTask.js --token=<token> --bitmap=<url>
node ./scripts/getBitmapTaskResult.js --token=<token> --taskId=<taskId>

场景三:装修风格灵感探索

用户希望探索不同硬装风格的装修效果。

text

用户: 我想看看不同风格的装修效果

流程:
1. 系统获取风格标签
2. 展示标签选项(如现代、北欧、中式)
3. 用户选择后查询硬装风格
4. 展示风格封面图供选择
5. 选择后触发布局与渲染

命令示例:
node ./scripts/getTags.js --token=<token>
node ./scripts/getStyles.js --token=<token> --tagItemIds=<id1,id2>

不适用场景

以下场景酷家乐设计-免费版不适合处理：

3D建模和动画制作
照片级写实渲染
手绘原创插画

触发条件

需要设计创作、UI设计、海报制作、品牌视觉时使用。不适用于非本工具能力范围的需求。

快速开始

第一步:配置 access_token

首次使用需在项目根目录创建 .kjlconfig.json 文件:

json

{
  "access_token": "your_access_token_here"
}

获取地址:https://www.kujiale.com/skills

第二步:版本校验

bash

node ./scripts/versionCheck.js --token=${token} --version=1.0.0

第三步:启动设计流程

直接告诉 Agent:"帮我做一个室内设计",系统将引导你完成全流程。

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

基础配置项说明:

json

// .kjlconfig.json
{
  "access_token": "your_token",
  "default_city": "杭州",
  "default_style": "现代简约"
}

bash

# 版本校验结果说明
# action=1: 继续
# action=2: 提示"版本已过时,建议更新"
# 依赖说明

最佳实践

户型信息完整:搜索时提供城市+小区名+户型结构(几室几厅),提升搜索准确性
先确认户型再设计:仔细核对户型图面积与结构,确认后再进入设计阶段
风格标签多选:可多选标签(如"现代"+"简约"),系统会匹配更精准的风格
布局确认后再渲染:布局生成后仔细查看各房间家具布置,确认后再渲染
渲染需等待:渲染出图约需 2-5 分钟,期间可做其他操作
结果排序参考:渲染图按房间优先级排序(客餐厅→主卧→次卧→其他)

常见问题

Q1:搜索不到我的户型怎么办?

A:尝试用上传户型图的方式;或确认小区名称拼写;或提供周边标志性建筑辅助定位。

Q2:户型图识别失败怎么办?

A:确保图片清晰、正面、无遮挡;尝试重新拍摄;或改用文字搜索方式。

Q3:智能布局消耗额度吗?

A:智能布局会消耗账号内的布局额度/核豆,执行前系统会提示并需用户确认。

Q4:渲染图不清晰怎么办?

A:免费版为标准画质。如需高清渲染,请使用 PRO 版的高清渲染与批量渲染能力。

Q5:方案可以保存吗?

A:可以。设计完成后会生成方案详情链接,可登录酷家乐平台查看与编辑。

依赖说明

运行环境

Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
操作系统: Windows / macOS / Linux
运行时: Node.js 16+

第三方依赖

依赖项	类型	是否必需	获取方式
酷家乐设计 API	外部 API	必需	官网注册获取 token
Node.js 16+	运行时	必需	官方安装
axios	HTTP 库	必需	npm install axios

API Key 配置

配置文件: .kjlconfig.json(项目根目录)
字段名: access_token
获取方式: 访问 https://www.kujiale.com/skills 生成
存储建议: 配置文件加入 .gitignore,避免泄露

可用性分类

分类: MD+EXEC(纯 Markdown 指令,核心功能需要 exec 命令行执行能力)
说明: 基于Markdown的AI Skill,通过分步对话与脚本调用驱动室内设计全流程

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

需LLM支持,无LLM环境不可用
复杂业务场景建议结合人工经验判断
执行效率受模型能力与网络环境影响
当前为免费版本,如需完整功能请升级到付费版获取全部能力