portrait_image_breakdown

Portrait Image Breakdown 是一个为人像拍摄现场设计的桌面工具，聚焦三个实际问题：分析照片中人物的2D姿态、朝向、取景与构图；把分析转化为简短、具体、可直接向模特说出的现场指令；以及将参考图与当前图进行对比，给出姿态、主体位置和构图方面的调整建议。 主界面只有三个页面：2D 分析、现场指令、图片对比，工作流优先服务于拍摄时的即时判断，而不是摄影参数的理论推导。2D 分析页右上方还提供一个独立打开的3D重建工具，用于探索图片可能对应的相机与场景假设。该模块明确区分观测值（Observed）、估计值（Estimated）和未知项（Unknown），避免把单张图片的推断当作精确测量。 项目使用 Python 3.12+，通过 uv 管理依赖，支持 .jpg、.jpeg、.png、.bmp 和 .webp 图片，可在2D页面点击画布或拖入照片。代码分为 core（2D姿态、构图与现场指令）、gui（三个主页面与可选3D窗口）、reverse_engineering（与主流程隔离的可选3D推理模块）等部分，并提供 pytest 测试和 PyInstaller Windows 打包配置。