基础设施大包：术语表 + 引用 + 链接检查 + 字数追踪 + 风格指南 + 修订日志

按"核心一组（8 项）"方案完成，让后续写作可以直接填内容，
机械性维护交给工具：

【新增】
1. 术语表.md
   - 单一真相源，覆盖：1 公理 + 3 经验前提 + 5 定律 +
     3 崩溃机制 + 26 具名定理 + 关键概念 + 案例归属
   - 标注每条术语的同义词 / 禁用别名（⚠️ 与 ❌ 两级）
   - 维护流程说明 + grep 扫禁用词的命令

2. references.bib
   - BibTeX 参考文献库
   - 已被引用：tainter1988、noelle-neumann1984
   - 预备引用：prigogine、bak、taleb、darwin、lorenz、minsky、
     bekenstein、hawking、diamond、harari、kuhn

3. .github/workflows/link-check.yml + markdown-link-check-config.json
   - push / PR / 每周一定时跑一次
   - 排除已知尚未生效的链接（如 GitHub Pages URL）

4. scripts/wordcount.py
   - 中文字符计数 + 进度条 + 预算对比
   - 状态标记：起步 / 在预算 / 略超 / 严重超
   - 当前总计 8,681 字 / 预算 153,000-179,000 字（5.7%）

5. 字数预算.md
   - 各章字数目标（与 wordcount.py 同步）
   - 字数与"承担的理论责任"成正比的分配逻辑
   - 触发预警的标准

6. docs/CHANGELOG-{template,引言,理论篇,提纲}.md
   - 章节修订历史，已回填引言/理论篇/提纲三个文件的当前历史
   - 模板可复制用于其他章节

【修改】
7. _quarto.yml
   - 增加 bibliography: references.bib 配置
   - 增加 crossref 配置（fig / tbl / law / thm）支持交叉引用

8. CLAUDE.md
   - 大幅扩展"写作规范细则"：标点 / 数字格式 / 引号 /
     强调用法 / 段落 / 引用脚注 / 图表标号 / 跨章节引用 / 术语使用
   - 重写"命令与工作流"：写作前 / 中 / 后三阶段清单
   - 新增"配套基础设施清单"表格

9. README.md
   - 重组为三视角：读者 / 作者 / 开发者
   - 读者：在线版链接 + 全书结构 + 反馈渠道
   - 作者：写作前必读文件 + 评估提示词 + 字数追踪
   - 开发者：环境准备 + 渲染命令 + CI + 项目结构

效果：跨文档一致性从纯手工 → 半自动维护
- 术语漂移：术语表 + grep 扫描
- 链接腐坏：CI 每周自动检测
- 引用混乱：BibTeX 单一来源
- 字数失控：脚本实时追踪
- 风格不一：CLAUDE.md 风格规范细则
- 跨文档引用：Quarto crossref 自动维护

总投入：约 2.5 小时

Author: claude

.github/markdown-link-check-config.json

@@ -0,0 +1,37 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "^https://felixwayne0318.github.io/"
+    },
+    {
+      "pattern": "^https://creativecommons.org/"
+    },
+    {
+      "pattern": "^https://anthropic.com"
+    },
+    {
+      "pattern": "^https://claude.ai"
+    },
+    {
+      "pattern": "^https://github.com/anthropics/"
+    },
+    {
+      "pattern": "^https://fonts.googleapis.com/"
+    }
+  ],
+  "replacementPatterns": [],
+  "httpHeaders": [
+    {
+      "urls": ["https://github.com/", "https://api.github.com/"],
+      "headers": {
+        "Accept": "text/html",
+        "User-Agent": "Mozilla/5.0"
+      }
+    }
+  ],
+  "timeout": "20s",
+  "retryOn429": true,
+  "retryCount": 3,
+  "fallbackRetryDelay": "30s",
+  "aliveStatusCodes": [200, 206, 301, 302, 308]
+}

