跳转至

[ISSUE-0177] ellipsis 不是自适应,它是丢信息

现象

Tony 实测截图:顶部数据条显示 11.9k…、17.9…、进行…、今日…; 任务行里「地图」chip 和「进度」两段文字叠成了「地度」,进度条压在关键词上。

病灶一:数据条 —— 信息量超过容器,却用 ellipsis 硬塞

主窗口默认 992px(DefaultCreateParams),减掉 200px 侧边栏,数据条只有 ~790px。 v0.15.0 在里面放了 6 个 KPI + 2 个转化率,且 6 个 KPI 全是 flex: 1 等分:

每格 减 px: 2(32px) 22px 的「11.9k / 16.7k」实际要
v0.15.0 ~100px 68px ~100px

超 32px ⇒ noWrap 的 ellipsis 生效 ⇒ 数字被吃掉。

⚠️ 关键认识:数据条的唯一职责就是给数字。一个被截成 17.9… 的格子不是「显示得不够完整」, 是这一格完全白做。ellipsis 在正文里是合理降级,在数字上是信息销毁。

病灶二:任务行 —— 宽度分配倒置

flex:1 | width:260 | width:260:两个写死的固定宽吃掉 520px, 信息密度最高的左侧(任务名 + 十几个关键词 + 地区数 + 总项数)只分到 244px。

窗口再窄一点,左侧被压到负宽度(原型里量到 -32px),内容溢出叠到右栏—— 这就是「地度」的来源。右侧指标区那个 Stack 也没有 minWidth: 0,同样会溢出。

修法:换空间,不丢信息

正确的自适应有三种手段,它们都保住了每一个数字:

① 降精度(不是截断)

23,085 → 23.1k。两者都能读;23… 不能。

② 换行(横向不够就用纵向)

链(商家→官网→邮箱)和旁支(手机/任务/今日)是两个不可分割单元。 放不下时旁支整条换行,而不是每格各自截断。

🔴 让三个旁支各自参与 wrap 会出现「手机和任务在第一行、今日掉到第二行」这种 断点——断在哪儿纯粹取决于字符数,既难看又没道理。

③ 重新分配宽度

任务行:操作区实测只要 ~176px(原来占 260);进度条挪到整行贴底 (它是整行的属性,不是右侧某一列的),右栏从三行降到两行。 左侧因此从 244px 拿回到 ~420px。

三个踩过的坑

坑 1:flex-basis 开大了会提前换行

链最初写 flex: 1 1 440px,结果 643px 宽就断行,而那个宽度明明放得下。

🔴 flex 的换行判定发生在收缩之前——basis 是「还没收缩时的宽度」。 basis 之和超过容器就换行,根本轮不到 shrink 去救。 ⇒ 靠 grow 撑开,不靠 basis 占位。改成 1 1 340px 后 590px 以上都能单行。

坑 2:完整数字对大数不安全

tier 0 用完整形态(23,085)时,链的最小宽度 330px 是按「最长 7 位数」算的。 数据涨到百万位后 1,234,567 会顶穿这个假设 ⇒ 在明明是最宽档的情况下反而溢出。 这种 bug 只在数据长大之后才出现、且和窗口宽度无关,最难查。 ⇒ 加 FULL_FORM_MAX = 1_000_000 上限 + k() 补 M 档(否则百万会变成比完整数字还长的 2400.0k)。

坑 3:验证时量错了东西

原型给舞台加了 transition: width .12s,而截图是在动画中途拍的 ⇒ 量到的宽度不是设的宽度,前两轮结论全部建立在错误的宽度上。 ⇒ 去掉过渡后重测,并改用「520→1000 每 4px 共 121 个点、断言每格 scrollWidth <= clientWidth」的 逐像素扫描,而不是肉眼看几张截图。

判据

tests/data-bar-adaptive.test.ts(14 条,8 条变异全部被抓): 分档单调性、三档数字形态、不许出现 ellipsis、必须按自身宽度降级、 basis 必须小于二级阈值、任务行不许写死 260、进度条必须 absolute 贴底 + 行容器必须 relative。

tests/data-bar-funnel.test.ts 第 6 条改过锚点:原来量 noBorder 这个 prop 名字, 而 v0.15.1 重排后链内 Kpi 根本不画 borderRight(分隔改由旁支容器的 borderLeft 承担), 立意一分没变、判据却红了——它量的是实现手段,不是立意。已换到立意那一层。


