科技报告字体调整：西文改 Cochineal、标题统一鸿蒙、代码换等宽 #19

用户反馈「标题一会儿黑体一会儿什么体的」。pymupdf 提取旧 PDF 定位到
三处字体分裂，逐条修掉。

一、西文从鸿蒙换成 Cochineal（cls/font.cls）

旧版 \setmainfont / \setsansfont / \setmonofont 三处全是鸿蒙。中文换成
思源宋体之后，正文就成了「中文衬线 + 西文无衬线」：同一行里英文数字比
汉字细、像陷进去，读起来割裂。

Cochineal 是 Minion 风格的衬线体（OFL 1.1，fonts/cochineal/ 已在库内），
与思源宋体灰度接近；度量与 Termes 只差 1.9%，不推着断行变。

\setsansfont 保持鸿蒙 —— 标题靠 \hm 切到 OUCHM 族，西文 sans 位仍是鸿蒙，
标题的中西文因此都是鸿蒙，与正文区分得开。

二、\hm 重定义为中西文一起切（cls/font.cls，本次核心）

这是「字体一会儿一个样」的真正来源。fonts.tex 里的 \hm 是
    \def\hm{\CJKfamily{OUCHM}}
纯 xeCJK 中文字族切换，管不到阿拉伯数字和拉丁字母。而标题、封面主标题、
摘要标题都用 \hm 表示「这是鸿蒙」，于是凡是标题里夹了西文就还是西文字体：

  · 章节编号 "1." "3.1" → 走 \setmainfont → 旧版是鸿蒙粗，改 Cochineal 后
    变成衬线粗，与中文鸿蒙粗并排
  · "这是一个很好用的 LaTex 模板" 里的 LaTex → 走 \setmainfont
  · 目录条目编号是数字、标题是中文 → 同一条目录两种字体

修法：本模板内把 \hm 重定义为 \hmlatin\CJKfamily{OUCHM}，中西文一起切。
一次在源头解决，不在每个调用点补 \hmlatin —— 后者必然漏（封面、摘要、
目录标题、页眉、文本框标题各漏一次，本次实测漏了 4 处）。

不改 ../fonts.tex 的 \hm：幻灯片和简历也在用，它们没有这个问题，全局改
会外溢。

三、目录条目与页码归零（cls/title.cls）

\cftsecfont 等三条只管条目文字，页码走 \cft*pagefont，不显式清掉的话
目录里页码比标题还粗、最抢眼。两组共 6 条一起设 \normalfont。
不塞 \bfseries：加粗与否是各条目录自己的事，硬加会让二三级也变粗。

四、代码等宽位换 Latin Modern Mono（cls/font.cls）

旧版 \setmonofont 也是鸿蒙 —— 它不是等宽字体，代码里 i/l/1、m/w 宽度
不一，竖向对不齐、缩进看着是歪的。lmmono 是 TeX Live 自带，无需额外
字体文件。

⚠️ 这里不能用 Extension + UprightFont=*-regular：lm 系列文件名本身是
"lmmono10-regular.otf" 已带 -regular，再拼会变成 lmmono10-regular-regular
然后报 cannot be found。给完整文件名、不给 Extension。粗体用
lmmonolt10-bold（同族等宽，换粗体不错位），没有 lmmonobq 这个变体。

五、内容块保留 3 个 Underfull（cls/boxes.cls，只加注释不改代码）

第 208/214/220 行的 \verb|Illuminate\Foundation\Http\Kernel| 是 35 字符
不可断串，在内容块 371pt 内宽里塞不下。试过无效的：\emergencystretch
2em/10em（不是额度不够，是这行没有足够可拉伸 glue）、\sloppy（badness
从 1231 升到 3590，更差）。有效但不采用：\seqsplit（归零但任意字符处
断行，代码路径被切两段）、窄体 lmmonoltcond（归零但压缩可读性）。

结论：保留这 3 个，badness 1231 属轻微（10000 才是严重），渲染只是行末
留白略多。日志里看到它们属预期，不是回归。

六、report.tex 字体说明同步

第 52/58 行原文说「英文字体默认使用鸿蒙」，改后已不准确，重写为
Cochineal + Latin Modern Mono 的实际状况，并说明标题编号统一的原因。

