pdf技能貌似对中文字体支持不够好

[hwj123hwj]

[hwj123hwj]

。感觉画的图表也不太好，openclaw配置的gemini 3-flash模型效果如上

[wtlwang2019]

我的也是的

[wtlwang2019]

楼主咋解决的

[pigwing]

详细问题报告与解决方案建议

感谢 @hwj123hwj 提出这个问题。我在使用过程中也遇到了同样的问题，想补充一些详细的技术分析和解决方案建议。

---

🔍 问题复现

使用场景：使用 minimax-pdf skill 生成包含中文内容的 PDF 报告

执行命令：

bash scripts/make.sh run \
  --title "RabbitMQ MQTT Retained Message 插件使用指南" \
  --type report \
  --content "content.json" \
  --out "output.pdf"

问题表现：

• PDF 文件成功生成（9 页，118 KB）
• 封面渲染正常（因为标题较短，可能使用了 fallback 字体）
• 正文所有中文字符显示为乱码/方框
• 英文、数字内容显示正常

---

🛠️ 技术诊断

根本原因：render_body.py 使用的 ReportLab 默认字体（IBM Plex Sans / Playfair Display）不包含 CJK（中日韩）字符集。

代码位置：

1. scripts/palette.py - 字体选择逻辑未考虑 CJK 字符
2. scripts/render_body.py - 使用默认字体，无中文 fallback 机制
3. scripts/tokens.json - 生成的 design tokens 未包含中文字体选项

环境信息：

• Windows 11
• Python 3.12.10
• ReportLab 已安装
• Playwright 已安装（封面渲染正常）

---

💡 解决方案建议

方案 A：自动检测中文内容并使用 fallback 字体（推荐）

在 render_body.py 中添加内容检测逻辑：

# render_body.py - 在 build() 函数开头添加
import re

def contains_cjk(text):
    """检测文本是否包含 CJK 字符"""
    return bool(re.search(r'[\u4e00-\u9fff\u3400-\u4dbf]', text))

def build(tokens, content, output_path):
    # 检测内容是否包含中文
    has_cjk = any(contains_cjk(str(item)) for item in content)
    
    if has_cjk:
        # 使用中文字体 fallback
        if sys.platform == 'win32':
            font_body = 'Microsoft YaHei'  # Windows
        elif sys.platform == 'darwin':
            font_body = 'PingFang SC'  # macOS
        else:
            font_body = 'WenQuanYi Micro Hei'  # Linux
    else:
        font_body = tokens.get('font_body', 'IBM Plex Sans')

方案 B：在 design tokens 中添加字体配置选项

在 palette.py 中添加 --font-body 参数支持：

# palette.py
parser.add_argument('--font-body', type=str, default=None,
                    help='Override body font (useful for CJK support)')

然后在 make.sh 中添加条件判断：

# 检测内容是否包含中文
if grep -qP '[\x{4e00}-\x{9fff}]' "$content_file"; then
    if [[ "$OSTYPE" == "msys" ]]; then
        font_args="--font-body 'Microsoft YaHei'"
    elif [[ "$OSTYPE" == "darwin"* ]]; then
        font_args="--font-body 'PingFang SC'"
    fi
fi

方案 C：在 skill 文档中明确说明

在 SKILL.md 中添加使用限制说明：

## 已知限制

### CJK 字体支持

当前版本的 PDF 生成使用西文字体（Playfair Display / IBM Plex Sans），不包含中日韩字符集。

**临时解决方案**：

1. 使用 Markdown 导出，然后用 Typora / VS Code 转换为 PDF
2. 使用 Pandoc：
   ```bash
   pandoc content.md -o output.pdf --pdf-engine=xelatex -V mainfont="Microsoft YaHei"

未来计划：

• 自动检测 CJK 内容并使用 fallback 字体
• 添加 --font-body 参数支持自定义字体
• 提供预配置的 CJK 字体包

---

### 📋 临时解决方案（已验证可用）

对于需要立即生成中文 PDF 的用户，可以使用以下方法：

**方法 1：使用 Markdown + Pandoc**
```bash
# 1. 生成 Markdown 版本的内容
# 2. 使用 Pandoc 转换为 PDF
pandoc document.md -o document.pdf \
  --pdf-engine=xelatex \
  -V mainfont="Microsoft YaHei" \
  -V CJKmainfont="Microsoft YaHei"

方法 2：使用 Typora / VS Code

1. 用 Typora 打开 Markdown 文件
2. 文件 → 导出 → PDF（自动使用系统字体）

---

🎯 影响范围

根据仓库 issue 统计，这是一个影响中文用户的普遍问题：

• Issue pdf技能貌似对中文字体支持不够好 #9: pdf 技能貌似对中文字体支持不够好
• 类似的问题在 PDF 生成工具中很常见（reportlab 默认不支持 CJK）

建议优先级：高（影响所有中文用户的核心功能）

---

📌 补充信息

测试文件：

• 生成的乱码 PDF：D:\RabbitMQ-MQTT-Plugins-Guide.pdf（9 页，118 KB）
• 可用的 Markdown 版本：D:\RabbitMQ-MQTT-Plugins-Guide.md
• 可用的纯文本版本：D:\RabbitMQ-MQTT-Plugins-Guide.txt

期望行为：

• 检测到中文内容时自动使用中文字体
• 或者在文档中明确说明 CJK 限制并提供解决方案
• 最好能添加 --font-body 参数允许用户自定义字体

---

希望这些信息能帮助改进 minimax-pdf skill！如果需要我协助测试或提交 PR，请随时告知。

[RyanLee-Dev]

感谢提醒，可以提交 PR。 最好格式和目前保持一致