用途
office-render 用于把已保存的交付文档渲染成图片，以便查看实际视觉效果或检查版式布局。适用于需要对 DOCX、PPTX、PDF、XLSX 做视觉审查的场景，例如检查正文是否被裁切、对齐是否正确、标题层级、表格宽度、对比度、图表标签和数字格式等。
主要能力
- 通过 LibreOffice Kit CLI 渲染文档为图片，并覆盖 DOCX、PPTX、PDF 和电子表格。
- 支持按页码或幻灯片选择渲染范围，命令示例：
"<node>" "<cli>" render --input <final-file> --output-dir <new-directory> --pages "1,3,4" - 支持按工作表精确名称和单元格区域渲染，命令示例：
"<node>" "<cli>" render --input <final-workbook.xlsx> --output-dir <new-directory> --sheet <exact-name> --range <A1-range> - 对 DOCX、PPTX 或 PDF，可在一次调用中批量渲染指定页面或幻灯片。
- 返回 JSON 清单，包含图片路径、页数、分片矩形和缺失字体诊断，便于定位渲染问题。
使用方式
在 Bash 中用 "<node>" "<cli>" 调用，在 PowerShell 中用 & "<node>" "<cli>" 调用，并传入 node 与 CLI 的绝对路径。优先使用随附的 LibreOffice；如用户要求其他安装方式再另行处理。若缺少 Office sidecar，需先询问用户是否下载，用户同意后才安装。不要调用系统 soffice、npx，也不要安装替代渲染器或自建渲染管线来绕过渲染失败。
做仅用于检查的预览时，需在工作区内创建唯一命名的临时父目录：在 POSIX 上使用 preview_root=$(mktemp -d "./.dsh-office.XXXXXXXX") 并将 --output-dir "$preview_root/render" 传入一个尚不存在的子目录（CLI 会创建该子目录）；在 PowerShell 中在工作区下创建名为 .dsh-office- 加 GUID 的父目录，并传入未创建的 render 子目录。输入输出路径需加引号，检查完成后删除该临时父目录。
只有当前模型支持读图时才进行图像检查；否则应完成可适用的内容与结构检查，并说明视觉检查不可用。不要在生成预览前猜测文本几何来判断溢出。
失败与空白预览
有内容的文档若渲染出全透明或均匀空白图像，视为渲染器失败。如需像素检查，应先将 RGBA 合成到白色背景再判断。检查一次即可，不要重复读取同一图像；出现空白结果后应停止该任务的视觉检查，不再重试其他范围、页码、工作表、DPI、输出格式或打印设置，也不要在编辑或复制源文件后重新渲染。
当内容与结构检查通过但视觉检查未完成时，按资料要求仅输出一句状态说明：英文为 “Content and structure checks passed; visual inspection was not completed.”，中文为 “内容与结构检查通过；视觉检查未完成。”，并分别报告内容或结构问题，不能声称全部检查通过或已完成视觉验证。
限制
LibreOffice 的渲染结果可能与 Word、PowerPoint 或 Excel 存在差异；预览图不能证明动画或媒体播放效果，也不能刷新源工作簿的公式缓存或保证原生应用中的最终显示保真度。检查用预览图或报告不应交付，除非用户明确要求。未提供关于收费、价格、平台支持范围或具体安装步骤的更多信息。