装修一条龙助手

概述

装修一条龙 Renovation One Stop

Overview

用户输入城市、装修需求、工装/家装、风格与平面图，本技能完成三件事：

1. 分析平面图，提取户型结构；
2. 生成装修效果图（默认 AI 文生图，可选专业渲染 API）；
3. 联网检索当地设计公司、施工与装修材料商家，输出可咨询的链接清单。

When To Use

• 用户发来平面图并说「帮我出装修效果图」「装修一条龙」「推荐装修公司」。
• 用户明确工装（餐饮/办公/零售/酒店）或家装，并给城市与风格。
• 用户要找某城市的装修材料、主材、设计事务所。

Inputs（必须采集）

缺平面图或城市时，先向用户索取，不要猜测。

Workflow

Step 1 · 采集与确认

汇总上述字段，复述一遍让用户确认。风格缺失时调用 references/styles.md 给 2–3 个推荐。

Step 2 · 预算与工期测算（出图前先算账）

效果图决定用户喜不喜欢，预算决定用户敢不敢动工。 两张图都要给。

SK=~/.workbuddy/skills/renovation-one-stop

# 家装：南宁 100㎡ 中档全包
python3 $SK/scripts/estimate_budget.py --city 南宁 --area 100 --tier mid

# 半包（主材自购）加 --mode half；只排工期加 --schedule-only
# 工装：南宁 200㎡ 餐饮店中档
python3 $SK/scripts/estimate_budget.py --city 南宁 --area 200 --type fnb --tier mid

脚本输出：单价区间、费用结构、不可预见费（默认 8%，必留）、合计区间、硬装工期与关键路径（家装含通风散味，工装含消防报审与验收）。

向用户交付时必须附这句提醒：

低于下限要警惕偷工减料，高于上限要核对是否被溢价。

配套资料：

• references/budget_baseline.md — 城市档位系数、家装/工装各档次单价、费用结构、增项漏项清单、省钱优先级
• references/schedule.md — 家装十道工序工期表、工装五业态工期表、三个挤爆工期的变量

若用户给了预算上限：用脚本反推可承受档次，超出时明确告知并给出降档方案（按 budget_baseline.md 的「省钱优先级」砍，不要平均砍）。

Step 3 · 平面图分析

用 Read 工具读取平面图图片（多模态），提取：

• 户型结构（几室几厅 / 工装功能区划分）
• 各房间功能、面积估算、朝向、门窗位置、动线
• 可改造点与限制（承重墙、管道位）

输出一段结构化「户型摘要」，供 Step 4 拼提示词。

Step 4 · 生成效果图

默认采用 AI 文生图通道（无需任何外部凭证，立即可用）。若后续接入专业渲染服务（如三维家）并已配置环境变量，可改用 scripts/render.py走真实渲染（见下方「可选增强」）。

通道 A — AI 文生图（ImageGen，零配置，默认）：

1. 读 references/rendering_prompts.md 取提示词结构；
2. 从 references/styles.md 取风格关键词、配色、材质；
3. 把 Step 3 户型摘要 + 风格拼成英文 prompt；
4. 调用 ImageGen，按房间逐间生成（家装：客/卧/厨/卫；工装：门面/营业区/后勤）。

中文不要直接进 prompt。 FLUX/SD 类模型吃中文会生成乱码文字。

用下方 render.py --dry-run 可自动把中文户型描述翻译成英文并预览（不消耗额度）。

通道 B — 第三方图像模型（scripts/render.py，需自备 Key）：

适合批量出图、固定模型保持风格一致、或走图生图（以平面图/实景图为条件）。

SK=~/.workbuddy/skills/renovation-one-stop

# 先看要发什么（强烈建议先跑，不花钱）
python3 $SK/scripts/render.py --rooms "客厅,主卧" --style "原木风" 
  --layout "三室两厅100平，客厅南向落地窗，层高2.8米" --dry-run

# 真实出图（需 export RENOVATION_IMAGE_KEY=...）
python3 $SK/scripts/render.py --rooms "客厅,主卧,厨房" --style "原木风" 
  --layout "三室两厅100平，客厅南向落地窗" 
  --provider siliconflow --save-dir ./效果图

# 图生图：以平面图或实景图为条件
python3 $SK/scripts/render.py --rooms "客厅" --style "轻奢" --ref plan.jpg 
  --provider siliconflow --save-dir ./out

支持硅基流动 / 智谱 / 通义万相 / Stability / Replicate / 自建端点，配置与对比见 references/image_api_setup.md。

旧版的三维家、酷家乐分支已移除 —— 两家开放平台都要求企业资质才能申请凭证，

个人无法使用，旧代码里是跑不通的占位骨架。

回落规则：render.py 退出码 2（未配置凭证）或 3（调用失败）时，自动回落到通道 A。通道 B 失败不会阻塞流程，永远有图可出。

两种通道产出的图片都用 present_files 展示给用户。

Step 5 · 链接商家与设计公司

读取 references/merchant_search.md，按城市 + 工装/家装 + 品类并行 WebSearch：

• 设计公司 / 工装设计事务所
• 施工整装
• 主材商家（瓷砖/地板/定制/卫浴/涂料/软装，按风格倾向选 2–3 类）

抽取 名称/类型/擅长/区域/联系/亮点/来源，按三类分组去重。结果稀疏时放宽风格词或改用邻近城区。

Step 6 · 汇总交付

向用户输出：

1. 预算与工期表（Step 2 产出，最先给 —— 用户先看钱再看图）；
2. 效果图（present_files 展示）；
3. 商家清单（表格/卡片，含咨询链接）；
4. 一段可直接发给商家的咨询话术（见 merchant_search.md），用用户真实信息填空；
5. 避坑清单（见 references/pitfall_checklist.md）——随交付一并给出，包含：
   • 签约三条硬红线（闭口合同、预付≤30%、尾款留 10%）
   • 合同必须写进去的六条（工期违约金、增项确认制、材料型号、质保、安全、费用归属）
   • 五个必须到场的验收点（材料进场、水电打压、闭水 48h、贴砖空鼓、竣工）
   • 常见套路识别表

水电管线走向必须拍照录像存档 —— 最容易被忽略、后期最救命的一件事，交付时要单独强调。

不替用户下单或代付款，仅提供信息与咨询入口。

Resources

• references/styles.md — 装修风格词典（关键词/配色/材质/商家匹配）
• references/budget_baseline.md — 城市档位系数、家装四档/工装五业态单价、费用结构、增项漏项清单、省钱优先级
• references/pitfall_checklist.md — 签约三条红线、合同六条、五个验收点、常见套路识别、工装专属三条
• references/schedule.md — 家装十道工序工期表、工装五业态工期表、面积与季节修正、进度管控三条
• references/merchant_search.md — 商家搜索策略与咨询话术
• references/rendering_prompts.md — 效果图提示词模板与多视角清单
• references/image_api_setup.md — 出图通道说明、服务商对比、API Key 配置三步走、提示词工程原理
• scripts/estimate_budget.py — 预算与工期测算器（纯标准库，无依赖；支持 –json / –schedule-only）
• scripts/render.py — 效果图生成器（多模型文生图/图生图，内置中译英与负向词；--dry-run 预览不耗额度；退出码 2/3 回落通道 A）