作品集 工程记录 03 / 03

产品表达 · 一把键盘的十层结构 · 独立开发

87 键键盘:把十层装配关系,做成点得开的结构

一张爆炸图能画得好看,但不能回答问题——「这个垫片到底在哪一层」。 所以除了 A3 双页规格图,还做了一个网页版:十层逐层点开,点哪层哪层浮起、其余压暗。 这一页讲的是怎么证明它点得对:不靠眼睛,靠真浏览器和像素统计。

打开作品 →
10层零件
87颗轴
3 档曝光探针
410 KB整页含十层图

01 交付了什么

一份数据,两种交付

十个零件按装配顺序自下而上排:底壳 → 脚垫 → 电池 → 底棉 → PCB → 轴下垫 → 定位板 → 夹层棉 → 上盖 → 轴与键帽。爆炸方向是装配的逆序,间距不是等比放大——按可读性手工调过,因为等比会把上层挤成一团、下层空一片。

网页版和印刷版共用同一份 parts.json:每个零件带像素数、包围盒、质心、方向,网页用它做命中与浮起,A3 图用它摆位置。所以两个版本讲的永远是同一件事,不会出现「图上九层、网页十层」。

目标写得很具体:不懂结构的人,三层之内能看懂——点一下、浮起来、看这一段文字,就够了。

02 动手前先写下的判据

前两条是可执行的,不是感觉

判据怎么测结果
十层都能点中,点第 N 层只有第 N 层浮起 真浏览器端到端:CDP 按 parts.json 的十个键位逐个点击,断言命中与状态切换 十层全部命中
空间关系不许靠肉眼判断 analyze.py 读渲染像素:覆盖率、包围盒、页边距、亮度分位、近白裁剪比例、水平带剖面数层数 十层在剖面上可分辨
曝光选哪一档要有依据 同机位渲 +2.4 / +3.0 / +3.6 三档,按近白裁剪比例与亮度分位挑 选 +3.0
网页版与 A3 印刷版讲同一件事 两个交付都从 parts.json 取零件名与顺序 层名、层数、上下顺序一致

03 真的错过的三处

每条都按「现象 → 怎么发现的 → 改成什么 → 现在拿什么证明」写

01点击「有反应」,但选不中零件

怎么发现的
嵌入的命中图(每个像素存零件 id 的面具)在页面里解不出来,点击落在一个空图上,所以看起来点了没反应。肉眼完全看不出原因——它不报错。
改成了什么
写了一个专门的探针脚本,在真浏览器里检查面具的长度、base64 合法性、解码后的 naturalWidth、以及 new Image() 是否同步抛错,把「图没解出来」变成一个可读的错误,再改成先确认资源加载完才出图。
现在的证据
端到端测试跑在真浏览器上——真的命中测试、真的 CSS 过渡,而不是读源码猜行为;十层逐个断言,改一行就重跑。

02爆炸间距按等比放大,装配关系反而读不出

怎么发现的
第一版按相同比例把十层拉开,结果上面几层挤在一起,下面留一大片空白——每一层都「在」,但没有一层看得出自己在谁的上面。
改成了什么
改成按可读性手工调间距,十层不等距;再写一段像素分析,从渲染图抽水平带剖面、数出可见层数,确认十层都能被分辨出来(而不是我以为能)。
现在的证据
analyze.py 的输出里有每层的覆盖率、包围盒和页边距百分比;层数少了或挤了,读数会先变。

03白键盘最容易过曝,糊成一片白

怎么发现的
白配色加浅背景,曝光稍高就丢结构,稍低就脏。凭感觉调,每次改灯光都要重看一遍。
改成了什么
同一机位渲三档曝光(+2.4 / +3.0 / +3.6),用近白像素(亮度 > 0.96)的裁剪占比和核心区亮度分位来挑,不靠眼睛;同时把「覆盖率 / 近黑占比」做成固定检查项,用来抓漏渲和脏边。
现在的证据
选档记录与三档探针图都在 renders/;再改灯光,跑一遍脚本就能看出比现在好还是差。

04 如果给它加一层 AI,我会怎么验收

设计推演 · 未实现 —— 这一版还是纯静态说明

设计推演 · 未实现

做一个「装错了吗」的问答,但答案必须点在图上

现在每层旁边是一段我写的说明。这类结构问题一旦开放成问答,最容易出的事是模型讲一段听着对、但这把键盘上没有的东西。所以判据先定死:

① 只答这十个零件与 87 键位范围内的问题,超出范围直接拒答,不延伸到「一般机械键盘」;
② 每条答案必须带一个要高亮的层 id(来自 parts.json),点一下图上就浮起那一层——这是唯一能让用户当场验证答案对不对的办法;
③ 扭矩、公差、材料牌号这些没建模的参数,一律输出「未建模」,不许给一个常见数值;
④ 装错顺序的问题,要指出「第几层被放到了第几层前面」,而不是笼统说「顺序不对」。

评测怎么做:准备 30 条真实会问的问题(拆装顺序 / 换轴 / 键位兼容 / 异响),只判两件事——指对层了没有、该拒答的有没有拒。不判回答是否流畅。

05 局限