name: 度慧文件轉換-文件轉PDF description: 當需要通過阿里雲市場的度慧文件轉換將單個本地文件轉換為 PDF 時，請使用此 skill。凡是請求中提到“度慧”、“文件轉PDF”、“doc to pdf”、“文件轉換”、“格式轉換”、“文件格式轉換”或“PDF轉換”，或者需要通過非同步 API 將單個本地 Office/WPS/OFD/圖片/文本/網頁等任意檔案轉換為 PDF 時，均應觸發此 skill homepage: https://market.aliyun.com/detail/cmapi00044564 compatibility: Requires python3, DUHUI_ALI_APPCODE, and network access to Duhui/Alibaba endpoints. always: false metadata: clawdbot: emoji: "📄" requires: bins: - python3 env: - DUHUI_ALI_APPCODE audit: runtime_python_packages: [] external_endpoints: - https://file.duhuitech.com/k/tmp_up.json - https://fmtmp.oss-cn-shanghai.aliyuncs.com - https://doc2pdf.market.alicloudapi.com/v2/convert_async - https://api.duhuitech.com/q data_handling: uploads_local_files_to_vendor_controlled_oss: true fetches_temporary_upload_credentials_at_runtime: true cleanup_remote_source_best_effort: true persists_secrets_to_disk: false secrets_must_not_be_requested_in_chat: true requires_user_notice_before_upload: true

度慧文件轉PDF

Overview

用這個 skill 處理“單個本地檔案轉單個 PDF”的度慧非同步轉換任務。 標準鏈路是：本地檔案 -> 阿里雲 OSS 臨時上傳 -> 把 OSS 物件直鏈放進 input -> v2/convert_async -> 輪詢查詢 -> 下載本地 PDF -> 刪除 OSS 臨時檔案。

Required Runtime And Secret

• 必需二進位制：python3
• Python 側只依賴標準庫，不需要額外安裝第三方包
• 必需環境變數：DUHUI_ALI_APPCODE
• AppCode 獲取地址：https://market.aliyun.com/detail/cmapi00044564
• 在執行轉換指令碼前，agent 必須確保 DUHUI_ALI_APPCODE 已出現在執行環境中
• 本 skill 不規定 secret 的儲存、檢索或注入方式；這由使用者自己的 agent 能力和授權策略決定

Network Endpoints

• https://file.duhuitech.com/k/tmp_up.json：執行時獲取臨時 OSS 上傳憑證
• https://fmtmp.oss-cn-shanghai.aliyuncs.com：vendor 控制的臨時 OSS 桶，用於上傳本地原始檔
• https://doc2pdf.market.alicloudapi.com/v2/convert_async：提交非同步轉換請求
• https://api.duhuitech.com/q：輪詢轉換狀態
• vendor 返回的 pdfurl：下載輸出 PDF

Data Flow And Privacy

• 本地原始檔會先上傳到阿里雲 OSS 上海地域臨時桶 fmtmp.oss-cn-shanghai.aliyuncs.com
• 上傳完成後會把 OSS 物件 URL 傳給 vendor 的非同步轉換介面
• 指令碼會在執行時從 https://file.duhuitech.com/k/tmp_up.json 獲取臨時上傳憑證，僅供當前程序使用
• 轉換結束後會 best-effort 刪除 OSS 臨時原始檔；如果刪除失敗，遠端原始檔可能短暫殘留
• agent 不得在聊天、日誌或最終答覆裡回顯 AppCode
• agent 只有在使用者明確同意在聊天裡直接貼上 AppCode
• agent 只有在使用者明確同意且其自身 secret 管理策略允許時，才能持久化或快取 AppCode

When To Use

• 使用者明確提到度慧、文件轉 PDF、文件轉換、格式轉換、PDF 轉換、壓縮pdf，PDF水印
• 使用者要把單個本地 doc/docx/ppt/pptx/xls/xlsx/ofd/img/txt/html/... 檔案轉成 PDF
• 任務需要走度慧的非同步介面，而不是本地 LibreOffice 或其他轉換器

Do Not Use

• 直接 URL 輸入
• Base64 輸入
• 回撥 URL