🔴 v0.15.1 返工(v0.15.2):修了一半,另一半更糟

Tony 实测 v0.15.1 截图:任务行重叠得比修之前还厉害 —— 「13265」直接压在「地图」chip 上,「6024/443910 · 剩余 19 天」压在关键词行上。

根因:我把「最重要的一栏」设成了「最先被饿死的一栏」

v0.15.1 的左侧信息区写的是:

<Box sx={{ flex: 1, minWidth: 0 }}>   // flex: 1 === flex: 1 1 0%

flex-basis: 0 的语义是「我不预占任何宽度,剩多少拿多少」。 于是分配顺序变成:

basis 结果
指标区 210px 先被满足
操作区 auto(~176px,不收缩) 先被满足
信息区 0 拿剩下的

Tony 那个窗口只有 717px 宽 ⇒ 内容区 ~517 ⇒ 任务行容器 ~467。 467 - 210 - 176 - 24 = 57px —— 信息区只剩 57px,内容全部溢出叠到隔壁。

⚠️ v0.15.1 的诊断是对的(宽度分配倒置),但修法只改了数值、没改结构: 把 260 换成 210 只是让饿死来得晚一点,basis: 0 这个根因一直在。

修法

① 信息区给真正的 basis:flex: '1 1 240px'。 收缩按比例发生,它不会被单方面榨干。

② 三栏放不下就换两行(和数据条旁支换行同一条原则): ROW_THREE_COL_MIN = 650(= 信息区 240 + 指标 210 + 操作 176 + 间距 24)。 低于它,指标并进信息区下方横排一行,信息区因此拿回整行宽度。

③ 换行兜底:标题行 useFlexGap + flexWrap —— 窗口窄到连三个 chip 都排不下时让它们换行,而不是溢出重叠。 ⚠️ MUI Stack 在 wrap 时必须配 useFlexGap:默认 spacing 用 & > * + * { margin-left },换行后第二行首个元素仍带左边距,排出来是歪的。

这次的验证方式变了

v0.15.1 只验了数据条(121 个宽度点),任务行一个点都没验 —— 于是回归就发生在没验的那半。

v0.15.2 给任务行补了同样的扫描,而且判据更强: 不只测「有没有文字被截」,还逐对比较三栏的矩形有没有相交(重叠的直接判据)。 300→900 共 601 个宽度点,0 处重叠。

元教训

修了 A 没验 B,回归就出在 B。 上一轮我明确写了「证据边界:真组件的实际渲染没能看到」—— 边界写对了,但没有把边界内能验的部分验全。 原型能验任务行(它和数据条一样是纯 flex 布局),我只是没做。


🔴 v0.15.2 再返工(v0.15.3):两个各自独立的病灶

Tony 第三张截图(v0.15.2 实测):「状态不应该对齐吗??其他的细节也注意 比如挡住了」

病灶三:noWrap 在 inline 元素上只生效一半

关键词行是 <Typography variant="caption" noWrap>。 MUI 的 caption 变体渲染成 <span>,而它的父容器是 Box(block)不是 flex —— span 于是保持 display: inline,而 overflow: hidden 对 inline 元素无效。

⇒ noWrap 只剩 white-space: nowrap 起作用:文字不换行、也不省略、直接溢出, 压在右边的指标区上。这就是三张截图里「挡住了」的真正根因。

对照:指标区里那两行同样是 caption,却没有这个问题 —— 它们是 flex item,会被 blockify。renderWebsite 里那处同理。 所以全项目只有这一处需要显式 display: 'block'。

⚠️ v0.14.1 加的「按字符预算截断关键词」是可读性措施,不是溢出防线。 只做了前者,所以这个 bug 从 v0.14.1 一路活到 v0.15.2。

病灶四:可收缩的列 = 逐行不等宽 = 全列错位

v0.15.2 把指标区设成 flex: '0 1 210px'(可收缩),操作区设成按需占宽。 在单行视角下这是对的;放进列表就错了:

任务状态 操作区内容 宽度
running 暂停 + 商家 + ⋮ 188px
done 商家 + ⋮ 130px

