2024 年度复盘：少做演示，多做工具

这一年留下最多的并不是某个“完成”的项目，而是一批越来越朴素的工具：串口记录器、蓝牙状态面板、固件打包脚本、屏幕测试图和备份检查表。它们没有演示视频那么亮眼，却让第二次、第三次解决同类问题明显更快。

归档说明：本文按年末笔记整理，发布日期用于标记复盘时间；没有补写不存在的成绩或数据。

做对的三件事

第一，把原始证据当作产品的一部分。以前遇到问题会截一张终端图，现在工具默认保存版本号、配置摘要、时间线和原始数据。别人接手时不必先问“当时到底发生了什么”。

第二，把故障注入加入日常测试。蓝牙断开、电源抖动、传感器拔出、磁盘写满不再等现场触发，而是通过脚本或夹具主动制造。异常路径越早被执行，发布时就越少依赖运气。

第三，开始写短决策记录。为什么选择某个协议、为什么不做某项功能、阈值从哪里来，都用一页文档说明。几个月后回看代码，决策背景仍然存在，重复争论也少了。

我仍然做了太多“一次能跑”的演示。它们常常只有我的电脑能构建，依赖版本没锁定，配置藏在 IDE，甚至没有导出失败日志。演示当天很顺利，下一周换一块板就从头排查。这类工作看似速度快，其实只是把成本推给未来。

另一个问题是界面设计太早。核心数据路径还没稳定，就花时间调整按钮和颜色。后来把顺序改成命令行验证、日志闭环、最小界面、视觉打磨，返工明显减少。

串口调试台从“显示文本”变成“记录实验”；BLE 模块从“能连上”变成“能解释为什么断开”；屏幕驱动从复制初始化数组变成分层测试。这些变化都没有增加特别复杂的技术，却改变了完成的定义：功能跑通只是开始，能够验证、诊断和交接才算可用。

我不列几十项愿望，只保留四件事：让组件边界更清楚；给桌面工具建立统一发布流程；为自托管服务做自动备份演练；持续整理技术笔记。每件事都要求有可见产物，例如测试报告、恢复记录或能被别人复现的步骤。

年末最大的体会是，工程能力不只体现在解决难题，也体现在减少下一次问题的成本。一个好工具会把个人经验变成稳定流程，一篇好记录会让过去的失败继续产生价值。来年继续少做只能播放一次的演示，多做愿意长期维护的小系统。