Merge pull request #4 from FelixWayne0318/claude/review-repo-docs-5yiWO

Author: FelixWayne0318

.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'

.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish Book
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  build-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+        with:
+          version: "1.5.57"
+
+      - name: Install Chinese fonts (Noto CJK)
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y fonts-noto-cjk fonts-noto-cjk-extra
+
+      - name: Render and Publish to GitHub Pages
+        uses: quarto-dev/quarto-actions/publish@v2
+        with:
+          target: gh-pages
+          render: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -205,3 +205,23 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Quarto build artifacts
+/_book/
+/.quarto/
+*.tex
+!filters/*.tex
+site_libs/
+
+# OS / editor cruft
+.DS_Store
+Thumbs.db
+*.swp
+*~
+
+# Word/Office temporary files (in case of paste-from-Word workflow)
+~$*
+*.docx#
+
+# Local writing drafts (per CLAUDE.md convention)
+/drafts/

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：自动出版 + 链接检查 |

LICENSE

@@ -0,0 +1,63 @@
+《随机演化论》
+Random Evolution
+
+Copyright © 2026 魏永江. All rights reserved.
+
+================================================================================
+
+本作品采用 知识共享 署名-非商业性使用-禁止演绎 4.0 国际许可协议
+(Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International,
+ CC BY-NC-ND 4.0) 进行许可。
+
+完整许可条款（中文）：
+  https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh-Hans
+
+完整许可条款（英文 / 法律文本）：
+  https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+
+================================================================================
+
+简要权利说明
+--------------------------------------------------------------------------------
+
+您可以自由地：
+
+  * 共享 — 在任何媒介以任何形式复制、发行本作品
+
+但必须遵守以下条件：
+
+  * 署名 (BY)
+      您必须给出适当的署名，提供指向本许可的链接，同时标明是否对原始
+      作品作了修改。您可以用任何合理的方式来署名，但是不得以任何方式
+      暗示许可人为您或您的使用背书。
+
+  * 非商业性使用 (NC)
+      您不得将本作品用于商业目的。
+
+  * 禁止演绎 (ND)
+      如果您再混合、转换、或者基于本作品进行创作，您不可以分发修改
+      作品的整体或部分。
+
+  * 没有附加限制
+      您不得适用法律术语或者技术措施从而限制其他人做许可协议允许的事情。
+
+================================================================================
+
+商业授权与衍生授权
+--------------------------------------------------------------------------------
+
+如需用于商业目的（包括但不限于：出版发行、收费课程、商业培训、商品周边
+等），或希望基于本作品创作衍生作品（包括翻译、改编、节选汇编等），请
+联系作者获取单独授权：
+
+  作者：魏永江
+  联系方式：（待补充）
+
+================================================================================
+
+代码与配置文件
+--------------------------------------------------------------------------------
+
+本仓库中的非正文文件（如 `_quarto.yml`、`filters/*.lua`、`theme.scss`、
+`.github/workflows/*.yml` 等构建配置与脚本）单独以 MIT 许可协议发布，
+可自由复用于其他 Quarto 项目。