跳转至

商家列表顶部三条带吃掉近半屏 —— 压成一行,并顺带根治一个入口消失的 P0

用户原话

1.快速模式和完整模式的切换 可以和"商家列表"4 个字一行? 2.下边那个如何压缩呢?有两行文字,太浪费了,有些没必要的,是不是可以用问号形式隐藏? 3.是不是视图和上边那个合并?默认多个视图?用户可以自己切换(视图条件写死)然后用户可以新建视图?

截图现场:标题行下面依次是 模式 Alert(整宽) → 快速筛选 chips 行 → 失败商家提示(一行小字) → 采样说明 Alert(两行) → 视图 tab 行, 五条带叠在表格上方,表格第一行已经贴到屏幕中部。

三处修法

① 模式切换并进标题行(并根治一个 P0)

两条整宽 Alert ⇒ 标题行右侧一个 ToggleButtonGroup + 一个问号。 用 portal 挂进 data-view.tsx 的标题行 —— 不把 mode 状态提上去, 因为 setMode 带着 page 重置逻辑(切模式时旧 page 在新数据集可能不存在 → 显示空页), 提升会把那段逻辑打散到两个组件里。

🔴 顺带根治一个 P0:原来「切到完整模式」这个唯一手动入口挂在 quickModeGapStable 上。 local-data-view.tsx 里 v0.10.172 那段注释记录的历史②就是这么出事的 —— 当时加了 !isRunning 条件,而 isRunning 是引擎总开关(默认 true), 整条 Alert 永不渲染,入口永久消失。 开关常驻、不挂任何条件之后,这类事故结构上不可能再发生。

② 采样说明 + 失败商家提示收进一个问号 —— 但警告没有被藏起来

⚠️ 这里有一条不能违反的既有结论(v0.10.172 对抗审 P2-②):

「筛选范围也在采样内」是行为警告不是背景知识 —— 用户按 chip 筛完导出, 少掉的行不会有任何提示。它必须在折叠态就可见,收进 Collapse 等于藏起来。

所以不是简单地把两条文字塞进问号,而是把警告降维、换到更准的位置:

  • 受影响的那三个 chip(有邮箱 / 有网址 / 高评分)数字前加一个 ~ —— 就地、常驻、只占一个字符,而且它贴在受影响的数字上,比一条通用长文更准 (长文从不说清是哪三个)
  • 「全部 / 已挖掘 / 待挖掘」不带 ~,是真实数 —— 真实数与采样数的区分原来埋在长文中间,现在一眼可见
  • 问号里放「为什么、差多少、怎么办」,以及失败商家那条

③ 快速筛选并进视图行

🔴🔴 这一节的第一版结论是错的,下面是订正后的版本。 原文写「两者本来就是同一个东西: 一组写死的筛选条件 + 一个名字」—— Tony 追问「为啥遗留?」之后我回去查了真相源, src/hooks/use-data-source.ts:130:

const mergedFilters = [...(opts.filters || []), ...quickFilters];

它们是叠加关系,不是同一个东西:视图给一组 filters,快筛再追加一组,一起进查询。 (顺带查清另一件事:viewId 本身不进查询,是 dead param —— 见 use-data-source.ts:144 的注释;视图靠把自己的 filters/keyword/logic 写进 state 生效。)

这推翻了第一版的三个判断:

第一版写的 实际
「两者本来就是同一个东西」 叠加 —— 视图是范围,快筛在范围内再收窄
「『全部』chip 与『所有数据』tab 概念重复,是遗留」 不重复:一个是「不再按条件收窄」,一个是「不用任何保存的视图」,各自维度的「不筛」
「chip 数字的问题是『作用域歧义』,只显示当前项即可回避」 那六个数不含视图条件,有视图时本来就是错的。只显示当前项=把错数字藏起来,没修对

订正后的做法:

  • 顺序改成「视图在前、快筛在后」(TableViewsHeader 的 trailing 插槽,不是 leading), 并在 chips 前加两个字「再筛」。读起来是「在 X 视图里,再筛有邮箱的」; 反过来会暗示快筛是主、视图是次。
  • 数字改用 dataSource.total —— 它就是「当前视图 ∩ 当前快筛」的结果总数, 已经在手边、免费、随视图变、两种模式都对。 只有选中项有数字,其余没有:其余那些数原本就不含视图条件,显示出来是错的。

⚠️ 为什么不让六个数都随视图变:视图是高级筛选(任意字段任意算子), 转不成 jsstore 的 where;要算就得把当前结果集整个拉回来数 —— 那正是 0188-task-detail-froze-on-400k-combos / 0192-detail-polled-a-30k-table-every-2s / 0193-combos-rebuilt-on-table-path 那个「无界查询」家族。这不是遗留,是架构约束。 - ~ 的含义随之改变:它现在只表示「快速模式只统计了最近那批行」, 与「哪三个字段」无关。问号文案同步重写 —— 旧文案讲的「三个字段是 50k 采样」 已经不适用(数字不再来自那个采样),留着就是注释在叙述一个不存在的东西。

两条「遗留」的最终处置

第一版我登记了两条遗留,Tony 追问「为啥遗留???你能一次干完???」。回去查证后:

  1. 「全部 chip 与所有数据 tab 重复」—— 不是遗留,是我判断错了。 两者不重复(见上表)。
  2. 「六个 count 一次全算」—— 不是遗留,是架构约束,而且现在不再需要。 chip 数字改用 dataSource.total 之后,根本不依赖那六个数; merchantStats 现在只为问号里的 failedCount 服务。

元教训

第一版的错误不在实现,在「我没去读那条数据路径」。 我凭两个组件「看起来都是一组筛选条件」就断定它们是同一个东西,还把它写进了 commit message、ISSUE 和三处代码注释 —— 如果没人追问,这个错误判断会以 「已归档的结论」的身份留在仓库里,下一个人读到会继续按它推理。

判据:说两个东西「是/不是同一个东西」之前,先找到它们汇合的那一行代码。 这次汇合点就一行(mergedFilters),找到它,三个判断同时被推翻。