WillTools 2026-09-09 -- clean snapshot of the development repo for review

History-free snapshot of the private development repository at 77a82eb.
Code, docs and the public catalogue only: no plant or job knowledge
layers, no client, job or producer names (tools/scrub.py clean against
the widened term list; a second word-level grep clean). The intro deck is
left out because its slide images cannot be checked for job drawings.

QNA/README.md

@@ -0,0 +1,52 @@
+# QNA — 有啥不明白的，写在这儿
+
+这个文件夹只有一个用途：**你随手记下没搞懂的问题，我看到了就回答。**
+
+不用等到我在旁边。想到了就写，反正记下来的问题总比忘掉的强。
+
+---
+
+## 怎么问
+
+打开 `questions.md`，在最下面加一段：
+
+```markdown
+## Q: transfer length 那个 33.2 in 是怎么来的？
+```
+
+`## Q:` 开头，一行说清楚就行。要贴代码、贴报错、贴一段 job JSON 都可以，
+跟在下面就是了。**不用管格式，不用管排版。**
+
+写完存盘。就这样，没有别的步骤。
+
+## 怎么得到回答
+
+我会在问题下面直接补一段：
+
+```markdown
+**A**（2026-08-22）：ACI 318 的 ℓt = f_se·db/3 ……
+```
+
+答案就跟在问题下面，一个文件从上往下读就是一份记录 —— 不用在两个文件之间来回翻。
+
+---
+
+## 说清楚一件事：我不是 24 小时在线
+
+盯这个文件夹的是 `tools/qna_watch.py`：它是当前 agent 会话里的一个后台任务，
+一有改动就退出并叫醒我去读、去做，做完再重新布防。**只有这个会话开着的时候才有效**。
+终端关了、电脑重启了，就没人看了 —— 那之后写进来的问题会一直躺在
+`questions.md` 里，等下次会话开始时 watcher 一启动就会把积压的改动先报出来，
+我读一遍，照样会答，只是没那么快。
+
+所以：**积压是正常的，丢掉是不会的。**
+下次开工的时候直接跟我说一句「看下 QNA」，我就把没答的都补上。
+
+## 别在这儿写客户名和项目名
+
+跟仓库里别的地方一个规矩（见 `CLAUDE.md` 第 3 节）：不写业主名、不写工程名、
+不写模型文件名。产品编号不算 —— design number、piece mark、五金件料号都可以照写。
+
+保险起见，`questions.md` 本身是 gitignore 掉的，不会被 push 上去。
+只有这份 README 进仓库，因为它是约定，不是内容。
+哪天你想把问答记录也存进版本库，把 `.gitignore` 里那两行删掉就行。