验证（两套环境各跑两遍，逐字同数）

  WSL / TeX Live 2025：rc=0，error 0，Overfull 0，Underfull 4，10 页
  Windows / TeX Live 2022：rc=0，error 0，Overfull 0，Underfull 4，10 页

pymupdf 提取字体分布，两侧完全一致：
  Cochineal-Roman 782   OUCSerif-Regular 143   LMMono10-Regular 98
  OUCKai-Regular 33     HarmonyOS_Sans_SC_Bold 22   HarmonyOS_Sans_Bold 14
  OUCSerif-Bold 8       FontAwesome 5   HarmonyOS_Sans_SC 3
  ZhuqueFangsong 2      OUCSans-Regular 2   CMSY10 1   CMEX10 1
  HarmonyOS_Sans 1

标题逐页核对（中西文双档均属鸿蒙）：
  p1 封面   HarmonyOS_Sans_SC_Bold「这是一个很好用的」+ HarmonyOS_Sans_Bold「LaTex」
  p2 目录   HarmonyOS_Sans_SC_Bold「目录」
  p5 摘要   HarmonyOS_Sans_SC_Bold + HarmonyOS_Sans_Bold「LaTex」
  p6 正文   HarmonyOS_Sans_Bold「1.」+ HarmonyOS_Sans_SC_Bold「准备工作」
  p10 正文  HarmonyOS_Sans_Bold「8.」+ HarmonyOS_Sans_SC_Bold「图标」

OUCSans-Regular 2 / ZhuqueFangsong-Regular 2 / HarmonyOS_Sans 1 三处少量
命中已逐个查清，都不是回归：
  · p6「黑体」「仿宋」—— 正文故意演示 \fzzdx / \fzfs 的示例文字
  · p8 每页同 bbox、45° 旋转、29.8pt —— 全页水印，设计如此
  · p10「HTTP/Console」—— 文本框标题走 fonttitle=\hm，改后已是
    HarmonyOS_Sans + HarmonyOS_Sans_SC，中西文都属鸿蒙

涉及文件：
  科技报告/cls/font.cls    默认族、\hm 重定义、等宽位
  科技报告/cls/title.cls   目录条目与页码归零
  科技报告/cls/boxes.cls   仅补 Underfull 记录注释，代码未改
  科技报告/report.tex      字体说明文字同步

科技报告/cls/boxes.cls

@@ -6,6 +6,27 @@
 % 颜色一律引用 cls/color.cls 里的语义名（oucinfo / oucalert ...），
 % 不在这里写具体色名，更不写 RGB 值。
 %
+% 【关于内容块里的 3 个 Underfull \hbox（#19 记录）】
+%
+% 第 208/214/220 行那三段示例文字里有 \verb|Illuminate\Foundation\Http\Kernel|，
+% 这个 35 字符的串在 \verb 里**不能断行**，整行只能把它塞进去，于是那行
+% 被撑松 —— 报 Underfull (badness 1231)。
+%
+% 试过且**无效**的方案（别重复踩）：
+%   · \emergencystretch 2em / 10em —— 无效。它不是"额度不够"的问题：
+%     这一行没有足够的可拉伸 glue 可用，给多少额度都无从施展。
+%   · \sloppy —— 反而更差，badness 从 1231 升到 3590（放宽了断行标准，
+%     TeX 选了别的更松的解）。
+%
+% 有效但**不采用**的方案：
+%   · \seqsplit —— Underfull 归零，代价是在任意字符处断行，
+%     一条代码路径被切成两段，可读性明显变差。
+%   · 换窄体等宽 lmmonoltcond（Light Condensed）—— 也归零，
+%     但压缩字体让代码变窄变小，为一个示例文本牺牲整体代码可读性不合理。
+%
+% 结论：保留这 3 个 Underfull。badness 1231 属轻微（10000 才是严重），
+% 渲染出来只是行末留白略多，不影响阅读。日志里看到它们属预期，不是回归。
+%
 
 %% 带标题的文本框
 % 这个框走的是"极简"路线：框线和标题栏都是白色，靠黑字 + 细边分界。

科技报告/cls/font.cls

@@ -42,18 +42,38 @@
 %======================================================================
 % 二、默认字体族
 %
