Metadata-Version: 2.4
Name: floorplan-recognition-kit
Version: 0.2.0
Summary: Offline CAD preparation, semantic floor plan delivery and HTML preview
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: floorplan-scene==0.2.0
Requires-Dist: pillow<12,>=10.1
Requires-Dist: resvg-py<0.6,>=0.5
Provides-Extra: cad
Requires-Dist: ezdxf==1.4.4; extra == "cad"
Requires-Dist: PyMuPDF==1.28.2; extra == "cad"

# Floorplan Recognition Kit

本地户型识别交付工具：图片/CAD 准备、SVG 审图、多平面转换、FPI/Legend/meta 与离线 HTML 预览。不调用模型、不连接工作台；识别由加载 Skill 的助手完成。

```sh
floorplan-recognition prepare plan.png --output prepared
floorplan-recognition convert --manifest raw/manifest.json --inputs prepared/inputs.json --output result
floorplan-recognition review --svg raw/plan.svg --out review
```

第二步的 raw/manifest.json 与 SVG 由助手按 Skill 协议生成。安装 `[cad]` extra 后可准备 DXF；DWG 还需要 PATH 中的 `dwg2dxf`。首次环境准备后复用解释器。

交付 `preview.html`、`meta.json`、每个平面的 `preview.svg`、`floorplan.fpi.json`、`floorplan.legend.json`；原始识别文件仅内部归档，不默认交付。HTML 离线打开，无服务/CDN 依赖。内嵌 prepared 原图，支持原图/SVG/叠合/并排对照；有效映射才允许叠合。支持构件悬停高亮、属性提示、点击选中与 Esc 清除；使用随包附带许可证的 DOMPurify 和 Floating UI。

退出码：0 全部产物完成，2 部分完成，1 全部失败或命令输入错误。warnings 与未知属性不直接使转换失败。不覆盖既有交付目录。
