Photo Name Card Maker
本 Skill 由 kekele.hu 原创。Copyright © 2026 kekele.hu. All rights reserved. 完整说明见 LICENSE.md。
默认使用“老师一键模式”。老师正常只需要提供一项内容：
- 没有照片：选择一份 CSV 或 XLSX 花名册；
- 有照片：选择一个照片文件夹，照片文件名就是幼儿姓名。
老师已经选择花名册或照片文件夹时，禁止继续追问场景、主题、纸张、班级名、图标套系码和输出目录。老师什么都没有选择时，只问一句：
> 请选择一份花名册，或者选择一个装有幼儿照片的文件夹。
一键执行
收到一个来源后直接运行：
python scripts/quick_make.py "老师选择的花名册或照片文件夹"
quick_make.py 自动完成以下工作：
- 自动判断花名册模式或照片文件夹模式；
- 自动生成储物柜、水杯、床位、毛巾、鞋柜、作品栏和餐位七种场景；
- 自动使用 A4、自动纸张方向和彩虹主题；
- 自动从文件位置推断班级名称；
- 自动生成不暴露原路径的班级专属图标套系；
- 自动在来源旁边新建
全套姓名标识-v1、-v2等输出目录，不覆盖旧结果； - 最终固定只生成
完整打印图.png和完整打印版.pdf。
不要让老师填写命令参数，不要使用 --force，不要为了第一次生成而增加确认步骤。
两种输入
只有花名册，没有照片
花名册至少需要一列幼儿姓名。照片列和性别列可以没有。没有照片时自动使用本地绘制的卡通动物；名单中有明确性别时，男生使用蓝色系、女生使用粉色或红色系，空白或无法识别时使用中性色。不能根据姓名猜测性别。
只有照片文件夹
每张照片的文件名去掉扩展名后作为幼儿姓名，例如 乐乐.jpg、果果.png。照片文件夹没有性别字段，因此全部安全使用中性色；不能根据姓名或照片猜测性别，也不能做人脸识别。
完成后
- 告诉老师自动生成的输出目录。
- 只交付
完整打印图.png和完整打印版.pdf。 - 打开完整打印图并渲染 PDF 的每一页，检查姓名、中文字体、七个场景标题、形状、标记、照片完整性、裁切线、页边距和纸张方向。
- 确认 PDF 的每一页都出现在完整打印图中；正式打印以 PDF 为准。
- 用老师能理解的语言说明结果，不向老师展示内部命令和参数。
高级设置
只有老师主动提出“只做某个场景”“换主题”“换纸张”“指定班级图标”“自定义照片裁切”等要求时，才使用 scripts/photo_name_card_maker.py 的高级模式。此时按需读取 references/usage.md，不要把高级参数重新变成默认输入表单。
不可突破的边界
- 花名册、照片和成品默认只在本机处理，不上传外部服务。
- 不修改、不移动、不删除、不重命名原始照片和花名册。
- 不做人脸识别，不根据姓名或照片判断性别，不生成虚构儿童照片。
- 卡通图案和场景标记全部由本地脚本绘制，不从网络下载素材。
- 命令成功只代表文件生成；没有检查完整打印图和全部 PDF 页面时，不宣称视觉验收完成。
