適用於 Openclaw 的 PDF Report Skill

一個高性能 PDF 生成引擎,可將結構化 JSON 資料轉換為專業的 A4 報告。

mohamed-hammane
v1.0.1
Apr 5, 2026
0
1.1k
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install pdf-report

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 pdf-report。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 PDF Report Skill?

Openclaw Skills 的 PDF Report 技能使開發人員和 AI 代理能夠直接從工作區資料建立格式化的高品質文件。透過利用 Jinja2 進行模板渲染和 WeasyPrint 進行匯出,它將複雜的 JSON 物件轉換為整潔的多頁 PDF,包括表格、列表和圖表圖像。對於 Openclaw Skills 內部任何需要自動報告或文件匯出能力的流程,此工具都是必不可少的。

該工具在設計時考慮了靈活性,允許透過自定義模板進行深度定制,同時保持嚴格的工作區安全性。無論您是在生成技術文件還是業務摘要,此技能都能確保您的資料以專業的、適合列印的格式呈現。

PDF Report Skill 應用場景

  • 從資料庫匯出中生成自動化的每月業務摘要。
  • 建立包含表格和嵌入式 Matplotlib 圖表的分析資料報告。
  • 將工作區資料匯出為可供利益相關者共享的 A4 格式。
  • 構建包含已渲染 HTML 預覽的偵錯報告。

PDF Report Skill 運作原理

  1. 按照技能要求的特定 schema 準備 JSON 格式的結構化資料。
  2. 在 Openclaw Skills 工作區內使用專用的 Python 虛擬環境執行渲染腳本。
  3. 該技能透過 Jinja2 模板處理 JSON 輸入以生成結構化 HTML。
  4. WeasyPrint 將生成的 HTML 渲染為專業的 A4 PDF 文件。
  5. 生成的 PDF 將保存到指定的工作區路徑,並帶有自動頁碼和格式化頁首。

PDF Report Skill 設定指南

首先,安裝 WeasyPrint 所需的系統依賴項:

# Ubuntu/Debian
sudo apt-get install -y libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev libcairo2

接下來,在 Openclaw Skills 目錄中建立一個虛擬環境並安裝 Python 依賴項:

python3 -m venv ~/.openclaw/workspace/.venv_pdf
~/.openclaw/workspace/.venv_pdf/bin/pip install weasyprint jinja2

PDF Report Skill 資料結構與分類體系

該技能需要一個具有特定層級結構的 JSON 物件以確保正確渲染。以下是 Openclaw Skills 使用的元資料分類:

Field Type Description
title String 報告的主標題。
summary Array 執行摘要部分的字串列表。
sections Array 包含標題、項目、表格和圖表的文件物件列表。
charts Array 嵌套在 sections 中,包含圖像的 src 路徑和說明文字。
footer String 出現在每一頁底部的文字。

PDF Report Skill 進階特性

  • 支援自定義 Jinja2 模板,以實現對文件品牌和佈局的完全控制。
  • 多頁文件的自動頁尾頁碼(例如,1 / 3)。
  • 強制執行工作區相對路徑,以確保 Openclaw Skills 環境內的安全性。
  • HTML 偵錯模式,可在 PDF 轉換前檢查渲染的標記。
  • 針對缺失圖表資源的優雅錯誤處理,確保即使視覺資料不完整也能完成報告生成。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

精選*