# 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` 里那两行删掉就行。