导入照片，自动识别人脸位置裁剪，换成白、蓝或红底，排满一张 6 寸相纸，然后打印或导出。
全部处理都在本机完成，照片不会上传到任何服务器，运行时也不需要联网。
- 自动裁剪 — 识别人脸位置，按规格算好头顶留白和脸部占比，不用手动对齐。水平方向不是简单地按双眼居中，而是取眼、眉、鼻翼、嘴角、下颌共 15 组双侧关键点的中点共识来定中线——观感上的「正不正」主要看鼻、嘴、下巴，光对齐眼睛是不够的。没检测到人脸时退回手动裁剪，可以拖拽、滚轮或方向键微调。
- 姿态提示 — 头部倾斜、侧脸或俯仰超过 5° 时提示重拍。只提示不代劳：把整幅照片转正会连肩线和衣领一起转歪，反而更难看。
- 换底色 — 白、蓝、红三种，也可以保持原底不动。
- 十种内置规格 — 一寸、二寸、三寸、大一寸、小一寸、大二寸、小二寸、简历照、普通话水平测试、英语四六级。
- 自定义尺寸 — 宽高各自独立输入，10–152mm。上限取 4R 相纸的长边，因为再大也排不进去。
- 6 寸相纸排版 — 自动求解一张纸能排多少张，间距和边距可调（0–20mm）。裁剪线会按成品底色自动开关：白底照片印在白相纸上看不见边，自动开启；蓝底红底则关闭。手动改过之后就听你的。
- 导出与打印 — 单张与整版相纸都支持 JPEG / PNG / PDF；也能直接调系统打印。
- 高级导出 — 单张证件照可自选格式、图像质量与输出 DPI，导出前实时预估文件大小。
全部按 300 DPI 输出。
到 Releases 页面下载对应平台的安装包。
下载 IDPhotoStudio-x.y.z-macOS-arm64.dmg，双击打开后把 ID Photo Studio 拖进「应用程序」文件夹。
首次打开会提示「无法验证开发者」，因为安装包没有做 Apple 代码签名。绕过方法：在「应用程序」里右键点击它，选「打开」，再在弹窗里确认「打开」。之后就能正常双击启动了。
如果右键仍被拦，去「系统设置 → 隐私与安全性」，在底部找到被阻止的提示，点「仍要打开」。
仅支持 M 系列芯片的 Mac。Intel Mac 暂不支持，因为依赖的 mediapipe 1.0.0 没有发布 macOS x86_64 版本。
按 macOS 的惯例，点窗口红叉只是收起窗口，程序仍在运行——点程序坞图标可以唤回，Cmd+Q 才真正退出。
下载 IDPhotoStudio-x.y.z-Windows-x64-Setup.exe，双击一路下一步。安装需要管理员权限。
SmartScreen 可能提示「未知发布者」，点「更多信息 → 仍要运行」即可。同样是没做代码签名的缘故。
- 导入 — 点右上角「导入」，或把照片直接拖进窗口。
- 选规格和底色 — 左侧挑内置规格，或填自定义尺寸；底色选白、蓝、红会在后台抠图，选「原底」则不动原图背景。
- 微调裁剪 — 中间的裁剪框可以拖动、滚轮缩放、方向键逐像素移动，也能整体旋转和切换横竖版。右下角实时显示裁剪后的像素尺寸。
- 导出或打印 — 右上「导出」存单张或整版相纸，需要指定格式、质量或 DPI 就走菜单里的「高级导出」；「打印」直接调系统打印对话框。右侧同时给出成品单张和 6 寸相纸的排版预览，以及一张纸能排几张。
换下一张照片时，点裁剪区域左上角的垃圾桶图标即可清空，已选的规格和底色会保留。
用 EPSON L805 这类照片打印机时，驱动里的纸张类型必须选光泽照片纸。选普通纸会出现竖条纹和偏色。
idphoto_cli.py 提供一条最小的批处理通路，直接产出排好版的 4R 相纸 PNG：
python idphoto_cli.py 照片.jpg 一寸 白 --output-dir out只支持内置规格，不支持自定义尺寸和直接打印——那些走图形界面。
从源码运行、跑测试、自己打包、发布新版本，都在 docs/DEVELOPMENT.md。提交约定见 CONTRIBUTING.md，版本变更记录见 CHANGELOG.md。
- 抠图 — ISNet（isnet-general-use），onnxruntime CPU 直接推理
- 人脸定位 — MediaPipe FaceLandmarker
- 界面 — PySide6