拿自家户型试一次，8 分钟：house-plan-designer 怎么接住 floorplan-3d 没做的那一步
它是什么 装进 Claude Code 或 Codex 的一个 Skill，给它一张户型图，它生成一个双击就开的装修设计器网页，带 3D 漫游、水电管线、报价和施工图。
为什么火了 floorplan-3d 被大号推火后，大家都想「换成我家的户型」，它正好用 Agent 做了这一步；再加一篇多平台同发的实测文和一个月三次大更新，一波波涨星。
C你可以怎么跟 别再做户型，学它的套路：盯住下一个刚火、只能看示例的 demo，用 Agent Skill 做「换成你自己的数据」那一步，或者换成英文户型、换到别的行业。
- 数据(每天更新) · 建库 2026-10-06 · 396 星 · 7 天 +131
GitHub · 星数 数据 2026-10-14 → 2026-11-08(26 天,26 次观测)。10-28 以前的点来自 deeply / 存档补录,不是每天都有
house-plan-designer 是一个给 Claude Code、Codex 这类 Agent 用的 Skill：扔进去一张户型图，说一句话，它还你一个双击就能打开的装修设计器网页。31 天 359 颗星，只有它「前辈」floorplan-3d 的十分之一，但 fork 率高、涨得稳，而且每一波上涨都找得到原因。这条路能学的是打法，户型这个题本身已经挤了。
10 月 23 日，一个三室两卫
10 月 23 日，少数派上出现一篇《装修也有"不烧心"版本了？这个开源AI项目，我拿自家户型试了试》。作者「熊猫不是猫」平时写 NAS 专栏，这次他把自家三室两卫的户型图交给 Codex，只说了两句话：先「安装这个 skill」，再「把这张户型图做成装修设计器网页」。
装依赖、检查浏览器都是 Codex 自己弄的。8 分多钟后，他拿到一个约 1.4MB 的 HTML 文件，用 Chrome 打开：9 个空间、60 件家具、套内净面积 120.47㎡，能切 3D 鸟瞰、第一人称漫游，水电点位单独一层，报价板块按方案算出一份工程量清单。他的评价是「有点贝壳的 VR 看房的感觉」。
同一篇文章前一天发在什么值得买，同一周又出现在腾讯云开发者社区和知乎专栏。仓库那几天的星数：10-22 是 80，10-24 是 147。
它到底做了什么
仓库 10 月 6 日建，作者 ZWD11 只有这一个公开仓库，17 个关注者。README 第一句：「一张户型图（或一份 CAD 图纸），一句话，Agent 就把它还原成可 2D / 3D 直接设计的装修设计器网页。」
活是分工做的：模型负责看图，脚本负责量墙、补门窗、摆家具，再把结果叠回原图对一遍账，最后打包成一个离线 HTML。里面不止好看的 3D：
- 插座、照明、网线、冷热水、排水 5 类管线自动排，号称参照国标，开关按「门把手一侧、不装门后」的施工规矩布；
- 能导出国标 DXF 施工图，能算量报价，单价可改；
- 交付前自动做墙体、尺寸链、家具摆放三个对账；
- 后来还加了办公楼层、黑底 CAD 截图识别、吊顶灯带、光线追踪出图。
有一点要注意：生成出来的设计器是编译好的，源码（TypeScript + Vite + three.js）不在仓库里，issue 里已经有人在问。
它为什么火了：有人先把需求教育好了
9 月 29 日，wy51ai/floorplan-3d 上线：一个单文件的 2D/3D 户型设计器，好看、能漫游。10 月 1 日 GitHubDaily 在 X 上推了它，3.81 万浏览、592 收藏，之后一堆中文站转载，到 11-06 它有 3,582 星。
但它的户型是写死在代码里的示例。README 自己说「改几组房间和墙体数据就能换成自家的」——对大多数看热闹的人来说，这句话等于「换不了」。所以看完的第一反应几乎都是：怎么换成我家的？
5 天后 house-plan-designer 建库，做的正好是这一步，而且交给 Agent 做。作者没说过是受它启发，这一条是推断，但时间线和定位都对得上。再叠上今年中文圈 Claude Code / Codex Skill 的热潮，「装一个 Skill、扔一张图」本身就好传播。
星是怎么涨上来的
| 时间 | 发生了什么 | star |
|---|---|---|
| 10-06 ~ 10-17 | 建库，几乎没人看 | 到 10-17 才 27 |
| 10-20 ~ 10-24 | 10-22 大更新（水电管线自动排、光线追踪）；熊猫的实测文 10-22 发什么值得买、10-23 发少数派等 | 4 天从 34 到 147 |
| 10-28 | 大更新：办公/商业楼层、DXF 对账 | 单日 +35，最高的一天 |
| 10-30 | linux.do 有人发帖问「有没有好用的室内装修平台，或者skill」，回帖里有人推荐它 | 每天 +7 ~ 15 |
| 11-02 ~ 11-05 | 大更新：跨平台、黑底 CAD 截图、三个对账 | 每天 +17 ~ 26 |
数字来自 GitHub 逐日 star 记录（10-17 起）。11-06 是 359 星、67 fork；fork 率接近 19%，同类展示型仓库一般 5–10%，说明很多人是真拿去跑自家户型的。issue 里「我家要中央空调」「想换瓷砖贴图」这种需求也印证了这一点。
它没上过 GitHub trending（建库不满 60 天），只在 10-23 进过 Trendshift HTML 语言榜第 24 名；X 上没找到大号转发，GitHubDaily、阮一峰周刊都没写过；B 站、小红书、抖音上没查到视频（查不到不等于没有）。熊猫那篇是自发还是约稿，没核实。
规律很清楚：一篇实测文 + 每次大更新配新截图和更新日志，各带一波。
谁在跟它抢
| 项目 | 上线 | 体量 | 和它的区别 |
|---|---|---|---|
| wy51ai/floorplan-3d | 9-29 | 3,582 星 / 748 fork，近 7 天 +358 | 示例户型写死，不读图 |
| 酷家乐智能设计 Skill | 2026（API Beta） | 平台级 | 上传户型对话出方案，但在酷家乐云端、走它的账号计费 |
| egmalt/house-planner | 10-01 | 372 星 | 自托管，人手画平面，不读图 |
| interior-design-master | 10 月 | Threads 帖 1.07 万浏览 | 平面图 + 风格出 3D 效果，没有水电和施工图 |
| SkillHub interior-design-assistant、JasonZhu 的户型→3D 提示词 | 10 月 | 未核实 | 一个偏文字方案，一个一次性出漫游页 |
| Sweet Home 3D、react-planner、三维家、知户型 | 早年 | 开源几百到一千多星，商业 App 体量大 | 传统手画工具 |
「户型 → 3D」在 10 月是个扎堆的题目，都是追 floorplan-3d 那波。house-plan-designer 是其中唯一把「读图→量墙→自检→布水电→出施工图」整条流程做成 Skill 的。没看到有人照着它抄。
做得这么深，为什么星只有十分之一
floorplan-3d 一张动图就能让人点星；house-plan-designer 的好处——量墙准、管线合规、DXF 能给施工队——要自己跑一遍才知道。看仓库的人大多不会跑。
所以它的深度换来的是高 fork 率和测评作者的好评，不是星数。想要星，冲击力比流程深度好使；想要「真有人在用」，深度才有用。这是这个项目最值得记住的一点。
如果是你
判断： 学它的打法，别再做户型。「户型→3D」已经挤满，floorplan-3d 吃掉了大头，house-plan-designer 把工程化做到 105 项验收也只拿到 359 星；第 N 个进去，很难超过它。
适合谁： 会写 Agent Skill、对某个行业有真懂行的细节（像这里的国标管线、开关位置），能每周出一次像样更新的个人开发者。
不适合谁： 想靠一个 demo 一夜几千星的；不愿意写大量脚本做校验、只想写一段提示词的——那一层已经有人免费放出来了。
怎么做： 盯住下一个刚被 GitHubDaily 这类大号推火的「好看但只能看示例」的 demo，做它缺的那一步「换成你自己的」，交给 Agent 做：模型看输入，脚本负责量、校验、打包，产出一个双击就开的文件。可以换领域（电路图、园林平面、展位布置、PCB、家谱），也可以换人群：做一个读英文户型图、用英尺、出美国常见格式的版本——英文圈有没有人做，没核实，动手前先搜一下。
怎么获客： 找一位有自己专栏的测评作者用他自己的真实数据跑一遍，一篇文同时发少数派、什么值得买、知乎；每次大更新配一套新截图和更新日志；去 linux.do 这类开发者社区答「有没有好用的 xx skill」的帖子。
什么时候之前： 源头 demo 被推火后 1–2 周内建库。house-plan-designer 只晚了 5 天，正好赶上大家问「怎么换成我家的」。
什么情况说明看错了： ① house-plan-designer 一个月内自然涨过 2,000 星——说明深度也能换来星，户型这个题还有空间；② 有人做了英文版户型 Skill，一个月过千星——说明换人群这条路是空的，值得马上跟；③ 作者把设计器源码收回、转成收费产品，fork 的人不再更新——说明这类 Skill 的热度只是一阵。
数据与出处：GitHub 仓库页、README 与 issues，逐日 star 记录（10-17 至 11-06）；trendshift.io/repositories/315706；GitHubDaily X 帖（10-01）；wy51ai/floorplan-3d 仓库页；少数派 sspai.com/post/117175（10-23）、什么值得买（10-22）、腾讯云开发者社区、知乎专栏；linux.do/t/topic/3098556（10-30）；kujiale.com/skills；egmalt/house-planner 仓库页。
研究底稿:竞品表、获客证据、完整研究报告
- 竞品
名字 在哪 上线 规模 它和这家不同在哪 wy51ai/floorplan-3d 开源 2026-09-29 3582 star / 748 fork 手工写死示例户型的单文件设计器，换户型要自己改代码；它让 Agent 读图自动生成 酷家乐智能设计 Skill 大厂功能 2026（API Beta） 酷家乐平台级 云端出渲染图和方案，走酷家乐账号与计费；它交付本地离线、可继续编辑的 HTML，免费开源 egmalt/house-planner 开源 2026-10-01 372 star 自托管、人工手画平面，不读图 interior-design-master（akseolabs-seo） 开源 2026-10 Threads 帖 1.07 万浏览 偏 3D 渲染效果，没有施工图、水电、DXF 和对账流程 interior-design-assistant（SkillHub） 其他 2026-10 未核实 文字类户型解读/预算/方案文档，不产出可交互设计器 JasonZhu.AI 户型图→3D 漫游提示词 网页 2026-10-13 未核实 一段提示词一次生成，没有量墙、自检、工程产出 openPlan3D / react-planner / Sweet Home 3D / 知户型 / 三维家 其他 早年 开源 270–1500 star；商业 App 体量大 传统手画户型工具，不读图、不用 Agent - 用户从哪来
- 推断 蹭 floorplan-3d 热度（GitHubDaily 10-01 X 帖 3.81 万浏览）引起的需求:floorplan-3d README 写「改几组房间和墙体数据就能换成自家的」；它 10-06 建库，做的正是这一步
- 查实 中文测评文章同时发多个平台:熊猫不是猫的实测文 10-22 发什么值得买、10-23 发少数派/腾讯云/知乎；对应 10-22 到 10-24 +86 星
- 查实 大版本更新:更新日志 10-22、10-28、11-02 三次大更新，和 10-23、10-28（+35）、11-03 到 11-05 三段涨星吻合
- 查实 社区口碑 linux.do:10-30 帖《有没有好用的室内装修平台，或者skill》（289 浏览）回帖里有人推荐
- 查实 Skill 目录/聚合站:seoagent skill-grader 评 A 级，LinkedIn 10-19 转发；Trendshift HTML 榜 10-23 第 24 名
ZWD11/house-plan-designer：为什么能跑出来
一张户型图（或 CAD 图纸）加一句话，Agent（Claude Code / Codex 等）把它还原成一个双击即开、离线可用的单文件 HTML 装修设计器：2D 布置、3D 漫游、水电管线自动排布、算量报价、国标 DXF 导出。 仓库：github.com/ZWD11/house-plan-designer（MIT，2026-10-06 建，HTML）
一、数据速览
| 项 | 数值 | 来源 |
|---|---|---|
| star / fork | 359 / 67（11-06 卡片）；GitHub API 当天下午 371 / 68 | 数据卡、GitHub API |
| 近 7 天 / 前 7 天 | +131 / +115，温和加速 | 数据卡 |
| 单日最高 | +35（10-28） | 数据卡 |
| fork 率 | 约 18.7%（同类展示型仓库通常 5–10%），说明很多人真的拿去装、去改 | 数据卡 |
| 作者 | ZWD11，只有这 1 个公开仓库，17 个粉丝；博客 blog.zwdblog.online（小小松）专写「GitHub 上又火了一个 xx」类介绍文 | GitHub API、博客首页 |
| GitHub trending | 从没上过（建库不满 60 天，按规则进不了）；Trendshift 只在 10-23 进过 HTML 语言榜第 24 名 | 数据卡、trendshift.io/repositories/315706 |
| issue | 4 个（要中央空调、要换瓷砖贴图、问设计器源码在哪、一个跨平台修复 PR） | GitHub issues |
逐日曲线（数据卡）：10-17 才 27 星，即头 11 天几乎没人看；10-20 到 10-24 从 34 跳到 147（4 天 +113）；10-28 +35；11-01 +22；11-03 到 11-05 每天 +17 到 +26。
二、竞品：做同一件事的都有谁
| 名称 | 在哪 | 上线 | 规模 | 和它的不同 |
|---|---|---|---|---|
| wy51ai/floorplan-3d | 开源（单 index.html） | 2026-09-29 | 3582 star / 748 fork（github 库 11-06），近 7 天 +358 | 一个手工写死示例户型的单文件 2D/3D 设计器；README 写明「户型数据就写在这个文件里，改几组房间和墙体数据就能换成自家的」。不能读图，换成自家户型要自己改代码。house-plan-designer 正好把「改成自家户型」这一步交给 Agent 自动完成 |
| 酷家乐智能设计 Skill | 大厂功能（kujiale.com/skills，API Beta） | 2026 年（抖音教程 10-06 已有） | 酷家乐平台级 | 上传户型图对话出全屋方案、渲染图、全景图，但结果在酷家乐云端、走它的账号与计费；house-plan-designer 交付的是本地离线 HTML，可继续编辑，免费 |
| egmalt/house-planner | 开源（自托管 React+PHP） | 2026-10-01 | 372 star（github 库） | 手画真比例平面 + 3D + 卫星图 + 管线算量，人自己画，不读图；homedesignsai.pro 团队出品 |
| interior-design-master（akseolabs-seo，Threads @darkseoking） | 开源 Skill / Prompt | 2026-10 | Threads 帖 1.07 万浏览 | 平面图 + 风格 → Agent 生成 3D 空间；台湾繁中圈，偏渲染效果图，没有施工图、水电、DXF |
| interior-design-assistant（SkillHub） | Skill 市场 | 2026-10（夜雨飘零博客 10-20 介绍） | 未核实 | 偏文字：户型解读、选材、预算、方案文档，不产出可交互设计器 |
| JasonZhu.AI「户型图生成的 3D 可漫游住宅」Opus 5.5 提示词 | 网页提示词 | 2026-10-13 | 未核实 | 一段提示词让模型一次性生成 3D 漫游页，没有量墙、对账、施工图这些工程化流程 |
| V2EX 在线户型图编辑器（帖 1251061） | 网页 | 2026-10-22 | 未核实 | 人手精确绘图 + 4000 家具 + DXF 导出，不是 Agent 读图 |
| openPlan3D、react-planner、arcada、Sweet Home 3D、知户型、三维家 | 开源 / App / 桌面软件 | 早年 | 270–1500 star；商业 App 体量大 | 传统手画户型工具，不读图 |
结论：「户型 → 3D 设计器」在 2026-10 是个扎堆的题目，起因是 floorplan-3d 9 月底被 GitHubDaily 推火。house-plan-designer 是这一波里唯一一个把「读图→量墙→自检→布水电→出施工图」整条流程做成 Agent Skill 的开源项目。
三、增长手段：用户从哪儿来
- 蹭 floorplan-3d 引起的需求（时机）：GitHubDaily 10-01 在 X 发帖推 wy51ai/floorplan-3d（3.81 万浏览、592 收藏，x.com/GitHub_Daily/status/2105651520557678731）；随后 lvruan、itimo、appmiao、新浪微博、go176、hqyman 等 10-01 到 10-20 一路转载。很多人看完的第一反应是「怎么换成我家的户型」。house-plan-designer 10-06 建库，回答的就是这个问题。原作者没有承认受它启发，这一条是推断，但时间线和产品定位都对得上。
- 中文测评文章同时发多个平台（已证实，最大的一波）：作者「熊猫不是猫」（专栏「NAS原来这么有用」）写的《装修也有"不烧心"版本了？这个开源AI项目，我拿自家户型试了试》，10-22 发在什么值得买（post.smzdm.com/p/am9399wv），10-23 发在少数派（sspai.com/post/117175）和腾讯云开发者社区（developer.cloud.tencent.com/article/2767784，282 阅读），还转到了知乎专栏（zhuanlan.zhihu.com/p/2097008301384929892）。文章是实测：用 Codex 装 Skill，8 分多钟拿到 1.4MB 的 HTML，120㎡、60 件家具、报价 14.4 万。这和曲线上 10-22 到 10-24 的 +86 星完全对上。熊猫和作者是否有合作，未核实。
- 大更新带动的涨星（已证实时间吻合）：README 更新日志写了 10-22（水电管线自动排布、光线追踪）、10-28（办公/商业楼层、DXF 对账）、11-02（跨平台、黑底 CAD 截图、三个对账）三次大更新；这三天前后正好是 10-22/23、10-28（+35，单日最高）、11-03 到 11-05 三段涨星。
- 社区口碑（已证实）：linux.do 10-30 帖《有没有好用的室内装修平台，或者skill》，289 浏览、12 赞，回帖里有人推荐了本仓库（linux.do/t/topic/3098556）。
- Skill 目录与聚合站（已证实，量小）：seoagent.com skill-grader 给了 A 级（257 个里排第 69），LinkedIn 10-19 有转发；Trendshift 收录。
- 作者自己的博客：作者的博客专写 GitHub 热门项目介绍，但首页没看到写自己这个项目的文章。X（x-radar 本地语料）上没搜到提到它的帖子，没找到大号转发。
没找到付费投放、TikTok、小红书、B 站的证据（查不到不等于没有）。
四、它为什么跑出来
- 需求被别人先教育过：floorplan-3d 9 月底拿了 3500 多星，证明「单文件 HTML 户型 3D 设计器」很戳人，但它只能看示例户型。house-plan-designer 解决的就是「换成我家户型」这一步，读图、改数据这种最费劲的活交给 Agent。
- 踩中 Skill 热潮：2026 年中文圈 Claude Code / Codex Skill 正火（huashu-design 1.7 万星、各种「一句话出 xx」Skill），「装一个 Skill，扔一张户型图」本身就容易传播。
- 产出能马上看到、马上动手：结果是一个 1.4MB 的 HTML，双击就开；测评作者用自家户型 8 分钟跑通。高 fork 率和 issue 里「我家要中央空调」这类需求，都说明真有人在拿自家户型试。
- 做得深，像在交付工程：不只是好看的 3D，还有国标 DXF、5 类管线（参照 GB 50096/50311/50242/50015）、开关装在门把手一侧、墙体/尺寸链/家具三个对账、105 项验收。中文装修用户最关心的水电、报价、施工图都有，这让它和「一段提示词出 3D」的同类拉开了距离。
- 更新快而且密：一个月三次大版本，每次都写清更新日志、配新截图，每次更新都带来一波涨星。
五、差异化
和 floorplan-3d、openPlan3D 这些「人自己画/改」的工具比，它是 Agent 读图自动还原；和酷家乐 Skill 比，它是 本地离线 HTML + 免费开源 + 能继续编辑；和其他「户型→3D」提示词或 Skill 比，它有 工程化的读图管线（cadvec/analyze/axismap 量墙、check.mjs 叠回原图对账）和 施工级产出（水电、DXF、报价）。这个差异化正是它的起量原因：测评文章讲的就是「拿自家户型真跑通了」，而不是「demo 好看」。不过 star 的绝对量（359）只有 floorplan-3d 的十分之一，说明 demo 的冲击力还是比流程深度更容易拿 star。
六、看见度与跟风
- 看见度：小圈子里在传。依据：少数派、什么值得买、腾讯云、知乎各一篇（同一作者同一篇文章）、linux.do 一帖、Skill 评级站一条；X 大号、GitHubDaily、阮一峰周刊都没写过（检索范围内）；没上过 trending。开源项目不赚钱，没有收入公开这回事。
- 跟风：没发现直接抄它的 fork 或改名项目；但同期出现了好几个类似的「户型→3D」Skill/提示词（interior-design-master、JasonZhu 提示词、SkillHub interior-design-assistant），更像是一起追 floorplan-3d 那波热度，不是抄它。
七、可借鉴
- 盯住一个刚被大号推火的 demo，做它缺的那一步：floorplan-3d 是「示例」，这个项目是「换成你的」。
- 用 Skill 包装重活：模型负责看图，脚本负责量、校验、打包，交付物是一个文件、零部署。
- 面向中文家装的真实需求（水电、报价、国标施工图），而不是只做好看的渲染。
- 每次大更新配一套新截图和更新日志，吸引测评作者、带动二次传播。
八、还不确定的
- 10-06 到 10-17 的冷启动期星从哪来、10-20 那天 +16 的来源，没查到。
- 熊猫不是猫那篇文章是自发写的还是约稿，未核实。
- 设计器源码（TypeScript+Vite+three.js）不在仓库里（issue #4 也在问），作者会不会把源码闭源、转商业，未知。
- 小红书、B 站、抖音上有没有视频在传，这次没查到证据。
- 没拿到 GitHub 的 stargazer 时间戳和 referrer 数据（stargazer 接口报 404，又碰上 API 限流），各渠道带来多少星只能靠日期对应来推断。
出处
- 数据卡 /home/ljr/fanout/why/cards/gh_ZWD11__house-plan-designer.json；github 库 repo_profile / repo_day（11-06 查询）
- github.com/ZWD11/house-plan-designer（README、更新日志、issues）
- trendshift.io/repositories/315706
- x.com/GitHub_Daily/status/2105651520557678731（10-01，推 floorplan-3d）
- github.com/wy51ai/floorplan-3d
- sspai.com/post/117175 ；post.smzdm.com/p/am9399wv/ ；developer.cloud.tencent.com/article/2767784 ；zhuanlan.zhihu.com/p/2097008301384929892
- linux.do/t/topic/3098556
- seoagent.com/skill-grader/ZWD11/house-plan-designer
- www.kujiale.com/skills ；www.threads.com/@darkseoking/post/DdYUbBpDmny ；blog.yeyupiaoling.cn/article/1792441302981 ；jasonzhu.ai/zh/prompts/claude-opus-5-5/2110036224320884998
- blog.zwdblog.online