minimax-pdf

minimax-pdf

三项任务，一个 skill。

在执行任何 CREATE 或 REFORMAT 工作之前，必须阅读 design/design.md

---

路由表

规则： 当在 CREATE 和 REFORMAT 之间犹豫时，询问用户是否已有文档作为起点。如有 → REFORMAT。如无 → CREATE。

---

路由 A: CREATE

完整管道 — 内容 → 设计 token → 封面 → 正文 → 合并 PDF。

bash scripts/make.sh run \
  --title "Q3 策略评审" --type proposal \
  --author "策略团队" --date "2025 年 10 月" \
  --accent "#2D5F8A" \
  --content content.json --out report.pdf

文档类型： report · proposal · resume · portfolio · academic · general · minimal · stripe · diagonal · frame · editorial · magazine · darkroom · terminal · poster

封面附加项（通过 --abstract、--cover-image 注入 token）：

• --abstract "文本" — 封面上的摘要文本块（magazine/darkroom）
• --cover-image "url" — 主图 URL/路径（magazine、darkroom、poster）

颜色覆盖 — 始终根据文档内容选择：

• --accent "#HEX" — 覆盖强调色；accent_lt 自动通过向白色淡化派生
• --cover-bg "#HEX" — 覆盖封面背景色

强调色选择指南：

你对强调色拥有创作权。从文档的语义上下文——标题、行业、目的、受众——中选取，而非选择通用的"安全"色。强调色出现在节间分隔线、标注栏、表头以及封面上：它承载着文档的视觉标识。

规则： 选择一位有品味的设计师会为这份特定文档选择的颜色——而不是类型的默认色。柔和、低饱和度的色调效果最好；避免鲜艳的原色。犹豫不决时，选择更暗、更中性的颜色。

content.json 块类型：

chart / flowchart 模式：

{"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."}]}

---

路由 B: FILL

填写已有 PDF 中的表单字段，不改变布局或设计。

# Step 1: inspect
python3 scripts/fill_inspect.py --input form.pdf

# Step 2: fill
python3 scripts/fill_write.py --input form.pdf --out filled.pdf \
  --values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'

始终先运行 fill_inspect.py 以获取精确的字段名称。

---

路由 C: REFORMAT

解析已有文档 → content.json → CREATE 管道。

bash scripts/make.sh reformat \
  --input source.md --title "我的报告" --type report --out output.pdf

支持的输入格式： .md .txt .pdf .json

---

环境

bash scripts/make.sh check   # 验证所有依赖
bash scripts/make.sh fix     # 自动安装缺失的依赖
bash scripts/make.sh demo    # 构建示例 PDF