content-generation

内容生成

概述

使用 AI 驱动的工具生成专业内容，包括图像、图表、文档和摘要。

快速决策树

What do you need?
│
├── Generate images
│   └── references/images.md
│   └── Script: scripts/generate_images.py
│
├── Create flowchart/diagram
│   └── references/flowchart.md
│   └── Script: scripts/generate_flowchart.py
│
├── Create Google Doc
│   └── references/document.md
│   └── Script: scripts/generate_document.py
│
├── Generate client proposal
│   └── references/proposal.md
│   └── Script: scripts/generate_proposal.py
│
├── Convert Markdown to PDF
│   └── references/pdf.md
│   └── Script: scripts/md_to_pdf.py
│
└── Summarize content
    └── references/summarize.md
    └── Script: scripts/summarize_content.py

环境设置

# Required in .env
FAL_API_KEY=fal_xxxx              # For image generation
OPENROUTER_API_KEY=sk-or-v1-xxx   # For AI text generation

获取 API 密钥：

• fal.ai：https://fal.ai/dashboard/keys
• OpenRouter：https://openrouter.ai/keys

常见用法

生成图像

# Nano Banana Pro (best quality)
python scripts/generate_images.py "Professional product photo of smartwatch" --model nano-banana-pro

# FLUX-2 (fast, cheap)
python scripts/generate_images.py "Vibrant lifestyle photo" --model flux-2 --size landscape_4_3

创建流程图

python scripts/generate_flowchart.py "User login: enter email, validate, check password, if correct go to dashboard"

生成文档

python scripts/generate_document.py --input content.json --title "Q4 Report"

生成提案

python scripts/generate_proposal.py --transcript-file meeting.txt --client "Acme Corp"

费用估算

工具	费用
Nano Banana Pro 1K	$0.15/张图像
Nano Banana Pro 4K	$0.30/张图像
FLUX-2	$0.012/百万像素
流程图	~$0.005/张图表
提案	~$0.10/份文档

安全说明

凭据处理

• 将 FAL_API_KEY 存储在 .env 文件中（切勿提交到 git）
• 将 OPENROUTER_API_KEY 存储在 .env 文件中（切勿提交到 git）
• 如果密钥遭到泄露，请在对应的控制面板中重新生成
• 切勿在脚本输出中记录或打印 API 密钥

数据隐私

• 文本提示词会发送至 fal.ai 和 OpenRouter 服务
• 生成的图像存储在本地 .tmp/ 目录中
• AI 服务可能会记录提示词，以改进服务
• 避免在提示词中包含敏感或机密数据
• 生成的文档可能会上传到 Google Drive

访问范围

• FAL_API_KEY - 可全面访问图像生成模型
• OPENROUTER_API_KEY - 可访问已配置的 AI 模型
• Google OAuth - 创建 Google Docs 所需（参见 google-workspace skill）

合规注意事项

• AI 披露： 在要求披露的情况下，考虑说明内容由 AI 生成
• 图像权利： 生成的图像受 fal.ai 使用条款约束
• 版权： AI 生成内容的版权因司法管辖区而异
• 品牌一致性： 根据品牌指南审核 AI 输出
• 敏感内容： AI 图像生成器设有内容政策
• 客户提案： 发送给客户前请核实准确性
• 署名： 某些情境下需要披露内容由 AI 生成

故障排除

常见问题

问题：图像生成失败

症状： fal.ai 返回错误或未生成图像 原因： 提示词无效、模型不可用或 API 出错 解决方案：

• 检查提示词是否违反政策（如包含露骨内容等）
• 确认模型 ID 正确且可用
• 尝试使用更简单的提示词测试 API 连接
• 查看 fal.ai 状态页面，确认是否发生服务中断

问题：违反内容政策

症状： 出现“Content policy violation”或类似的安全错误 原因： 提示词包含被标记的词语或概念 解决方案：

• 从提示词中移除露骨、暴力或有害内容
• 改写可能触发过滤器的模糊词语
• 查看 fal.ai 内容政策指南
• 使用更通用、专业的措辞

问题：未创建 Google Doc

症状： 脚本执行完毕，但 Drive 中没有出现文档 原因： OAuth 问题、文件夹权限问题或 API 出错 解决方案：

• 确认 Google OAuth 正常工作（参见 google-workspace skill）
• 检查目标文件夹是否存在且可访问
• 删除 mycreds.txt 并重新进行身份验证
• 查看脚本输出中的错误消息

问题：流程图语法错误

症状： Mermaid 图表无法渲染 原因： 生成的图表中 Mermaid 语法无效 解决方案：

• 检查生成的 Mermaid 代码是否存在语法错误
• 将复杂流程拆分为较小的图表
• 在 https://mermaid.live/ 测试图表
• 确保特殊字符已正确转义

问题：PDF 转换失败

症状： Markdown 转 PDF 时出错 原因： 缺少依赖项或 Markdown 无效 解决方案：

• 确保已安装所需的 PDF 工具（weasyprint 等）
• 检查 Markdown 语法是否有效
• 如果指定了自定义字体，请确认字体文件存在
• 尝试使用更简单的 Markdown 来定位问题

问题：OpenRouter API 错误

症状： 文本生成因 API 错误而失败 原因： API 密钥无效、模型不可用或触发了速率限制 解决方案：

• 确认已正确设置 OPENROUTER_API_KEY
• 在 OpenRouter 控制面板中检查模型是否可用
• 如果当前模型不可用，请尝试其他模型
• 查看速率限制状态，并在需要时增加延迟

资源

• references/images.md - fal.ai 图像生成
• references/flowchart.md - Mermaid 图表生成
• references/document.md - Google Docs 创建
• references/proposal.md - 客户提案生成
• references/pdf.md - Markdown 转 PDF
• references/summarize.md - 内容摘要

集成模式

生成并保存

技能： content-generation → google-workspace 使用场景： 创建文档并存储到 Drive 流程：

1. 生成内容（提案、报告、摘要）
2. 格式化为 Google Doc 或 PDF
3. 通过 google-workspace 上传到相应的 Drive 文件夹

提案关联到 CRM

技能： content-generation → attio-crm 使用场景： 将生成的提案关联到交易记录 流程：

1. 根据会议文字记录生成客户提案
2. 将提案上传到 Google Drive
3. 在 Attio CRM 公司记录中添加包含提案链接的备注

将图像用于视频

技能： content-generation → video-production 使用场景： 为视频课程创建标题页 流程：

1. 为每节课生成带品牌标识的标题页图像
2. 将图像导出为兼容视频的格式
3. 使用 video-production 将图像与课程视频拼接