批量把目录里成百上千个 .vsd 收成 PPTX：靠 manifest 与按行重跑，而不是靠「文件夹看起来都生成了」
`batch-vsd-pptx` 面向资产盘点、合规归档与多产品线同步出讲义。风险包括部分文件静默失败、同名输出互相覆盖、或无法只重跑坏行而被迫全量重洗。应冻结 manifest：源路径、页范围、幻灯片尺寸、输出对象键、状态码、页数、文件哈希与耗时；对超大页单独限流。日终对账成功行数与对象存储计数，差异必须工单闭环并在次日批次前修复根因。
批量导出操作说明：黄金样本与损坏样本试跑后固定引擎版本，再写 checkpoint manifest 支持断点续跑与失败补偿
- 从各业务线抽取最复杂、最旧与若干损坏 .vsd 验证默认模板与质量参数，由数据 owner 签署 manifest 列定义；禁止各团队临时发明不同 CSV 头导致下游对账脚本失效。
- 生产任务每 N 行落盘 manifest 与失败清单，输出路径含库名与路径哈希；随机打开若干 PPTX 用宏统计页数是否为零或异常偏小，发现系统性偏移立即熔断同批参数。
- 批次归档 manifest 自身哈希与对象存储只读快照；重跑失败行时跳过已法务确认的对外演示快照行除非带强制工单，避免覆盖销售已发送给客户的那一版。
VSD 转 PPTX（批量）常见问题：manifest、断点续跑、同名覆盖、页数异常与合规封存
日志显示成功但对象数少于源文件数，最先应核对 manifest 哪些列而不是怀疑随机抖动？
检查每行状态、跳过原因与输出 URI 是否为空，常见是路径编码、只读锁或中途人工删除产物，而非转换引擎偶发故障。
多分支 CI 写入同一输出前缀导致审计对不上 git 提交，manifest 至少应额外记录哪些构建上下文字段？
必须记录流水线编号、提交 SHA、容器镜像 digest、源校验和与产物哈希；禁止无版本标签的 latest 目录作为唯一真相来源。
个别 .vsd 转出 PPTX 体积异常小疑似空演示，如何用页数与缩略图哈希组合自动拦截？
在流水线校验幻灯片计数下限与首页渲染哈希，低于阈值标记 suspect_empty 并人工用 PowerPoint 打开复核是否白屏或渲染失败。
同一 basename 在不同子目录反复出现，扁平导出会互撞，命名规则应如何系统性编码目录信息？
输出名包含相对路径哈希或库名前缀并写入 manifest；禁止扁平桶只保留单级文件名导致跨目录覆盖。
监管要求证明某日全量快照，仅靠 CSV manifest 是否足够，桶版本与 manifest 哈希是否必须成对封存？
不够，应封存桶版本或只读快照并对 manifest 文件做哈希存证；单独表格可被事后编辑无法自证，审计不会接受。