PowGrade.FileConverters.PptToPptx 0.1.0

PowGrade.FileConverters.PptToPptx

将 PowerPoint 97-2003 二进制格式（.ppt）转换为 OpenXML（.pptx / .pptm）的 .NET 库与 CLI 工具。

项目组成

• src/PowGrade.FileConverters.PptToPptx：核心转换库（net8.0;netstandard2.1）
• src/PowGrade.FileConverters.PptToPptx.Cli：命令行工具（ppt2pptx）
• tests/PowGrade.FileConverters.PptToPptx.Tests：xUnit 测试集

当前完成度（基于代码与测试现状）

说明：以下是“工程可用性”视角，不是“与 Office 完全像素级一致性”视角。

已实现能力

• 无需 Office Interop，直接解析 OLE Compound File 与 PPT 记录流
• 支持文件与流输入输出（同步/异步）
• 支持 ConversionOptions：超时、大小限制、页数限制、图片数限制、编码覆盖、进度回调
• 支持 ConversionResult：耗时、页数、资源计数、告警、异常信息
• 支持批量转换（顺序与并行）
• 支持 CLI 子命令：
  • convert：单文件转换
  • batch：目录/批量转换
  • validate：输入文件检测
  • preset：预设查看
  • info：能力说明

已知限制

以下限制在运行结果中通常会以 warning 形式体现：

• 动画：复杂时序、路径和高级触发不保证可逆
• 评论：回复线程不会完整导出
• OLE/媒体：部分仅保留 payload，缺少可播放/可编辑关系绑定
• SmartArt：复杂布局仍可能走 fallback，编辑保真受限
• 字体：嵌入字体与主题字体方案的映射仍有边界
• 空安全：当前代码存在较多 nullable 警告，需要逐步清理

快速开始

环境要求

• .NET SDK 8.0+

构建与测试

dotnet build PowGrade.FileConverters.PptToPptx.sln
dotnet test PowGrade.FileConverters.PptToPptx.sln

库用法

using PowGrade.FileConverters.PptToPptx;

var options = new ConversionOptions
{
    KeepTempFiles = false,
    MaxSlideCount = 1000,
    Timeout = TimeSpan.FromMinutes(10)
};

PptToPptxConverter.Convert(
    @"C:\input\legacy.ppt",
    @"C:\output\converted.pptx",
    options);

如输入包含 VBA，建议输出为 .pptm：

PptToPptxConverter.Convert(
    @"C:\input\legacy.ppt",
    @"C:\output\converted.pptm");

CLI 用法

在项目目录执行：

dotnet run --project src/PowGrade.FileConverters.PptToPptx.Cli -- convert --input in.ppt --output out.pptx

批量转换：

dotnet run --project src/PowGrade.FileConverters.PptToPptx.Cli -- batch --input-dir ./in --output-dir ./out --pattern *.ppt

生成转换报告：

dotnet run --project src/PowGrade.FileConverters.PptToPptx.Cli -- convert --input in.ppt --output out.pptx --report report.txt

查看命令帮助：

dotnet run --project src/PowGrade.FileConverters.PptToPptx.Cli -- --help
dotnet run --project src/PowGrade.FileConverters.PptToPptx.Cli -- convert --help

架构概览

• PptReader：解析 OLE 与 PPT 二进制记录，构建中间模型 Presentation
• PptxWriter：将中间模型写入 OpenXML 包结构（[Content_Types].xml、ppt/slides/*.xml、rels 等）
• Features/*：动画、注释、超链接、媒体、OLE、主题、SmartArt 等增强模块
• Pipeline/*：提供可组合中间件管道能力（日志、校验、重试、缓存等）
• TemplateEngine：文本报告渲染（单文件/批量）

依赖与集成

• 依赖 PowGrade.FileConverters.Core（注册适配器 PptToPptxFileConverter）
• 可通过 ServiceCollectionExtensions 注入 IPptToPptxConverter 与 IBatchConverter

改进路线（建议优先级）

1. 清理 nullable 警告并补齐关键空值防护
2. 提升表格保真（合并单元格、边框、填充）
3. 扩展动画映射（触发/时序/路径）
4. 完善媒体与 OLE 的 shape 绑定和播放行为映射
5. 强化字体与主题联动，减少 fallback
6. 继续扩大真实样本回归集并收敛告警噪音

许可证

MIT License，详见 LICENSE。