PDF Generation Editing Tool

PDF文档处理

Read design/design.md before any CREATE or REFORMAT work.

Route table

Rule: when in doubt between CREATE and REFORMAT, ask whether the user has an existing document to start from. If yes → REFORMAT. If no → CREATE. Rule: if the user wants to operate on an existing PDF (not make it beautiful), use PROCESS. Rule: for plain text extraction / reading PDF content, use the system's built-in read tool (natively supports PDF + OCR) — do NOT use this skill.

Route A: CREATE

Full pipeline — content → design tokens → cover → body → merged PDF.

bash make.sh run \
  --title "Q3 Strategy Review" --type proposal \
  --author "Strategy Team" --date "October 2025" \
  --accent "#2D5F8A" \
  --content content.json --out report.pdf

Doc types: report · proposal · resume · portfolio · academic · general · minimal · stripe · diagonal · frame · editorial · magazine · darkroom · terminal · poster · richee

自定义封面布局（AI-Driven Layout）

你可以通过 --pattern 选择预设模板，或通过 --layout-params 生成布局 JSON 文件，由 AI 完全自主描述封面布局。渲染引擎将依次渲染 JSON 中的每个元素。

优先原则：--layout-params > --pattern > 类型默认 cover_pattern。

# 方式 1：显式选择预设模板
python palette.py --title "..." --type report --pattern diagonal --out tokens.json

# 方式 2：AI 生成自定义布局（核心流程）
# Step 1: AI 生成 layout.json
# Step 2:
python palette.py --title "..." --type report \
  --layout-params layout.json --accent "#C4964A" --out tokens.json
python cover.py --tokens tokens.json --out cover.pdf

设计空间坐标系统

所有坐标基于 794×1123 设计空间（自动缩放到 A4）：

• 标准边距：80
• 可用内容宽度：634
• 标题区域通常位于 y ≈ 24%42%（270472）
• 页脚区域通常位于 y ≈ 94%97%（10561087）

布局元素类型（layout_params.elements）

每个元素按数组顺序从前到后渲染。

• font: "display" 或 "body"
• align（text/text_block）: "start" / "middle" / "end"
• line_h: 行高（pt），默认 size * 1.4
• opacity: 0.0~1.0

模板变量

元素中的字符串值使用 {变量名} 语法，执行时会被替换为 tokens 中对应值：

布局示例（fullbleed 风格）

参见 design/samples/ 目录下的 fullbleed.json。

Cover extras (inject into tokens via --abstract, --cover-image):

• --abstract "text" — abstract text block on the cover (magazine/darkroom)
• --cover-image "url" — hero image URL/path (magazine, darkroom, poster)

Color overrides — always choose these based on document content:

• --accent "#HEX" — override the accent color; accent_lt is auto-derived by lightening toward white
• --cover-bg "#HEX" — override the cover background color

Accent color selection guidance:

Richee 品牌要求绿色系为唯一彩色强调色，禁止引入蓝色、紫色、橙色等其他彩色系。accent 色必须从以下绿色色板中选择：

Rule: 绿色是 Richee 唯一的彩色强调色。封面与正文必须使用同一套配色方案，由 palette.py 统一产出 tokens.json 定义。

content.json block types:

chart / flowchart schemas:

{"type":"chart","chart_type":"bar","labels":["Q1","Q2","Q3","Q4"],
 "datasets":[{"label":"Revenue","values":[120,145,132,178]}],"caption":"Q results"}

{"type":"flowchart",
 "nodes":[{"id":"s","label":"Start","shape":"oval"},
          {"id":"p","label":"Process","shape":"rect"},
          {"id":"d","label":"Valid?","shape":"diamond"},
          {"id":"e","label":"End","shape":"oval"}],
 "edges":[{"from":"s","to":"p"},{"from":"p","to":"d"},
          {"from":"d","to":"e","label":"Yes"},{"from":"d","to":"p","label":"No"}]}

{"type":"bibliography","items":[
  {"id":"1","text":"Author (Year). Title. Publisher."}]}

Route B: REFORMAT

Parse an existing document → content.json → CREATE pipeline.

bash make.sh reformat \
  --input source.md --title "My Report" --type report --out output.pdf

Supported input formats: .md .txt .pdf .json

Route C: PROCESS

Operate on existing PDFs — tables, merge, split, watermark, forms, encrypt, etc. All scripts are in scripts/processing/.

Text extraction / reading PDF content: use the system's built-in read tool (natively supports PDF + OCR). This skill does NOT handle plain text extraction.

Table Extraction

Use pdfplumber directly (no dedicated script). See reference.md for examples.

import pdfplumber
with pdfplumber.open("document.pdf") as pdf:
    for page in pdf.pages:
        tables = page.extract_tables()
        for table in tables:
            for row in table:
                print(row)