Workflow

1. 先確認執行前置條件。
2. 執行環境必須可用 python3。
3. 只檢查環境變數 DUHUI_ALI_APPCODE。
4. 如果環境變數已經存在，直接執行轉換指令碼；不要要求使用者重複輸入 AppCode。

   訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

5. 如果環境變數不存在，必須明確告訴使用者：當前執行環境缺少 DUHUI_ALI_APPCODE，請先到阿里雲市場商品頁獲取 AppCode：https://market.aliyun.com/detail/cmapi00044564。不要只籠統地說“請提供 AppCode”。
6. agent 應引導使用者通過其支援的安全 secret 配置機制、環境變數機制或本地 secret store 來配置 DUHUI_ALI_APPCODE。如果 agent 支援安全的非聊天式 secret 輸入，可指導使用者使用該機制。
7. 只有在 agent 無法安全提供 DUHUI_ALI_APPCODE 且使用者尚未完成配置時，才停止執行並等待使用者完成配置。
8. 預設優先執行指令碼，不要手寫 OSS 上傳或 HTTP 呼叫邏輯：

python3 scripts/duhui_doc_to_pdf.py ./input.docx

1. 使用者指定輸出路徑時，加 --output：

python3 scripts/duhui_doc_to_pdf.py ./input.docx --output ./output.pdf

1. 預設會覆蓋同名輸出 PDF；如果使用者要保留舊結果，顯式指定另一個 --output 路徑。
2. 只有在檔案字尾缺失、錯誤、或需要強制覆蓋源型別時才傳 --type。
3. 需要 vendor v2 可選引數時，用 --extra-params '<json>' 透傳，例如：

python3 scripts/duhui_doc_to_pdf.py ./input.docx --extra-params '{"pagesize":2,"compress":1}'

1. 絕不在聊天、日誌或最終答覆裡回顯 AppCode 或指令碼內建的 OSS 憑證；持久化時也只用佔位符，不要把秘密再次展示出來。
2. 當需要確認支援格式、把使用者的細化要求對映成更多 v2 引數、檢視 vendor 引數細節、或排查 vendor 返回欄位時，讀取 references/doc_to_pdf_ali.md。

Missing AppCode Prompt

• 當 DUHUI_ALI_APPCODE 缺失時，優先使用類似下面的提示，而不是直接中止：

當前執行環境缺少 DUHUI_ALI_APPCODE。
請先到阿里雲市場商品頁獲取度慧文件轉 PDF 的 AppCode：
https://market.aliyun.com/detail/cmapi00044564

請改用你當前 agent 支援的安全 secret 配置方式、環境變數機制或本地 secret store 完成配置；配置完成後再繼續轉換。

Output Contract

• 進度資訊只寫到 stderr
• stdout 只輸出一個 JSON
• 成功 JSON 包含：status, token, output_path, pdf_url, page_count, filesize, source_object_key
• 失敗 JSON 包含：status, stage, token, reason

Notes

• 指令碼始終只處理一個本地輸入檔案
• 指令碼只使用 Python 標準庫，不依賴額外 Python 包
• OSS 物件名固定為 up/<uuid4><原副檔名>
• 執行時會從 https://file.duhuitech.com/k/tmp_up.json 請求臨時 OSS 上傳憑證
• 上傳後直接把 OSS 物件 URL 傳給 vendor，不生成簽名 URL
• 查詢介面不帶認證，固定每 2 秒輪詢一次，最長等待 60 分鐘
• 轉換結束後會嘗試刪除 OSS 臨時原始檔；刪除失敗只記 warning，不覆蓋主錯誤
• DUHUI_ALI_APPCODE 的儲存、持久化、檢索和注入由使用者自己的 agent 負責

這個文件轉 PDF 的 Skill 質量良好，文件說明清晰易懂，核心功能實現完善，敏感資訊保護到位。主要優點是配置詳細、使用便捷、安全考慮周全；不足是缺少測試和示例檔案，文件格式有小瑕疵。對於普通使用者而言，這是一個值得信任的工具，但建議開發者在正式使用前先自行驗證一下轉換效果。