Skip to content

✨ feat(web): 添加生产网站图标 - #145

Merged
ZhaoXingPeng merged 1 commit into
mainfrom
feat/144-web-favicon
Sep 11, 2026
Merged

ZhaoXingPeng merged 1 commit into
mainfrom
feat/144-web-favicon

Conversation

@ZhaoXingPeng

Copy link
Copy Markdown
Owner

关联 Issue

Closes #144

结论

为生产 Web 前端提供显式 PNG/ICO 网站图标,浏览器标签不再显示默认地球图标。

范围 / 非范围

范围:frontend/index.html 图标引用与 frontend/public 图标资产。
非范围:API、WebSocket、后端、模型和域名路由。

实现与架构

图标由仓库外的授权图像生成服务按项目品牌约束生成,再缩放为 256px PNG 与多尺寸 ICO;前端只引用静态资产,不引入运行时依赖。

实验记录

阶段:D4 real
假设:图标生成服务可返回可用的项目图标源图。
环境:gpt-image-2 1K。
输入:方形、无文字、高对比 BabelFlux 抽象标记提示词。
命令:通过图像生成 API 生成并下载后使用 Pillow 缩放。
结果:返回 PNG 源图并生成 256px PNG、16/32/48/64/128/256 ICO。
结论:接受;生成源图不提交仓库,仅提交处理后的 favicon。
限制:图像生成质量与第三方服务可用性不构成运行时依赖。

验证

  • npm test -- --run:9 files,59 tests passed。
  • npm run build:通过。
  • git diff --check:通过。

风险与回退

风险:浏览器缓存旧 favicon。静态资源使用稳定文件名并由发布后的 Nginx 提供。
回退:删除 HTML 中两条图标引用并回滚本提交,重新构建并发布上一版本。

背景:生产 Web 入口缺少显式 favicon,浏览器显示默认图标。

变更:接入由授权图像服务生成并缩放的 PNG/ICO 图标。

验证:npm run test -- --run(59 passed);npm run build 通过。

Refs #144
@ZhaoXingPeng
ZhaoXingPeng merged commit 92ac0f5 into main Sep 11, 2026
3 checks passed
@ZhaoXingPeng
ZhaoXingPeng deleted the feat/144-web-favicon branch September 11, 2026 15:24
@ZhaoXingPeng

Copy link
Copy Markdown
Owner Author

阶段:D4 real
假设:合并后的前端发布不会影响 BabelFlux 健康检查,且浏览器可取得新图标。
环境:Ubuntu 22.04 生产实例,Nginx TLS 入口。
输入:合并提交 92ac0f5 的前端生产构建。
命令:systemctl restart babelflux;curl https://babelflux.icu/、/favicon.png、/api/health。
结果:根页 200;/favicon.png 返回 image/png、62,218 bytes;/api/health 返回 200;babelflux 与 nginx 均 active。
结论:发布通过。
限制:favicon 会受浏览器历史缓存影响,但 HTTP 资源已更新。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ feat(web): 添加生产网站图标

1 participant