维护者确认：PR #3754 窄窗口用量表格布局修复

[MagicLizi]

PR #3754 修复设置页「用量历史」在窄窗口下按 Agent / 按模型表格列重叠。

改动会改变用户看得见的布局与交互：两张表明确最小宽度（520 / 720px），首列 overflow-hidden，空间不足时走横向滚动而不是继续压缩列。属于产品 / UI 布局确认，不是零像素的内部修复。

请维护者直接在 PR 上 Approve 放行；若需要修改请 Request Changes，作者改完后再 Approve 即放行。

---

关联 PR:#3754(作者 @Stella-xixi);本 issue 由 review-pr 流程自动创建,用于先讨论该 PR 涉及的产品 / UI 变更,维护者确认后 PR 会恢复推进。

[dash-s-cindy]

判断：设置 → 用量历史的按 Agent / 按模型表格确实需要保证窄窗口下的可读布局；当前缺少的不是展示能力或统计逻辑，而是极窄内容区下对最小列宽、首列溢出和横向滚动边界的稳定约束。建议继续推进 PR #3754，但将其视为已有修复的布局补强：确认产品行为后合并，不需要修改聚合、排序、模型格式化或名称长度限制。

进一步检查发现，当前 main 快照 838e3cf7c9a56e51ef2097091a0adc4241657416 的 apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx 已具备：

• Agent 表和模型表首列使用 w-full max-w-0 pl-0，使首列成为可收缩列；
• 首列内部使用 flex min-w-0，名称使用 truncate，并通过原生 title 保留完整 Agent 名或模型 ID 的查看入口；
• 其他表头和数值列使用 pl-3，避免截断后相邻数字贴连；
• apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx 在两张明细表外层使用 overflow-x-auto，空间不足时允许横向查看表格。

因此，PR #3754 提出的 520px（Agent）和 720px（模型）最小宽度、首列 overflow-hidden 与现有滚动容器是同一产品目标的进一步明确化：名称和标签不侵入相邻列，数字列保持完整，整体空间不足时由横向滚动承接。它没有移除用户行为，也没有改变数据含义。

建议行动

1. 确认并推进 PR fix(settings): 修复窄窗口用量表格列重叠 #3754 的产品布局方向。 该 PR 当前仍为 open、未合并，标签为 awaiting-discussion 和 touches:product-ui；维护者应在产品行为上确认“明确最小宽度 + 横向滚动”是可接受的窄窗口表现。现有 窄窗口下「用量历史」表格首列与相邻列及表头发生重叠 #3546 的期望行为和已合并 fix(settings): 用量历史「按模型 / 按 agent」表首列不再横向撑开 #3446 的实现先例均支持这一方向。

2. 先处理审查阻塞，再 Approve。 PR fix(settings): 修复窄窗口用量表格列重叠 #3754 的自动审查认为实现与现有 overflow-x-auto 调用链配合良好，但指出新增响应式测试目前主要锁定 CSS 类名，没有渲染生产滚动容器，也没有测量实际溢出、滚动和列边界。当前 PR 讨论还记录有一个未 resolve 的 review conversation。建议作者补充或说明真实窄容器行为，resolve conversation 后重新触发审查，再由维护者 Approve；不建议在证据不足时直接放行。

3. 做最小真实 UI 验证。 在 Windows、zh-CN、桌面设置 → 用量历史路径验证：

   • 常规内容区约 800px；
   • 窄内容区约 460px；
   • 极窄内容区约 230px；
   • 超长自定义 model ID、超长 Agent 名，以及模型名旁带 Agent 标签的行。

   检查首列省略号是否稳定、名称与标签是否保持边界、各列表头是否独立、数字列是否完整，以及横向滚动是否可操作。PR 已报告 Windows 最窄窗口的手工验证，以及相关单元测试和 typecheck 通过；剩余重点是把测试从类名存在性提升到真实布局行为，避免 CSS 回退时测试仍通过。

4. 区分发布落地。 fix(settings): 用量历史「按模型 / 按 agent」表首列不再横向撑开 #3446 已于 2026-08-26 合并，当前 main 已包含其核心首列收缩和滚动保护；但用户报告来自 0.1.66，不能仅凭 main 代码判断用户构建是否包含修复。若 0.1.66 不含 fix(settings): 用量历史「按模型 / 按 agent」表首列不再横向撑开 #3446，应按版本发布落地问题处理；若已包含且仍能复现，则需记录精确窗口宽度、设置内容区宽度、渲染环境和最小数据样本，再定位新的 DOM/CSS 几何问题。

边界与风险

本次建议范围仅限 renderer 表格布局。不要顺带修改 usageHistoryStats、token 聚合口径、排序、formatModelShort、供应商空值语义，或为模型/Agent 名增加业务长度限制；这些都不是当前证据所要求的改动。已有方案通过省略号和 title 保留完整名称，横向滚动也保留完整数字列，回滚只需回退布局提交，不涉及数据迁移或协议兼容。

相关记录

• #3546：同一用量历史窄窗口重叠现象的用户报告，明确了首列不覆盖数字列、空间不足时横向滚动的产品期望。
• #3446：已合并的直接前置修复，解决按模型 / 按 Agent 首列长文本横向撑开问题，并在当前 main 中留下 w-full max-w-0、truncate、title、列间距和滚动容器实现。
• #3393：已合并的同类任务表修复，为首列收缩和完整名称悬停查看提供既有技术与设计先例。
• #3754：当前待产品确认的补强 PR；尚未合并，且真实布局行为测试仍需加强。