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

- 删除 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
+12 -17
View File
@@ -10,7 +10,6 @@
% ⚠️⚠️ 本文件的表格**只写内容,不写任何 \SetCell**。
% 所有合并规则都在 oucmeeting.sty 的 oucmeettable 环境里,
% 用 cell{行}{列}={c=n}{对齐} 矩阵式声明。
% 原因(踩了两小时):在这套 7 列 Q[c,m,wd=…] + colsep 配置下,
% 一写 \SetCell 就报一串 Missing number,且错误全指向 \end{tblr}。
% 详见 sty 第 4 节的记录。
%
@@ -62,7 +61,6 @@
% ---- R1~R6 基本信息 ----
%
% ⚠️⚠️ 每行必须写满 7 段(6 个 `&`),被 cell{} 合并掉的格**留空**。
% 实测(最小复现):同样的 cell{} 配置下
% 写 7 段 `甲 & & 乙 & & 丙 & & 丁` → 四个字全部正确
% 写 4 段 `甲 & 乙 & 丙 & 丁` → **乙、丁 被吞掉**
% ⇒ 段数 ≠ 列数时,多出来的内容会静默丢失,不报错。
@@ -71,12 +69,11 @@
% R2 的 cell 配置是 2+2+2+1,即
% 格1(列1-2)=会议时间 格3(列3-4)=空值 格5(列5-6)=会议地点 格7(列7)=空值
% 所以「会议地点」必须写在**第 5 段**,写在第 3 段就会挤到左边、
% 与「会议时间」贴在一起(踩过)。
会议名称 & & & & & & \\
会议时间 & & & & 会议地点 & & \\
% ⚠️ R3/R4 的填空横线用 \hspace 撑,宽度必须控制。
% 跨 5 列约 122mm,三个选项各带一对(\hspace{3em})就要 6×3em=18em
% 再加文字,实测撑到 529.7bp(版心止于 521.57),超 8bp。
% 再加文字,撑到 529.7bp(版心止于 521.57),超 8bp。
% ⇒ 单个填空收到 2.2em(约 7mm,手写两三个字够用)。
会议类型 & & 国内业务会议(\hspace*{2.2em})\hspace*{1em}%
国内管理会议(\hspace*{2.2em})\hspace*{1em}%
@@ -109,24 +106,23 @@
% 纵向合并由 sty 里的 cell{21}{1}={r=5}{c} 声明,
% 这里用 \shortstack 让四个字上下堆叠。
% ⚠️ 不能用 \rotatebox{90}:那只是把横排整句转个角度,
% 不是"上下排列"(#24 按用户意见修正)。
% 不是"上下排列"(修正)。
% ⚠️ \shortstack 里的 \\ 是**普通换行**,tabularray 在 cell{} 语法下
% 不会把它误当行结束(旧版 \SetCell 语法下会崩,那是另一个坑)。
%
% ★ 字距取 4bp:文字块约 56bp,格高 82bp → **上下各留 13bp**,
% 既不贴格线,也能看出竖排拉开的效果。
%
% ⚠️⚠️ 字距不能给太大,会顶到格线。实测(9pt 字、格高 82bp):
% ⚠️⚠️ 字距不能给太大,会顶到格线。(9pt 字、格高 82bp):
% \\[17bp] → 文字块 94bp,**比格高还高**,头尾字距格线只有
% 2.5bp,视觉上字和表格线连成一片(用户指出过)
% \\[8bp] → 文字块 67bp,上下各留 7.4bp ← 仍偏挤
% \\[4bp] → 文字块 56bp,上下各留 13bp ← 采用
% 不加参数 → 文字块 43bp,上下各留 19bp(字挤成一小团,不算竖排)
%
% ⚠️ 不能靠局部设 \baselineskip —— \shortstack 内部会重置它,
% 实测设 19bp 无效(字距仍是 11.6bp)。必须在 \\ 上给可选参数。
% 实际设 19bp 无效(字距仍是 11.6bp)。必须在 \\ 上给可选参数。
% ⚠️ 也不能用 \parbox{}{其\\他\\费\\用} —— 会变成 4 个独立行盒子,
% tabularray 排版错乱,四个字跑到不同段落(实测)。
% tabularray 排版错乱,四个字跑到不同段落(实际)。
\shortstack{其\\[4bp]他\\[4bp]费\\[4bp]用} & 交通费 & & & & & \\
& 会议资料印刷费 & & & & & \\
& 会议室使用费 & & & & & \\
@@ -138,8 +134,8 @@
% R27~R28 意见与签字(跨 3+4)
% ⚠️⚠️ 这里的 \hspace 会把**单元格撑宽,进而把表格右边框推出纸外**,
% 而且文字本身仍在版心内 —— 所以逐 span 查文字查不出来,
% 只有查竖线坐标才能发现(实测最右竖线跑到 526.40,版心止于 521.57)。
% 实测数据:\hspace*{7em} → 超 4.83bp;4.5em → 仍超 4.83bp(跨列宽度已定死,
% 只有查竖线坐标才能发现(实际最右竖线跑到 526.40,版心止于 521.57)。
% 实际数据:\hspace*{7em} → 超 4.83bp;4.5em → 仍超 4.83bp(跨列宽度已定死,
% hspace 只是让内容溢出单元格,不改列宽)。
% ⇒ 该单元格内容必须能在一行内放下。「(签字) (盖章)」共 9 个全角字符
% ≈ 9×9bp = 81bp,跨 4 列约 96mm = 272bp,够放,只要 hspace 不太大。
@@ -148,7 +144,7 @@
% ⚠️ 关于「校级领导意见」:源 .doc 的 R26 第二格里确实有**两个段落** ——
% 「所在单位负责人意见:」和「校级领导意见:」,不是转换时多出来的
% (用 LibreOffice 直接转 txt 核过,原文件就有)。
% 但用户确认这份表不需要校级领导,故按用户意见删除。
% 但用户确认这份表不需要校级领导,故删除。
% ⚠️ 要恢复就把它加回来,且必须单独一行(源文件是两段,不是一行):
% 所在单位负责人意见:\\ 校级领导意见:
%
@@ -159,9 +155,8 @@
%
% ⚠️⚠️ 为什么拆出去(很重要,别又改回主表里)
%
% 这两行放在主表里,无论怎么写都会出问题。四种组合全部实测过:
% 这两行放在主表里,无论怎么写都会出问题。四种组合全部实际过:
% 内容 8 段 + cell{27}{4}={c=4} → 右侧多一列(9 条竖线)❌
% ← 用户指出的"多出一列"
% 内容 7 段 + cell{27}{4}={c=4} → 右侧多一列(9 条竖线)❌
% 内容 2 段 + cell{27}{4}={c=4} → 列数对了,但第 2 段落进第 2 列
% 被 c=4 的合并盖住,内容消失 ❌
@@ -180,14 +175,14 @@
% 前 3 列 6.10+29.65+11.43 = 47.18mm(+colsep 4mm)
% 后 4 列 18.18+29.65+3.00+40.10 = 91.02mm(+colsep 4mm)
% ⚠️ 两列各自的 colsep 各算 2 个(左右各 1),所以实际宽度 = wd + 4mm
% ⚠️⚠️ 第 1 格不要用 \hfill 推「(签字)」到右边 —— 实测会溢出格子:
% ⚠️⚠️ 第 1 格不要用 \hfill 推「(签字)」到右边 —— 实际会溢出格子:
% 第 1 格宽 51.71mm=146bp,「(签字)」36bp,\hfill 推到格尾后
% 文字自身**超出单元格右边界**(tabularray 的格内容不自动裁剪),
% 结果第一个「(签字)」跑到 199~265,跨过 232 的分界线,
% 和第二个「(签字)」在 pymupdf 里连成一串(看着像只有一个)。
% 和第二个「(签字)」连成一串(看着像只有一个)。
% ⇒ 直接顶着格左边界排,前面补一点 \hspace 抵消全角括号的字形左空白。
% (全角「(」的 ink 起点比盒起点靠左约 2.5bp,不加会略微超出
% 版心左界 79.40 —— 实测 x=76.9)
% 版心左界 79.40 —— 实际x=76.9)
\begin{oucmeetsign}
经费(项目)负责人意见: & 所在单位负责人意见: \\
\hspace*{1mm}(签字) & \hspace*{1mm}(签字)\hspace*{5em}(盖章) \\