酷家乐设计工具 - 专业版

概述

酷家乐设计专业版是一款面向企业团队与专业室内设计师的高级智能设计工具。在免费版分步设计流程之上,扩展了多方案并行对比、批量高清渲染、自定义硬装风格库、团队协作与方案版本管理等高级功能,可融入商业室内设计生产流水线。

本版本完全兼容免费版所有流程与脚本,企业用户可直接迁移既有工作流并获得更高渲染质量与更丰富的设计维度。

核心能力

能力项	免费版	专业版	说明
户型搜索/上传	是	是	两种方式均支持
硬装风格选择	基础库	完整库+自定义	支持自定义风格
智能布局	是	是	自动家具布局
渲染画质	标准	高清/超清	印刷级输出
多方案对比	否	是	同户型多风格
批量渲染	否	是	多房间并发
全景图	是	是	360度全景
团队协作	否	是	方案共享与权限
版本管理	否	是	方案历史版本
技术支持	社区	专属	工单响应

核心功能执行

用input_params参数进行配置。

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

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

参数配置与调用

用config_options参数进行配置。

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

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

结果处理与输出

用output_format参数进行配置。

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：企业级室内设计工、支持多方案对比、自定义风格与团队、适配商业设计生产、酷家乐设计专业版、面向企业团队与专、业室内设计师的高、级智能设计工具、核心能力、多方案并行对比、支持同户型多风格、快速生成、批量渲染高清效果、图与全景图、自定义硬装风格库、与软装搭配、团队协作与方案版、优先渲染队列与企、业级技术支持等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:装修公司多方案比稿

装修公司需为同一户型提供 3 种风格方案供客户比稿,使用多方案并行生成。

# 多方案并行生成(同一户型,不同风格)
python3 （请参考skill目录中的脚本文件） \
  --planId <planId> \
  --styles "现代简约,北欧风,新中式" \
  --parallel 3 \
  --output ./proposals/
# .
# 每个方案独立布局与渲染
# 方案1: 现代简约
node （请参考skill目录中的脚本文件） --token=<token> --planId=<planId>
node （请参考skill目录中的脚本文件） --token=<token> --designId=<designId1> --styleId=<styleId1> --autoDesign=true
node （请参考skill目录中的脚本文件） --obsDesignId=<designId1> --xToken=<token> --quality=hd
# .
# 方案2: 北欧风(并行)
node （请参考skill目录中的脚本文件） --token=<token> --planId=<planId>
node （请参考skill目录中的脚本文件） --token=<token> --designId=<designId2> --styleId=<styleId2> --autoDesign=true
node （请参考skill目录中的脚本文件） --obsDesignId=<designId2> --xToken=<token> --quality=hd
# .
# 生成对比报告
python3 （请参考skill目录中的脚本文件） \
  --proposals ./proposals/ \
  --output comparison_report.md

场景二:房地产样板房批量设计

房地产开发商需为样板房的多个房间批量生成高清渲染图。

# 批量渲染多个房间
python3 （请参考skill目录中的脚本文件） \
  --designId <designId> \
  --rooms "客餐厅,主卧,次卧,书房,厨房" \
  --quality 4k \
  --parallel 5 \
  --output ./renders/
# .
# 批量生成全景图
python3 （请参考skill目录中的脚本文件） \
  --designId <designId> \
  --rooms "客餐厅,主卧,次卧" \
  --output ./panoramas/

场景三:团队协作设计方案

设计团队需协同完成一个大型项目,使用团队协作与版本管理。

# 创建团队项目
python3 （请参考skill目录中的脚本文件） create \
  --name "万科未来城样板房" \
  --team "design-team-a"
# .
# 提交方案版本
python3 （请参考skill目录中的脚本文件） \
  --project "万科未来城样板房" \
  --designId <designId> \
  --message "v1.0 现代简约方案" \
  --reviewer alice
