中文 PDF 报告排版

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install cn-pdf-report-typeset
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 cn-pdf-report-typeset。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

这款 Openclaw Skills 工具提供可重复使用的 Python 和 ReportLab 工作流程，用于制作精美的中文 PDF 报告。其版面规范优先考虑移动设备上的可读性、A4 纵向页面、紧凑的间距、中文字体渲染，以及自动换行而非溢出的表格。
使用随附的报告模板制作报告封面、章节标题、结论提示框、表格和页脚。该技能还记录了实际排版中常见的问题，并要求在交付前检查生成的 PDF。整个流程在本地运行，无需 API key。

应用场景

创建可行性研究、尽职调查报告、项目分析及其他正式的中文客户交付材料。
当用户要求以 PDF 格式提供报告或结论时，将现有研究或分析整理为可下载的 PDF。
制作适合在手机上阅读的报告，包含中文排版、清晰的表格、页码和醒目的结论。
重新排版表格溢出、中文文本渲染不正确或页面留白过多的草稿。
使用统一的视觉风格生成适合打印的 A4 纵向文档。

工作原理

获取相关分析或源材料；如有现成研究，应尽量复用，而不是不必要地重写。
复制推荐的 ReportLab 模板，并替换其内容部分，包括封面信息、标题和表格数据。
应用版面规则：A4 纵向页面、易读的字号、紧凑的页边距、左对齐段落，以及使用 Paragraph 并支持 CJK 换行的表格单元格。
使用 Python 和配置好的中文字体及报告样式生成 PDF。
使用 PyMuPDF 检查输出：核对页数、中文文本渲染、结论是否存在、页面布局是否均衡，以及内容是否超出边界。
通过适当的渠道向用户交付 PDF 文件；在文档说明的飞书工作流程中，应发送文件本身，并附上简要的主要结论摘要。

配置指南

在运行该技能所用的 Python 环境中安装 ReportLab。输出验证使用 PyMuPDF。在 Windows 上，工作流程可以使用系统已安装的 Microsoft YaHei 字体文件；无需单独下载字体。注册 .ttc 字体时必须设置 subfontIndex=0。
python -m pip install reportlab pymupdf
复制推荐模板 templates/reportlab_gold_template.py，并在保留其版面辅助函数的同时替换报告内容。确认模板指向当前计算机上的有效字体路径。生成 PDF，并在交付前运行验证检查。原始说明引用了项目专用的 $V Python 环境和 Windows 字体路径，因此请根据你的配置调整解释器和路径。

数据架构

该技能使用 Python 模板和报告内容，不定义单独的数据库或结构化输入格式。
项目 用途
templates/reportlab_gold_template.py 推荐的 ReportLab 模板，采用金色风格、左对齐文本、较大字号、紧凑页边距和表格处理方式。
templates/reportlab_chinese_template.py 较早期的中文报告模板，作为旧版选项保留。
报告内容部分 插入模板的封面文字、日期或来源、标题、段落和表格数据。
生成的 .pdf 最终的 A4 纵向报告，通常保存在配置的项目输出目录中。
PyMuPDF 检查 生成后检查页数、提取的中文文本、结论和版面问题。
推荐的视觉体系使用金属金色作为章节和表格标题的颜色，近黑色作为正文颜色，暖浅金色作为表格隔行底色，浅金色作为网格线颜色。版面包括封面、自然流动的报告章节、重复显示标题行的表格、结论提示框和页码页脚。仅在封面与正文之间分页；避免每一章都强制另起一页。

高级特性

面向移动设备优先的排版建议；推荐模板强调较大的正文和表格字号，以及醒目的标题。
使用 ReportLab Paragraph 对象和
wordWrap="CJK"
对中文表格单元格进行换行，防止较长内容溢出。
提供可重复使用的辅助函数，用于设置表格样式、行内强调、封面元素、结论框和页脚。
KeepTogether
控制表格和适当的内容块，同时避免将过大的内容组合在一起，以免生成几乎空白的页面。
自动化或脚本辅助检查字号常量、不必要的分页、页数、提取的文本和渲染问题。
使用 PyMuPDF 检查页面布局是否均衡，以及内容是否越过可打印区域的右边距；溢出检查应考虑实际页边距，并排除页脚文本。
在受支持的 Windows 环境中使用系统已安装的 Microsoft YaHei 字体在本地运行，无需 API key。
提供有文档说明的交付流程，将完成的 PDF 作为可访问的文件发送，并附上简洁的主要结论摘要。

name: cn-pdf-report-typeset slug: cn-pdf-report-typeset
displayName: 中文PDF报告排版·手机上也看得清的交付级版式
description: >- 中文报告做成 PDF，常见翻车三件套：字体乱码、表格错位、字号小到客户在手机上根本看不清。这套是交付级的排版标准加可直接跑的模板。

交付标准（按「客户在手机上看」倒推）：

• 大字号：正文 ≥16pt、表格 ≥15pt、H2 ≥17pt、大标题 ≥30pt——不是 12pt 那种印出来都费劲的
• 紧凑不注水：只在封面后分页一次，正文自然流动，禁止每章强制分页撑页数
• 表格智能换行：单元格用 Paragraph 加中文断行，长内容不溢出页面
• 页面均衡：生成后自查每页字符数，避免一页只有两行
• A4 竖排、边距 18-20mm、直接打印可用

附：微软雅黑系统字体直接调用（不用下载字体文件）、封面/页脚页码/核心结论框模板、排版自检脚本（自动查字号是否达标、有没有多余分页）。

适用：可行性研究报告、尽调报告、项目分析、任何要交付给客户的中文正式文档。纯本地 Python，零 API Key。

触发词：做成PDF、生成PDF、中文PDF、报告排版、雅黑、乱码、表格溢出、手机看不清、可研报告、交付文档。
version: 1.1.0
author: 九品锦锂e
summary: reportlab+微软雅黑出正式中文PDF：大字号手机可读、表格不溢出、紧凑不硬撑页数。
license: MIT