README.zh.md 2.7 KB
description: "宿主转换提供方使用的已授权 Office 输入与完整 PDF 输出。"
kind: "package-reference"
@deepseek-ai/dsh-document-render
English | 中文
概述
将已授权的 .doc、.docx、.xls、.xlsx、.ppt 和 .pptx 字节转换为完整 PDF。调用方获得 PDF 字节；OOXML 输入还提供缺失字体名称，不修改原文件或添加模型上下文。
目录
使用此包
挂载 LibreOffice 提供方以提供 ctx.documentRender。抽象服务没有可挂载实现或配置。调用方须先授权并 stat 源文件，再向 render() 传入标识、版本、可选字节数、延迟的有界读取、Office 扩展名和调度优先级。提供方在调用读取回调前准入元数据。源版本变化时拒绝转换。
理解实现
实现内部细节 — 点击展开
提供方返回各调用方独立拥有的 PDF 字节、转换缓存键和渲染 generation。消费者在复用缓存 PDF 前检查 `generation`；替换配置会创建新的 generation。单个读取方取消时立即拒绝；提供方销毁会等待实际读取、转换和临时文件清理。取消以其原因拒绝；已分类的转换失败使用 `DocumentRenderError`。提供方和消费者通过 peer dependency 共享此包，使 `instanceof DocumentRenderError` 能识别双方的失败。此服务仅声明操作，没有独立保留的观测，因此不发布运行时不变量伴随入口。延伸阅读
模型体验
无，因为此包仅转换字节，不提供面向模型的工具、消息或 Session 事件。
KV Cache effect
无；转换不会构造或修改模型请求。
已知限制与延后工作
- 服务仅接受上述六种 Office 格式；源文件授权由消费者负责，共享转换复用由提供方负责。