# .
# 团队成员拉取与审核
python3 （请参考skill目录中的脚本文件） --project "万科未来城样板房"
python3 （请参考skill目录中的脚本文件） --pr 42 --action approve --comment "风格统一,通过"

不适用场景

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

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

触发条件

、品牌视觉时使用。不适用于非本工具能力范围的需求。

快速开始

领先步:配置企业 token

// .kjlconfig.json
{
  "access_token": "your_pro_token",
  "edition": "pro",
  "team_id": "your_team_id"
}

第二步:版本校验

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

第三步:启动多方案设计

# 多方案并行生成
python3 （请参考skill目录中的脚本文件） \
  --planId <planId> \
  --styles "现代简约,北欧风,新中式" \
  --parallel 3

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤。

示例

专业版完整配置:

// .kjlconfig.json
{
  "access_token": "your_pro_token",
  "edition": "pro",
  "team_id": "your_team_id",
  "default_render_quality": "4k",
  "default_parallel": 5,
  "custom_styles_repo": "git@team:styles-repo"
}

# 高级参数
--quality standard|hd|4k        # 渲染画质
--parallel <n>                  # 并发数(1-10)
--multi-style <style1,style2>   # 多方案风格
--batch-rooms <room1,room2>     # 批量渲染房间
--team-project <name>           # 团队项目名

优选实践

1. 多方案先布局后渲染:多方案先生成布局对比,选定后再渲染,节省渲染时间
2. 批量渲染分优先级:按房间优先级(客餐厅→主卧→次卧)排序,关键房间优先
3. 4K 用于展示印刷:客户展示与印刷物料用 4K,内部评审用高清即可
4. 团队命名规范:统一方案命名(如 {项目}_{户型}_{风格}_{版本}),便于管理
5. 版本审核流程:关键方案需经团队审核后再交付客户,保证质量
6. 自定义风格沉淀:将优质自定义风格入库,团队复用提升效率

常见问题

Q1:专业版与免费版是否兼容?

A:完全兼容。专业版支持免费版所有流程与脚本,迁移时仅需更换 token 并设置 edition=pro。

Q2:多方案并发生成会冲突吗?

A:不会。每个方案独立创建 designId,互不影响。并发数受 API 限制(最高 10)。

Q3:4K 渲染时间多久?

A:4K 渲染约需 5-10 分钟/房间,批量渲染时建议并发 3-5 个,避免超时。

Q4:自定义风格如何导入?

A:在酷家乐平台创建自定义风格后,获取 styleId,在脚本中传入即可。支持团队风格库共享。

Q5:团队协作支持多少人?

A:License 绑定团队席位,支持 5-50 人团队(视授权规模)。支持角色权限管理。

Q6:能否集成到 CRM 系统?

A:可以。通过 API 可集成到装修公司 CRM 系统,实现客户→户型→方案→渲染的自动化流程。

依赖说明

运行环境

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

依赖详情

依赖项	类型	是否必需	获取方式
酷家乐 Pro API	外部 API	必需	企业服务渠道申请
Node.js 16+	运行时	必需	官方安装
Python 3.9+	运行时	必需	官方安装
axios	HTTP 库	必需	npm install axios
Git	版本控制	必需	系统自带

API Key 配置

• 配置文件: .kjlconfig.json(项目根目录)
• 字段名: access_token(企业版 token)
• 附加字段: edition=pro、team_id
• 获取方式: 通过企业服务渠道申请,享有高优先级渲染队列
• 安全建议: 配置文件加入 .gitignore,token 使用密钥管理服务存储

可用性分类

• 分类: MD+execute(纯 Markdown 指令,核心功能需要 exec 命令行执行能力)
• 说明: 基于Markdown的AI Skill,支持多方案对比、批量渲染、团队协作等企业级室内设计场景

错误处理

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

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

输出格式

{
  "success": true,
  "data": {
    "result": "酷家乐设计-专业版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "kujiale design pro"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。