⇒ 操作区宽度逐行不同 ⇒ 左边所有栏跟着逐行不同 ⇒ 状态 chip、编辑图标全部参差不齐。Tony 截图里差 58px —— 正好一个「暂停」按钮。

🔴 v0.15.1 的这句话是错的:「右对齐 + 行右边缘固定已经保证了对齐,不需要再占一块死宽度」。 右对齐只保证操作区自己贴着行右边缘,管不了它左边那些栏。 原作者写死 width: 260 是对的,错只错在 260 太宽(实测只要 188)。

⇒ 固定宽度回来:ACTION_COL_W = 192,指标区改 flex: '0 0 210px'。 可收缩性由「三栏 → 两行」的整档切换承担,不由单栏各自收缩承担。

阈值随之从 650 改 670(240 + 210 + 192 + 24 = 666)。 v0.15.2 把操作区估成 176 是因为原型里的按钮是手写的窄按钮; 真实 MUI Button size="small" 带 startIcon 是 padding 10 + icon 20 + 间距 8 + 两个中文字 26 + padding 10 = 74px。

这次判据也补了一个洞

原型的重叠检测只比较「三栏的矩形是否相交」。而操作区 justify-content: flex-end 时内容向左溢出,getBoundingClientRect 仍是设定宽度 ⇒ 矩形不相交,但内容确实盖住了隔壁。 补了第五条:任何一栏 scrollWidth > clientWidth 都算失败。

补上之后立刻抓到了「操作区宽度不足」这个原本会漏过的问题。 ⇒ 「矩形不相交」不等于「没有重叠」。

判据自己也踩了今天的主题