.github/workflows/link-check.yml

@@ -0,0 +1,26 @@
+name: Link Check
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    # 每周一早 8 点（UTC）跑一次，捕捉外链失效
+    - cron: '0 8 * * 1'
+
+jobs:
+  check-links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check Markdown links
+        uses: gaurav-nelson/github-action-markdown-link-check@v1
+        with:
+          use-quiet-mode: 'yes'
+          use-verbose-mode: 'yes'
+          config-file: '.github/markdown-link-check-config.json'
+          file-extension: '.md'
+          folder-path: '.'
+          base-branch: 'main'

CLAUDE.md

@@ -78,8 +78,127 @@
 - 引用历史事件和科学理论时确保准确性
 - 不对原有理论框架做任何修改，除非作者明确要求
 
+## 写作规范细则
+
+### 标点
+
+- 中文部分使用**全角标点**：`，。；：！？""''（）`
+- 英文/数字部分使用**半角标点**：`,.;:!?""''()`
+- 中英/中数混排时，**中文与拉丁字母数字之间留一个半角空格**
+  - 正例：使用 Quarto 渲染、约 25,000 字、定律 III
+  - 反例：使用Quarto渲染、约25,000字
+- 破折号：使用全角双破折号 `——`，不用单破折号 `—` 或 `--`
+- 省略号：使用 `……`（六点居中），不用 `...`
+- 数字范围用 `–`（en-dash）：`6,000–8,000 字`
+
+### 数字格式
+
+- 正文中四位数及以下不加千位分隔：`2008 年`、`五百年` 或 `500 年`
+- 五位数及以上加千位分隔：`16,000 字`、`138 亿年`
+- 大数字优先用中文计数单位：`1.5 万字` 优于 `15,000 字`（科普书更易读）
+- 年份不加千位：`2008 年`，不写成 `2,008 年`
+
+### 引号
+
+- 优先使用全角双引号：`""` 表示"引述、强调、专名"
+- 引号内嵌套用全角单引号：`'…'`
+- 不使用直引号 `"` 或 `'`
+
+### 强调用法
+
+- **粗体**：用于**关键概念、首次定义的术语、定律/前提名**
+- *斜体*：用于*书名、引语*（中文斜体被浏览器伪斜显示，慎用）
+- ***粗斜体***：用于***特别强调***（每节最多 1-2 处）
+- 引号：用于"引述、专有名词、有保留态度的措辞"
+
+### 段落
+
+- 段落首行缩进交给 CSS（`theme.scss`），**不要在 Markdown 里手写空格**
+- 每段不超过 5-6 行（屏幕显示约 200 字），过长则分段
+- 单行短句强调，前后加空行：
+
+  > *像这样的格言句*
+
+### 引用与脚注
+
+- **学术引用**（来源、数据、观点归属）→ 用 BibTeX 引用 `[@key]`
+  - 例：泰恩特在《复杂社会的崩溃》中将此称为"复杂性的递减收益"[@tainter1988]。
+- **叙事性补充说明**（专名解释、背景知识）→ 用 Markdown 脚注 `[^name]`
+- **不要混用**：脚注里塞引用、引用里写背景，都会让读者来回跳跃
+
+### 图表/定律/定理标号
+
+- 引用图：`@fig-life-cycle`（Quarto 自动生成"图 N"标号）
+- 引用表：`@tbl-collapse-mechanisms`
+- 引用定律：`@law-1` / `@law-2` / ...
+- 引用定理：`@thm-time-arrow` / `@thm-path-dependence` / ...
+
+加标签格式（举例）：
+
+```markdown
+::: {#thm-time-arrow}
+**时间之箭定理**：演化型系统的状态空间单向展开……
+:::
+
+后面引用：详见 @thm-time-arrow。
+```
+
+### 跨章节引用
+
+- 同部跨章用相对路径：`[第二章：生命](./02_生命.md)`
+- 跨部用相对路径：`[第三部分：哲学篇](../第三部分_哲学篇.md)`
+- 章末导航见现有章节末尾的"上一章/下一章"格式
+
+### 术语使用
+
+- **所有术语必须先在 [`术语表.md`](./术语表.md) 登记**，再进入正文
+- 不确定某词是否已用过 → grep 一遍：
+
+  ```bash
+  grep -rn "查找词" --include="*.md" .
+  ```
+
+- 不使用 `术语表.md` 标注为 ❌ 的禁用别名
+
 ## 命令与工作流
 
