PDF Generator — 已验证方案#

⚠️ 注意：本技能的PDF导出是**"部署HTML + 用户本地浏览器Ctrl+P导出"**。 这与"上传图片到CDN"是完全不同的操作，不要混淆。

本方案经验证（2026-03-24 UE特效师成长计划、2026-03-30 ComfyUI学习路线）效果良好，已固化为此技能的 唯一标准方案。

---

触发条件#

• 用户说"生成PDF"、"导出PDF"、"转PDF"、"下载PDF"、"导出PDF文件"
• 用户提供了HTML文件需要转PDF
• 用户提供了URL需要转PDF

---

✅ 标准工作流程（默认唯一方案，2026-03-30确立）#

Step 1：准备HTML文件#

在 /workspace/dist/index.html 写入完整HTML内容（包含内联CSS和@media print打印样式）

bash

# 已有HTML文件时复制到部署目录
cp /workspace/源文件.html /workspace/dist/index.html

@media print 样式必须在HTML中包含（否则导出会变白底）：

css

@media print {
  html, body { background: #0d0d1a !important; color: #e8eaf0 !important; }
  .module { background: rgba(255,255,255,0.03) !important; }
  -webkit-print-color-adjust: exact;
  print-color-adjust: exact;
}

Step 2：部署#

text

deploy --dist_dir /workspace/dist --project_name "项目名称"

Step 3：返回结果给用户#

标准话术（直接复制发给用户）：

text

📎 已为您生成可下载/导出的页面！

👉 [部署URL]

导出PDF步骤：
1. 点击上方链接打开页面
2. 按 Ctrl+P（Mac：Cmd+P）
3. 打印机选择"另存为PDF"
4. 布局选"横向"（适合文档风格）
5. 务必勾选"背景图形"（否则背景色会变白）
6. 点击保存

该链接长期有效，可随时收藏使用。

---

⚠️ 禁止事项#

• ❌ 不要用 upload_to_cdn 来"生成PDF"——CDN只上传文件，不生成PDF
• ❌ 不要说"上传图片"——图片上传和PDF导出是两件事
• ❌ 不要在服务器端用Playwright生成PDF——服务器无GUI浏览器，效果差且不稳定
• ❌ 不要在无深色背景的HTML里导出——打印效果会很差

---

适用场景判断#

场景方案说明HTML文档/资料转PDF部署+Ctrl+P ✅最佳效果，用户本地渲染，支持深色背景演示文稿/学习路线部署+Ctrl+P ✅支持分页和背景，样式完整保留图片集打包为PDF不要用本技能图片PDF用其他工具，本技能专用于HTML内容

---

深色主题HTML打印模板（可直接复用）#

html

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>文档标题</title>
<style>
body {
  font-family: "PingFang SC", "Microsoft YaHei", Arial, sans-serif;
  background: #0d0d1a;
  color: #e8eaf0;
  font-size: 13px;
}
@media print {
  html, body {
    background: #0d0d1a !important;
    color: #e8eaf0 !important;
    width: 100%;
    margin: 0 !important;
    padding: 0 !important;
  }
  .module {
    background: rgba(255,255,255,0.03) !important;
    border: 1px solid rgba(255,255,255,0.07) !important;
    -webkit-print-color-adjust: exact;
    print-color-adjust: exact;
  }
}
</style>
</head>
<body>
<!-- 内容 -->
</body>
</html>

---

效果验证记录#

日期内容效果2026-03-24UE特效师成长计划✅ 深色背景完整保留，用户体验良好2026-03-30ComfyUI学习路线✅ 链接长期有效，用户自行Ctrl+P导出

---

关键文件路径#

• 临时部署目录： /workspace/dist/index.html（每次使用前直接覆盖）
• HTML源文件备份：保留在用户指定路径或 /workspace/dist/