新加的「关键词行必须 display:block」判据,第一版拿 {/* 标题行 这个注释当锚点 —— 而判据的输入是 codeOnly() 剥过注释的文本,永远找不到。 ⇒ 锚点必须是代码里的唯一标识符。已换成 const BUDGET。


🔴 对抗审返工(v0.15.4):两路独立命中同一个 P0

2026-09-19 用 dsh 派双路对抗审(dshf·deepseek × mimo-pro·xiaomi,跨厂商, 同一份任务书 sha256 逐字节相同,互不通信)。两路都判 GO-WITH-CHANGES (6.0 / 7.2,门槛是 9.0 + P0=0 + P1=0)⇒ BLOCK,返工。

P0(两路独立命中):strip_js_comments 没有正则字面量状态

s.replace(/\/\//g, ''); const box = { width: 260 };

剥完只剩 s.replace(/\/ —— 正则里的 \/\/ 被当成行注释起点, 把该行后面的真代码整段剥掉 ⇒ expect: absent 判据漏报真违规(假绿)。

⚠️ 漏报比误报严重得多:误报拦住提交(看得见),漏报是闸静默失效(看不见)。

mimo-pro 补的关键事实:全仓 110 个 audit_grep pattern 里只有 ISSUE-0178 用了 scope: code,而那个文件恰好不含正则字面量 —— 这个 bug 目前是靠运气没发作。

修:状态机加正则字面量态(启发式判断 / 是除法还是正则,靠「上一个有意义字符」)。

P1:判据值盲(两路共识)

dshf 实测:把 ACTION_COL_W 改成 10、指标区改成 10px,24 条判据照样全绿。 ⇒ 192/210/726 这三个数没有任何东西在守,而 commit 里却写着「变异全部被抓」。

修:把注释里的推导式变成可执行断言(见 tests/data-bar-adaptive.test.ts 「宽度常量必须对得上自己的推导」)。

P1:阈值单位错位

ROW_THREE_COL_MIN 量的是列表宽,而 240+210+192+24=666 是行内宽 —— 中间隔着卡片 padding(20) + border(2) + checkbox(30) + 间距(8) ≈ 60px。 v0.15.3 写 670 时列表宽 670 只剩 610 行内宽,信息区实得 ~184px 而不是设计的 240。 不重叠(内容能 ellipsis),但「三栏放得下」这个说法是假的。 ⇒ 阈值改 726,并把这条写成判据。

P1:证据从未入仓

commit 里的「121 / 601 / 701 个宽度点全绿」是在浏览器 console 手敲的一次性循环, 原型在 gitignore 的 .tmp/ 里 ⇒ 任何人(包括我自己)都无法复现。 而且 601 与 701 两个数字在 docs 与 commit 之间自相矛盾。

⇒ 台子和扫描驱动一起入仓(tests/layout/):harness 带 ?scan=1 自己跑完整扫描 并把结论写进 DOM,node tests/layout/scan.mjs 抓回来。 它如实报出了 300–326px 区间的 27 处内容溢出 —— 那正是我之前口头说过、 但从未拿出数字的部分。

P1:guard 判定过宽

原来吞三种错误文本。Receiving end does not exist / message port closed 不是「扩展已重载」的同义词 —— background SW 真挂了报的也是它们。 ⇒ 收窄到只认 Extension context invalidated。 「判定必须窄,放宽会吞掉真 bug」是这个文件自己写的原则,上一版却没照着做。

P2:两处论证错(结论对、依据错)

「实测 188px」是按 MUI 默认 Button padding(10) 算的,而本项目主题 override 成了 4px ⇒ 最宽态实际 166px。192 仍够用,但当时的算法漏了主题 override。

🔄 修判据时又踩了一次同样的坑

新加的正则字面量判据第一版是恒真的:转义层数写错(四层 \\\\), 落到 fixture 里变成 JS 的「匹配一个反斜杠」而不是「双斜杠」, 于是把修复摘掉判据照样绿。变异验证当场抓住,改用 chr(92) 拼接才成真。

⇒ 这一轮里判据自己出错两次(锚点用注释、转义层数),两次都是变异验证抓的。 没有变异验证的判据不算判据。


🔴 v0.15.5:补掉上一刀漏修的那一半

对抗审 C 路的 P0 原文写的是「正则字面量……判据侧同一缺陷存在于 tests/_helpers/code-only.ts(未被本次修复)」。 v0.15.4 只修了 Python 那份,TS 这份漏了 —— 而它的影响面更大:

codeOnly() 被 23 个判据文件依赖(设置项文案、密钥不外泄、UI 死路…)。 实测 var r = /\//; var box = { width: 260 }; 剥完只剩 var r = /\ —— 那 23 个文件里的断言在遇到含正则字面量的源码时会静默变成恒绿。

顺带发现:它自己一条测试都没有

23 个判据依赖它,而这个 helper 从来没有被测过。 它坏掉的方式恰恰是最危险的那种:不报错,只是让依赖它的判据全部失效。

⇒ 建 tests/code-only-lexer.test.ts(10 条,4 条变异全抓)。 判据分成方向相反的两组: - 「剥掉的必须是注释」—— 行/块/跨行/${} 内/撇号污染 - 🔴 「留下的必须是全部代码」—— 正则字面量、replace 形态、除法、URL、模板文本 (只有这一组能抓住 return '',前一组对它恒绿)

同时修掉 3 条恒真判据

D 路点名 AuditGrepScopeTest 里 3 条在 empty strip 下恒绿: 它们只断言「注释里的 pattern 没被找到」,而整个文件被剥空时结果一模一样。

⇒ 加 assert_code_survives():每条都要再问一句「代码那半边还在吗」。 效果:同一个变异(strip 返回空串)从「11 条抓到 4 条」变成「14 条抓到 9 条」。

两路有一处分歧,按证据裁决

ACTION_COL_W 余量:C 路算 166px(余量 26),D 路算 186-194px(余量仅 4,标 TIGHT)。 采 C 路 —— 它读了 src/theme/overrides/components/button.tsx, 本项目把 Button 的 padding override 成 4px;D 路用的是 MUI 默认 10px。 主控独立复核主题文件确认 override 存在。不投票,看谁查了源码。


🔴 第二轮对抗审(v0.15.7):换掉手写词法器

第二轮双路重审(同样 dshf × mimo-pro,任务书明确要求「独立核实 8 条 finding 是否真修好,而不是接受主控的说法」):

路 评分 P0 P1 结论
dshf 3.5 1 2 NO-GO
mimo-pro 7.5 0 1 GO-WITH-CHANGES

新 P0:JSX 文本节点

<div>See https://a.com//style width: 260 here</div>

剥出的文本停在 ...See https: —— JSX 文本节点里的 // 被当行注释, 吃掉整行剩余内容 ⇒ expect: absent 漏报。 dshf 给了端到端复现(走真实 grep_pattern,控制组/变异组对照)。

真正的问题不是「又少了一个状态」

dshf 的 X_OPEN 一句话点破:

这份词法器的正确性,由谁独立裁决? 两份同构实现共享同一个漏洞时,parity 会永远绿。

实证就是这么发生的:v0.15.6 建的共享用例表里没有 JSX 用例, 于是两份实现同步地漏剥 JSX 文本,两侧 parity 全绿。 共享用例表只能证明一致,不能证明正确。

而手写启发式的补丁史本身就是证据: 字符串 → 模板 → 模板插值 → 正则字面量 → JSX 文本 → …… 每一个都是被漏报倒逼补上的。

⇒ 换裁决者:TypeScript 官方 parser

typescript 本来就在依赖里,它对这套词法的裁决是权威的。

  • TS 侧 tests/_helpers/code-only.ts:直接用 parser(23 个判据依赖它)
  • Python 侧:走 scripts/strip-comments-ts.mjs(同一个裁决者),批量调用

用例表保留 —— 它的角色从「正确性来源」降级为「锁定已知形态的回归网」。

路上踩的三个坑(都是判据抓的,不是我看出来的)

  1. forEachChild 走不到 token 级 ⇒ JSX 子元素之间的 {/* */} 整片漏收 ⇒ 注释没剥干净 ⇒ 4 条既有判据当场误报。改 getChildren 递归到叶子。
  2. 我自己加的 JSX 启发式制造了假违规 —— 当场报出一个注释里的 width: 260, 把 scope: code 的意义整个抵消掉。⇒ 回退,换 parser。 「修一个洞时新开的洞」正是任务书里让审查方重点盯的方向,结果我自己撞上了。
  3. cwd 相对路径 —— 扫描器会在隔离 fixture 的临时目录里被调用, 相对路径找不到剥离脚本 ⇒ 退回原文 ⇒ 5 条 fixture 判据红。 改脚本自身位置推导。那次红本身说明 fail-safe 方向选对了:不是静默错,是响亮地错。

