核心用法
PPT Generator 是一个基于本地运行的智能演示文稿生成工具，通过多阶段流程将用户输入转化为专业 .pptx 文件：
1. 环境自检（Phase 0）：首次使用时运行 check_env.py 检测 Python/Node 依赖，支持自动修复
2. 需求采集（Phase 1）：通过对话收集主题用途、参考文档（支持 PDF/Word/Markdown 等）及模板偏好
3. 风格规划（Phase 2）：无模板时由 AI 推荐配色方案（10 种风格分类如企业商务、未来科技、中国风等），有模板时解析并复用其设计系统
4. 内容生成（Phase 3）：自动分块处理大文档（支持 40k+ 字符的摘要模式），LLM 生成结构化幻灯片计划（JSON），含图表数据配置，最终通过 python-pptx 或 pptxgenjs 渲染输出
显著优点
- 完全本地运行：零外部 API 依赖，数据不出境，适合敏感内容
- 智能内容处理：自动分块、token 优化、多格式文档解析
- 真实图表渲染：支持柱状图/折线图/饼图等，非截图而是原生 Office 图表
- 模板系统：支持上传
.pptx模板，保留视觉风格仅替换内容 - 增量修改：Patch 模式可局部更新幻灯片，无需重新生成整份计划
潜在缺点与局限性
- 依赖链复杂：需同时维护 Python（markitdown、python-pptx）和 Node.js（pptxgenjs）两套环境
- LLM 质量依赖：幻灯片逻辑与文案质量直接受限于所配置的 LLM 能力
- 图表类型有限：不支持复杂交互图表或自定义可视化
- 无实时协作：纯本地单用户工作流，无云端同步或多人编辑
- 视觉 QA 门槛高：LibreOffice 可视化检查为可选依赖，缺失时难以发现排版问题
适合人群
| 场景 | 说明 |
|------|------|
| 企业内网用户 | 数据敏感、禁止上传外部 SaaS |
| 高频 PPT 制作者 | 周报/月报/季度总结等重复性需求 |
| 技术团队 | 有 Python/Node 环境，能自助排障 |
| 品牌合规要求 | 需严格使用公司统一模板文件 |
常规风险
1. 依赖漂移风险：pptxgenjs 或 python-pptx 版本更新可能导致渲染异常，建议锁定版本
2. LLM 幻觉：长文档摘要阶段可能丢失关键细节，需人工复核 slide plan
3. 模板兼容：复杂动画母版或自定义版式可能解析失败，建议先用简单模板验证
4. 色彩格式：必须严格遵守 HEX_NO_HASH 规则（如 1E2761 而非 #1E2761），否则导致文件损坏