从配列开始做一张键盘版本卡

键盘项目最容易从“想换个布局”开始，最后却找不到当时为什么改。版本卡先固定使用场景，再记录配列、固件、定位板、外壳和键帽的变化。这样一轮改动结束后，留下的是可以回看的工程记录，而不是一串模糊的“更舒服了”。

先写场景，再选配列

把每天真正会用到的动作写下来：文字输入、终端快捷键、数字录入、窗口切换，还是需要频繁移动鼠标。每个动作对应一个约束，例如主区宽度、方向键位置、独立数字区或层切换的位置。约束写清楚后，配列取舍就能解释，而不是靠图片的第一印象。

一张版本卡的字段

字段	记录内容	证据
layout	行列、层、特殊键和改动原因	配列图或固件配置
switch	轴体、润滑/弹簧处理、触发偏好	采购批次与手感备注
plate / case	材料、厚度、装配方式	CAD 版本和实物照片
firmware_commit	固件提交、键位映射、构建日期	仓库提交或构建日志
sound_note	测试桌面、键帽和录音位置	同一条件的录音
rollback_to	出现问题时恢复的版本	旧配置或标签

手感描述要绑定测试条件。相同轴体在不同定位板、底壳填充和键帽下会呈现不同反馈；如果条件没有固定，就只把它写成“本次主观感受”，不要包装成客观结论。

版本命名与小步实验

建议使用 KBD-YYYYMMDD-rN 这样的名字，每次只改变一个主变量：例如保持配列和键帽不变，只更换定位板；下一轮再恢复定位板，只调整底壳填充。每轮记录变更、观察、未解决问题和回退方式，避免一次改五项以后无法判断原因。

当前档案边界

当前工程资料没有键盘样机、BOM 或固件提交，因此本文是可直接套用的记录模板，不描述一把已经完成的键盘。真正建立档案时，再补上实物照片、尺寸和长期使用记录。只有字段能被照片、BOM 或提交记录复核，版本卡才算完成。