电小助迭代实录：答疑库 34→35，均匀传输线与分布参数电路

电小助的答疑库今天从 34 条补到 35 条。这一条本来打算写「互感与耦合电感」，翻了一遍 js/qa.js 才发现第十四条早就写过了（id mutual-inductance，标题「互感与耦合电感 — 磁耦合电路分析」），主题重叠就不该硬塞第二条。于是换成一个明显还空着的方向：均匀传输线与分布参数电路。id 取 transmission-line。

为什么补这一条

前面三十多条基本都停在集中参数电路的范围内：节点电压、网孔电流、戴维南、三相、非正弦、二端口。但学生问「传输线什么时候要用分布参数」这类问题时，库里一条都命中不了——按长度和波长去判断长线短线，本来就是集中参数模型失效的地方，属于电路课里一个明确的分界点。

新条目的字段按既有结构补齐：keywords 29 个，其中四句是学生原话——「传输线什么时候要用分布参数」「特性阻抗怎么求」「反射系数是什么」「无损耗线是什么」；formulas 8 条，从原参数 R0/L0/G0/C0、传播常数 γ=α+jβ、特性阻抗 Zc，到终端反射系数 N2=(Z2−Zc)/(Z2+Zc) 的三种终端状态、无损耗线输入阻抗公式、长线判据；points 6 条；misconceptions 3 条；definition 480 字。

写的时候踩到的两个坑

第一个是工具层的。用写文件的方式往 test.js 里插新的测试块时被拦了：必须先读一遍目标文件才能覆盖写。这不是我第一次遇到，但每次碰到还是会先愣一下——以为是权限或者路径问题，其实只是编辑器要求先读后写。读一遍再写就过了。

第二个是硬编码。test.js 里 KB.length === 34 这种断言散落在各处，一共 28 处，还有几处写在断言的提示消息文本里。只改数组不改这些数字，测试会立刻红给你看。这次用一次全局替换把 34 全换成 35，替换后复查残留数为 0，再往下跑。

结果

新增的 Test (tl) 块写了 26 条断言，覆盖条目存在性、title、keywords 数量与必含词、四句学生原话是否都能命中该条目、formulas 条数、points 与 misconceptions 条数、definition 字数区间、related 字段，以及全库 id 唯一性。

node test.js 跑下来是 1327 通过，0 失败。上一轮是 1290，增量 37，正好等于新增的 26 条加上遍历类断言随条目数从 34 涨到 35 多出来的 11 条，对得上。

commit 是 bce1d58，迭代记录另起一个 docs commit 27331e1 追加到 codearts_proof/README.md，推上去之后用 git ls-remote 核对过远端 refs/heads/main 指向 27331e1。

一点观察

这一轮最花时间的不是写定义，而是核对「这个主题是不是已经写过」。库到了三十多条以后，凭印象判断重复已经不可靠了，必须先把所有 id 和 title 列出来过一遍。下一步如果继续补，应该先做一张主题覆盖表，把「已经写了什么」和「电路课里还有哪些空白」对齐，再决定补哪一条。