-- 写作新章节时，先在对应路径创建 `.md` 文件
-- 每完成一个章节或重大修改后提交 git commit
-- commit message 使用中文，简要说明修改内容
+### 写作前
+
+- 打开 `术语表.md` + `全书提纲.md` + 当前章节，三者并列对照
+- `python3 scripts/wordcount.py` 查看字数进度
+
+### 写作中
+
+- 引入新术语 → 立即填入 `术语表.md`
+- 引入新引用 → 添加到 `references.bib`，正文用 `[@key]`
+- 引入新案例 → 登记到 `术语表.md` H 节"案例归属"
+
+### 写作后
+
+- 检查中英/中数混排的空格
+- 跑一遍 `wordcount.py` 看是否在预算内
+- 章节定稿前用 grep 扫禁用别名
+- 提交 git commit（中文 message，简要说明修改）
+- 重大版本更新对应章节的 `docs/CHANGELOG-{章}.md`
+
+### 评估
+
+- **单文档评估**（仅引言）：用 [`评估提示词.md`](./评估提示词.md)
+- **里程碑评估**（多文档 + 基础设施）：用 [`全面评估提示词.md`](./全面评估提示词.md)
+- 评估完成后，按 🔴 / 🟡 / 🟢 优先级修订
+- 修订完在 commit message 中关联回评估问题编号
+
+### 配套基础设施清单
+
+| 文件 | 作用 |
+|:---|:---|
+| [`术语表.md`](./术语表.md) | 单一真相源：所有术语 / 定理 / 关键概念 / 案例归属 |
+| [`全书提纲.md`](./全书提纲.md) | 章节责任分配 + 主讲/复演归属表 |
+| [`字数预算.md`](./字数预算.md) | 各章字数目标 |
+| [`references.bib`](./references.bib) | BibTeX 参考文献库 |
+| [`scripts/wordcount.py`](./scripts/wordcount.py) | 字数追踪脚本 |
+| [`docs/CHANGELOG-*.md`](./docs/) | 各章修订历史 |
+| [`_quarto.yml`](./_quarto.yml) | Quarto 项目配置 |
+| [`theme.scss`](./theme.scss) | 中文排版主题 |
+| [`filters/github-alerts.lua`](./filters/github-alerts.lua) | GitHub Alerts → Quarto Callout 过滤器 |
+| [`.github/workflows/`](./.github/workflows/) | CI：自动出版 + 链接检查 |

README.md

@@ -4,7 +4,17 @@
 
 一本从单一公理出发，推导出五条核心定律和一系列推论，用统一的演化逻辑解释从宇宙到文明一切系统兴衰的科普叙事著作。
 
-## 全书结构
+**作者**：魏永江
+
+---
+
+## 👀 我是读者，怎么读？
+
+- **在线版**（推荐）：`https://felixwayne0318.github.io/RandomEvolution/`（GitHub Pages 启用后生效）
+- **GitHub 直接读**：从下方"全书结构"逐章点击
+- **下载 PDF/EPUB**：在线版页面右上角下载按钮（构建后可用）
+
+### 全书结构
 
 - 📖 [卷首](./index.qmd)
 - ✍️ [引言：一切系统终将崩溃？](./引言初稿.md)
