度慧文档转 PDF

适用问题

这个技能面向需要把单个本地文件交给度慧异步转换服务生成 PDF 的场景，例如 doc/docx、ppt/pptx、xls/xlsx、ofd、图片、txt、html 等转 PDF，也覆盖用户提到 PDF 压缩、PDF 水印 等需要走 vendor 参数的需求。它不用于本地 LibreOffice 转换，也不接受 URL、Base64 或回调式输入。

工作方式

运行前需要 python3 和环境变量 DUHUI_ALI_APPCODE。技能通过脚本完成标准链路：读取本地文件，从临时接口获取 OSS 上传凭证，把文件上传到上海地域临时桶，再将 OSS 对象直链交给 v2/convert_async；随后每 2 秒轮询状态，最长等待 60 分钟，成功后下载 PDF 并 best-effort 删除远端临时文件。输出约定：进度写 stderr，stdout 只输出 JSON，成功字段包含 output_path、pdf_url、page_count、filesize 等。

边界与注意点

• 默认覆盖同名输出，需要保留旧结果时指定 --output。
• --type 只在文件后缀缺失、错误或需要强制覆盖源类型时使用。
• 需要透传 vendor v2 可选参数时使用 --extra-params ''，细节应查 references/doc_to_pdf_ali.md。
• 不得在聊天、日志或最终答复中回显 AppCode 或 OSS 凭证；删除远端文件失败只记录 warning，可能短暂残留。