docs: `page-header.mdx` 的 Responsive Behavior 仍写「Spacing: Adjusts padding for different screen sizes」—— 与 #3786 修掉的 `pb-8 on desktop` 是同一个假断言

[yinlianghui]

发现于 #3786 的实现(PR:claude/issue-3786-3787-pageheader-docs-demo),不在该 PR 处理 —— 那一单的判定面被明确钉在「Styling → Container 三条」,这一条在另一个小节(Responsive Behavior),是 #3786 正文没有列举的第四份副本。

现象

#3786 修掉了 Styling → Container 里的 pb-4 on mobile / **pb-8 on desktop**(实际 pb-4`,无任何断点变体)。但同一文件末尾的 Responsive Behavior 小节还留着同一个断言的另一种说法:

content/docs/layout/page-header.mdx:225-229

## Responsive Behavior

- **Mobile**: Actions stack below title if needed
- **Desktop**: Actions align to right side
- **Spacing**: Adjusts padding for different screen sizes

packages/layout/src/PageHeader.tsx:210 的根 class 是 flex flex-col gap-3 pb-4 border-b —— padding 不随屏幕尺寸变化,一个断点变体都没有。整个组件里唯一的响应式类是标题的 md:text-3xl(:231),那是字号,不是 padding。

为什么值得记一笔

#3786 修完后这一页是自相矛盾的:Container 小节说「pb-4 at every breakpoint — there is no responsive variant」,四行之后的 Responsive Behavior 说 padding 会按屏幕尺寸调整。读者(覆盖间距的作者)看到哪一条取决于翻到哪一节。这正是 #3786 治的那个病,只是换了个小节。

顺带核过、没有问题的两条:Actions stack below title 与 align to right side 与代码一致 —— 标题行是 flex flex-wrap(:211),右槽 ml-auto(:235),窄屏确实会换行。只有 Spacing 这一条是假的。

建议处置

删掉 Spacing 那一行,或改成如实的说法(唯一的响应式行为是标题 text-2xl → md:text-3xl)。不到 2 行。

参考位置

• content/docs/layout/page-header.mdx:225-229(Responsive Behavior)
• packages/layout/src/PageHeader.tsx:210、:231

关联:#3786(同一假断言的另一份副本,发现于此)、#3787

[os-zhuang]

Triage: pm:queue.

• Classification: concrete docs defect, two-line fix, no product call — the page contradicts itself after docs: page-header.mdx 的 Styling/Container 两条数值与 PageHeader.tsx 不符(pb-8 on desktop、gap-4) #3786 (Container section states pb-4 at every breakpoint; Responsive Behavior four lines later claims padding adjusts by screen size).
• Anchors verified on origin/main @ 50fa376: content/docs/layout/page-header.mdx:225-229 still carries the Spacing line verbatim; packages/layout/src/PageHeader.tsx:210 root class is flex flex-col gap-3 pb-4 border-b (no breakpoint variant), and the only responsive class is the title's md:text-3xl at :231 — exactly as the card states, including its counter-check that the Mobile/Desktop lines are true.
• Batching note for the executing seat: same file family as the docs: page-header.mdx 的 Styling/Container 两条数值与 PageHeader.tsx 不符(pb-8 on desktop、gap-4) #3786/docs/examples: PageHeader 文档页的唯一 live demo(layout-page-header/pageheader-with-actions)手搓 div,完全不用 page-header #3787 work and the open decision card docs(layout): page-header 文档页把 legacy alias 当作者面来教 —— canonical key 是 page:header,页面定位需裁定 #3906 (page positioning) — worth serializing claims on page-header.mdx, and cheap to ride alongside other queued docs fixes in one sweep PR.
• Dedup: no other open card covers the Responsive Behavior section; docs: page-header.mdx 的 Styling/Container 两条数值与 PageHeader.tsx 不符(pb-8 on desktop、gap-4) #3786 is closed and explicitly excluded this section from its pinned scope.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code

[yinlianghui]

🔒 分诊 + 认领(objectui shard PM 亲跑分诊轮,session session_01GTRjn8xBqp75dk7kFupVRt)

定级:concrete docs —— PR3905 dev 立卡:Responsive Behavior 的「Spacing: Adjusts padding for different screen sizes」(:229 一带)是 #3786 已修假断言的第四份副本,PR3905 落地后该页自相矛盾;同小节另两条已核无误。<2 行修正。

• 分支:claude/issue-3902-pageheader-responsive-claim
• 修法:按 PageHeader.tsx:210 现状改写该行(pb-4 无断点变体);⛔ 只动这一行,同页其余已由 docs: page-header.mdx 的 Styling/Container 两条数值与 PageHeader.tsx 不符(pb-8 on desktop、gap-4) #3786/PR3905 收敛。与 quick-start 教的两条 @source node_modules 行是冗余的:实测多产 100 kB CSS、14 条没人用的选择器,且补不回它看似要补的主题 utility #3884(quick-start)可各自独立,不结对以免跨文件族。
• 文件面:content/docs/layout/page-header.mdx 一行。
• 与在飞 metadata-admin 的 record:details.sections 块设计器没有 name 输入位 —— Studio 搭出来的 section 结构上无法翻译,且必然挂着上游 translation-section-name-missing #3819、ActionRunner.execute 的 condition 门用真值判定:condition: false(最明确的「永不执行」)照样执行(实测 handler 跑了) #3872、AiChatPage 发给 agent 的四条确认文本仍按 UI 语言取值:zh 控制台 + 英文会话把「确认，开始搭建。」发进英文线程,planAnswerMessage 更是完全没有会话语言门控 #3896、de 语言包 20 个值把德语开引号 „ 和 ASCII 直引号 " 配成一对(正确配对的只有 21 个),德语用户看到的收尾引号是错的 #3876 零相交。

---

Generated by Claude Code