前言¶

在室內方案溝通裏，常見做法是反覆在 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