Duhui Document to PDF

Problem It Solves

This skill handles converting one local file to PDF through Duhui's asynchronous conversion service, including doc/docx, ppt/pptx, xls/xlsx, ofd, images, txt, and html. It is intended for tasks where the workflow requires the vendor API, such as PDF compression or PDF watermarking parameters, rather than local conversion with LibreOffice. It does not support direct URL input, Base64 input, or callback URLs.

How It Works

The runtime requires python3 and the DUHUI_ALI_APPCODE environment variable. The script follows the standard path: upload the local file to a temporary Shanghai OSS bucket, pass the OSS object URL to v2/convert_async, poll the status every 2 seconds for up to 60 minutes, download the resulting PDF, and delete the temporary remote file on a best-effort basis. Progress is written to stderr, while stdout emits a single JSON object; success includes output_path, pdf_url, page_count, and filesize.

Boundaries and Notes

• The default behavior overwrites an existing PDF with the same name; use --output to keep the old result.
• Use --type only when the file extension is missing, incorrect, or the source type must be forced.
• Use --extra-params '' to pass optional vendor v2 parameters; check references/doc_to_pdf_ali.md for supported formats and field details.
• Do not echo the AppCode or OSS credentials in chat, logs, or final output; a failed remote deletion only records a warning and may leave the source file temporarily.