Skip to content

📚 docs(readme): 居中展示项目名称与主图 - #143

Merged
ZhaoXingPeng merged 1 commit into
mainfrom
docs/142-project-hero
Sep 11, 2026
Merged

ZhaoXingPeng merged 1 commit into
mainfrom
docs/142-project-hero

Conversation

@ZhaoXingPeng

Copy link
Copy Markdown
Owner

关联 Issue

Closes #142

做了什么

  • 将首屏标题改为居中的 BabelFlux Java / 巴别流同传。
  • 新增紧凑横向项目主图,仅包含语音波形/对话图标和中英文项目名称。
  • 主图置于标题和发布徽章之间;保留单一 Bilibili Demo 链接,不恢复预览图。

实现与取舍

  • 主图保存为 docs/design/babelflux-java-project-banner.jpg,展示尺寸 1536x652、文件大小 128,683 字节,避免将服务原始的 4.8 MB PNG 纳入仓库。
  • 使用居中 HTML 标题和图片,兼容 GitHub README 渲染;主图内容填充横向画布,不添加口号、设备 mockup 或额外装饰。
  • 图片生成使用 C:\project\生图.txt 配置的兼容图像接口;gpt-image-2 服务端两次失败后,改用该服务支持的 nano-banana-pro 完成生成。未将任何凭据写入仓库或 PR。

实验与结果

实验:在 GitHub README 目标宽度下检查主图文字、图标、留白和文件体积;逐个验证 README 徽章链接;执行文档差异检查。
结果:BabelFlux Java 与 巴别流同传 文案清晰,图标与名称占据主图主体;主图优化为 128,683 字节;Quality Gates、Release、Maven Package、License 徽章链接可访问(HTTP 200);git diff --check 通过。
结论:首屏可直接识别项目名称,主图简洁且不造成过量仓库体积,Demo 仍保持单一入口。

验证

git diff --check
结果:通过

HTTP HEAD: Quality Gates / Release / Maven Package / License badges
结果:HTTP 200

风险与回滚

仅变更 README 与新增图片资产,不影响源码、构建和发布工作流。回滚时还原该单个文档提交并删除新增主图即可。

提交前检查

背景:首屏缺少居中标题和紧凑项目主图。
变更:新增优化后的项目图标与名称横幅,保留发布徽章和单一 Demo 链接。
验证:检查主图文字与留白,验证徽章 HTTP 200,并运行 git diff --check。
Refs #142
@ZhaoXingPeng
ZhaoXingPeng merged commit bed3a16 into main Sep 11, 2026
3 checks passed
@ZhaoXingPeng
ZhaoXingPeng deleted the docs/142-project-hero branch September 11, 2026 02:15
@ZhaoXingPeng

Copy link
Copy Markdown
Owner Author

实验:在合并前执行 Quality Gates,并检查主图文件、首屏链接与徽章响应。
结果:Run 34553795338 的 Java 后端、前端测试/构建、桌面类型检查/构建均成功;主图为 1536x652、128,683 字节;首屏 Demo 仅保留一个 Bilibili 链接;发布相关徽章返回 HTTP 200。
结论:项目 README 的居中标题和紧凑主图可安全合并,不影响构建或发布链路。

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.

📚 docs(readme): 居中展示项目名称与主图

1 participant