V1.2.0

Vertree 1.2.0

新增文件预览图 API，扩展本机自动化能力。Office-Viewer 与 Vertree 复用同一套渲染和格式清单。

文件预览图

• POST /api/v1/preview-images：传本机绝对路径，后台直接返回 PNG；不弹窗、不影响当前预览。
• 可指定宽高（默认 1200 × 1600，最大 4096 × 4096）、PDF/PPT 页码、工作表和视频时间点。
• 未知格式检测为文本后可预览，未知二进制和音频等无可视内容文件明确返回不支持。
• Office-Viewer 增加共享导出函数和桌面“导出预览图”入口，格式能力在构建时自动生成。

自动化与可靠性

• 增加预览控制/状态、格式能力、版本恢复/备注、文件比较、设置读写、批处理、异步任务、SSE 事件和诊断接口。
• 恢复版本前保留当前文件备份；修复连续备份可能复用分支编号并覆盖旧备份的问题。
• SSE 支持最近 256 条事件回放；异步任务支持状态、进度和安全边界上的协作式取消。
• 配置写入串行化；补充本地预览测试页与完整 API 使用文档。

使用说明

本机 API 默认关闭，需要在设置中启用并携带 Bearer Token。成功生成返回 image/png 字节，失败返回 JSON 错误。

Windows 使用 WebView2，macOS 使用 WKWebView；Linux 后台图片生成需要安装 Chromium / Google Chrome。Word 和连续文本导出首屏，不支持按打印页码选择；视频编码支持取决于浏览器引擎。

本地验证：Flutter 83 项测试、Office-Viewer 112 项测试、预览宿主 20 项测试通过；Windows 实测 PNG/PDF/Word/PPT/表格/Markdown/XMind、视频时间点和第二页选择，以及恢复、批处理、异步任务、SSE 回放。各平台安装产物由发布工作流构建。

Windows 常规安装请选择 vertree-windows-x64-1.2.0-setup.exe，先退出旧版或本地测试实例，再覆盖安装。