# 羊年吉祥物视觉项目 / asset-sheep-year-mascot

## Purpose

承接并迭代“羊年吉祥物”视觉资产：基于用户即将提供的已确定形象和资料，制作可用于后续设计交付的吉祥物图、提示词、版式方案、预览与最终交付文件。

## User Requirements

- 用户已确认有资料和确定形象，将随后发送。
- 先新开项目并准备接收素材。
- 后续制作前需要锁定：使用渠道/尺寸、画面用途、风格、是否需要透明底/源文件/分层文件、交付格式。

## Current State

- 2026-05-29：已接收用户提供的国博领导馆内过审羊年吉祥物最终形象图，本地复制到 `source/user_uploads/approved_museum_sheep_mascot.jpg`（原始用户素材不提交）。
- 2026-05-29：已生成第一版可用三视图交付稿：`deliverables/three_view_v2/sheep_mascot_three_view_v2_1.png`，横版 2048×1152，包含正面、右侧面、背面三视图。
- 2026-05-29：根据用户反馈“太宽、身体比例不好、正面怪”，生成 v3 三个协调差异版比较板：`deliverables/three_view_v3_variants/sheep_mascot_three_view_v3_variant_1.png`。
- 2026-05-29：用户确认更喜欢 v3 第三排方向，并纠正“三个版本要分开三张图”。已生成 v4 分开三张独立三视图：`deliverables/three_view_v4_separate/sheep_mascot_three_view_v4_A.png`、`..._B.png`、`..._C.png`。
- 2026-05-29：用户反馈 v4 质量差，并要求使用官方稳定渠道 gpt2image / MXAI。已实时确认 MXAI `gpt-image-2` 模型可用，改用官方稳定 MXAI REST `gpt-image-2`、2K、high，并只以国博过审原始形象图为输入参考，生成 v5 三张独立三视图：`deliverables/three_view_v5_official_gpt2image_mxai/sheep_mascot_three_view_v5_A_official_gpt2image_mxai.png`、`..._B_...png`、`..._C_...png`。
- 2026-05-29：用户判断三视图可能因宽度不够导致质量问题，要求改为只生成正面和侧面。已继续使用官方稳定 MXAI `gpt-image-2`、2K、high，生成 v6 三张独立双视图：`deliverables/two_view_v6_official_gpt2image_mxai/sheep_mascot_two_view_v6_A_official_gpt2image_mxai.png`、`..._B_...png`、`..._C_...png`。
- 2026-05-29：用户喜欢 v6 第一版体型，但指出纹样与头部结构变化，要求提示词更精简、少禁止项、强制按参考图。已基于第一版体型方向、仅参考原始过审图，生成 v7 三张双视图：`deliverables/two_view_v7_reference_locked_gpt2image_mxai/sheep_mascot_two_view_v7_A_reference_locked_gpt2image_mxai.png`、`..._B2_...png`、`..._C_...png`。

## Change Log / Decision Notes

- 2026-05-29：按新项目创建本地 AI Work 项目与 Git 追踪骨架，原始用户素材默认只本地保存、不直接提交。
- 2026-05-29：根据用户明确说明“最终国博领导馆内过审的形象图”，采用参考图图生图方式制作三视图，核心约束为保持红金粉色、盘羊角、圆润小羊轮廓和传统卷云/螺旋纹样；v1 存在尺度不一致，已改用 v2 作为交付稿。
- 2026-05-29：v3 按用户反馈调整为更窄、更协调、正面更端正，并在同一比较板里提供三行不同体型方向：收窄挺拔、圆润幼态、接近原图饱满感。
- 2026-05-29：v4 根据用户更喜欢 v3 第三排的选择，改为三张分开的独立版本；每张只包含一组正面/侧面/背面三视图，提示词分别微调为第三排基准、轻微收窄、圆润稳重。
- 2026-05-29：v5 纠正 v4 质量问题：不再用上一批生成图做输入参考，改用官方稳定 MXAI `gpt-image-2` 直接参考国博过审原图，提示词改为更短的正向中文画面描述，分别生成 A/B/C 三张独立图。
- 2026-05-29：v6 根据用户“宽度不够放不下，不要生成三视图，只要正面和侧面”的判断，停止生成背面，只输出正面+右侧面双视图，以解决三视图挤压和比例变形问题。
- 2026-05-29：v7 根据用户“喜欢第一版，但纹样和头部结构变化、提示词不要废话和长禁止项”的反馈，检查并精简提示词，改为“参考图是唯一造型标准”+少量结构锁定词，继续用官方稳定 MXAI `gpt-image-2` 生成 A/B2/C。

## File Map

- `README.md`：项目说明。
- `PROJECT_CONTEXT.md`：供 AI Work 项目索引检索的简要上下文。
- `docs/requirements.md`：需求与素材接收清单。
- `source/user_uploads/`：用户上传素材本地工作副本入口，默认不入 Git。
- `work/prompts/`：后续提示词与方向稿。
- `deliverables/`：最终/阶段交付物。
- `exports/`：导出预览与发送文件。
- `cache/`：临时中间文件。

## Safety / Secrets Boundary

不得提交密钥、令牌、账号凭据、聊天原文、未确认可入库的原始用户素材、缓存、临时图、失败中间稿。用户/NAS原始资料只读/本地复制后处理；NAS写入另需精确路径和风险二次确认。

## Remote / Ownership

- Local path: `/Users/bot1/AI Work/02_projects/active/asset-sheep-year-mascot`
- Remote: `ssh://git@192.168.1.4:2222/qianliyun/asset-sheep-year-mascot.git`
- Web: `http://192.168.1.4:3000/qianliyun/asset-sheep-year-mascot`
- Machine/Profile: bot1 / designer3
- Default branch: main
- Note: SSH push from this profile returned `Permission denied (publickey)` during initialization; use the documented non-persistent HTTPS/token fallback until SSH key mapping is repaired.