重写全部 README，只保留使用说明

17 个 README 统一改成使用说明书，去掉来源、踩坑、需求过程等内容。

只保留：
- 怎么编译、跑几遍
- 文件结构
- 要改哪些参数（逐项列出宏名与含义）
- 用到的命令（表格）
- 版式参数

删除：
- 原文件来源、抽取过程
- 踩坑记录、最小复现、实测数据
- 用户需求、工单号、历史沿革
- 改造前后对比

行数 4185 → 2261。

全库 16/16 编译通过。

成绩构成说明/README.md

@@ -1,368 +1,115 @@
-# 成绩构成说明 — 中国海洋大学《成绩构成说明》（LaTeX 版）
+# 成绩构成说明
 
-把任课教师手写的「成绩构成说明」做成 LaTeX 模板。原件是一份填过的
-`.doc` 实例（两段话 + 标题，无表格、无签字栏），本模板在**保留其信息
-内容**的前提下重新组织，并补齐归档必需项。
-
-> **本模板不含原件任何真实数据。** 课程名、学年、学期、教师姓名、
-> 所有比例、日期均已替换，已 grep 验证零命中。
->
-> 样张填的是一份**完整的虚构课程**：《数字逻辑》2025 秋学期、任课教师「张远航」、
-> 理论课 80% + 实验课 20%、平时 30%（作业 20% + 点名 10%）+ 期末 70%。
-> 这套比例是**自洽的**（20+10=30、30+70=100、80+20=100），正好能演示
-> 模板的比例校验功能；与 [`课程教学日历/`](../课程教学日历/)、
-> [`试卷归档封面/`](../试卷归档封面/)、[`试卷/`](../试卷/) 为同一门课。
-
-## 目录
-
-- [文件](#文件)
-- [编译](#编译)
-- [改内容](#改内容)
-- [相对于原件的改动](#相对于原件的改动)
-- [比例自洽校验](#比例自洽校验)
-- [版式参数](#版式参数)
-- [五个坑](#五个坑)
-- [真实数据零泄漏](#真实数据零泄漏)
-- [字体](#字体)
-
-## 文件
-
-| 文件 | 说明 |
-| :-- | :-- |
-| `成绩构成说明.tex` | 主文件。填表只改第 1 节（10 个宏） |
-| `oucgrade.sty` | 版式包。页面/字体/表格/签字栏，附换算注释 |
-| `成绩构成说明.pdf` | 成品样张（1 页） |
+中国海洋大学课程成绩构成说明表，A4 单页，正文小四（12pt）。
 
 ## 编译
 
 ```bash
+cd 成绩构成说明
 xelatex 成绩构成说明.tex
 ```
 
-**单页，跑一遍即可**（无交叉引用，不需要 bibtex）。
+或仓库根：`bash build.sh 成绩构成说明`
 
-⚠️ 必须在**本目录**下编译，不要从仓库根调用 —— `fonts.tex` 用的是
-相对路径 `../fonts/`。
+## 文件
 
-需要 XeLaTeX，并安装 `ctex`、`geometry`、`fontspec`、`xeCJK`、
-`tabularray`、`enumitem`、`graphicx`。实测环境：TeX Live 2022。
+| 文件 | 说明 |
+|---|---|
+| `成绩构成说明.tex` | 主文件，填内容改这里 |
+| `oucgrade.sty` | 版式包，一般不改 |
 
-## 改内容
+## 填写参数
 
-### 课程信息（10 个宏）
+改 `\begin{document}` 之后的第 1 节，共 10 个宏，正文不用动：
 
 ```latex
 \newcommand{\grdcourse}{数字逻辑}        % 课程名称
-\newcommand{\grdyear}{2025}            % 学年
-\newcommand{\grdseason}{秋}            % 季学期（春 / 秋）
-\newcommand{\grdteacher}{张远航}        % 任课教师
+\newcommand{\grdyear}{2025}              % 学年
+\newcommand{\grdseason}{秋}              % 季学期（春 / 秋）
+\newcommand{\grdteacher}{张远航}          % 任课教师
 
-\newcommand{\grdtheory}{80}        % 理论课占总成绩 %
-\newcommand{\grdlab}{20}           % 实验课占总成绩 %
+\newcommand{\grdtheory}{80}              % 理论课占总成绩
+\newcommand{\grdlab}{20}                 % 实验课占总成绩
 
-\newcommand{\grddaily}{30}         % 平时成绩占理论课 %
-\newcommand{\grdfinal}{70}         % 期末考试成绩占理论课 %
+\newcommand{\grddaily}{30}               % 平时成绩占理论课
+\newcommand{\grdfinal}{70}               % 期末考试成绩占理论课
 
-\newcommand{\grdhw}{20}            % 作业占理论课 %
-\newcommand{\grdattend}{10}        % 点名占理论课 %
+\newcommand{\grdhw}{20}                  % 作业占理论课
+\newcommand{\grdattend}{10}              % 点名占理论课
 
 \newcommand{\grdlabnote}{由实验课教师根据实验报告与实验操作评定。}
 ```
 
-上列前四项是**样张实际用的虚构值**。**数字只填数字，不要带 `%` 号**，百分号由模板加。
+| 参数 | 说明 |
+|---|---|
+| `\grdcourse` | 课程名称 |
+| `\grdyear` | 学年 |
+| `\grdseason` | 季学期，春 / 秋 |
+| `\grdteacher` | 任课教师 |
+| `\grdtheory` | 理论课占总成绩百分比 |
+| `\grdlab` | 实验课占总成绩百分比 |
+| `\grddaily` | 平时成绩占理论课百分比 |
+| `\grdfinal` | 期末考试占理论课百分比 |
+| `\grdhw` | 作业占理论课百分比 |
+| `\grdattend` | 点名占理论课百分比 |
+| `\grdlabnote` | 实验课评定方式，一句话说明 |
 
-### 「占本类」与「占总成绩」是两回事
+百分数只填数字，不要带 `%`。
 
-这是本模板最要紧的一个设计，见下节。
+## 比例必须自洽
 
-### 改写正文
-
-- 总述：`\grdpara{...}`
-- 分节：`\grdsec{一、成绩构成}`
-- 列表：`\begin{grdlist} \grditem{项}{：说明} \end{grdlist}`
-- 表格单元格：`\grdth{}`（表头）/ `\grdtd{}`（表身）
-
-## 相对于原件的改动
-
-原件全文只有这些内容（**下面是脱敏摘录**，原件里的真实课程名 / 学年 / 教师名
-用 `××××` 盖掉了；样张 PDF 里排的是虚构的《数字逻辑》2025 秋）：
+模板会自动检查三组加法：
 
 ```
-成绩构成说明
-  ×××× 20××学年 ×季学期 期末考试
-  理论课成绩占总成绩的80%。理论课成绩包括平时成绩、期末考试成绩。
-  平时成绩占30%（作业占20%，点名占10%），期末考试成绩占70%。
-  实验成绩占总成绩的20%。由实验课老师提供。
-```
-
-它的问题有四个，逐个解决：
-
-### 1. 三层百分数混用不同基准，读者要心算三轮
-
-| 句子 | 百分数 | **基准实际是** | 折总成绩 |
-| :-- | --: | :-- | --: |
-| 理论课占总成绩的 80% | 80% | 总成绩 | 80% |
-| 平时成绩占 30% | 30% | **理论课** | 24% |
-| 作业占 20% | 20% | **理论课** | 16% |
-| 期末考试成绩占 70% | 70% | **理论课** | 56% |
-
-「平时占 30%」看着像占总成绩三成，实际上只占 **24%**。教务抽查时
-这里最常被挑错，学生也容易误读。
-
-**改法**：表格左右并置「占本类」与「占总成绩」两列，后者由
-`\grdcalc{理论课\%}{分项\%}` 自动算出，不给心算留余地。
-
-### 2. 层级关系埋在句子里
-
-「平时成绩占30%（作业占20%，点名占10%）」—— 括号里的两个数加起来
-才是括号外的数，这种嵌套在一个句子里读起来要来回扫。
-
-**改法**：改成 6 列表格，一级项目跨行合并，层级一眼可见。
-
-### 3. 没有说明「怎么算」
-
-原件说了比例，没说作业怎么平均、缺交怎么扣、点名缺几次记零。
-这些是学生真正会问的，也是申诉时的依据。
-
-**改法**：新增「二、分项说明」一节，用列表逐项写清（文字留占位，
-任课教师按自己课程的规则填）。
-
-### 4. 没有签字栏
-
-**这是用户明确要求补的。** 没有任课教师签字的成绩构成说明，在教务
-归档时不被认作有效文件。
-
-**改法**：右下角落款，含签字线与「年 月 日」三个手写填空位。
-
-⚠️ **「年 月 日」不印年份**。成绩构成说明是学期末签署的文件，年份
-由签字人当场手写；模板里预留 `20××` 反而会占掉手写空间、并诱导
-使用者去改占位符。所以这一行只有三个字 + 两处 `\hspace` 间距。
-
-### 另外新增（可关闭）
-
-「三、成绩评定与异议」一节 —— 说明总成绩如何取整、异议如何在几个
-工作日内提出。原件没有，但归档材料有这一节更完整。
-
-不要的话把 `.tex` 里这个开关改成 0：
-
-```latex
-\def\grdwithini{0}   % 1=印这一节，0=不印
-```
-
-⚠️ 关掉后正文变短，签字栏会往上移。若想让它仍贴底部，把 `oucgrade.sty`
-里签字块前的 `\par\vspace{3mm}` 调大即可（见[坑 3](#坑-3签字栏被挤到第-2-页)）。
-
-## 比例自洽校验
-
-模板会检查三组加法：
-
-```
-平时 + 期末     = 100        （构成全部理论课）
-作业 + 点名     = 平时        （构成全部平时成绩）
-理论课 + 实验课 = 100        （构成全部总成绩）
+理论课 + 实验课 = 100
+平时成绩 + 期末考试 = 理论课
+作业 + 点名 = 平时成绩
 ```
 
 不通过时：
+- 编译 log 里打 `*** oucgrade: 比例不自洽 ***`
+- PDF 上印一个醒目的提示
 
-1. `.log` 里打出
-   `*** oucgrade: 比例不自洽 --- 作业+点名 应构成全部平时成绩: 实际 25+10, 应为 30 ***`
-2. PDF **标题正下方**印一行红字警告
+## 表格结构
 
-**为什么值得做**：成绩构成说明是要归档、要被抽查的文件，比例加不起来
-是最常见也最难被自己发现的错误 —— 原件那句「平时 30%（作业 20%，
-点名 10%）」正是靠心算才看得出 20+10=30。
+| 区段 | 内容 |
+|---|---|
+| 表头 | 课程名称、学年学期、任课教师 |
+| 总成绩构成 | 理论课 / 实验课两行，各占百分比 |
+| 理论课内部 | 平时成绩 / 期末考试 |
+| 平时成绩内部 | 作业 / 点名 |
+| 实验课说明 | 一行文字 |
+| 签字栏 | 任课教师、教研室主任、教学院长 |
 
-**已做负面测试**：把 `\grdhw` 从 20 改成 25 重编，log 报
-`实际 25+10, 应为 30`，PDF 第 1 页顶部出现警告；改回 20 后警告消失。
+## 改表格内文字
 
-⚠️ 警告印在**开头**不是文末。文末的提示会被签字栏挤到第 2 页，
-而第 2 页通常没人翻 —— 等于没提示。
+正文里表格用标准 `tabular`，各格改写直接改文字。
 
-## 版式参数
+### 常用命令
 
-### 页面
+| 命令 | 用途 |
+|---|---|
+| `\grdmaintitle` | 主标题 |
+| `\grdsubtitle` | 副标题 |
+| `\grdsubtitleline` | 副标题下横线 |
+| `\grdsec{标题}` | 分区标题 |
+| `\grditem{文字}` | 条目 |
+| `\grdpara{文字}` | 段落 |
+| `\grdth{内容}` | 表头格 |
+| `\grdtd{内容}` | 表体格 |
+| `\grdcalc{算式}` | 算式格（自动排版） |
+| `\grdsignblock` | 签字栏整块 |
+| `\grdsmall{文字}` | 小字 |
+| `\grdcheck` | 运行比例校验 |
+| `\grdwarnifbad` | 不自洽时印警告 |
 
-| 项 | 值 | 来源 |
-| :-- | --: | :-- |
-| 纸张 | A4 210×297mm | `pgSz 11906×16838` twips |
-| 上下边距 | 25.40mm | `pgMar top/bottom 1440` |
-| 左右边距 | 31.75mm | `pgMar left/right 1800` |
-| 版心 | 146.50 × 246.20mm | 210−2×31.75 / 297−2×25.40 |
-| 页脚距 | 17.51mm | `pgMar footer 992` |
+## 版式
 
-换算：`mm = twips / 1440 × 25.4`，`pt = twips / 20`。
-
-### 字号
-
-| 用途 | 原件 (w:sz) | 本模板 | 实测输出 |
-| :-- | --: | --: | --: |
-| 大标题 | 36 半磅 = 18pt | `18bp` | 18.00 |
-| 副标题 | 24 = 12pt | `12bp` | 12.00 |
-| 正文 | 28 = 14pt | `14bp` | 14.00 |
-| 表格/签字 | — | `12bp` | 12.00 |
-
-⚠️ **必须写 `bp` 不能写 `pt`**。Word 的 pt 是 PostScript pt（1/72 in），
-TeX 默认 pt 是 1/72.27 in，差 0.36%。写 `14pt` 实测输出 14.05。
-
-### 行距
-
-| 用途 | 值 | 说明 |
-| :-- | --: | :-- |
-| 正文 | 21.5bp | 14pt 的 1.54 倍 |
-| 表格/签字 | 17bp | 12pt 的 1.42 倍 |
-
-原件 `docGrid linePitch=312` = 15.6pt，对 14pt 字只有 1.11 倍，太挤。
-本模板用 21.5bp（1.54 倍）—— 这是**有意的改善**，不是复刻。
-21.5 是为压到一页反复试出来的值，可读下限约 1.4 倍，还有余量。
-
-### 表格列宽
-
-6 列，Σ wd = 123.64mm：
-
-| 列 | 宽 | 内容 |
-| :-- | --: | :-- |
-| 项目 | 22.00mm | 理论课 / 实验课 |
-| 占本类 | 14.00mm | 80% |
-| 细分项目 | 26.00mm | 平时成绩 / 期末 |
-| 占本类 | 14.00mm | 30% |
-| 占总成绩 | 17.00mm | 24% |
-| 评定依据 | 29.40mm | 作业 + 出勤 |
-
-**Σwd 为什么是 123.64 而不是 146.50**：`Q[wd=...]` 是内容区宽度，
-不含 `colsep`。每列实际占位 = `wd + 2×colsep`，6 列共多占
-`6×2×1.905 = 22.86mm`。所以
-`Σwd = 146.50 − 22.86 = 123.64mm`。
-
-⚠️ **画满全格线之后每列还要再扣 0.5pt**。只画外框时表宽里不含内部
-竖线；一旦 `vline{1-Z}` 把 5 条内部竖线都画上，表宽就多出
-`5×0.5 = 2.5pt`，编译报 `Overfull \hbox (2.47554pt too wide)`。
-所以最后一列从 30.28mm 收到 29.40mm（−2.5pt）补回来。
-
-### 行高：`ht` 是最小值，且跨行格不会自己长高
-
-这两点一起踩过，都表现为"字贴着格线"：
-
-| `ht` 是否小于内容高 | 结果 |
-| :-- | :-- |
-| 是（如 `ht=7.5mm` < 54.73pt） | 行被内容撑到 54.73pt，**上下零留白**，末行墨迹底离行线只剩 0.90pt（0.32mm），其他行是 4.97pt（1.75mm）—— 一眼看出挤 |
-| 否（`ht=22mm` = 62.4pt） | 行高 62.86pt，上下各留约 3.8pt，末行墨迹底离行线 4.08pt（1.44mm），与其他行同量级 |
-
-所以 **`ht` 给了不等于生效，必须大于内容自然高度**。本例「平时成绩
-（作业 20%、点名 10%）」在 26mm 列里折 3 行，自然高 54.73pt
-（= 2×17bp + 盒高），要撑开就得给到 22mm。
-
-`ht` 按**表格行号**给，不是按逻辑块：`row{1}` 是表头、`row{2}` 是
-「理论课/平时成绩」那一行。抬高 `row{3}`（「期末」行）只会移动中间
-那条线，对跨行块的高度没有影响。
-
-## 五个坑
-
-### 坑 1：`.tex` 里写带 `@` 的宏名
-
-`.tex` 文档中 `@` 的 catcode 是 12（其他），不是 11（字母）。写
-`\grd@chk` 会被解析成 `\grd` + `@chk`，报
-`! LaTeX Error: Missing \begin{document}`，并且**连累后面所有内容**
-（报一串 Undefined control sequence）。
-
-**规矩**：带 `@` 的内部宏一律定义在 `.sty` 里，`.tex` 只调用不带 `@`
-的公开接口（如 `\grdcheck`）。
-
-### 坑 2：tabularray 的 `hline{}` 里不能用带 `@` 的宏
-
-```latex
-hline{1,Z}={\grd@rulev}   % ✗ 报 \l__tblr_v_tl ->\grd @rulev
-hline{1,Z}={0.5pt}        % ✓ 写字面值
+```
+A4，正文小四（12pt），边距标准
+表格带框线
 ```
 
-tabularray 把 `hline` 的参数当**字符串重新 tokenize**，那一刻 `@` 的
-catcode 已经退化，宏名在 `@` 处断开。
+## 注意
 
-**规矩**：`hline` / `vline` 的线宽写字面值，别用宏包一层。
-
-⚠️ 关于 `1-Z` 与 `1,Z`：
-
-| 写法 | 含义 | 效果 |
-| :-- | :-- | :-- |
-| `hline{1,Z}` | 第 1 条 + 最后 1 条 | 只有顶框和底框 |
-| `hline{1-Z}` | 第 1 条到末条（全部） | 每条行线都画 |
-
-本模板用 `1-Z`：**所有格线都画满**。只画外框时，跨行格（理论课）
-与单行格的分界、以及数据行之间全是空白，非常容易看错行。这是
-用户明确要求改掉的点。
-
-代价是每列要再扣 0.5pt 表宽（见上文「画满全格线之后每列还要再扣」
-一节），并且暴露出一个原本被掩盖的缺陷：跨行格里的第 3 行字一直
-是贴着格线的（详见上文「行高」一节）。**画满格线会让所有"零留白"
-的排版问题显形** —— 这是好事，但要预留调 `ht` 的时间。
-
-### 坑 3：签字栏被挤到第 2 页
-
-试过四种写法，只有最后一种同时满足「一页」+「不出界」：
-
-| 写法 | 结果 |
-| :-- | :-- |
-| `\par\vspace{4mm}` + minipage | ✗ 翻页（minipage 紧跟 `\par` 是合法断页点） |
-| `\vfill` 顶到底部 | ✗ 不翻页但**出界**：年月日 y=774.9，版心底只有 771.6 |
-| `\vfill` + 块内 `\vspace*{5mm}` | ✗ 又翻页（`\vfill` 与块高之和超出剩余空间时，TeX 不接受压缩 `\vfill`，只能整块搬迁） |
-| `\par\vspace{3mm}` + minipage | ✓ 一页，内容底 769.8，余 1.8pt |
-
-**结论**：不要指望竖直胶帮你「自动贴底」。单页文档里最稳的是
-**固定间距 + 实测校准** —— 改正文后重编一次，看内容底距 771.6 还有多少。
-
-### 坑 4：minipage 内部用 `\hfill` 做右对齐
-
-```latex
-\begin{minipage}{76mm}
-  任课教师（签字）：\rule{40mm}{0.4pt}\par   % 行尾没有 \parfillskip 弹性
-\end{minipage}
-```
-
-minipage 里的行末会被拉伸到满宽，12pt 的字出现夸张字距 ——
-实测「任」「课」「教」「师」被拉到 **34.8pt 一字**。
-
-**正解**：minipage 内 `\raggedright`，`\hfill` 只放在外面：
-
-```latex
-\noindent\makebox[\textwidth][r]{\begin{minipage}{76mm}\raggedright ...\end{minipage}}
-```
-
-### 坑 5：列表引导符「·」缺字
-
-本库 OUC Serif 子集里**没有** `·`(U+00B7) 和 `•`(U+2022)，
-用它们会报 `Missing character: There is no · (U+00B7)`，印出来是空白。
-
-实测该字体有 `●`(U+25CF) 与 `○`(U+25CB)，且 `fonts.tex` 已把这两个
-码位归入 CJK 字符类，可直接用。本模板用缩小 0.6 倍的 `●` 作引导符。
-
-## 真实数据零泄漏
-
-原件是**填过的实例**（真实课程名、学年、教师姓名、全部比例）。
-本模板把这些逐项换掉：课程名 / 学年 / 教师名换成虚构的《数字逻辑》2025 秋
-「张远航」，原件的比例也未保留。
-
-已 grep 确认以下关键词在 `oucgrade.sty`、`成绩构成说明.tex` 与 `README.md`
-中**零命中**（含注释）：原件实例的课程名、学生人数、开课号、教师姓名、
-单位名称，以及原件出现过的具体年份。本 README 不列出这些原文，
-避免「为了证明零泄漏而把真实信息写进来」。
-
-> 关于 `80`/`20`/`30`：样张里这几个数**不是从原件抄的**，是按「理论 80 +
-> 实验 20、平时 30（作业 20 + 点名 10）+ 期末 70」重新配的一组自洽比例，
-> 目的是让模板的比例校验（见前文「比例自洽校验」）能演示出「三项都成立」
-> 的状态。原件那组比例本身有对不上的地方，不适合当范例。
-
-## 字体
-
-全部来自仓库公共字体包 `../fonts.tex`（唯一允许声明字体的地方）：
-
-| 用途 | 字体 | 授权 |
-| :-- | :-- | :-- |
-| 正文宋体 | OUC Serif（思源宋体 GB2312 子集） | SIL OFL 1.1 |
-| 标题楷体 | OUC Kai（霞鹜文楷子集） | SIL OFL 1.1 |
-| 分节黑体 | OUC Sans（思源黑体子集） | SIL OFL 1.1 |
-| 西文 | TeX Gyre Termes | GUST Font License |
-
-⚠️ 原件标题用的是**方正楷体_GB2312**，那是商业字体，本库不含也不能分发。
-改用霞鹜文楷（同属楷书形态，开源可商用）。这是**有意的替换**，不是遗漏。
-
-⚠️ 不要用 `\setCJKmainfont` 直接指定系统字体（SimSun / SimHei 等）——
-换到 Linux / macOS 就编不出来。全部走 `../fonts.tex`。
+示例内容为虚构数据，使用时全部替换。签字栏留空手填。