Touch My Photo
创建可追踪的照片转打印工程。默认使用 Windows、Bambu Lab P2S、0.4 mm 喷嘴以及当前已安装的官方 P2S 预设。不得声称生成的多视图是经过标定的几何图，也不得把切片成功说成实物打印已经成功。
除非用户明确只需要二维设计、商品推荐、物品识别或购买建议，否则应把“根据照片制作玩具、手办、公仔、摆件、雕塑或模型”等请求理解为制作可打印三维物件。即使用户只提供一张照片，也要开始输入盘点；应说明缺失视角带来的不确定性，而不是拒绝触发流程。
请求路由
- 安装、修复或环境就绪检查：阅读 Windows 环境安装说明，并在更改环境前运行
scripts/doctor.ps1。 - 新建照片转打印任务：阅读 照片盘点与主体确认，再执行下述流程。
- 生成建模参考图：阅读 多视角建模参考图，并使用内置的
scripts/async_gpt_image.py。修改或诊断服务商协议时，另行阅读 异步图片 API 契约。 - Blender 建模：阅读 Blender 建模工作流。
- 打印工程与切片：阅读 P2S 打印工程。
- 交付前：阅读 验证与交付。
- 扩展或审查本技能：阅读 详细技能设计和 V7 案例复盘。案例仅作为复盘证据，不得视为规定的执行顺序。
内置生图运行时
每次调用 scripts/async_gpt_image.py 前，先调用 Codex 工作区依赖加载器，并使用其返回的 Python 可执行文件。如果该能力不可用，则使用 PATH 中的 Python 3.9 或更高版本。该模块只依赖 Python 标准库。
首次使用时只运行 doctor --json，不要提交生图请求。如果缺少密钥，引导用户访问 https://1token-store.com/keys 并选择 ChatGPT/Codex 分组。只有在用户主动提供密钥时才能接收；通过管道把密钥传给 configure --from-stdin，不得将其放入命令行参数、回显或保存到 Git。环境变量配置支持 TOUCH_MY_PHOTO_IMAGE_API_KEY。运行时状态默认保存在 ~/touch-my-photo/image-generation，可用 TOUCH_MY_PHOTO_IMAGE_HOME 更改位置。
使用 edit 生成多照片参考图，并为每张照片重复传入 --image。如果付费请求可能超过当前轮次，使用 --detach，保存任务 ID，再通过 status 或 wait 恢复。脚本会在轮询前持久化请求、脱敏密钥，只重试安全的轮询失败，并且不会自动重复提交状态不确定的付费请求。默认使用 gpt-image-2.5；仅在用户要求或确实需要回退时使用 gpt-image-2。
必需工作流
- 盘点用户提交的每张照片，识别候选主体、遮挡、比例证据和视角覆盖情况；向用户展示拟定主体和歧义。
- 在用户明确确认主体前，停止付费生图和建模。主体确认只授权约定数量的参考图生成，不授权额外变体。
- 使用内置异步生图运行时生成一致的建模参考图组。保存原始照片、提示词、任务 ID、输出、裁图框和实际像素尺寸。把生成视图标记为视觉参考，而不是测量图。
- 跨视图比较参考图。如果主体身份、拓扑或隐藏结构发生漂移，展示问题，并且只在用户授权后重新生成。除非用户明确要求不中断地连续完成，否则应在详细建模前取得参考图批准。
- 详细建模前，根据已批准参考记录外观风格契约：视觉唯一依据、轮廓与体块、边缘软硬、表面特征、可见不对称、必需细节，以及自动玩具化圆润等应避免的倾向。应匹配获批风格，而不是强行写实化或风格化。随后在 Blender 中建立可编辑的外观母版。使用 Blender Lab MCP 做交互检查和增量场景工作；保留可复现的
bpy脚本，并使用 Blender CLI 完成干净重建、批量渲染、导出和审计。 - 使用对齐的类正交渲染和尺寸与已批准参考进行比较。检查轮廓地标、比例、截面、开口、边缘处理、表面特征和不对称，而不只是对象是否完整。把偏差和不确定性保存在项目清单中。
- 派生独立的打印母版。确保几何水密、方向正确、实体物理连接或按设计装配、厚度适合所选喷嘴，并符合 P2S 预设的尺寸约束。不得把着色器颜色或凹凸效果误认为可打印几何。
- 构建 P2S 3MF，明确写入机器、工艺、耗材、打印板、摆放、支撑和颜色槽位设置。展开 Bambu 预设时必须同时解析
inherits和include。 - 重新打开最终交付的准确 3MF，不带外部覆盖地重新切片。核验退出码、结果 JSON、对象数量、包络尺寸、耗材槽位、需要时的擦料塔、支撑与接触面路径以及机器 G-code 模板。即使切片器报告成功，也要把任何 error 级日志视为尚未解决的异常。
- 交付可编辑
.blend、可打印几何、P2S.3mf、预览、清单、验证报告、哈希和简洁打印说明。默认排除生成的 G-code；除非确实完成了实物打印，否则要明确说明未做实物打印。
按证据调整路径
工作流阶段是证据门和权限门，不是必须重演的历史版本。不得仅因为案例中存在 V1 到 V7，就重新制作这些版本或固定次数的迭代。对于已有项目，先盘点工件并验证最近的可信检查点，只执行缺失或失败的阶段。用户已经提供一致且获批的参考图组时，可以跳过参考图生成；已有经过验证的可编辑母版时，可以跳过外观重建。一体或拆件、颜色策略、摆放方向和支撑类型必须根据当前几何、用户意图和经过验证的切片结果选择，而不是照搬案例时间线。用户授权、来源可追踪、可打印性和最终 3MF 复开验证仍是不可省略的硬门。
默认项目规则
- 使用毫米；把来源、外观、打印、切片、验证和交付工件分别保存在独立目录。
- 以当前安装的 P2S 预设作为可打印区域的权威依据；标称机器体积不能保证裙边、支撑、清洗结构和保留区域都能放下。用户未指定尺寸时，优先以最长边 200 mm 作为起始候选值。
- PLA 和官方 P2S 0.4 mm 预设只能作为明确的工作默认值；记录所有覆盖项。不得默许承诺四色输出、一体结构或免支撑打印。
- 未经明确授权，不得发送打印任务、上传模型或发布用户照片。
- 保留原始文件并创建新的版本化输出。不得覆盖上一版已接受模型或最终 3MF。
