# Logo 规范与资源

![摩卡奶霜 Logo 版本](logo-preview.png)

杯口摩卡 `#A47764`；浅底杯腹深棕 `#49372E`；深底杯腹奶霜 `#FFF6EF`；标准图标背景深棕 `#49372E`。对应引用位于 `tokens/logo.json`，色值从 `tokens/palette.json` 解析。陶橙、浅燕麦不加入标准 Logo。

## 资源选择

| 文件（相对于 assets） | 使用场景 |
| --- | --- |
| `svg/logo-light.svg` | 白色或奶霜背景上的透明双色标志 |
| `svg/logo-dark.svg` | 近黑或深棕背景上的透明反白标志 |
| `svg/mono-dark.svg`、`mono-light.svg` | 单色印刷、水印和受限展示 |
| `svg/icon-dark.svg`、`icon-light.svg` | 有圆角容器的图标 |
| `svg/app-square.svg` | 平台后续按蒙版裁切的方形源 |
| `svg/avatar-circle.svg` | 圆形头像 |
| `icons/favicon.ico` | 默认深棕 favicon |
| `icons/favicon-transparent.ico` | 已知浅色背景下的透明 favicon |
| `icons/favicon-light.ico` | 奶霜底 favicon |
| `icons/apple-touch-icon.png` | 180px 方形平台图片 |
| `icons/pwa-192.png`、`pwa-512.png` | PWA 候选图片，应用自行配置 manifest |

`png/<版本>/endoleap-<尺寸>.png` 提供六组版本，每组包含 16、24、32、48、64、128、180、192、256、512、1024、2048px。三款 ICO 均内含 16、24、32、48、64、128、256px 的 PNG 帧。

平台图片不等于完整原生安装图标配置；平台蒙版、safe zone、资源目录与元信息由消费应用配置。字标未包含在本包内，应用产品名称应使用正常文本和现有排版。

## 一致性与修改规则

唯一轮廓来源是 `tokens/geometry.json`，包含 rim / bowl 两条路径及其 transform。所有 SVG 共用完全相同的路径、坐标和比例，仅填色或背景容器不同。PNG 和 ICO 从对应 SVG 逐尺寸渲染；不能通过图片模型重新生成某个尺寸，也不能手工拉伸某个版本。

修改颜色时同步 `palette.json`、Logo 色板引用和正式资源；修改形状时仅修改几何母版，再在 ces-control 导出所有受影响的文件。标准尺寸画布为 820×820 viewBox，标志与四周留白保持当前母版坐标。已有固定 PNG 可以从本次批准的素材直接迁入；后续渲染由远程 CI 验证。

`assets/manifest.json` 列出颜色、版本、SVG 路径、PNG 与 ICO 尺寸；静态测试核对结构和轮廓，远程 Docker 使用固定版本的 resvg/Pillow 逐像素核对 PNG。不要把探索稿、ZIP、截图、提示词或本机路径当成正式源文件。

提交 PR 时说明变动是填色、容器还是几何；附选定版本对照并记录受影响应用。不得直接推 main 或替用户合并。