更新记录
每篇文章末尾都留着修订记录。这个页把它们汇总起来—— 被推翻的结论不删掉,而是划掉重写。
-
一台不存在的设备
如果只留一句话,是这句:模拟的价值不在于像,而在于它逼真实现说清了自己的契约。种子固定、能力残缺、诚实报未实现—— 三件事看着都是「故意不把模拟做好」,其实全是把工程做扎实。
-
把 wx 关在门外
写这篇时反复想起的一句话是「规则靠人自觉守不住」。这句判断的另一半是: 能被机器校验的规则,就应该被机器校验—— 专用脚本比通用 lint 工具更精确,把省下的工具链复杂度留给真正需要的地方。
-
全绿之后,模拟器崩了
这篇最想留下的不是「要写 /index」这个知识点,而是它背后的模式: 多环境工具链里,最严格的那个解析器决定代码怎么写。 TS 和 Jest 都宽容,但宽容是它们的自由,不是代码的自由。
-
只有六个动词的协议
写完才发现,这篇里每个设计都指向同一件事:把不确定性往确定的方向压—— 角度用相对增量压掉累积误差,越界用钳制压掉异常分支,安全用设备侧看门狗压掉断连风险,演进用能力协商压掉版本碎片化。
-
它听不懂时,选择不猜
复盘时最想留下的是这个顺序:先定「不确定时怎么办」,再写「确定时怎么解析」。兜底话术和能力边界测试都是先于流水线细节确定的—— 因为它们定义了这个系统的品格:宁可笨一点,不可错一句。
-
它听不懂时,选择不猜
整理自「一语控物」项目的解析层设计与实施记录(
docs/03-指令解析层与降级策略.mdv1.1)。 -
只有六个动词的协议
整理自 DAP v1 协议规范(docs/02,v1.0 冻结于 2026-09-12)及 motion.drive 增量的实施记录。协议一致性由 tests/fixtures/commands.json 的测试向量保证。
-
全绿之后,模拟器崩了
整理自「一语控物」项目的真实踩坑记录(docs/04-开发规范与约定.md §2.2 的出处)。
-
把 wx 关在门外
整理自「一语控物」项目的架构纪律与测试基线(docs/01 §2.3、docs/04 §3,以及 scripts/check-core-purity.mjs 的实施记录)。
-
一台不存在的设备
整理自「一语控物」的虚拟设备设计(core/virtual/、 docs/01 §2.2 原则 P1、docs/02 §6.1 标准能力集)。
-
黑豹 X2 假死之后
文中所有命令都在复活后的系统上验证过一遍。最有价值的不是某条命令,而是 MaskROM 这个「底层安全网」的存在—— 它意味着对瑞芯微的板子来说,系统层的砖几乎没有救不回来的。
-
RK3566 的 NPU 跑起来之前
最大的认知修正:我一开始在 /proc/misc 里找了很久 NPU,把「找不到设备」当成了「驱动没装」。实际上证据链从头到尾都躺在 dmesg 里——先看内核说什么,再去用户态找对应物,这个顺序不能反。
-
retcode -3:包发出去了,没人回
整个排查走了两次方向转折:先放弃跨发行版(统一成 Jazzy),再放弃自动发现(CycloneDDS + 显式单播)。复盘下来,DDS 排障的核心心法是「报错在发送端,问题在对端」—— 顺着这个方向按表排查,半小时能走完当初几天的路。
-
在 Armbian 上装 ROS 2 Jazzy 的两条路
两条路线先后都走过,最终稳定在「容器为主」。决定性因素其实是第三篇里那个 DDS 问题:跨机通信要求容器用 host 网络,而这一步做完之后,容器路线和原生环境的差距就只剩下两条 start 命令了。
-
在 Armbian 上装 ROS 2 Jazzy 的两条路
整理自 2026 年 10 月在黑豹 X2(Armbian trixie)上的环境搭建记录。 RoboStack 的 channel 名与 ROS 2 版本号绑定(robostack-jazzy),换发行版时 channel 也要跟着换。
-
retcode -3:包发出去了,没人回
整理自 2026 年 10 月打通「PC(Ubuntu + Docker)↔ 黑豹 X2(Armbian + Podman)」 ROS 2 Jazzy 链路的完整过程。IP、网卡名请按自己的拓扑替换。
-
RK3566 的 NPU 跑起来之前
整理自 2026 年 10 月在黑豹 X2(Armbian,内核 6.1)上的部署记录。 librknnrt 版本会持续更新,命令请按自己手上的 toolkit 版本调整。
-
黑豹 X2 假死之后
整理自 2026 年 10 月一次真实的救砖过程。功耗计、RKDevTool、ICS 共享这些工具的版本会变,但「先证明活着、再谈修复、修完立刻备份」这个顺序不会变。
-
一次好得可疑的拟合
补上了第 04、05 两节。原始便签里只有代码和一行结果 JSON,当时我觉得"跑通了"就收工了——重读时才发现那两个数字一直在报警。
-
我改了那个函数,但跑的不是它
原文只写了"系统中有两个不同的 onAtmosphericDataReceived 实现"这一句。重读时我觉得这一句才是整段记录里最值钱的部分,所以单独给它一节。
-
两个输入,一个状态机
新增第 02、03 两节。原文只写了「旋转不能切模式」这个结论,没有写理由——补理由的过程让我发现自己当初的直觉是对的,只是说不清为什么。
-
micro_ros_agent 装不上的三个原因
补上了
ros2 topic hz那段数据——原始笔记里只写了「好像不太稳」,把数字摊开之后才看清问题的量级。 -
把手机变成 ROS 2 上位机
重读时改了一处结论:把「强制使用内置 fmt」改成了「先清干净再构建」。原始记录里的步骤和它自己的标题对不上,而真正起作用的显然是清理。
-
在没有 systemd 的环境里让服务活下来
把三段笔记合并时才发现它们的结构是一样的:都是「在不标准的环境里,找一个标准事件当钩子」。这条线比单个命令更值得留下。
-
内容对了,为什么没送到
把「0.35 Hz + 时间戳为 0」这两条线索单独提出来讲。原始笔记里它们混在排查过程里,其实它们是判断「这个发布者会不会自己消失」最快的依据。
-
那 7 秒里,6 秒在加载模型
新增第 04 节。原始便签里只是把启动命令和几条验证命令罗列在一起,没有解释那些 duration 字段——而它们才是"为什么第一次这么慢"的答案。
-
8 GB 显存里塞一个 27B 模型
把「加载失败」和「性能衰减」合成了一篇——它们本来是同一次折腾的前后两段,分开看只是两个孤立的问题,串起来才是一条完整的"从跑不动到跑起来再到跑得快"的路径。
-
读懂 ESP32 的启动日志
补上了 0x3F0000 + 64 KB = 0x400000 的地址核对过程——当初只是觉得「数字对得上」,没有真的算过。
-
读懂 ESP32 的启动日志
整理自 2026 年 8 月的一段串口记录与当时的排查笔记。日志原文来自 ESP32-WROOM-32E(ESP-IDF v5.5.4 / Arduino 3.3.10),未作删改。
-
8 GB 显存里塞一个 27B 模型
整理自一份两小时的 llama-server 运行日志与相应的排查记录。机型为 Ryzen 7 7735H + RTX 4060(8 GB)+ 16 GB 内存,模型为 27B 三值量化。
-
串口日志里的一天
补上第二步反向验证的数据(掉线周期随雷达校准周期变为 12 s)。初稿里我只写了"换电源后恢复",那不构成证据。
-
串口日志里的一天
初稿把根因写成"Wi-Fi 信道干扰",结论错误,已全文重写。感谢读者 Z 在邮件里指出 40 s 周期与雷达电机声同步。
-
我的工作台:一张桌上的十四件东西
杜邦线那一段补了一句:间歇性故障先换线。过去三个月我遇到两次,两次都是线。
-
Wi-Fi 上跑 ROS 2,是一种什么体验
有读者问为什么不上 5 GHz。ESP32-WROOM 只支持 2.4 GHz,这个型号没得选;ESP32-C5 / S3 的部分型号才支持 5 GHz。
-
那 7 秒里,6 秒在加载模型
整理自 2026 年 8 月 31 日的便签记录。日志与 JSON 返回值为当时的真实输出,机器为无独立显卡的 aarch64 设备(可用内存 6.3 GiB)。
-
内容对了,为什么没送到
整理自 2026 年 8 月 30 日的排查记录。当时的现象是停掉手动发布的 TF 之后,点云画面依旧存在——顺着这条线才把 QoS 不匹配的问题挖出来。
-
Wi-Fi 上跑 ROS 2,是一种什么体验
初稿把 43 ms 写成"最终值",那是只改了省电模式的中间结果。加上有线对比后应为 12.9 ms,已更正。
-
舵机抖动的三种可能
有同行指出数字舵机的 PID 参数在部分型号上可通过串口调整,降低 P 增益也能缓解自激。我手上这两颗不支持,没有实测,仅作记录。
-
在没有 systemd 的环境里让服务活下来
整理自 2026 年 8 月的三段便签记录(PRoot 下的 sshd 自启、WSL2 取主机 IP、图形界面显示问题)。环境各不相同,命令请按自己的发行版和网络情况调整。
-
micro_ros_agent 装不上的三个原因
整理自 2026 年 8 月的便签记录,日志为当时的真实输出(ROS 2 / Ubuntu on aarch64)。系统版本与包名请按自己的环境替换。
-
把手机变成 ROS 2 上位机
整理自 2026 年 8 月 13 日创建、8 月 29 日更新的一段便签,内含当时的终端输出与 Agent 日志原文。设备为一部 PRoot 环境下的 Android 手机。
-
舵机抖动的三种可能
更正:初稿写"脉宽抖动 ±3.1 µs 是主因",对照实验后应降级为次要因素,正文已改。
-
两个输入,一个状态机
整理自三段便签:2026 年 5 月 28 日的编码器交互设计、8 月 19 日的电机与验收标准讨论、以及 9 月 13 日关于显示逻辑与重启后状态恢复的零散想法。
-
我改了那个函数,但跑的不是它
整理自 2025 年 9 月 22 日的一段便签。原始记录是散点的排查条目(对照结果、三个待查问题、以及"两个同名函数"这个发现),这里的结构是事后重排的。
-
一次好得可疑的拟合
整理自 2025 年 9 月 8 日的一段便签,代码与输出为当时的原文(含真实的返回 JSON)。原始场景是给一条车辆轨迹算转弯半径。