Rylai PDF 是做什麼的?
由 Rylai 原創的 Codex-Hermes-Claude 技能。
使用本地檔案與確定性工具。除非使用者明確要求原地取代,否則請保留原始文件。絕不憑空發明密碼、嵌入憑證,或未經直接核准將文件上傳至外部服務。
執行環境
使用 Python 3,搭配:
pypdf:進行頁面層級的檢查與編輯。pdfplumber:需要高品質文字提取時使用。pypdfium2或 Poppler 的pdftoppm:用於選擇性頁面渲染。- LibreOffice:僅在將 Office 來源檔案轉換為 PDF 時使用。
安裝前先探測:
python -c "import pypdf; print(pypdf.__version__)"
python -c "import pdfplumber; print(pdfplumber.__version__)"
只安裝缺少的 Python 套件:
python -m pip install pypdf pdfplumber pypdfium2
腳本 scripts/rylai_pdf.py 的路徑相對於此技能目錄。
工作流程
- 確認輸入路徑、要求的操作、輸出路徑與頁面範圍。
- 在編輯不熟悉或加密的 PDF 之前,先執行
info檢查。 - 寫入新的輸出路徑。僅在打算取代時才使用
--force。 - 重新開啟結果,檢查頁數、中繼資料,並在適用情況下檢查提取的文字。
- 對於版面敏感的作業,渲染代表性頁面並檢視 PNG 輸出。
- 當 Poppler、LibreOffice、OCR 或其他選擇性相依套件不存在時,回報跳過的檢查。
對於沒有實用文字層的掃描頁面,使用可用的本地 OCR 引擎。保留原始 PDF,並說明使用了哪個 OCR 工具與語言模型。
內建 CLI
檢查:
python scripts/rylai_pdf.py info input.pdf
提取選定頁面:
python scripts/rylai_pdf.py extract input.pdf output.txt --pages 1-3,7
合併:
python scripts/rylai_pdf.py merge output.pdf first.pdf second.pdf
將選定頁面分割成個別檔案:
python scripts/rylai_pdf.py split input.pdf output-pages --pages 2-5
將選定頁面順時針旋轉:
python scripts/rylai_pdf.py rotate input.pdf rotated.pdf 90 --pages 1,3
使用本地 PDFium 或 Poppler 渲染:
python scripts/rylai_pdf.py render input.pdf rendered-pages --dpi 144
僅在使用者為該文件提供密碼時,才加上 --password。
品質標準
- 輸出檔案開啟時無修復警告。
- 頁面順序、數量、旋轉角度與選定範圍符合要求。
- 提取的文字不會無聲地為空;掃描頁面會被識別。
- 渲染的頁面無意料之外的裁剪或空白輸出。
- 原始檔案、暫存檔案、密碼或使用者路徑不與技能打包在一起。