-%    西文：鸿蒙 HarmonyOS Sans（与原模板一致，观感不变）
 %    中文：OUC Serif 书宋（对应原方正书宋），粗体用 OUC Serif Bold
 %          （对应原方正小标宋 —— 小标宋本身就是宋体的标题变体）
+%    西文：Cochineal（Minion 风格，OFL 1.1）
+%    无衬线：鸿蒙 HarmonyOS Sans（标题、目录标题、封面标题都靠 \hm 切）
 %
 %    ⚠️ Path= 是相对**编译时工作目录**（= 科技报告/）的，不是相对 cls/。
 %       故写作 ../fonts/...，不要写 ../../。
+%
+%    ⚠️⚠️ 西文为什么从 HarmonyOS 换成 Cochineal（2026-10 改，#19）
+%
+%    旧版这里 \setmainfont / \setsansfont / \setmonofont 三处全是鸿蒙。
+%    中文换成思源宋体之后，正文就成了「中文衬线 + 西文无衬线」，
+%    同一行里英文数字明显比汉字细、比汉字"陷进去"，读起来割裂。
+%
+%    更明显的副作用在目录：\setmainfont 是西文字体总开关，目录条目的
+%    编号（"1." 是数字）走它 → 鸿蒙粗体；而条目标题是中文 → 走
+%    \setCJKmainfont → 思源宋体粗。**同一条目录里两种字体**，
+%    这就是"标题一会儿黑体一会儿什么体"的实际来源。
+%
+%    换成 Cochineal 后：中文宋体、西文衬线，灰度接近；目录编号与标题
+%    也归到同一字族。度量与 Termes 只差 1.9%，不推着断行变。
+%
+%    ⚠️ \setsansfont 保持鸿蒙 —— 标题用 \hm（CJK 族名 OUCHM）切换，
+%       西文 sans 位仍是鸿蒙，标题的中西文因此都是鸿蒙，与正文区分得开。
 %======================================================================