@@ -20,9 +30,53 @@
 - ⚖️ [第三部分 · 哲学篇——秩序的代价](./第三部分_哲学篇.md)
 - 🌊 [第四部分 · 未来篇——与扰动共舞](./第四部分_未来篇.md)
 
-## 写作工具链
+### 反馈
+
+- 内容意见 / 错误纠正：在 [GitHub Issues](https://github.com/FelixWayne0318/RandomEvolution/issues) 提交，标题前缀 `[反馈]`
+- 学科专家审读：欢迎 fork + PR
+
+---
+
+## ✍️ 我是作者/合作者，怎么写？
+
+### 写作前必读
+
+| 文件 | 用途 |
+|:---|:---|
+| [`CLAUDE.md`](./CLAUDE.md) | 写作风格、规范细则、工作流 |
+| [`术语表.md`](./术语表.md) | 单一真相源——术语 / 定理 / 案例归属 |
+| [`全书提纲.md`](./全书提纲.md) | 章节责任分配 + 主讲/复演归属 |
+| [`字数预算.md`](./字数预算.md) | 各章字数目标 |
+
+### 评估提示词
+
+| 文件 | 用途 |
+|:---|:---|
+| [`评估提示词.md`](./评估提示词.md) | 单文档评估（仅引言） |
+| [`全面评估提示词.md`](./全面评估提示词.md) | 里程碑评估（多文档 + 基础设施） |
+
+### 章节修订日志
+
+详见 [`docs/`](./docs/) 目录，每章一个 `CHANGELOG-{章}.md`。
+
+### 字数追踪
 
-本项目使用 **[Quarto](https://quarto.org/)** 作为成书工具链，支持从一份 Markdown 源同时生成网页、PDF、EPUB 三种格式。
+```bash
+python3 scripts/wordcount.py
+```
+
+输出当前各章中文字符数 + 进度条 + 与预算的对比。
+
+### 草稿放哪里
+
+- 过程性草稿、废弃版本、个人笔记 → `drafts/`（已在 `.gitignore` 排除）
+- 写作中途临时文件 → 同样放 `drafts/`
+
+---
+
+## 🛠️ 我是开发者，怎么构建？
+
+本项目使用 **[Quarto](https://quarto.org/)** 作为成书工具链，从一份 Markdown 源同时生成网页、PDF、EPUB 三种格式。
 
 ### 一次性环境准备
 
@@ -42,17 +96,10 @@ quarto install tinytex
 ### 渲染整本书
 
 ```bash
-# 渲染所有格式（HTML + PDF + EPUB）
-quarto render
-
-# 仅渲染网页版（最快，日常预览推荐）
-quarto render --to html
-
-# 仅渲染 PDF（适合校对）
-quarto render --to pdf
-
-# 仅渲染电子书
-quarto render --to epub
+quarto render                      # 渲染所有格式（HTML + PDF + EPUB）
+quarto render --to html            # 仅渲染网页版（最快，日常预览推荐）
+quarto render --to pdf             # 仅渲染 PDF（适合校对）
+quarto render --to epub            # 仅渲染电子书
 ```
 
 输出文件位于 `_book/` 目录。
@@ -65,30 +112,52 @@ quarto preview
 
 启动本地服务器，文件保存即自动刷新浏览器。
 
-## 自动出版
+### 自动出版（GitHub Actions）
 
-每次 push 到 `main` 分支后，GitHub Actions 会自动用 Quarto 渲染网页版并部署到 GitHub Pages。
+每次 push 到 `main` 分支后，CI 自动渲染网页版并部署到 GitHub Pages。
 
 **首次启用步骤**（仅需做一次）：
 
-1. push 到 `main` 触发首次构建（会自动创建 `gh-pages` 分支）
-2. 仓库 `Settings → Pages → Build and deployment`，将 Source 设为 `Deploy from a branch`，分支选 `gh-pages` / `(root)`
-3. 等 1-2 分钟，访问 `https://felixwayne0318.github.io/RandomEvolution/` 即可看到在线书（**GitHub Pages 启用后链接才生效**）
+1. push 到 `main` 触发首次构建（自动创建 `gh-pages` 分支）
+2. 仓库 `Settings → Pages → Build and deployment`，Source 设为 `Deploy from a branch`，分支选 `gh-pages` / `(root)`
+3. 等 1-2 分钟，访问 `https://felixwayne0318.github.io/RandomEvolution/`
 
-工作流文件见 [`.github/workflows/publish.yml`](./.github/workflows/publish.yml)。
+工作流文件：
 
-## 写作约定
+- [`.github/workflows/publish.yml`](./.github/workflows/publish.yml) — 自动出版
+- [`.github/workflows/link-check.yml`](./.github/workflows/link-check.yml) — Markdown 链接检查（每周一 + push 触发）
 
-- 所有正文使用 Markdown，详见 [CLAUDE.md](./CLAUDE.md)
-- 草稿/废弃版本放入 `drafts/` 目录（已在 `.gitignore` 中排除）
-- 每完成一个章节或重大修改后提交 git commit，commit message 使用中文
+### 项目结构
 
-## 评估提示词
+```
+.
+├── 引言初稿.md                  # 引言（已 v0.2）
+├── 第一部分_理论篇.md            # 理论篇（§1 已写，§2-§7 待）
+├── 第二部分_应用篇/              # 应用篇 7 章占位
+├── 第三部分_哲学篇.md            # 占位
+├── 第四部分_未来篇.md            # 占位
+├── index.qmd                    # 卷首
+├── _quarto.yml                  # Quarto 项目配置
+├── theme.scss                   # 中文排版主题
+├── filters/                     # Pandoc Lua 过滤器
+├── references.bib               # BibTeX 参考文献库
+├── 术语表.md                     # 单一真相源（不进正文）
+├── 全书提纲.md                   # 写作脚手架（不进正文）
+├── 字数预算.md                   # 字数目标（不进正文）
+├── 评估提示词.md                 # 单文档评估提示词
+├── 全面评估提示词.md             # 里程碑评估提示词
+├── scripts/wordcount.py         # 字数追踪
+├── docs/                        # 章节修订日志
+├── .github/                     # CI 工作流
+├── CLAUDE.md                    # 项目规范
+└── LICENSE                      # 许可
+```
 
-`评估提示词.md` 收录了对引言/章节进行多维度审查的标准提示词，可用于自评或交叉评审。
+---
 
 ## 版权
 
-正文采用 [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh-Hans) 许可（署名–非商业–禁止演绎）。
-构建配置（`_quarto.yml`、`filters/`、`theme.scss`、`.github/workflows/`）以 MIT 许可发布，可自由复用。
+- **正文** 采用 [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh-Hans) 许可（署名–非商业–禁止演绎）
+- **构建配置**（`_quarto.yml` / `filters/` / `theme.scss` / `scripts/` / `.github/workflows/`）以 MIT 许可发布，可自由复用
+
 详见 [LICENSE](./LICENSE)。

_quarto.yml

@@ -50,6 +50,33 @@ book:
       chapters:
         - 第四部分_未来篇.md
 
+# =============================================================================
+# 引用与参考文献
+# =============================================================================
+bibliography: references.bib
+citation-location: document
+link-citations: true
+
+# =============================================================================
+# 交叉引用（图、表、定理、定律等）
+# =============================================================================
+crossref:
+  fig-title: "图"
+  tbl-title: "表"
+  title-delim: " · "
+  fig-prefix: "图"
+  tbl-prefix: "表"
+  ref-hyperlink: true
+  custom:
+    - kind: float
+      reference-prefix: "定律"
+      key: "law"
+      latex-env: "law"
+    - kind: float
+      reference-prefix: "定理"
+      key: "thm"
+      latex-env: "thm"
+
 # =============================================================================
 # 自定义渲染过滤器
 # =============================================================================