Skip to content

feat(home): 重做默认公开首页(品牌与服务说明),公开页头隐藏未知版本 - #47

Merged
AdoreJc merged 1 commit into
fork-mainfrom
hq/T261114-02-home-page
Nov 14, 2026
Merged

AdoreJc merged 1 commit into
fork-mainfrom
hq/T261114-02-home-page

Conversation

@AdoreJc

@AdoreJc AdoreJc commented Nov 14, 2026

Copy link
Copy Markdown
Owner

目标:让未登录首页的首屏截图能清楚显示 OpenPalm 品牌和服务说明(用作商标使用证据)。

HQ-Task: T261114-02

变更

  • 首页首屏显示 status.system_name,并说明这是用于管理、路由、监控和分析 AI 模型与 API 访问及使用情况的统一 API 网关 / SaaS 平台。
  • 功能区改为四块:统一接入、路由与负载均衡、用量监控与分析、密钥与计费管理。
  • 删除无法核实的统计数字(及 Stats、StatItem 组件和常量)。
  • 去掉首页文案中的 NewAPI 字样;docs_link 未配置时不再回落到 docs.newapi.pro,直接隐藏文档按钮。
  • 公开页头版本标签在版本未知时不渲染(新增 hideWhenVersionUnknown,只有公开页头使用;管理员更新对话框与应用内页头不变)。
  • 仅改 en.json、zh.json(新增 13 个键,插入在 translation 末尾);AGPL 头与页脚上游署名未动。

验证(实测,Windows,Bun 1.4.0)

  • bun install --frozen-lockfile 通过;bun x tsc -b(tsc 7.0.2,等价 bun check -b)无错误。
  • bun run test:244 个文件 / 2720 个用例全部通过(含新增的版本标签隐藏用例)。
  • bun run build 成功。
  • 本地后端(临时 SQLite,SystemName=OpenPalm)渲染未登录首页,桌面 1440 与 390 宽、亮色与暗色均已截图。
  • DOM 文本检查(英文界面):含 OpenPalm 与服务说明;不含 NewAPI、Unknown version、旧统计数字。

未处理 / 注意

🤖 Generated with Claude Code

商标证据(OPENPALM)需要一张能说明服务内容的未登录首页截图。
- 首页首屏显示 status.system_name 品牌名,并用一句话说明这是用于管理、路由、监控和分析 AI 模型与 API 访问及使用情况的统一 API 网关 / SaaS 平台
- 功能区改为四块:统一接入、路由与负载均衡、用量监控与分析、密钥与计费管理
- 删除无法核实的统计数字(50+/100+/50+/10+)及其组件
- 去掉首页文案中的 NewAPI 字样;docs_link 未配置时不再回落到 docs.newapi.pro,直接隐藏文档按钮
- 公开页头的版本标签在版本未知时不渲染(管理员更新对话框与应用内页头不变)
- 仅改 en.json / zh.json,新增 13 个键;保留 AGPL 头与页脚上游署名

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@AdoreJc

AdoreJc commented Nov 14, 2026

Copy link
Copy Markdown
Owner Author

HQ-Review R1 @ 7aca004: APPROVE

逐项核对了 diff 和相关源码:改动范围只在首页、公开页头版本标签和 en/zh 两个语言文件,没有动 Go、计费、鉴权、AGPL 头和页脚上游署名,HomePageContent 分支和管理员更新对话框也没有变。system-update-action.tsx 的提前 return 放在全部 hook 之后,hook 顺序安全。新增用例在默认管理员身份下运行,换成旧代码会失败(旧代码会渲染 Unknown version 按钮)。新增的 13 个键 en/zh 都有,都放在 translation 对象里;旧文案键还留在文件里,但不会让测试失败,这样做也是为了少和合并上游时冲突。四个功能块的说法(分组/优先级/权重路由、自动重试、日志与用量看板、令牌额度和限制、余额计费)都能在产品里找到对应功能,没有新增数字。

以下各项都不阻塞合并:

  1. web/src/features/system-update/system-update-action.tsx:51-75:SystemUpdateAction 对非管理员一律返回 null,所以以前未登录访问时公开页头本来就不会出现 Unknown version,只有管理员登录后看公开页才会出现。这次改动只对“以管理员身份截图”有用。副作用:版本未知时,管理员在公开页头上也看不到“有可用更新”的提示(应用内页头不受影响)。可以接受,记录在这里。
  2. web/src/features/home/components/sections/hero.tsx:51-53:前端已经不再回落到上游文档。但后端 docs_link 的默认值仍是上游文档站,线上如果没改,首页和页头的“文档”按钮还会出现并指向上游。截图前请运营在系统设置里清空或改成自己的文档地址(属于运维操作,不需要改代码)。
  3. 首页路径上还能看到的上游字样(都不在本任务范围内,留作记录):
    • web/src/components/layout/components/footer.tsx:131-139:页脚 © <年份> New API 署名,按要求保留,位于首屏以外。
    • footer.tsx:175-200:没有自定义页脚时,默认页脚栏目链接到上游文档站。
    • web/index.html:9-10:<title>New API</title>。首次访问、本地还没有状态缓存时,标签页标题会先显示 New API,状态加载后才换成 system_name。截图如果带浏览器标签栏,请等加载完再截。
      所以首页 DOM 里仍然有 New API(页脚),没有满足 brief 里“不含 New API”的字面要求,但这是 brief 中“保留上游署名”这条要求带来的冲突,PR 描述里也已经说明。
  4. 测试缺口:hero.tsx 没有组件测试,这几点没有自动化断言:品牌取自 status.system_name、服务说明出现、docs_link 为空时隐藏“文档”按钮。现在只有作者手动做的 DOM 检查。建议后续在 web/src/features/home/__tests__/ 下补一个渲染测试。另外,hideWhenVersionUnknown 在版本已知时仍然正常渲染的正向路径也没有测试。
  5. web/src/features/home/components/sections/cta.tsx:64:新文案写的是“创建账号获取 API 密钥”。如果站点关闭了注册,这句话就和实际不符(不过原来的 Get Started 按钮本来也指向 /sign-up,影响很小)。

@AdoreJc
AdoreJc merged commit 9682b8d into fork-main Nov 14, 2026
AdoreJc added a commit that referenced this pull request Nov 14, 2026
fork-main 又合入了 #47,并进来以免 PR 冲突。
冲突只有 en、zh 两个前端语言文件:保留同步分支的内容,再加回 #47 新增的 key。

HQ-Task: T261113-16

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@AdoreJc
AdoreJc deleted the hq/T261114-02-home-page branch November 14, 2026 10:59
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.

1 participant