前言¶

在室内方案沟通里，常见做法是反复在 CAD、效果图工具和聊天里切换：先对齐户型，再谈风格，再改布局，最后才等渲染。每一步都要人记上下文，Agent 也容易跳过确认直接给结论。下面介绍 SkillHub 上的「酷家乐智能设计」，把流程收成「户型确认 → 风格选择 → 布局确认 → 渲染出图」四段对话，并由脚本对接酷家乐侧接口。

这是什么¶

「酷家乐智能设计」是面向室内智能设计的 Agent Skill（坐标 @user_b14347c4/ai-kujiale-design，当前版本 0.0.6，分类 design-media，来源为 community，发布者为 user_b14347c4）。SKILL 元数据中作者标注为 ManycoreTech。

它解决的是：在对话里按固定阶段推进装修设计，调用 scripts/ 下的 Node 脚本完成户型检索或临摹、创建方案、选风格、触发布局与渲染，并按约定模板输出效果图与链接。SkillHub 页面标注 requires_api_key=true，实际配置为项目内的酷家乐 access_token。

官方入口：

• SkillHub 展示页：https://www.skillhub.cn/skills/user_b14347c4/ai-kujiale-design
• 资源地址：https://api.skillhub.cn/user_b14347c4/ai-kujiale-design

（SkillHub 统计：评分 100000，下载 10357，安装 35。）

核心功能¶

依据 SKILL.md 与包内脚本，已核实能力如下。

四阶段对话流程¶

1. 户型获取与确认：用户提出室内设计需求后，可走「小区名 + 城市搜索户型」，或上传户型图（临摹任务）。确认 planImage 与面积后，调用 createDesign.js 得到 designId。
2. 风格选择：getTags.js 拉取偏好标签，getStyles.js 按标签匹配硬装风格（多风格时展示封面供选择）。
3. 布局生成与确认：需先告知用户将消耗账号内智能布局额度/核豆；triggerLayout.js 触发布局，getLayoutResult.js 轮询结果并汇总各房间家具。
4. 渲染出图：trigger-render.js 触发渲染，getRenderResult.js 取渲染图（pictype=0）与全景链接（pictype=1），按 outputs/result.md 模板输出亮点、图片与方案详情链接。

配套脚本与文档¶

包内提供 searchPlan.js、getFloorplanInfo.js、getUploadToken.js、createBitmapTask.js、versionCheck.js 等脚本，并在 docs/ 下附带各接口说明（如 planSearch.md、layout.md、renderResult.md）。

运行约束¶

• 执行前需通过 versionCheck.js 校验 Skill 版本（0.0.6）。
• 进度通过 message(action=send) 反馈；Webchat 发图片链接，飞书使用 MEDIA:图片url 格式。
• 最终结果需严格遵循 ./outputs/result.md，方案详情链接格式为 https://www.kujiale.com/pcenter/design/{designId}/setting?from=skills。

安装与启用¶

1. 获取 Skill¶

在 SkillHub 打开上述展示页，按平台指引将 @user_b14347c4/ai-kujiale-design 安装到当前 Agent 可用的 Skills 目录。包内为通用 SKILL.md 格式，解压后应包含 SKILL.md、scripts/、.kjlconfig-example.json 等文件。

也可通过下载接口获取压缩包（与 SkillHub 分发一致）：

curl -L -o ai-kujiale-design.zip \
  "https://api.skillhub.cn/api/v1/download?slug=ai-kujiale-design&namespace=user_b14347c4"

解压后，将 Skill 目录加入你所用客户端的 Skills 加载路径。各客户端（Cursor、Codex CLI、Claude Code 等）的具体菜单名称以各自文档为准；本 Skill 包内未单独区分安装步骤。

2. 配置 access_token¶

首次使用需在 与 .kjlconfig-example.json 同级 的项目根目录创建 .kjlconfig.json。示例结构如下：

{
  "access_token": "your_token_here"
}

若无 token，按 SKILL 说明引导用户访问 https://www.kujiale.com/skills 生成，并将复制的值写入 access_token 字段。所有脚本调用前从该文件读取 token。

3. 环境要求¶

脚本为 Node.js 调用形式，例如：

node ./scripts/versionCheck.js --token=<token> --version=0.0.6

版本校验返回 action=1 可继续；action=2 提示更新；action=3 需重新安装 Skill。

典型用法¶

启用 Skill 后，用户用自然语言发起装修设计即可；Agent 应按 SKILL.md 严格分步执行，不得跳步。下面是与官方流程一致的可复现路径摘要。

户型（文字搜索）

1. 询问城市、小区与户型信息。
2. 执行搜索：

node ./scripts/searchPlan.js --token=<token> --query=<小区名> --areaId=<城市id> --start=0 --num=20

3. 用户选定条目后，用 getFloorplanInfo.js --planId=<planId> 展示户型图并等待「确认」。
4. 确认后：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,id2,...> --styleId=<styleId> \
  --applyDecorationStyle=true --buildCeiling=true --autoDesign=true
node ./scripts/getLayoutResult.js --token=<token> --designId=<designId>

渲染

node ./scripts/trigger-render.js --obsDesignId=<designId> --xToken=<token>
node ./scripts/getRenderResult.js --token=<token> --designId=<designId>

最终输出需包含设计亮点、按「客餐厅 → 主卧 → 次卧 → 其他」排序的渲染图、全景链接及方案详情 URL。

适用场景与注意¶

适合谁

• 需要在 Agent 对话里完成从户型到效果图闭环的产品或运营同学。
• 已具备酷家乐 Skills 侧 access_token、并接受布局环节消耗账号内智能布局额度/核豆的团队。

限制与注意

• 必须配置 .kjlconfig.json；未配置时应引导至 https://www.kujiale.com/skills 获取 token。
• 上传户型图路径依赖监听 ~\.openclaw\media\inbound 等新文件（每 5 秒检查），部署环境需与该约定一致。
• 渲染结果为空时，文档约定每分钟重试，超过 5 分钟应反馈失败。
• Skill 要求「不能自作主张发散」，阶段内确认话术与脚本参数需与 SKILL.md 保持一致。

结尾¶

「酷家乐智能设计」把室内方案拆成可核对的分步对话，并用 Node 脚本对接酷家乐户型、风格、布局与渲染能力，适合在 SkillHub 生态里做可复现的装修设计 Agent。详情与安装见：https://www.skillhub.cn/skills/user_b14347c4/ai-kujiale-design