品牌图标

三个 Icon Composer 项目是完整应用图标的权威来源：

• dev/app-icon.icon
• nightly/app-icon.icon
• prod/app-icon.icon

每个项目用 text.svg 作为 T3 标志，并在背景是矢量图层时使用 background.svg。其余图层使用描述其角色与位置的语义名称。

从仓库根目录运行 vp run icons:export，以重新生成受跟踪的 iOS、Linux、Windows 和 Web 资源。开发用的 Web 导出还会复制到 apps/web/public，用于浏览器站点图标、Web 应用清单图标和启动画面。运行 vp run icons:check，可验证生成的资源以及公开副本与其来源一致，并且不修改文件。

导出需要 macOS 上的 Icon Composer 2 或更新版本。脚本会从 Xcode 或独立安装的 Icon Composer 中选择最新的兼容导出器，并把设计代次固定为 26。把 ICON_COMPOSER_TOOL 设为 Icon Composer.app/Contents/Executables/ictool 的完整路径，即可覆盖自动发现。

macOS 导出

Icon Composer 的命令行导出器没有提供 macOS pre-Tahoe 预设。普通的命令行 macOS 导出是满版出血，不适合桌面应用，因此导出脚本有意保持受跟踪的 macOS PNG 不变，并在每次运行后打印一条提醒。

更改 Icon Composer 项目后，在 Icon Composer 中打开它，并严格按照以下设置导出 macOS PNG：

• 平台：macOS pre-Tahoe
• 外观：Default
• 尺寸：1024pt
• 缩放：1×

把三份导出保存到：

• dev/app-icon.icon -> dev/blueprint-macos-1024.png
• nightly/app-icon.icon -> nightly/nightly-macos-1024.png
• prod/app-icon.icon -> prod/black-macos-1024.png

结果必须是一张 1024×1024 的 PNG，并符合经典的 macOS 安全区：不透明图标主体为 824×824，四边各内缩 100 像素，只有 Icon Composer 的原生阴影延伸进周围的透明画布。

若要让 Codex 执行原生导出，把下面这段提示粘贴到在仓库根目录打开的任务中：

Use [@Computer](plugin://computer-use@openai-bundled) and the Icon Composer app to export the three macOS app icons in this repository.

For each project below, use Platform: macOS pre-Tahoe, Appearance: Default, Size: 1024pt, and Scale: 1×, then save the PNG to the exact destination:

- assets/dev/app-icon.icon -> assets/dev/blueprint-macos-1024.png
- assets/nightly/app-icon.icon -> assets/nightly/nightly-macos-1024.png
- assets/prod/app-icon.icon -> assets/prod/black-macos-1024.png

Do not resize, composite, or otherwise post-process the exported PNGs.

Verify every result is 1024×1024 and has the classic macOS safe area: an 824×824 opaque body inset 100px on every side, with only Icon Composer's native shadow extending beyond it.

不要直接编辑生成的 PNG 或 ICO 文件。

Android 启动器与启动画面图稿

Android 会遮罩 108dp 自适应画布的中央 72dp，Android 12 及以上的启动画面会遮罩 288dp 画布的中央三分之二，因此不能直接使用 Icon Composer 的导出：它们的圆角方形轮廓会被再套一层边框，字标也会被裁掉。Android 图稿改为由 vp run icons:export:android 根据同样的 Icon Composer SVG 来源渲染：

• apps/mobile/assets/android-icon-foreground.png：共用的透明字标，尺寸保持在安全区之内
• apps/mobile/assets/android-icon-background-dev.png 与 -nightly.png：满版出血的变体图稿（蓝图网格与标注；夜空与云）。生产环境使用纯色。
• apps/mobile/assets/android-splash-icon-*.png：把两个图层合成为一张 288dp 图像，使启动画面的遮罩复现启动器图标的取景。

更改某个图层 SVG 之后，重新运行导出。android-icon-mark.png 仍然是扁平剪影，用于 Android 的单色主题图标。