核心用法
Doc2Slides 是一款文档转演示文稿自动化工具，通过命令行即可将PDF、DOCX或Markdown文件快速转换为专业PowerPoint幻灯片。用户安装技能后，执行单条命令即可完成转换流程，支持自定义页数、风格指令和输出格式。
典型工作流程：
1. 安装技能与Python依赖（python-pptx、playwright等）
2. 运行 workflow.py 指定输入文档与输出路径
3. 系统自动完成文档解析、智能布局匹配、HTML渲染（3倍高清）和PPTX组装
可选增强：配置OpenAI、智谱AI或DeepSeek API密钥后，可启用AI驱动的智能布局决策；未配置则自动回退至零网络依赖的模板模式。
---
显著优点
- 自动化程度高：全程无需手动设计，AI自动匹配18+种布局类型（仪表板、时间线、对比矩阵、金字塔等）
- 输入格式广泛：原生支持PDF、Word、Markdown三种主流文档格式
- 离线可用性：模板模式下零外部CDN调用，完全本地运行，保障数据隐私
- 输出质量专业：3倍高清渲染、内嵌SVG图表（饼图、柱状图、进度环等）
- 扩展性强：模块化架构（workflow.py、llm_adapter.py、smart_layout_matcher.py等），便于二次开发
- 零成本授权：MIT-0许可证，允许无限制商用与修改
---
潜在局限与风险
| 类别 | 具体说明 |
|------|---------|
| **环境依赖** | 需预装Python 3、pip3及Playwright（含Chromium下载，约100MB+），首次配置门槛较高 |
| **运行时依赖** | 依赖python-pptx和Playwright等第三方库的版本兼容性，可能出现依赖冲突 |
| **LLM成本** | 启用AI增强模式后，将产生API调用费用（按各厂商定价） |
| **复杂排版限制** | 高度复杂的自定义设计需求可能超出预设18种模板的覆盖范围 |
| **文件权限** | 技能声明需要本地文件读写权限，需确保输入文档来源可信 |
---
适合人群
- 职场人士：需快速将报告、方案转换为演示文稿，无设计时间或技能
- 研究人员：将论文、技术文档转化为会议汇报PPT
- 开发者/运维：基于文档自动生成标准化汇报材料
- 隐私敏感用户：偏好本地处理、不愿上传文档至云端转换服务的场景
---
常规风险提醒
1. 输入安全：确保转换的PDF/DOCX文件来源可信，避免解析恶意构造的文档
2. API密钥管理：如启用LLM模式，建议通过环境变量配置密钥，避免硬编码泄露
3. 输出检查：AI生成的布局建议可能出现语义偏差，重要场合建议人工复核关键页面
4. 依赖维护：定期更新python-pptx和Playwright以修复潜在安全漏洞