proxycast/docs/oem/logo.md

OEM Logo 快速替换指南

本文用于未来 OEM / 代理商定制时，快速把 Lime 的品牌图替换为代理商品牌图，并尽量让 AI 一次完成主要资产更新。

目标不是讲设计理论，而是提供一条可执行、可复用、低沟通成本的流程。

适用范围

适用于以下两类需求：

1. 只替换图形 Logo，不改产品名、包名、文案。
2. 同时替换 Logo 与对外品牌名，例如启动页 slogan、README 下载文案、发布说明。

当前确认的 Lime 主 Logo

当前仓库已经确认的正式主 Logo 原图是：

./lime-claw.png

说明：

1. 该文件为透明底 2048x2048 主 Logo。
2. 当前前端 Logo、启动页 Logo、桌面端打包图标都应以这张图为准。
3. ./logo-lime.png 可视为不带 claw 的备用图，不是当前默认主 Logo。

当前仓库里的关键 Logo 落点

执行 OEM 替换时，优先关注这些位置：

• 通用前端 Logo：public/logo.png
• 启动页专用 Logo：public/logo-splash.png
• 桌面端打包图标：src-tauri/icons/
• 浏览器页签图标：index.html 中引用的 /logo.png
• 直接引用前端 Logo 的页面：
  • src/components/AppSidebar.tsx
  • src/components/SplashScreen.tsx
  • src/components/onboarding/steps/WelcomeStep.tsx
  • src/components/settings-v2/system/about/index.tsx
  • src/components/agent/chat/components/MessageList.tsx

注意：

• src-tauri/icons/tray/* 是托盘状态图，不一定适合直接换成 OEM Logo。
• 如果只是换品牌图，通常不要动 tray 状态图。

推荐输入物

给 AI 或执行者提供以下输入，成功率最高：

1. 一张高分辨率透明底主 Logo，建议 2048x2048 或更高。
2. 一个简短的品牌定位描述。 例如：偏企业、稳重、科技蓝绿 或 轻快、创意、果汁感
3. 是否需要同步替换 slogan。
4. 是否需要同步替换产品名。

推荐把 OEM 原始图先放到仓库根目录，命名为：

oem-logo.png

如果还有启动页专用版本，也可以额外提供：

oem-logo-splash.png

标准替换流程

方案 A：只替换 Logo

1. 把 OEM Logo 放到仓库根目录，例如 oem-logo.png
2. 让 AI 先扫描引用点和打包图标目录
3. 更新 public/logo.png
4. 单独生成 public/logo-splash.png
5. 同步生成 src-tauri/icons/ 下的桌面端图标资产
6. 保持 src-tauri/icons/tray/* 不变
7. 跑 npm run lint

方案 B：Logo + 品牌名一起替换

在方案 A 基础上，再额外处理：

1. 启动页 slogan
2. README 下载说明
3. RELEASE_NOTES.md
4. 如果是完整品牌切换，再继续检查：
   • package.json
   • src-tauri/tauri.conf.json
   • 深链 scheme
   • 安装包命名
   • GitHub Release 文案

推荐给 AI 的单次提示词

下面这段可以直接复制给 AI，通常一轮就能完成大部分替换：

请帮我把当前仓库的品牌图替换为 OEM Logo。

输入图片路径：
- 主 Logo：./oem-logo.png

要求：
1. 先扫描仓库里当前 logo 的引用点和图标资产，不要盲改。
2. 替换通用前端 logo：public/logo.png
3. 为启动页单独生成一张更适合大尺寸展示的专用图：public/logo-splash.png
4. 同步更新 src-tauri/icons/ 下的桌面端打包图标，包括 png / ico / icns / ios / android 图标集
5. 不要替换 src-tauri/icons/tray/*，这些是状态图标
6. 如果启动页当前复用通用 logo，请改成单独引用 logo-splash.png
7. 如果启动页视觉太小，请顺手调整 SplashScreen 的布局和尺寸，让 logo 更显眼
8. 除非我明确要求，不要改产品名、包名、identifier
9. 修改完成后执行 npm run lint
10. 最后告诉我改了哪些文件、哪些图标已同步、哪些没有动

实现约束：
- 修改前先读文件
- 不要改无关业务逻辑
- 保持 macOS / Windows / Android / iOS 图标资产一致

如果还要一起改 slogan

把上面的提示词补充为：

另外把启动页改成只保留 logo、slogan、进度动画。
新的 slogan 是：
“青柠一下，灵感即来”
副标是：
“从一句想法，到成稿、成图、成片、成事”

如果需要统一引用当前确认的品牌方案，优先查看：

• docs/oem/brand.md

如果还要一起改品牌名

把上面的提示词再补充为：

这是一次 OEM 品牌替换，不只是换图。
请额外扫描并更新对外展示名称、README、RELEASE_NOTES、GitHub Release 文案。
但先不要擅自修改历史 tag。

AI 执行后的核对清单

完成后至少检查以下内容：

视觉核对

• 浏览器页签是否已经换成 OEM Logo
• 侧边栏 / About / 欢迎页是否已经换图
• 启动页是否明显使用了单独的大图，而不是缩小后的通用 logo
• 启动页 Logo 是否居中，是否存在透明留白过大问题

打包核对

• src-tauri/icons/icon.png
• src-tauri/icons/icon.ico
• src-tauri/icons/icon.icns
• src-tauri/icons/ios/*
• src-tauri/icons/android/*

命令核对

npm run lint

如果这次同时改了 Tauri 或 Rust 相关资源生成流程，补跑：

cargo check --manifest-path "src-tauri/Cargo.toml" --offline

常见问题

1. 启动页 logo 看起来还是小

通常不是图片太小，而是：

• 启动页复用了 public/logo.png
• Logo 外面套了过厚的卡片、边框或内边距
• 透明边界太大

解决方式：

1. 单独生成 public/logo-splash.png
2. 把启动页改成专用引用
3. 去掉厚重容器，只保留大 logo + slogan + 进度动画

2. Windows Release 里只看到一个 setup.exe

这通常不是图标问题，而是 CI 的 Windows 在线包 / 离线包命名或上传逻辑有冲突。

重点检查：

• .github/workflows/release.yml
• assetNamePattern
• Windows offline / online 构建顺序

3. tray 图标看起来不适合直接 OEM

这是正常的。

tray 图标承担的是状态表达，不是品牌海报位。除非 OEM 要求非常明确，否则建议保持原状态图逻辑不变。

建议的资产策略

未来长期维护时，建议默认拆成两类资源：

1. 通用品牌图

   • public/logo.png
   • src-tauri/icons/*

2. 场景专用品牌图

   • public/logo-splash.png

这样后续即使继续 OEM，也能避免“一个 logo 到处复用，结果某个场景总显得小或不协调”。