品牌只落 Logo:换图标,不动产品配色
模块:前端 · 品牌资产接入(tmp/tako-brand-integration)|状态:方案已定、未施工(2026-10-31 核实:
web/public/不存在,index.html无 icon 链接,App.vue仍是旧t)|证据:tmp/tako-brand-integration/{planning,todos}.md、tmp/tako-brand/final/、yk-tako-eino/web/{index.html,src/App.vue}
1. 场景与病灶
品牌已经定稿——「Tako Grid」图形 + 06 燕麦焦糖双色 + 轮廓化字标。素材在 tmp/tako-brand/final/(tako-mark.svg、tako-logo-horizontal.svg、AppIcon.appiconset/ 等)。
但运行 ./scripts/dev.sh 打开页面,看到的还是旧的黑底白字字母 t;浏览器标签没有 favicon;Safari「添加到主屏幕」也没有方形图标。
原因不是设计没做,而是两处断链:
- 素材在
tmp/——tmp/被.gitignore排除、验收后会被清理,它不是资产存放处。换个 clone 或清一次台账,定稿素材就没了;这与「验收脚本必须从tmp/搬进scripts/acceptance/」是同一个病。 - 页面没有引用——
web/public/目录不存在,index.html里没有<link rel="icon">/apple-touch-icon,App.vue的侧栏与登录页仍是.mark的字母t(App.vue:1272、:1468)。素材再漂亮,没有一条稳定的 HTTP 路径到达它,等于不存在。
后果很具体:演示时第一眼是旧品牌,截图与文档对不上;若此时有人清 tmp/,定稿 SVG 与 PNG 源文件一起消失,只能重做。
2. 候选与代价
| 候选 | 做法 | 好处 | 代价 |
|---|---|---|---|
A 继续用字母 t + CSS |
现状 | 零改动 | 品牌与产品不一致;定稿素材闲置;主屏幕图标缺失 |
B 内联进组件(base64 / 大段 <svg>) |
把 Logo 塞进 App.vue |
少一个静态文件 | 每次渲染重复携带;favicon / apple-touch-icon 仍需要独立文件;改图要改组件 |
C 静态资产进 web/public/brand/ + 三处引用(选定) |
复制三份定稿资产;index.html 接 favicon 与 apple-touch-icon;侧栏与登录页换成同一横向 Logo |
一条稳定路径(/brand/...);页面与标签/主屏幕同源;回滚只需删目录 + 还原两个文件 |
多三份二进制/矢量资产;两处品牌要同时换,漏一处会出现两套 |
| D 顺便把整套 UI 换成燕麦焦糖主题 | 改 token / 全局配色 | 「统一」 | 产品配色是另一条已验收的设计线(doc/51 中性现代风);品牌替换借机改主题会把两件事的验收混在一起 |
| E 建原生 iOS 工程 + 完整 AppIcon | 拷 AppIcon.appiconset 进 iOS target |
原生图标完整 | 仓库今天没有 iOS target;为一个不存在的宿主建工程是空转 |
选 C。边界写死:只换品牌呈现,不改产品配色 token、不改任何 API/存储/运行协议。 完整 AppIcon.appiconset 留在素材 ZIP 里,将来真有 iOS target 再拷。
3. 接线的四个落点
| 落点 | 做法 | 为什么 |
|---|---|---|
web/public/brand/tako-mark.svg |
独立图形,作 favicon | Vite 从 /brand/... 直接提供静态文件,无需打包 |
web/public/brand/tako-logo-horizontal.svg |
横向 Logo,字标已轮廓化 | 不依赖访问者本机是否装 Menlo;否则换台电脑字标就变字体 |
web/public/brand/tako-apple-touch-icon.png |
180×180 方形图标(源 icon-iphone-60@3x.png) |
iOS「添加到主屏幕」要 PNG,不吃 SVG |
web/index.html |
加 SVG favicon + apple-touch-icon 两个 <link>,保留 theme-color 与标题 |
标签页与主屏幕先于页面内容可见 |
App.vue 登录后侧栏 .brand |
用横向 Logo 替换字母 t;保留「工作区」副标或等价可访问名称 |
主工作台入口的品牌 |
App.vue 未登录 .gate-copy |
同一张横向 Logo;保留 h1 语义或等价可访问标题 |
冷启动第一眼;两处必须同一套 |
窄屏约束:860px 以下顶栏不允许横向溢出,品牌副标按现有窄屏规则隐藏(App.vue:3213-3214);390px 下登录页 Logo 不挤压右侧登录卡片、不出现横向滚动。
回滚:删 web/public/brand/,还原 index.html 与 App.vue 的本拍小块改动即可,不触碰其他文件。
4. 同族小裁定
| 小问题 | 裁定 | 代价 / 备注 |
|---|---|---|
| 资产放哪 | web/public/brand/,不放 tmp/、不内联 |
tmp/ 不入库且会被清理;内联解决不了 favicon / 主屏幕图标 |
| 改名后的 PNG 叫什么 | tako-apple-touch-icon.png |
语义化命名,避免把 icon-iphone-60@3x 这种源文件名带进代码面 |
| 字标用字体还是轮廓 | 轮廓化 SVG | 不依赖访问者本机字体;跨平台一致 |
| 换不换产品配色 | 不换 | doc/51 已定中性现代风;品牌是图形与字标,不是主题 |
| 登录页与侧栏 | 同一套横向 Logo | 两处不同会出现「两个品牌」 |
旧 .mark 样式 |
本拍清掉,不留两套 | 否则下次改品牌会漏改一处 |
| 是否建 iOS 工程 | 不建 | 没有 target;完整 AppIcon 留在素材 ZIP |
| 可访问性 | 保留 h1 或等价标题、图形 aria-hidden |
图形不是文字,读屏要读得到「tako」 |
| 验收方式 | 先 curl 静态字节,再看浏览器两处 + 窄屏 | 资产先能被 HTTP 打到,页面才谈得上引用 |
要不要改 doc/ |
不改(当时判断) | 这是视觉资产接入,不是产品能力增减;本次补录进问题库以保住决策 |
5. 证据
台账:tmp/tako-brand-integration/planning.md(背景、非目标、文件计划、A1–A5 顺序、回滚)、todos.md(每拍 curl 字节 + 浏览器走查;A1 验 public/brand 三个地址,A2 验 HTML 链接,A5 验类型/构建/无 404)。素材:tmp/tako-brand/final/{tako-mark.svg,tako-logo-horizontal.svg,AppIcon.appiconset/,tako-icon-1024.png,...}。
当前代码事实(2026-10-31 核实):
| 位置 | 状态 |
|---|---|
yk-tako-eino/web/public/ |
不存在(资产未入库) |
yk-tako-eino/web/index.html |
无 favicon / apple-touch-icon 链接 |
yk-tako-eino/web/src/App.vue:1272 |
侧栏仍是 <span class="mark">t</span> |
yk-tako-eino/web/src/App.vue:1468 |
登录页仍是 <span class="mark lg">t</span> |
yk-tako-eino/web/src/App.vue:3213-3214 |
窄屏 .brand 与 .brand-sub 的现有规则 |
tmp/tako-brand/final/tako-logo-horizontal.svg |
定稿横向 Logo(字标轮廓化) |
tmp/tako-brand/final/AppIcon.appiconset/ |
完整 iOS 图标集(本拍只取 180px 一张) |
复核命令:
ls yk-tako-eino/web/public/brand 2>&1 # 当前:No such file or directory
grep -n "favicon\|apple-touch-icon" yk-tako-eino/web/index.html # 当前:无输出
grep -n 'class="mark' yk-tako-eino/web/src/App.vue # 当前:1272 / 1468 两处旧字母
ls tmp/tako-brand/final/ # 资产仍在台账目录(随时可能被清)施工后的验收(按台账):
cd yk-tako-eino/web && npm run dev -- --host 127.0.0.1 --port 5199
curl -s http://127.0.0.1:5199/brand/tako-mark.svg | head -c 4 # <svg
curl -s http://127.0.0.1:5199/brand/tako-logo-horizontal.svg | grep -c '<path'
curl -s http://127.0.0.1:5199/brand/tako-apple-touch-icon.png | xxd -l 8 # 8950 4e47 0d0a 1a0a
curl -s http://127.0.0.1:5199/ | grep '/brand/tako-mark.svg'
npm run typecheck && npm run build6. 现状
- 方案仍有效:静态资产进
web/public/brand/、三处引用、字标轮廓化、不换主题、不建 iOS 工程、回滚只碰三个文件。 - 未施工:截至 2026-10-31,
web/public/与index.html的 icon 链接都不存在,App.vue两处仍是旧字母t。定稿素材只存在于tmp/tako-brand/final/,而tmp/不入库、会清理——这是当前最实际的风险:台账一清,方案与素材一起丢。 - 为什么补录进问题库:原计划判断「不改 doc/」,于是决策只活在
tmp/台账里。问题库这一层正好接住这类「做过判断、还没施工、台账又不入库」的事,避免它随tmp/消失。 - 同族问题:素材与脚本不入库的共同病 → 验收机器化;界面呈现层的验收方式 → 界面验收双轨;产品配色的真源 → 前端可用性欠账。