fail-safe 方向是刻意的

node 不可用 / 解析失败 ⇒ 该文件退回原文(不剥)。 不剥只会让注释里的字样算成命中(误报,看得见、能改); 剥错会吞掉真代码(漏报,静默失效)。宁可误报,不可漏报。


🔴 第三轮对抗审(v0.15.8):P0 清零,但三类「判据自身」的问题

路 评分 P0 P1 结论
dshf 6.0 0 3 GO-WITH-CHANGES
mimo-pro 8.0 0 3 GO-WITH-CHANGES

P0 清零(换 parser 之后 JSX 漏报确实没了,两路各自复现确认)。 剩下的三类问题全都出在判据自身,而不是产品代码:

① 死代码(两路独立命中)

换 parser 后 strip_js_comments 在生产路径上零调用点,但我把它留着了。 mimo-pro 的 X_OPEN 说得准:保留死代码的风险是 「未来有人误以为它是有效 fallback 并重新启用」+「审查时看到两个实现会困惑哪个是真相源」。 ⇒ 删除。

② 假 parity —— 比「parity 永远绿」更糟

test-lexer-parity.py 在 v0.15.7 被我改成调 strip_via_node(TS parser 的包装), 于是它和 TS 侧的 code-only-lexer.test.ts 测的是同一个东西, 而 Python 侧真正在跑的链路(strip_via_ts 批量填缓存 → text_for_scan 取用 → 降级) 一条判据都没有。

⇒ 重写为测那条真实链路,含降级方向的锁定 (缓存缺失时必须退回原文而不是返回空 —— 误报看得见,漏报静默失效)。

🔴 重写后做变异,第一版 test_raw_scope_is_untouched 仍然恒真: 缓存里没有该文件时,降级路径返回的同样是原文,于是把 scope 判断改坏也测不出来。 加「该文件必须先进缓存」的前提才真正可区分。

③ 证据台子自己腐烂了

我为了治「证据不可复现」把 harness 入仓,结果它扫的是 670/176,而发货的是 726/192。 dshf 的评语很准:

「保持手动」等于回到它自己在 README 里刚判成 P1 的状态 (证据不在闸里=可再次腐烂),而且已经腐烂了。

