fix: print PDF from actual editor theme CSS and shared Markdown rendering

2026-09-07 14:33:19 +08:00
parent 9f097ea629
commit d1cbc10fc4
20 changed files with 530 additions and 43 deletions
@@ -1638,3 +1638,10 @@ PDF 使用当前主题配色。`ExportOptions.palette` 可选，包含 page/surf
 关闭导出窗口仅停止 UI 轮询，已发起的导出继续。主动取消在准备阶段停止提交；创建请求期间取消会等待任务 ID，调用后台取消接口并读取实际状态。

 RAG `retrieval.fusion`接受rrf（默认）或weighted（归一化FTS/vector各50%），参数写入config_snapshot。真实本地单查询Embedding可命中有界进程缓存，provenance.query_embedding_cache为hit/miss；比较延迟须分别报告冷暖样本。HashEmbedding仍仅为确定性单元测试，不是当前生产检索模型。
+
+
+## PDF 浏览器快照契约（2026-09-07）
+
+`ExportRequest.print_html?: string` 仅允许 format=pdf。应用导出发送包含实际主题 CSS、根属性/CSS 变量、笔记 DOM 和内嵌字体图片的 HTML 快照；后端通过禁用脚本与网络的 Chromium 打印。`options.page_size` 控制 A4/Letter。print_html 存在时不再经过 ReportLab 的 AST 重排；无此字段的旧客户端维持兼容渲染。
+
+`POST /api/exports/preview-resources` 接收 ExportRequest 的 source/options，返回 `{images:[{source,data:string|null,warnings:string[]}],plots:[{source,svg,warnings:string[]}]}`，供浏览器共享 Markdown 渲染器使用。图片仅解析 Vault 相对路径；函数图使用共享白名单解释器，PDF 不使用预览页面配额。客户端准备失败不会创建半成品任务，已提交任务仍走统一取消和下载接口。