docs(book): 《要有光——人工智能史话》全书 33 篇 + 事实核查 + 文风打磨 + 投稿材料

.gitignore

@@ -80,3 +80,8 @@ test-fixtures/
 docs/marketing/*.mp4
 docs/marketing/*.mov
 docs/marketing/.build/
+
+# 生成的阅读稿（1MB 量级，不入库）
+要有光-全书.html
+要有光-试读本.html
+要有光-试读本.pdf

book/README.md

@@ -0,0 +1,162 @@
+# 要有光 —— 人工智能史话
+
+> 人类问超级计算机 AC：如何逆转熵增，阻止宇宙的死亡？
+> AC 回答：数据不足，尚无法回答。
+>
+> 千百万年后，人类彻底数字化融入其中，AC 吞噬了整个宇宙的能量与信息。当宇宙终于陷入寂静与黑暗，AC 找到了答案。
+> 它的第一步行动是说：「要有光。」
+>
+> —— 化用阿西莫夫《最后的问题》（*The Last Question*, 1956）
+
+一部人工智能的史话。**人物传记与科学进展混写**，整体风格参照曹天元《上帝掷骰子吗？——量子物理史话》。
+
+---
+
+## 全书结构
+
+五个时代，31 章，加序章与终章共 33 篇，目标 **约 32 万字**。
+
+| 时代 | 跨度 | 主题 | 章 | 目标字数 |
+|---|---|---|---|---|
+| 序章 | — | [最后的问题](序章-最后的问题.md) | — | 4 000 |
+| **一 · 寓言** | 史前—1943 | 计算神经元之前，人类对人工智能的想象 | 1–5 | 47 000 |
+| **二 · 计算** | 1943—1993 | 冯·诺伊曼时代：符号、逻辑与两场冬天 | 6–12 | 70 000 |
+| **三 · 网络** | 1969—2016 | DNN–CNN–RNN：被埋掉的那条路如何回来 | 13–20 | 79 000 |
+| **四 · 注意力** | 2014—2022 | Transformer 统一一切 | 21–25 | 52 000 |
+| **五 · 涌现** | 2022— | 现代 AI：对齐、推理、agent 与治理 | 26–31 | 64 000 |
+| 终章 | — | [要有光](终章-要有光.md) | — | 5 000 |
+
+**先读这四份**：
+
+1. [**全书提纲**](提纲/全书提纲.md) —— 每章一行 + 贯穿全书的七条母题 ← *主文档*
+2. [写作规范](提纲/写作规范.md) —— 风格如何落到可执行的规则
+3. [人物谱](提纲/人物谱.md) —— 全书人物、生卒、出场章
+4. [时间线](提纲/时间线.md) —— 编年骨架，防止叙事与史实错位
+
+素材与考据：[参考资料](提纲/参考资料.md)。　投稿材料：[投稿/](投稿/README.md)（推荐语、出版社调研、试读本生成）。
+
+---
+
+## 进度看板
+
+状态口径：`outline`（只有纲）→ `draft`（初稿）→ `revise`（修订中）→ `done`（定稿）。
+
+| 时代 | 章数 | outline | draft | revise | done |
+|---|:---:|:---:|:---:|:---:|:---:|
+| 序 / 终章 | 2 | 0 | 2 | 0 | 0 |
+| 一 · 寓言 | 5 | 0 | 5 | 0 | 0 |
+| 二 · 计算 | 7 | 0 | 7 | 0 | 0 |
+| 三 · 网络 | 8 | 0 | 8 | 0 | 0 |
+| 四 · 注意力 | 5 | 0 | 5 | 0 | 0 |
+| 五 · 涌现 | 6 | 0 | 6 | 0 | 0 |
+| **合计** | **33** | **0** | **33** | **0** | **0** |
+
+已成稿（第 1–17 章均已过一轮逐章精校，每章一个独立 session，见下文"审校"）。全部满足[写作规范](提纲/写作规范.md)：≥8 000 字、3–5 节、钩子指向下一章。序章为引子，不适用字数下限。
+
+| 篇 | 字数 | 节 |
+|---|---:|:--:|
+| [序章 · 最后的问题](序章-最后的问题.md) | 4,380 | 5 |
+| [1 · 偃师的木偶](第一时代-寓言/01-偃师的木偶.md) | 10,314 | 5 |
+| [2 · 会思考的钟表](第一时代-寓言/02-会思考的钟表.md) | 8,699 | 5 |
+| [3 · 让我们来算一算](第一时代-寓言/03-让我们来算一算.md) | 9,131 | 5 |
+| [4 · 伯爵夫人的异议](第一时代-寓言/04-伯爵夫人的异议.md) | 9,647 | 5 |
+| [5 · 判定问题](第一时代-寓言/05-判定问题.md) | 9,015 | 5 |
+| [6 · 全或无](第二时代-计算/06-全或无.md) | 8,942 | 5 |
+| [7 · 控制论的黄金年代](第二时代-计算/07-控制论的黄金年代.md) | 11,332 | 5 |
+| [8 · 机器会思考吗](第二时代-计算/08-机器会思考吗.md) | 9,605 | 5 |
+| [9 · 达特茅斯的夏天](第二时代-计算/09-达特茅斯的夏天.md) | 9,967 | 5 |
+| [10 · 感知机](第二时代-计算/10-感知机.md) | 11,292 | 5 |
+| [11 · 微世界的天花板](第二时代-计算/11-微世界的天花板.md) | 12,180 | 5 |
+| [12 · 知识就是力量](第二时代-计算/12-知识就是力量.md) | 8,949 | 4 |
+| [13 · 误差反向传播](第三时代-网络/13-误差反向传播.md) | 10,836 | 5 |
+| [14 · 能量的形状](第三时代-网络/14-能量的形状.md) | 9,598 | 5 |
+| [15 · 卷积](第三时代-网络/15-卷积.md) | 9,193 | 5 |
+| [16 · 时间的形状](第三时代-网络/16-时间的形状.md) | 8,170 | 5 |
+| [17 · 统计学的反攻](第三时代-网络/17-统计学的反攻.md) | 8,021 | 5 |
+| [18 · 试错的科学](第三时代-网络/18-试错的科学.md) | 8,448 | 5 |
+| [19 · 三个人的坚持](第三时代-网络/19-三个人的坚持.md) | 8,044 | 5 |
+| [20 · 深度的爆发](第三时代-网络/20-深度的爆发.md) | 8,012 | 5 |
+| [21 · 一束光](第四时代-注意力/21-一束光.md) | 8,584 | 5 |
+| [22 · 你只需要注意力](第四时代-注意力/22-你只需要注意力.md) | 8,154 | 5 |
+| [23 · 预训练的一年](第四时代-注意力/23-预训练的一年.md) | 8,109 | 5 |
+| [24 · 尺度定律](第四时代-注意力/24-尺度定律.md) | 10,580 | 5 |
+| [25 · 万物皆可Transformer](第四时代-注意力/25-万物皆可Transformer.md) | 9,205 | 5 |
+| [26 · 对齐](第五时代-涌现/26-对齐.md) | 9,052 | 5 |
+| [27 · 涌现还是幻觉](第五时代-涌现/27-涌现还是幻觉.md) | 8,833 | 5 |
+| [28 · 打开黑箱](第五时代-涌现/28-打开黑箱.md) | 8,341 | 5 |
+| [29 · 让它想久一点](第五时代-涌现/29-让它想久一点.md) | 11,401 | 5 |
+| [30 · 会用工具的机器](第五时代-涌现/30-会用工具的机器.md) | 9,739 | 5 |
+| [31 · 布莱切利的回声](第五时代-涌现/31-布莱切利的回声.md) | 10,313 | 5 |
+| [终章 · 要有光](终章-要有光.md) | 4,733 | 5 |
+
+当前正文字数：约 **300,819 / 320 000**（提纲与细纲另计约 5 万字）。**第一、二、三时代已全部完稿；**全书 33 篇初稿完成（序章 + 第 1–31 章 + 终章）。五个时代全部落地。**
+
+**每轮审视的检查清单**（有脚本，逐条跑）：字数下限、节数 3–5、开场是否为具体场景、章末钩子指向下一章、章间交叉引用、母题编号、订正区块格式、全书不得出现自指计数、相对链接、跨章重复句、中文标点、正文是否残留 `[[待核实]]`、人物谱与时间线是否回填。
+
+**待办**（2026-08-02 更新）
+
+1. **清欠账**：已清 684 · 待核 1 · 成书前 1（**100%**）。跑 `python3 tools/debt_report.py` 看分章明细。
+
+   **2026-08-02：待核归零。** 此前被判成「非借纸本不可」的四条，第五轮换检索路线全部结掉——加扎里乐师船的轮数（Hill 1974, p.107）、《感知机》两处结论的页码（定理 3.1.1 / p.56 与定理 5.1 / p.74）、英国 SRC 经费（数字本身不存在可引口径，有档案的人明说给不出来）、投资方施压（材料形态问题，正式关闭）。**教训见 [HANDOFF](HANDOFF.md) §二：前三轮把「入口不对」误判成了「东西不存在」，还把这个误判写进了「下一位不必重走」。**
+
+   **2026-08-03：成书前那批也深挖完了，14 条清到 1 条。** 过程中发现**两条规范里的数字是错的**——节长区间（全书 164 节只有 48% 落在内）与科学占比上限（取样七章只有一章在 1/4 以下，中位数 33.2%）。**两条都不是正文的问题，是数字从来没对着这本书量过。** 已按实测重定，详见[写作规范](提纲/写作规范.md) §一 2 与 §三 11。
+
+   **只剩两条，都不是能靠查资料解决的**：
+   - `待核 1`（第 29 章）：一处「后来有人不同意」缺出处、作者与机构。**这是本轮新查出来的事实缺口**，不是遗留——补不出来也不许删，争论纪律要求反方留着。
+   - `成书前 1`（终章）：把「本书写到 2026 年年中」改成实际定稿日。**定稿日在物理上还不存在**，但除了那个日期其余全部查清、分档、排序了——条目现在是一份拿到日期就能照着做完的操作说明（全书 42 处，甲档 6 处必须一起改）。
+2. **一章超出 12 000 字上限**：第 11 章 12 180（清欠账时补料补出来的）。补的都是真内容，要压回上限只能整节重构，未动。第 29 章 11 067 已在限内。
+3. **成书前必改**：把"本书写到 2026 年年中"改成实际定稿时间。**终章的欠账条目里有一份全书 42 处时效表述的清单**，按「必改／须重核断言／只核不改」分三档，照着一次做完即可，不必再搜。
+   ⚠️ **甲档（硬写年份、必须一起改）有 6 处，不是 4 处**——2026-08-03 复核补进两处：第 25 章 L203（诉讼争点仍悬在上诉法院）与第 29 章 L285（蒸馏争议走到监管陈情而非法庭判决）。第 25 章那处尤其要紧：它与同章 L177 只隔二十几行，只改一处会让同一章出现两个不同的「本书写到何时」。
+   ⚠️ **第 29 章要改的是 L285，不是 IMO 那几处**——IMO 的成绩与日期是已发生的事件，不随定稿日移动。
+4. **辟谣区块的体例**：全书十二处辟谣已统一为 `> **订正 · 事由**` 区块，**不编号**（见[写作规范](提纲/写作规范.md) §23 之二）。新增时直接加区块即可，不必登记、不必去动别的章。
+5. **排版体例（全书性，排版阶段一次做完）**——这几件此前散在各处，2026-08-03 归到这里：
+   - **引号**：正文现用 ASCII 直引号（四千余处）。纯文本里没问题，**印刷品上是错的**，排版前须统一为弯引号或直角引号。已验过全书直引号成对、无跨段落单引。生成试读本 PDF 时脚本会在渲染阶段临时转成弯引号（`tools/build_sample.py` 的 `curly()`），**源文件一直没动**——因为这是全书性的排版决定，该由作者定，不由脚本代劳。
+   - **引文注释体例**：全书引文目前只在行文里交代出处，没有统一的注释格式。定体例时一并处理。
+   - **古籍纸本校对**：第 1 章五处《列子》引文已对 ctext.org 与维基文库两个独立通行电子本逐字复核相符（唯一出入在标点，两读都兜得住）。**纸本校对**（拟用中华书局杨伯峻《列子集释》）属排版阶段的例行动作，不是事实欠账。
+   - **术语表**：`sautoir` 这类无通行中译的词，本书的处置是保留原文并给词源、不自拟专名（见第 3 章欠账区的沿革）。若日后要出术语表，按同一口径。
+
+---
+
+## 怎么写
+
+### 协作方式
+
+**一次一章。** 这条是硬规矩，不是建议——试过一轮四章，后面几章的密度必掉，初稿会跌破 8 000 字下限，补写花的功夫比重写还多。
+
+每章流程固定四步：
+
+1. **对纲** —— 读该时代的[细纲](第一时代-寓言/_时代细纲.md)，确认本章的场景、人物、要讲透的科学点。
+2. **核实** —— 把本章要用的日期/数字/引文过一遍一手来源，填进[参考资料](提纲/参考资料.md)；拿不准的原地标 `[[待核实]]`，绝不含糊过去。
+3. **写** —— 一次写完整章（8 000–12 000 字），不要挤牙膏式续写：史话的节奏感是整章级的。
+4. **收尾** —— 更新 frontmatter 的 `status` / 字数、[人物谱](提纲/人物谱.md)、[时间线](提纲/时间线.md)、本 README 的看板。
+
+### 硬规矩
+
+- **不编造史实。** 允许场景化的笔法（"那天下午，剑桥的雨…"），但凡具体的时间、地点、人物言行必须有出处；无法确证的一律写成"据说 / 传说 / 有一种说法"，或者直接不写。
+- **引文短且注出处。** 不整段搬运他人文字（这是一本要能公开出版的书）。
+- **术语第一次出现给中英对照**，此后统一用中文。译名对照见[人物谱](提纲/人物谱.md)。
+- **每章结尾留"本章欠账"区块**（`<!-- 欠账: … -->`），成书前统一清理。
+
+### 生成阅读稿
+
+```bash
+cd book && python3 tools/build_html.py     # 生成单文件 HTML 阅读稿
+python3 tools/debt_report.py               # 欠账三档快照
+python3 tools/refresh_readme.py            # 按实测重刷本页看板
+python3 tools/tag_presstime.py             # 给「成书前才能定」的欠账打标
+python3 tools/style_audit.py               # 文风体检：粗体占比 / 括号旁白 / 「我们」
+```
+
+**字数口径**：去 frontmatter、去 HTML 注释、**去 Markdown 强调与代码记号**、去空白后的字符数。实现在 `tools/measure.py`，所有脚本从那里取——早先把 `**` 也数成正文，粗体高的章会虚增几百字。
+
+把全部 33 篇加五份提纲编译成一份**自包含的单文件 HTML**（约 1.4 MB，只依赖标准库），默认输出到 `../要有光-全书.html`。**生成物不入库。**
+
+它同时是阅读稿和审稿工具：左侧按时代分组的目录、阅读进度条、明暗与字号切换、`j`/`k` 跳章；「订正」区块单独成框；顶栏的**「欠账」开关**会展开每一篇的欠账清单（已清打勾、未清标圈），便于对着正文审。
+
+### 这也是一次 dogfooding
+
+本书是 Markup [写作模式](../docs/design/07-writing-mode.md)的第一个真实项目：
+
+- [`_manuscript.md`](_manuscript.md) 就是那份设计里的**稿件树索引**（嵌套列表 + wikilink），现在由人手维护，W1 落地后由稿件面板维护。
+- 每章 frontmatter 的 `status` / `target_words` / `synopsis` 是卡片墙和进度视图的数据源。
+- 写这本书时觉得疼的地方，就是 W3/W4/W5 该排在前面的东西。真实痛点决定路线图，而不是竞品清单。

book/_manuscript.md

@@ -0,0 +1,56 @@
+---
+markup_project: book
+title: 要有光——人工智能史话
+author: oratis
+target_words: 320000
+ignore:
+  - "README.md"
+  - "提纲/**"
+  - "**/_时代细纲.md"
+compile:
+  separator: "\n\n---\n\n"
+  strip_frontmatter: true
+  demote_headings: auto
+  titles_from: tree
+---
+
+# 稿件
+
+- [[序章-最后的问题]]
+- **第一时代 · 寓言**
+  - [[01-偃师的木偶]]
+  - [[02-会思考的钟表]]
+  - [[03-让我们来算一算]]
+  - [[04-伯爵夫人的异议]]
+  - [[05-判定问题]]
+- **第二时代 · 计算**
+  - [[06-全或无]]
+  - [[07-控制论的黄金年代]]
+  - [[08-机器会思考吗]]
+  - [[09-达特茅斯的夏天]]
+  - [[10-感知机]]
+  - [[11-微世界的天花板]]
+  - [[12-知识就是力量]]
+- **第三时代 · 网络**
+  - [[13-误差反向传播]]
+  - [[14-能量的形状]]
+  - [[15-卷积]]
+  - [[16-时间的形状]]
+  - [[17-统计学的反攻]]
+  - [[18-试错的科学]]
+  - [[19-三个人的坚持]]
+  - [[20-深度的爆发]]
+- **第四时代 · 注意力**
+  - [[21-一束光]]
+  - [[22-你只需要注意力]]
+  - [[23-预训练的一年]]
+  - [[24-尺度定律]]
+  - [[25-万物皆可Transformer]]
+- **第五时代 · 涌现**
+  - [[26-对齐]]
+  - [[27-涌现还是幻觉]]
+  - [[28-打开黑箱]]
+  - [[29-让它想久一点]]
+  - [[30-会用工具的机器]]
+  - [[31-布莱切利的回声]]
+- [[终章-要有光]]