Merge / Split / Rotate / Watermark / Encrypt

Use pypdf directly. See reference.md for full examples. Quick reference:

Create Simple PDF (with Chinese text)

⛔ 创建含中文的 PDF 时，必须调用 processing_create_pdf.py，禁止自行用 reportlab 实现。 脚本已内置中文字体嵌入（STSong-Light CID 字体），自行实现会导致中文乱码（黑色方块）。

# From text content
python processing_create_pdf.py output.pdf "长恨歌内容..." "长恨歌"

# From file
python processing_create_pdf.py output.pdf @content.txt "长恨歌"

Form Filling

If you need to fill out a PDF form, read forms.md and follow its instructions.

The form filling workflow has two paths depending on whether the PDF has fillable form fields:

Step 1 — Check if fillable:

python processing_check_fillable_fields.py <input.pdf>

Fillable fields path:

1. extract_form_field_info.py → get field structure JSON
2. convert_pdf_to_images.py → render pages to PNG for visual analysis
3. Create field_values.json with values to enter
4. fill_fillable_fields.py → produce filled PDF

Non-fillable fields path:

1. convert_pdf_to_images.py → render pages to PNG
2. Visually determine bounding boxes for each field
3. Create fields.json with bounding box data
4. create_validation_image.py → generate validation images for review
5. check_bounding_boxes.py → verify no overlaps
6. fill_pdf_form_with_annotations.py → produce filled PDF

⛔ 严禁自行编写 PDF 填充代码。必须调用脚本，脚本已内置中文字体嵌入。

See reference.md for detailed examples of all libraries and tools.

输出规范

本技能遵循 Richee 输出规范 1.2.0，按严重程度分为三级：GATE（发布阻断，不满足则禁止发布）、REQUIRED（强制要求，验收失败但可修复）、RECOMMENDED（建议项，偏离需说明理由）。

全部 Profile 共同遵守（GATE）

正式 PDF 全文不得含 emoji；风险等级、状态、优先级等语义信息必须同时使用文字标签和颜色表达，禁止仅靠颜色区分。禁止出现保证胜诉、绝无风险、完全合规、一定合法等绝对化法律结论。依据标签必须由目标技能声明封闭集合，运行时不得自创或混用标签体系。

全部 Profile 共同遵守（REQUIRED）

输出文件名不含 emoji，采用可识别的"主题_日期"格式，如 Q3战略回顾_20260715.pdf。

pdf-report（CREATE / REFORMAT 精美报告 PDF）专属

GATE： PDF 默认 A4 页面（210mm × 297mm），正文页边距≥2cm，封面全幅无边距；导出后须检查封面和内容页完整性。PDF 含中文时必须使用 CJK 字体（STSong-Light CID 或等效 Unicode CID 字体），中文不得渲染为方块、乱码或空白——render_body.py 已内置 CJK 自动检测与字体切换，严禁绕过脚本自行实现。封面必须成功渲染且与正文合并，merge.py 会输出合并 QA 信息用于验证。

REQUIRED： 正文内容块（h1/h2/h3/body/table/chart/image 等）不得出现文本截断、跨页破坏或重叠；复杂页面（表格页、图表页、带大量内容的 h1 后正文页）应抽查确认无空白页、无截断。表格表头使用 accent 色底色 + 白字，数据行使用交替底色确保可读性，列宽按 col_widths 分配，禁止默认等宽。配色（accent / accent_lt / cover_bg）和字体（封面 Google Fonts + 正文 ReportLab 系统字体 / CJK 字体）必须由 palette.py 统一产出的 tokens.json 定义，封面与正文不得使用不同的配色方案。

RECOMMENDED： 若输出为法律/金融/合同类文档，建议在封面或正文首页包含"本文件由AI辅助生成，仅供参考"免责声明。

pdf-form（表单填写）专属（GATE）

PDF 含中文时必须使用 STSong-Light CID 字体，fill_fillable_fields.py 和 fill_pdf_form_with_annotations.py 已内置 CJK 字体嵌入。表单填写后字段值不得超出边界框、不得覆盖已有文本、不得出现重叠，填写完成后必须通过 processing_check_bounding_boxes.py 验证。

pdf-simple（create_pdf.py 简单 PDF）专属（GATE）

PDF 含中文时必须使用 processing_create_pdf.py 生成，不得自行用 reportlab 实现。脚本已内置 STSong-Light CID 字体嵌入，自行实现会导致中文乱码。

pdf-merged（合并/拆分/水印等操作结果）专属（GATE）

仅继承通用 GATE 中"全文禁止 emoji"的要求。

Environment

bash make.sh check   # verify all deps
bash make.sh fix     # auto-install missing deps
bash make.sh demo    # build a sample PDF

CREATE / REFORMAT dependencies

PROCESS dependencies