md2pdf 中文字体修复:install.sh 只认 TrueType(glyf) 轮廓,Noto(CFF) 移出候选并魔数校验自愈重建 fonts/cjk.ttf;img-utils 水印字型优先文泉驿(Noto ttc 默认字型是 JP),仅作兜底

This commit is contained in:
2026-09-16 10:49:25 +08:00
parent f9095f4588
commit 6969c5d949
3 changed files with 98 additions and 63 deletions
+36 -16
View File
@@ -1,25 +1,45 @@
#!/bin/bash #!/bin/bash
set -e set -e
# 确保存在可用的中文字体(watermark 中文水印需要)。 # 确保存在可用的中文字体(watermark 中文水印需要),Pillow 读字体无 reportlab 的 CFF 限制,
# 但 NotoSansCJK ttc 的默认字型(索引 0)是 JP,中文水印会出日式字形,
# 因此就绪判定只认文泉驿(系统 wqy 或同仓 md2pdf 提取的 fonts/cjk.ttf),Noto 仅作兜底。
# 命中即幂等退出;依赖缓存由 Skill Manager 依据本脚本内容哈希管理。 # 命中即幂等退出;依赖缓存由 Skill Manager 依据本脚本内容哈希管理。
for f in \
/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc \ SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
/usr/share/fonts/truetype/wqy/wqy-microhei.ttc \ MD2PDF_FONT="$SKILL_DIR/../md2pdf/fonts/cjk.ttf"
/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc; do
if [ -f "$f" ]; then has_wqy() {
echo "中文字体已存在:$f" for f in /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc \
exit 0 /usr/share/fonts/truetype/wqy/wqy-microhei.ttc; do
fi [ -f "$f" ] && return 0
done done
return 1
}
if has_wqy; then
echo "文泉驿字体已存在"
exit 0
fi
if [ -s "$MD2PDF_FONT" ]; then
echo "使用同仓 md2pdf 准备的中文字体:$MD2PDF_FONT"
exit 0
fi
if [ "$(id -u)" -eq 0 ]; then if [ "$(id -u)" -eq 0 ]; then
echo "未找到中文字体,安装 fonts-wqy-zenhei..." echo "未找到中文字体,安装 fonts-wqy-zenhei..."
apt-get update -y -qq # best-effort:apt 失败不直接报错,交给下面的就绪判定兜底
apt-get install -y -qq fonts-wqy-zenhei apt-get update -y -qq || true
else apt-get install -y -qq fonts-wqy-zenhei || true
echo "错误:非 root 用户且系统无中文字体,无法自动安装" >&2
exit 1
fi fi
echo "中文字体就绪" if has_wqy || [ -s "$MD2PDF_FONT" ]; then
echo "中文字体就绪"
elif [ -f /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc ]; then
# Noto 兜底:中文能显示,只是默认字型偏日式;不算失败
echo "警告:仅有 Noto CJK 字体(中文水印将使用其默认 JP 字型),建议安装文泉驿"
else
echo "错误:无中文字体可用(非 root 且系统未装文泉驿/Noto)" >&2
exit 1
fi
+5 -2
View File
@@ -36,8 +36,10 @@ NAMED_COLORS = {
CJK_FONT_CANDIDATES = [ CJK_FONT_CANDIDATES = [
'/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc', '/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc',
'/usr/share/fonts/truetype/wqy/wqy-microhei.ttc', '/usr/share/fonts/truetype/wqy/wqy-microhei.ttc',
'/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc',
] ]
# Noto 只作最后兜底:Pillow(FreeType) 能读它的 CFF 轮廓,但 ttc 默认字型(索引 0)是 JP 字形,
# 中文水印会出日式写法;同仓 md2pdf 的 cjk.ttf(文泉驿)排在它前面。
NOTO_CJK_FALLBACK = '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc'
def to_int(v, default=0): def to_int(v, default=0):
@@ -221,7 +223,7 @@ def action_compress(img, fmt, args):
def find_font(explicit): def find_font(explicit):
"""字体查找:显式 font > 系统 CJK 候选 > 同仓 md2pdf 技能准备的字体。""" """字体查找:显式 font > 系统 wqy > 同仓 md2pdf 准备的字体 > Noto 兜底。"""
if explicit: if explicit:
p = Path(explicit) p = Path(explicit)
if not p.exists(): if not p.exists():
@@ -230,6 +232,7 @@ def find_font(explicit):
skill_root = Path(__file__).resolve().parent.parent skill_root = Path(__file__).resolve().parent.parent
candidates = list(CJK_FONT_CANDIDATES) candidates = list(CJK_FONT_CANDIDATES)
candidates.append(str(skill_root / 'md2pdf' / 'fonts' / 'cjk.ttf')) candidates.append(str(skill_root / 'md2pdf' / 'fonts' / 'cjk.ttf'))
candidates.append(NOTO_CJK_FALLBACK)
for c in candidates: for c in candidates:
if Path(c).exists(): if Path(c).exists():
return c return c
+57 -45
View File
@@ -1,77 +1,89 @@
#!/bin/bash #!/bin/bash
set -e set -e
# 创建字体目录 # 准备中文字体 fonts/cjk.ttf。
# 关键约束:reportlab 的 TTFont 只支持 TrueType(glyf) 轮廓,
# Noto Sans CJK / Source Han Sans 均为 OTTO(CFF) 轮廓,提取/改名后依然注册失败,
# 因此候选只保留文泉驿(wqy,glyf 轮廓),缺失时用 apt 安装。
FONT_TARGET="fonts/cjk.ttf"
mkdir -p fonts mkdir -p fonts
# 如果已经存在提取好的字体且非空,则跳过(可选) # sfnt magic 必须是 TrueType(00010000 / true / typ1)才算有效;
if [ -s fonts/cjk.ttf ]; then # 旧版本曾用 Noto(CFF) 提取出魔数为 OTTO 的假 .ttf,这里检测并自愈重建。
echo "字体文件已存在,跳过准备" is_valid_ttf() {
[ -s "$1" ] || return 1
local magic
magic=$(od -An -N4 -tx1 "$1" | tr -d ' \n')
case "$magic" in
00010000|74727565|74797031) return 0 ;;
*) return 1 ;;
esac
}
if is_valid_ttf "$FONT_TARGET"; then
echo "字体文件已存在且为有效 TrueType,跳过准备"
exit 0 exit 0
fi fi
# 查找系统字体 if [ -s "$FONT_TARGET" ]; then
echo "现有 $FONT_TARGET 非 TrueType 轮廓(可能是旧版提取的 CFF 字体),删除重建"
rm -f "$FONT_TARGET"
fi
# 查找系统中的文泉驿字体(仅 glyf 轮廓字体可被 reportlab 使用)
FONT_FILE="" FONT_FILE=""
for f in /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc \ for f in /usr/share/fonts/truetype/wqy/wqy-microhei.ttc \
/usr/share/fonts/truetype/wqy/wqy-microhei.ttc \ /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc; do
/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc \
/usr/share/fonts/truetype/source-han-sans/SourceHanSansSC-Regular.otf; do
if [ -f "$f" ]; then if [ -f "$f" ]; then
FONT_FILE="$f" FONT_FILE="$f"
break break
fi fi
done done
# 如果没有找到,尝试安装文泉驿正黑 # 没有则安装文泉驿
if [ -z "$FONT_FILE" ]; then if [ -z "$FONT_FILE" ]; then
echo "未找到中文字体,尝试安装 fonts-wqy-zenhei..." echo "未找到文泉驿字体,尝试安装 fonts-wqy-microhei fonts-wqy-zenhei..."
if [ "$(id -u)" -eq 0 ]; then if [ "$(id -u)" -eq 0 ]; then
apt-get update -y -qq apt-get update -y -qq
apt-get install -y -qq fonts-wqy-zenhei apt-get install -y -qq fonts-wqy-microhei fonts-wqy-zenhei
FONT_FILE="/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc" for f in /usr/share/fonts/truetype/wqy/wqy-microhei.ttc \
else /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc; do
echo "错误:非 root 用户且系统无中文字体,无法自动安装" >&2 if [ -f "$f" ]; then
FONT_FILE="$f"
break
fi
done
fi
if [ -z "$FONT_FILE" ]; then
echo "错误:无中文字体可用(非 root 且系统未装文泉驿)" >&2
exit 1 exit 1
fi fi
fi fi
# 根据字体格式提取/转换为 TTF 到 fonts/cjk.ttf echo "从 TTC 提取第一个字型到 $FONT_TARGET:$FONT_FILE"
case "$FONT_FILE" in python3 - "$FONT_FILE" <<'PY'
*.ttc)
echo "从 TTC 提取 TTF..."
python3 - "$FONT_FILE" <<'PY'
import sys import sys
from fontTools.ttLib import TTCollection from fontTools.ttLib import TTCollection
ttc_path = sys.argv[1] ttc_path = sys.argv[1]
out_path = "fonts/cjk.ttf" out_path = "fonts/cjk.ttf"
collection = TTCollection(ttc_path) collection = TTCollection(ttc_path)
if not collection.fonts: if not collection.fonts:
print("TTC 中无字体", file=sys.stderr) print("TTC 中无字体", file=sys.stderr)
sys.exit(1) sys.exit(1)
collection.fonts[0].save(out_path) font = collection.fonts[0]
print(f"提取完成:{out_path}") if "glyf" not in font:
print(f"字体 {font['name'].getDebugName(4)} 不是 TrueType 轮廓,reportlab 无法使用", file=sys.stderr)
sys.exit(1)
font.save(out_path)
print(f"提取完成:{out_path}({font['name'].getDebugName(4)})")
PY PY
;;
*.otf)
echo "转换 OTF 为 TTF..."
python3 - "$FONT_FILE" <<'PY'
import sys
from fontTools.ttLib import TTFont
font = TTFont(sys.argv[1])
# 确保输出为 TrueType 轮廓(去除 CFF)
font.flavor = None
font.save("fonts/cjk.ttf")
print("转换完成")
PY
;;
*.ttf)
echo "复制 TTF 字体..."
cp "$FONT_FILE" fonts/cjk.ttf
;;
*)
echo "不支持的字体格式:$FONT_FILE" >&2
exit 1
;;
esac
echo "中文字体准备完成:fonts/cjk.ttf" # 兜底校验:产出的必须又是有效 TrueType
if ! is_valid_ttf "$FONT_TARGET"; then
echo "错误:提取结果不是有效 TrueType 字体" >&2
exit 1
fi
echo "中文字体准备完成:$FONT_TARGET"