-\setmainfont{HarmonyOS_Sans_Regular.ttf}[
-  Path           = ../fonts/harmonyos-sans/,
-  BoldFont       = HarmonyOS_Sans_Bold.ttf,
-  ItalicFont     = HarmonyOS_Sans_Regular_Italic.ttf,
-  BoldItalicFont = HarmonyOS_Sans_Bold_Italic.ttf,
+\setmainfont{cochineal}[
+  Extension      = .otf,
+  Path           = ../fonts/cochineal/,
+  UprightFont    = *-Roman,
+  BoldFont       = *-Bold,
+  ItalicFont     = *-Italic,
+  BoldItalicFont = *-BoldItalic,
 ]
 \setsansfont{HarmonyOS_Sans_Regular.ttf}[
   Path           = ../fonts/harmonyos-sans/,
@@ -61,8 +81,23 @@
   ItalicFont     = HarmonyOS_Sans_Regular_Italic.ttf,
   BoldItalicFont = HarmonyOS_Sans_Bold_Italic.ttf,
 ]
-\setmonofont{HarmonyOS_Sans_Regular.ttf}[
-  Path = ../fonts/harmonyos-sans/,
+
+% 等宽位：真等宽，供代码块（listings 的 \ttfamily）使用。
+% 旧版这里也是鸿蒙 —— 它不是等宽字体，代码里 i/l/1、m/w 宽度不一，
+% 竖向对不齐，缩进看起来是歪的。
+% lmmono（Latin Modern Mono）是 TeX Live 自带，无需额外字体文件。
+%
+% ⚠️ 这里**不能**用 Extension + UprightFont=*-regular 的组合。
+%    lm 系列的文件名本身就是 "lmmono10-regular.otf"，已经带 -regular 后缀；
+%    再配 Extension=.otf 加 *-regular，fontspec 会拼成
+%        lmmono10-regular-regular.otf
+%    然后报 The font "lmmono10-regular-regular" cannot be found。
+%    正确做法是给完整文件名、不给 Extension。
+% ⚠️ 没有 lmmonobq 这个变体；粗体用 lmmonolt10-bold（同属 lmmono 家族，
+%    字宽与 regular 一致，换粗体不会让代码错位）。
+\setmonofont{lmmono10-regular.otf}[
+  ItalicFont = lmmono10-italic.otf,
+  BoldFont   = lmmonolt10-bold.otf,
 ]
 
 % \hm 已在 fonts.tex 里登记（CJK 族名 OUCHM），这里不重复定义。
@@ -81,6 +116,28 @@
 \XeTeXlinebreaklocale "zh"
 \XeTeXlinebreakskip = 0pt plus 1pt
 
+%======================================================================
+% 二之二、重定义 \hm：中文与西文一起切到鸿蒙（#19）
+%
+%    问题：fonts.tex 里的 \hm 是 \def\hm{\CJKfamily{OUCHM}} —— 这只是
+%    xeCJK 的**中文字族**切换，管不到阿拉伯数字和拉丁字母。而本模板的
+%    标题、封面主标题、摘要标题都用 \hm 来做"这是鸿蒙"，于是凡是标题里
+%    夹了西文（"LaTex"、编号 "1." "3.1"）就还是渲染成西文字体，
+%    表现为同一个标题里中文鸿蒙、西文衬线 —— 就是"字体一会一个样"。
+%
+%    解法：在本模板内把 \hm 重定义为「中文字族 + 拉丁字族」一起切。
+%    \hmlatin 由 fonts.tex 用 \newfontfamily 定义，是 Latin 字族命令，
+%    与 \CJKfamily 作用域不同，可以并存。
+%
+%    ⚠️ 必须是 \renewcommand，不能 \newcommand —— 名字已被 fonts.tex 定义。
+%    ⚠️ 只改本模板，不动 ../fonts.tex：幻灯片和简历也在用那个 \hm，
+%       全局改会让它们跟着变，而它们没有这个"标题里混西文"的问题。
+%       这是本模板的局部修正，不该外溢。
+%    ⚠️ 重定义要在所有 \hm 调用**之前**。本文件由 report.cls 在
+%       \begin{document} 前 \input，位置没问题；不要把这段挪到后面。
+%======================================================================
+\renewcommand{\hm}{\hmlatin\CJKfamily{OUCHM}}
+
 %======================================================================
 % 三、5 个方正语义别名
 %

科技报告/cls/title.cls

@@ -2,12 +2,26 @@
 %% 标题、目录等设定
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+%----------------------------------------------------------------------
+% 各级标题字体（#19）
+%
+% 目标：编号和标题文字**都是鸿蒙**。
+%
+% 踩的坑：原来只写 format=\hm\bfseries，以为 \hm 就够了。实际 \hm 在旧版
+% 是纯 xeCJK 中文字族切换，管不到阿拉伯数字 —— 编号 "1." "3.1" 被判成
+% 西文，仍走 \setmainfont，于是同一个标题里中文鸿蒙、编号衬线。
+%
+% 修法：本次在 cls/font.cls 里把 \hm 重定义为「中西文一起切鸿蒙」，
+% 所以这里维持 format=\hm\bfseries 即可，不需要再写 \hmlatin。
+% 换个说法：问题统一在 \hm 的定义处解决，而不是在每一处调用点逐个补 ——
+% 后者必然漏（封面、摘要、目录标题、页眉都会各自漏一次）。
+%----------------------------------------------------------------------
 \ctexset{
   % 修改 section文字样式，
   section={   
     name={,.},%编号和文字中间用.。
     number={\arabic{section}},%编号形式：\arabic设置为阿拉伯数字，\chinese设置为中文，\roman设置为小写罗马字母，\Roman设置为大写罗马字母，\alph设置为小写英文，\Alph设置为大写英文。
-    format=\hm\bfseries\raggedright\zihao{4},%鸿蒙字体，小四号字，右对齐。
+    format=\hm\bfseries\raggedright\zihao{4},%鸿蒙字体（中西文都用鸿蒙），小四号字，右对齐。
     aftername=\hspace{5pt},%编号和标题的距离
     % beforeskip=1ex,%标题与前文的距离
     % afterskip=1ex,%标题与后文的距离
@@ -32,3 +46,33 @@
 \renewcommand{\cftpartleader}{\cftdotfill{\cftdotsep}} % 给 parts 加点
 %\renewcommand{\cftchapleader}{\cftdotfill{\cftdotsep}} % 给 chapters 加点
 \renewcommand{\cftsecleader}{\cftdotfill{\cftdotsep}} % 给 sections加点
+
+%----------------------------------------------------------------------
+% 目录条目的字族统一（#19）
+%
+% 问题：一条目录里能出现两种字体。编号 "1." 是阿拉伯数字 → 被 xeCJK
+% 判成西文 → 走 \setmainfont；条目标题是中文 → 走 \setCJKmainfont。
+% 旧版 \setmainfont 是鸿蒙、\setCJKmainfont 是思源宋体，于是同一条里
+% 「编号鸿蒙粗 + 标题宋体粗」，看着就是标题字体一会儿一个样。
+%
+% 把西文改回衬线（Cochineal）之后这个分裂本身已经消失，但这里仍然显式
+% 声明一次，理由有二：
+%   ① 不依赖 \setmainfont 的间接效果 —— 将来若有人改了 font.cls 的
+%      西文设置，目录不会跟着又裂开；
+%   ② tocloft 的 \cftsecfont 是"只管目录条目"的开关，改它比调全局安全。
+%
+% ⚠️ 只设 \cftsecfont / \cftsubsecfont / \cftsubsubsecfont，不动
+%    \cftsecpagefont —— 页码那列保持默认，不用跟着正文加粗。
+% ⚠️ \cftsecfont 里不要塞 \bfseries：加粗与否是各条目录自己的事
+%    （正文章节标题本就 \bfseries），在这里硬加会让二级三级也变粗。
+%----------------------------------------------------------------------
+\renewcommand{\cftsecfont}{\normalfont}
+\renewcommand{\cftsubsecfont}{\normalfont}
+\renewcommand{\cftsubsubsecfont}{\normalfont}
+
+% 页码列单独归零。上面三条只管条目文字，页码走的是 \cft*pagefont，
+% 默认继承条目的粗体设置 —— 不显式清掉的话，目录里页码会比标题还粗，
+% 一眼看过去页码最抢眼。
+\renewcommand{\cftsecpagefont}{\normalfont}
+\renewcommand{\cftsubsecpagefont}{\normalfont}
+\renewcommand{\cftsubsubsecpagefont}{\normalfont}

科技报告/report.tex

@@ -47,15 +47,15 @@
 
 \section{字体}
 
-在模板中，默认使用的字体是鸿蒙字体，除此之外，还定义了一些其他的中文字体。
+在模板中，中文默认使用思源宋体，西文默认使用 Cochineal，标题统一使用鸿蒙字体。除此之外，还定义了一些其他的中文字体。
 
-英文字体，默认使用的是鸿蒙字体(HarmonyOS Sans)，现在你看到的应该就是这个字体的效果。这些设置，可以在cls中，字体设定里面进行修改。
+英文字体，正文默认使用的是 Cochineal（一款 Minion 风格的衬线体），代码等宽位使用的是 Latin Modern Mono。所以你现在看到的西文和阿拉伯数字都是衬线字体。这样安排是为了和中文的思源宋体保持相近的灰度——如果西文用无衬线，同一行里字母数字会明显比汉字细、像"陷进去"，读起来割裂。这些设置，可以在 cls 中字体设定里面进行修改。
 
 中文字体，使用的是鸿蒙字体、思源宋体、霞鹜文楷、朱雀仿宋、思源黑体等。全部为开源可商用字体，不使用任何方正、微软雅黑等商业字体。
 
 中文的默认字体衬线字体是思源宋体，加粗字体是思源宋体的真粗体，就像这样：\textbf{这里是加粗字体}。斜体的字体是霞鹜文楷，就像这样:\textit{这里是中文斜体}。斜体粗体的字体是朱雀仿宋，就像这样：\textbf{\textit{这里是粗体斜体}}。中文的无衬线字体sans font使用的是鸿蒙字体，你应该可以在标题中看到它。中文等宽字体，使用的是思源黑体。
 
-默认的无衬线字体是鸿蒙字体，你应该可以在各种标题中看到它的样子。
+默认的无衬线字体是鸿蒙字体，你应该可以在各种标题中看到它的样子。注意标题里的中文和西文（包括编号 "1."、"3.1"）现在统一都是鸿蒙——旧版因为编号是阿拉伯数字、被归到西文字体，会出现同一个标题里中文鸿蒙、编号衬线的情况，看着像"字体一会一个样"，现已修正。
 
 同样，上述的字体，在cls中，都可以进行设置。