用途与实际影响
这项功能怎样使用
为什么需要它
同一份 CSS 在模拟软件外壳、实际 PDF 和 Typora 原生窗口中的表现可能不同；截图必须说明它能证明哪一层。
举个实际例子
调整标题间距后，把三个导出版本排出来看。页面上标明这是实际 PDF 渲染；软件外壳样张则保留浏览器概念预览标识。
最后我会得到什么
获得公开通用样例的 PNG 与联系表，辅助检查代码、表格、对比度和分页。
正常时
当前样例的 PDF 或图片能逐页打开，版式和文字已实际看过。
发现问题时
发现裁切、错行或样式不一致时修对应版式，再看同类文档。
入口不可用或证据不足时
缺浏览器或渲染环境时只能保留源码检查，不能声称完成视觉验收。
从哪里开始
使用项目预览脚本和公开通用样例生成当前样式图片，再打开整页 PDF/图片检查文字、分页和层级。
需要准备什么
- 要检查的版式或导出结果
- 可用于预览的样文
从开始到拿到结果
- 1
用固定样例生成
避免拿私人正文做公开截图，记录所用主题和模式。
- 2
看完整页面
逐页检查表格、代码、字体、留白和截断，并提取文字确认正文没丢。
- 3
留下可追溯对比
保存带来源的预览图；概念图不能当 Typora 实际窗口验收。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
实际 PDF 页面已检查关键规则与设计选择
概念软件窗口、CSS 回归、安装摘要、实际 PDF 和 Typora 原生观察分开。
公开样例不包含真实私人文档。
一页实际 PDF 验收不推广成所有长文都无须检查。
本模块用到的名词
- 联系表
- 把多张页面缩略图放在一起比较，不是文档正式页面。
专业定义
看排版，同时说清它是在浏览器还是编辑器里生成的
解决什么
可选预览器缺依赖不影响已安装 CSS；不能把缺少某个开发环境写成主题本身失效。
当前怎样实现
- render_previews.py 将 Markdown 与 profile CSS 组合成 HTML；软件外壳明确标记浏览器概念预览。
- render_html_png_playwright.js 为 Node/Playwright 辅助，脚本也有 Edge 截图路线；Pillow 生成多样式联系表，qa 为可重建中间产物。
- 本次三张画廊图从实际生成的 PDF 使用 Poppler 渲染，与程序自带的概念软件图不是同一证据层。
执行流程
- 1
选择公开通用样例
- 2
生成或导出当前结果
- 3
渲染完整页面
- 4
查看版式与提取文字
- 5
保存带来源的对比图
边界
- 预览脚本按当前 Windows 字体/浏览器配置工作。
- 软件概念图不冒充原生进程截图。
失败与恢复
- 缺浏览器或辅助依赖
- 报告这一层无法生成，保留其他独立证据。
真实入口
tools/render_previews.py预览流程
tools/render_html_png_playwright.js浏览器辅助
samples公开样例
previews历史可视化成果
如何验证
- 本次三种实际 PDF 各一页，渲染后逐张查看，未见裁切与重叠。
与其他模块的关系
检验最终排版，不能替代内容、安装和原生应用各自验收。