⇒ 我原先「不把 scan.mjs 接进 verify」的判断被评为「方向对,结论不足」: verify 必须处处可跑、headless Chrome 是可选依赖,这部分对; 但「保持手动」不是答案。 正解:台子本身不进 verify,但「台子与源码常量的一致性」不需要浏览器就能查 —— 那条一致性判据现在进了 verify。

④ 锚点不唯一(dshf 实测)

toMatch(/flex: '1 1 \d+px'/) 是全文搜 —— 审查方把 renderMaps 与 renderWebsite 的 basis 对调,19 条判据照样全绿。⇒ 锚点收窄到 renderMaps 函数体内。

⑤ 一族 not.toMatch 判据恒真

codeOnly() 返回空串时,所有 not.toMatch 都恒绿(实测 4 条)。 它们各自与正向判据配对,所以不是独立漏洞,但「变异全部被抓」这句话是夸大的。 ⇒ 加一条共同前提(剥完必须仍有体量与锚点),让整族一起红而不是一起绿。 效果:同一个变异从「4 条恒绿」变成 14 条红。

🔴 两处自述被纠正

  • 「补了 5 条 JSX 用例」→ 实为 4 条 JSX + 1 条泛型(那条名字里带 JSX,内容不是)。 mimo-pro 按内容数,我按名字数 —— 它对。
  • 「变异全部被抓」→ 见 ⑤。

⇒ 记录在案:夸大的验证声明比没有声明更危险,因为它会让人停止检查。


第四轮对抗审(v0.15.9):三条 P1 全在「守得不够」而非「守错了」

dshf 8.0(P0=0 P1=3)。P0 连续两轮为 0;三条 P1 都是同一类: 修了形态没修值、修了一半没修另一半。

P1-1:最该守的那个数反而没守

判据给 192 / 210 / 726 都加了值域断言,唯独信息区的 240 只查形态不查值。 审查方实测:源码改成 flex: '1 1 40px'(形态保留)⇒ 21 条判据全绿。

而「信息区不能被饿死」是 ISSUE-0177 的全部立意,240 就是那个数。 ⇒ 抽成共享常量 INFO_MIN_BASIS,阈值推导与 basis 值域判据用同一个数。

P1-2:一致性闸只覆盖 2/4 个常量

v0.15.8 加的「harness 与源码一致」判据只查了阈值和 ACTION_COL_W。 审查方两个构造都全绿: - 改 harness 的 .left basis → 40、.m.wide → 99 - data-bar-harness.html 里的 v<700/v<590 —— 全仓没有任何判据读它

⇒ 一致性闸漏掉的常量,正是下一次腐烂的位置。已覆盖两张台子的全部关键常量。

P1-3:「共用同一个裁决者」与实存不符

  • strip-comments-ts.mjs 按扩展名硬选 ScriptKind
  • code-only.ts 用双模态择优(TSX 试不通再试 TS)

同一个 parser,不同的 kind 决策 ⇒ .tsx 里出现泛型箭头 <T,>(x)=>x 时两条路分歧, 而两边注释与本文都声称「共用同一个裁决者」。 ⇒ mjs 也改双模态择优,扩展名只决定先试哪个。

验证

审查方给的四个构造,现在全部被抓: 源码 240→40、harness .left→40、harness 指标→99、数据条台子阈值腐烂。

B 路(mimo-pro):GO,9.2 —— 首次有一路达到门槛

两条 P1 都指向同一处:ACTION_NEEDED = 166。

第二条成立:主题区分 variant —— smallSize 给 padding 8, textVariant 才额外覆盖成 4。原注释只写了「padding 4」,漏了这个前提。

第一条(174 vs 166)我判 166:差的 8px 来自 IconButton —— 默认 padding 8(36px),size="small" 才是 5(30px)。代码里用的是 small。 (这与第一轮 dshf 166 / mimo-pro 186-194 的分歧是同一处,依据同样是「谁读了真实配置」。)

🔴 但这次分歧暴露了更实质的东西:166 依赖三个隐含假设 (Button small、Button text variant、IconButton small),而没有任何东西守着它们。 两家算出两个数,差异全部来自这里。

⇒ 不是改数字,是把假设立成判据:操作区里的按钮必须全部 size="small"、 不得出现 outlined/contained。两个变异(去掉一个 small、改成 outlined)均已验红。

数字依赖的假设不守,数字本身就是浮的。