前言¶

在 DSH 生态里做「户型 + 装修」类能力，常见做法是外挂网页或单独服务，难以和桌面端的插件装载、本地项目容器对齐。dsh-studio-floorplan 以客户端插件形式提供户型查看、空间编辑、家具布置与项目导出，并复用共享的 studio 卡片与项目容器，尽量不改动宿主应用。

这是什么¶

dsh-studio-floorplan 由维护者 1997liuyh-boop 发布，归类为 客户端 插件。仓库描述为：面向 2D 平面布局编辑、墙体变更、3D 漫游、测量与材料估价的户型与装修工作室。上游代码记录在 UPSTREAM.json，来源为 https://github.com/wy51ai/floorplan-3d。当前包版本 0.1.2，许可证 MIT。

社区目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-floorplan
源码：https://github.com/1997liuyh-boop/dsh-studio-floorplan

核心功能¶

依据仓库 README，插件当前提供的能力如下。

• 在 2D 平面图 中编辑房间、墙体、门窗与家具。
• 测量空间，估算地面材料费用，并在 3D 鸟瞰或第一人称 视图中查看结果。
• 将方案保存在 隔离的本地存储 中，支持 导出 / 导入 JSON 备份 与 PNG 图片。
• 本地打包 Three.js，发布页面不依赖 CDN 或额外服务。
• 使用共享的 studio 卡片与项目容器，无需修改宿主应用即可完成集成。

package.json 中的中文描述与之对应：2D 家具布置、墙体拆改、3D 漫游与装修估价。

安装与启用¶

安装前需先安装控制端 bundle，并在 完全退出 Desktop 后，用官方 Desktop 插件管理器安装 固定标签 的包。命令须与 README 一致（将 <Desktop install directory> 替换为实际安装目录）：

& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-library#v0.1.3"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-floorplan#v0.1.2"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop list"

校验已安装包是否暴露以下内容：main: lib/index.js、exports./client: lib/client.js、dsh.bundle.patch: ./cordis.patch.yml、static/index.html、studio.json。

重启 Desktop 后，打开 「Floor plan studio」 即可使用。

兼容性（来自 package.json）：dsh.compatibility.dsh 为 0.2.2-rc.1；engines.dsh 为 0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2。可选对等依赖包括 dsh-studio-projects、dsh-worktable。

典型用法¶

README 未给出逐步操作截图，可复现路径如下。

1. 完成上述安装并重启 Desktop。
2. 进入 Floor plan studio，在 2D 平面中调整房间、墙、窗、门与家具。
3. 使用测量与材料估价能力核对结果，必要时切换 3D 鸟瞰或第一人称查看。
4. 需要留档时 导出 JSON 或 PNG；换机或清数据前应先导出 JSON 备份。

本地存储与导出格式由插件页面能力提供，具体菜单以 Desktop 内工作室界面为准。

适用场景与注意¶

适合：需要在 DSH Desktop 内完成轻量户型编辑、简单拆改示意、家具摆放与材料粗算，且希望数据留在本地的开发者或使用者。

限制（README 明确要求）：

• 发布包使用 UPSTREAM.json 中固定的本地 Three.js 副本。
• 不会上传方案，也 不能自动识别上传的户型图。
• 清理浏览器或 DSH 数据前务必 先导出 JSON。
• 自定义房型数据需要改源码并重新构建。

安全与权限：插件随当前 DSH / Desktop 进程权限运行，安装前应在 GitHub 查阅源码、LICENSE 与 UPSTREAM.json 中的上游修订与改动说明。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系，不宜当作官方应用商店。

结尾¶

dsh-studio-floorplan 把 2D 编辑、3D 查看、估价与本地 JSON/PNG 导出收进一个客户端工作室插件，并与 dsh-studio-library 配套安装。进一步了解可访问 社区目录页 与 GitHub 仓库。