发现于 #5013 的全仓别名一致性闸门(范围外,未指派)。
Blocked-by: #5486
成因
strictUnknownKeyError 把别名表的 key 用 aliasProbe 归一化后建索引:
const aliasProbe = (key) => key.toLowerCase().replace(/[_\-\s]/g, '');
for (const [key, canonical] of Object.entries(options.aliases ?? {})) {
aliases[aliasProbe(key)] = canonical; // 后写覆盖先写
}同一张表里两个 key 归一化后相同时,后一条静默覆盖前一条。没有任何东西检查这件事——
和 #5013 的成因是同一类:别名表是对 schema 的断言,而断言没人核对。
活defect(1 条,作者可见)
packages/spec/src/studio/flow-builder.zod.ts:244,these snap settings:
aliases: { …, grid: 'gridSize', size: 'gridSize', step: 'gridSize', visible: 'showGrid', grid_: 'showGrid' },
grid_ 归一化后是 grid,与前面的 grid 撞车且写在后面,于是 grid: 'gridSize' 被覆盖。
作者写 grid: 24(想设网格像素大小,shape 里是 gridSize: z.number().int().min(1))得到的是:
Did you mean `grid` -> `showGrid`?
showGrid 是 z.boolean()。照做即第二次被拒——正是账本 finding 7 的形状:
把作者指进一个他的值同样不合法的槽位。
休眠实例(3 条,同因不同果)
这三条两个 key 指向同一个 target,覆盖后语义不变,今天没人踩到:
| 文件 |
surface |
撞车 |
target |
data/field.zod.ts:400 |
this field |
rollup / rollUp |
都是 summaryOperations |
automation/webhook.zod.ts:141 |
this webhook |
object_name / objectName |
都是 object |
ui/chart.zod.ts:212 |
this chart series |
strokeDasharray / strokeDashArray |
都是 dashArray |
这三条其实说明了另一件事:既然 aliasProbe 已经吃掉大小写和分隔符,
同一 probe 的多条 key 本身就是冗余,写两遍不会更管用。
建议
在 #5013 新增的 packages/spec/src/shared/alias-integrity.test.ts 里加第三条断言:
一张表内任意两个别名 key 的 aliasProbe 不得相同(判定同样走运行时表,
strictObjectDeclarations() 已经把表交出来了,加这条大约十行)。
先修 flow-builder 那条(grid_ 删掉即可,visible: 'showGrid' 已经覆盖那个意图),
再删三条冗余,最后开断言。
复现日期 2026-08-05,基线 origin/main ed0d2aa。
发现于 #5013 的全仓别名一致性闸门(范围外,未指派)。
Blocked-by: #5486
成因
strictUnknownKeyError把别名表的 key 用aliasProbe归一化后建索引:同一张表里两个 key 归一化后相同时,后一条静默覆盖前一条。没有任何东西检查这件事——
和 #5013 的成因是同一类:别名表是对 schema 的断言,而断言没人核对。
活defect(1 条,作者可见)
packages/spec/src/studio/flow-builder.zod.ts:244,these snap settings:grid_归一化后是grid,与前面的grid撞车且写在后面,于是grid: 'gridSize'被覆盖。作者写
grid: 24(想设网格像素大小,shape 里是gridSize: z.number().int().min(1))得到的是:showGrid是z.boolean()。照做即第二次被拒——正是账本 finding 7 的形状:把作者指进一个他的值同样不合法的槽位。
休眠实例(3 条,同因不同果)
这三条两个 key 指向同一个 target,覆盖后语义不变,今天没人踩到:
data/field.zod.ts:400this fieldrollup/rollUpsummaryOperationsautomation/webhook.zod.ts:141this webhookobject_name/objectNameobjectui/chart.zod.ts:212this chart seriesstrokeDasharray/strokeDashArraydashArray这三条其实说明了另一件事:既然
aliasProbe已经吃掉大小写和分隔符,同一 probe 的多条 key 本身就是冗余,写两遍不会更管用。
建议
在 #5013 新增的
packages/spec/src/shared/alias-integrity.test.ts里加第三条断言:一张表内任意两个别名 key 的
aliasProbe不得相同(判定同样走运行时表,strictObjectDeclarations()已经把表交出来了,加这条大约十行)。先修
flow-builder那条(grid_删掉即可,visible: 'showGrid'已经覆盖那个意图),再删三条冗余,最后开断言。
复现日期 2026-08-05,基线
origin/mained0d2aa。