mirror of
https://github.com/aiclientproxy/proxycast.git
synced 2026-09-24 23:10:56 +08:00
fix release assets and refresh lime branding
This commit is contained in:
@@ -0,0 +1,204 @@
|
||||
# OEM Logo 快速替换指南
|
||||
|
||||
本文用于未来 OEM / 代理商定制时,快速把 Lime 的品牌图替换为代理商品牌图,并尽量让 AI 一次完成主要资产更新。
|
||||
|
||||
目标不是讲设计理论,而是提供一条可执行、可复用、低沟通成本的流程。
|
||||
|
||||
## 适用范围
|
||||
|
||||
适用于以下两类需求:
|
||||
|
||||
1. 只替换图形 Logo,不改产品名、包名、文案。
|
||||
2. 同时替换 Logo 与对外品牌名,例如启动页 slogan、README 下载文案、发布说明。
|
||||
|
||||
## 当前仓库里的关键 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 原始图先放到仓库根目录,命名为:
|
||||
|
||||
```text
|
||||
oem-logo.png
|
||||
```
|
||||
|
||||
如果还有启动页专用版本,也可以额外提供:
|
||||
|
||||
```text
|
||||
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,通常一轮就能完成大部分替换:
|
||||
|
||||
```text
|
||||
请帮我把当前仓库的品牌图替换为 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
|
||||
|
||||
把上面的提示词补充为:
|
||||
|
||||
```text
|
||||
另外把启动页改成只保留 logo、slogan、进度动画。
|
||||
新的 slogan 是:
|
||||
“青柠一下,灵感即来。”
|
||||
```
|
||||
|
||||
## 如果还要一起改品牌名
|
||||
|
||||
把上面的提示词再补充为:
|
||||
|
||||
```text
|
||||
这是一次 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/*`
|
||||
|
||||
### 命令核对
|
||||
|
||||
```bash
|
||||
npm run lint
|
||||
```
|
||||
|
||||
如果这次同时改了 Tauri 或 Rust 相关资源生成流程,补跑:
|
||||
|
||||
```bash
|
||||
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 到处复用,结果某个场景总显得小或不协调”。
|
||||
Reference in New Issue
Block a user