当前公开版本为 0.2.0。下表比较它与 preview.10 的公开包行为。
版本差异与现有限制
| 项目 | preview.10 | 0.2.0 |
|---|---|---|
| 较大 OFD 读取（约 1,000+ 文本对象） | 读取/转换报 “OFD traversal exceeds its reference budget” | 默认工作计数上限已提高 |
| OFD→PDF 签章外观失败 | 静默跳过 | 通过诊断报告 |
| Regular-only 汉字合成粗体 | 固定表头“量”存在历史视觉失败；发布验收限定真实 Regular/Bold | 本库 OFD→PDF/图片出口修复固定样例的字腔堵塞 |
| CLI 严格嵌入粗体 | 无对应开关，严格配置使用 API | 支持 --native-embedded-bold-behavior throw |
| 段落排版引擎 | 无独立排版和 writer 入口 | 新增独立 API，Flow/DOCX 继续使用原入口 |
| macOS Preview Find | 部分完整词 / 日期查找异常，根因未定 | 保留独立限制 |
| 原始 Unicode 剪贴板 Copy | 未完成字节级验收 | 未完成，不等同已证实缺陷 |
| ImageSharp 2.1.13 | 已披露依赖告警 | D10 评估未消除告警 |
| Skia / Windows Audit025 偶发问题 | 历史根因未定 | 保留诊断，被动观察新自然失败 |
preview.10 发布说明只描述原发布。后续结果以路线图及各具名验收报告为准。
转换或显示异常时如何排查
- 确认版本和入口。 记录 NuGet/CLI 版本、转换方向、API 或完整命令，以及 Native / DualLayer、实际渲染引擎。按安装版本查阅对应发布说明。
- 核对实际字体。 记录
FontDirectories、fallback、Regular/Bold/Italic 文件和输出内嵌资源。字体名称相同不代表字体字节相同；先阅读字体指南。 - 检查诊断。 DOCX 使用
ConvertWithResultAsync查看Diagnostics、OriginalTextPreserved和页级映射状态；其他 API 检查返回结果及异常，而不是只看文件是否生成。 - 保留最小复现。 保存可共享的最小输入、配置、完整错误、退出码和实际输出；不要只保留截图，也不要直接覆盖唯一输入副本。
- 分离出口和阅读器。 分别检查 OFD 原文、OFD→PDF、SVG、PNG、HTML 及目标阅读器 UI。某个出口成功不能证明其他出口正确。
- 逐页检查。 关注缺字/乱码、英文断词、局部样式扩散、字号与基线、表格边框、对齐、分页、裁切、重叠、重影和异常空白页。
验证 Native DOCX 时，必须查看本次 DOCX → Native OFD 的产物；如经 PDF 查看，应继续使用该 OFD 导出的 PDF，不能用直接 DOCX→PDF 替代。
不应忽略的能力边界
任意复杂 Word 保真、完整 R02 外来字形映射、通用 RTL/Arabic/Indic、完整档案符合性、生产 PKI/签章法律效力及所有阅读器互操作仍不在普遍承诺内。具体拒绝和未验证范围见能力契约。