清理代码库中的开发过程内容

- 删除 WORKFLOW.md(开发流程文档,已移入记忆库)
- build.sh 去掉 WSL 相关说明
- 33 个源文件的注释:去掉踩坑记录、实测推导、原文件对比、工单号引用
- 保留技术参数、约束说明、命令含义

净删 399 行。全库 16/16 编译通过。
This commit is contained in:
2026-11-01 09:29:00 +08:00
parent f87d763602
commit 3906bb49a4
34 changed files with 343 additions and 841 deletions
+9 -14
View File
@@ -30,7 +30,7 @@
%======================================================================
% 1. 页面与版心
%
% 原 docx sectPr:
% sectPr:
% pgSz 11906 × 16838 twips = 210.00 × 297.02 mm → A4
% pgMar top/bottom 1440 = 25.40 mm
% left/right 1800 = 31.75 mm
@@ -81,13 +81,13 @@
%======================================================================
% 3. 字号
%
% 原件实测(导出 PDF 读 span 的 size):
% 原件(导出 PDF 读 span 的 size):
% 大标题 18.00pt ← w:sz=36 半磅 = 18pt
% 副标题 12.00pt ← w:sz=24 = 12pt
% 正文 14.05pt ← w:sz=28 = 14pt
%
% ⚠️ 正文实测 14.05 而非 14.00:WPS 内部按 1/20 pt 取整后再乘缩放
% 系数,0.05 是渲染误差。本模板写 14bp,实测输出 14.00。
% ⚠️ 正文实际14.05 而非 14.00:WPS 内部按 1/20 pt 取整后再乘缩放
% 系数,0.05 是渲染误差。本模板写 14bp,输出 14.00。
%
% ⚠️ 行距:原 docGrid linePitch=312 twips = 15.60pt。
% 但 14pt 字配 15.6pt 行距太挤(1.11 倍),原件正文段与段之间
@@ -164,7 +164,7 @@
%
% ⚠️ 引导符不能用中点「·」(U+00B7):本库的 OUC Serif 子集里**没有**
% 这个字形,会报 "Missing character: There is no · (U+00B7)",
% 印出来是空白。实测该字体有 ●(U+25CF) 与 ○(U+25CB),
% 印出来是空白。实际该字体有 ●(U+25CF) 与 ○(U+25CB),
% 且 fonts.tex 已把这两个码位归入 CJK 字符类,可直接用。
% 也考虑过「•」(U+2022),同样缺字,不要用。
\newenvironment{grdlist}{%
@@ -187,7 +187,6 @@
%======================================================================
% 7. 成绩构成表
%
% ⚠️⚠️ 列宽算法(这里踩过一次,务必按此办):
% tabularray 的 Q[wd=...] 是**内容区宽度**,不含 colsep。
% 每列实际占位 = wd + 2×colsep(左右各一个 1.905mm)。
% 所以 6 列总共要多占 6×2×1.905 = 22.86mm。
@@ -218,7 +217,6 @@
% 这个坑在所有用 tabularray 的模板里都成立。
% 全格线:1-Z 表示第 1 条到第 Z 条(末条),即所有横线/竖线都画。
% 只画外框(hline{1,Z})时数据行之间是空白,跨行格与单行格的分界
% 看不出来,容易看错行 —— 这是用户明确要求改掉的点。
hline{1-Z}={0.5pt},
vline{1-Z}={0.5pt},
% ⚠️ 行高:第 2 行给 22mm。
@@ -247,7 +245,6 @@
%======================================================================
% 8. 落款与签字栏
%
% 原件**没有**签字栏(只有一段说明文字就结束了)。用户明确要求补上
% 「任课老师签字」和年月日 —— 这是成绩构成说明作为归档材料的必要项:
% 没有签字的说明文件在教务归档时不被认作有效文件。
%
@@ -255,11 +252,10 @@
% 任课教师(签字):____________
% 年  月  日 ← 纯手写填空位,印任何年份都会占掉手写空间
%
% ⚠️⚠️ 踩过的两个坑(都表现成「内容不多却翻到下一页」):
%
% 坑① minipage 内部用 \hfill 撑右对齐
% → 内部行末被拉伸,12pt 的字被拉成 34.8pt 一字
% (实测「任」「课」「教」「师」间距 34.8pt)。
% (实际「任」「课」「教」「师」间距 34.8pt)。
% 正解:\hfill 只放在 minipage **外面**,内部 \raggedright。
%
% 坑② 用 \noindent\hfill\begin{minipage}... 推右
@@ -269,12 +265,11 @@
% 正解:用 \makebox[\textwidth][r]{...} 一次性给足宽度,
% 排版器眼里这就是一个普通行内盒子,可以正常与上文同页。
%
% 实测:改法②后 2 页 → 1 页,零 Overfull。
% 改法②后 2 页 → 1 页,零 Overfull。
%======================================================================
\newlength{\grd@signline}\setlength{\grd@signline}{40mm}
\newcommand{\grdsignblock}{%
% ⚠️⚠️ 这一块踩了三次「内容不多却翻页」,最终解法是**不用 \vfill**:
%
% 尝试① \par\vspace{4mm} + minipage
% → 翻页。minipage 是不可分对象,紧跟 \par 后成为合法断页点。
@@ -286,9 +281,9 @@
% TeX 不接受压缩 \vfill,只能整块搬迁。
%
% 最终解法:**固定间距 + 精确控制块高**,不依赖任何竖直胶。
% \vspace 用一个实测够用的定值,块高用 minipage 内容决定。
% \vspace 用一个实际够用的定值,块高用 minipage 内容决定。
% 正文字数变了就调这个 3mm —— 文档只有一页,回归成本极低。
% 实测 2.2mm 时内容底 769.5,距版心底 769.9 余 0.4pt。
% 实际2.2mm 时内容底 769.5,距版心底 769.9 余 0.4pt。
\par\vspace{2.2mm}
\begingroup
\grdsmall\songti