Skip to main content

rgPDF

繁體中文 · English

rgPDF 是一套跨平台桌面工具,可使用純文字或規則表達式搜尋具有文字層的 PDF 與 Word 文件。每筆命中會在找到時立即顯示,並可在非同步頁面預覽中查看精確且可自訂顏色的螢光筆標示。

名稱中的 rg 是向文字搜尋工具 ripgrep 致敬。

功能

  • 可選擇搜尋 PDF、Word 文件(.doc、.docx)或兩者,並可選擇是否包含子資料夾。
  • 支援純文字、規則表達式及區分大小寫。
  • 支援需要密碼的 PDF:可重試、略過單一文件,並沿用已驗證密碼預覽。
  • 支援跨行、跨頁匹配與行尾英文斷字合併。
  • 每找到一筆結果就立即顯示,搜尋期間介面仍可操作。
  • 檔案、命中段落與 PDF 頁面預覽三個連動區域。
  • 逐字元反白座標與可自訂的螢光筆顏色。
  • 繁體中文/英文介面,以及系統/淺色/深色主題。
  • 保存搜尋與外觀偏好。

rgPDF 只搜尋 PDF 已有的文字層。搜尋 Word 文件需要 Microsoft Word(Windows)或 LibreOffice;文件會先轉成快取 PDF,再搜尋文字並提供頁面預覽。rgPDF 不會執行文件巨集、不執行 OCR,也不修改來源檔案。

Word 搜尋採三階段管線:先直接讀取 DOCX 文字初篩,找到第一個可能命中就排入 PDF 轉檔,並繼續檢查其他文件;PDF 準備完成後再搜尋全部正式命中。頁碼、筆數、摘要與螢光標示均以 PDF 為準。已有有效 PDF 快取時直接搜尋快取,不再初篩。為降低排版差異造成漏搜的風險,初篩採保守判定;包含運算子的 Regex、舊式 .doc、欄位/特殊內容或擷取失敗的文件直接走 PDF 流程。開啟資料夾不會自動轉檔;取消搜尋會停止初篩與尚待轉檔的排程,正在執行的轉換完成或返回後清理。

工具列 Regex 按鈕旁的「忽略排版換行」預設關閉。啟用後,會依文字區塊、相鄰行位置及偵測到的表格儲存格接合排版換行:例如 循環 換行 緩衝區 可搜尋 循環緩衝區,英文 buffer 換行 size 保留詞間空格,inter- 換行 national 合併斷字。行內實際空格保留,段落/欄位/不同儲存格不主動接合,跨頁維持空格。Regex 套用在此正規化後的文字上;預覽仍標示原本每行的字元位置。此設定會保存。

使用方式

搜尋遇到需要密碼的 PDF 時會提示輸入,密碼以遮罩顯示;輸入錯誤可重試,按「略過此檔」則繼續搜尋其他文件,並於完成後列入警告。同一份文件在本次程式工作階段內可沿用已驗證密碼搜尋、預覽、換頁與縮放;關閉程式即清除,來源檔案變更後會重新驗證。密碼不寫入設定、搜尋結果或快取,也不產生解密後的 PDF 副本。

在左上「搜尋標的」窗格按「瀏覽」選取資料夾,或將檔案/資料夾拖放到視窗;若拖放檔案,搜尋標的設為該檔案所在的資料夾。拖放多個項目時使用第一個有效本機項目;搜尋或批次匯出 PDF 期間暫停接受拖放。設定標的不會自動搜尋,輸入文字或規則表達式後按「搜尋」。選取檔案及命中段落即可查看頁面與螢光標示。搜尋進度與完成狀態顯示在整個視窗底部的狀態列,長狀態文字可將滑鼠停留其上查看。

「文件資料夾」下方的「主檔名篩選」可限制要搜尋的檔案,留空時不篩選。點擊輸入欄位左側的說明圖示,可查看語法說明與範例。此欄位比對不含最後一個副檔名的完整主檔名,不區分大小寫;支援 *(任意字串)、?(單一字元)、[abc]、[0-9] 與 [!abc]。例如 ch0* 會包含 ch01.pdf、ch02.docx,排除 ch1.pdf、ch2.docx;ch01 則只比對完全相同的主檔名。篩選會在讀取 PDF 或轉換 Word 前執行,並搭配檔案類型與子資料夾設定;此欄位會保存至下次啟動,不受文字搜尋的 Regex 與區分大小寫設定影響。

使用工具列的「將 Word 檔匯出為 PDF」可勾選目前資料夾中的 .doc/.docx,再指定輸出資料夾。清單沿用主檔名篩選及子資料夾設定,不受搜尋檔案類型或搜尋樣式影響;沒有符合條件的 Word 檔時按鈕停用,Word 暫存鎖定檔不列入。每份檔案以原主檔名加上 .pdf 匯出到指定資料夾,不保留子資料夾結構。已有有效 PDF 快取就直接複製,否則先透過 Microsoft Word/LibreOffice 轉檔寫入共用快取,再匯出;不修改來源。預設略過既有同名 PDF,可勾選覆寫;若所選 Word 檔會產生同名 PDF,須先取消重複項目的勾選。狀態列顯示匯出進度,可取消後續作業;已匯出檔案與已完成的快取會保留,個別失敗不會中止其他檔案。

預覽窗格的「上一頁/下一頁」會逐頁瀏覽整份文件,包含未命中頁;選取命中項目窗格中的其他段落即可跳至其命中頁面。「符合頁面」會依預覽區域的寬度與高度完整顯示整頁,並隨窗格大小調整;「符合寬度」則可用較大尺寸閱讀。

預覽工具列提供 選取並複製文字「選取並複製文字」工具,預設啟用。以滑鼠拖曳選取目前頁面的文字,放開滑鼠後即自動複製到剪貼簿;拖曳期間不會重複寫入。Ctrl+A/⌘A 可選取並複製整頁文字,Esc 清除畫面選取。支援中文、跨行、縮放與旋轉頁面,以及已解鎖的加密 PDF;換頁、換檔或重新縮放會清除選取。沒有文字層的頁面無法選取文字,原命中標示仍保留。

預覽工具列以分隔線區分翻頁、複製及縮放功能。複製目前頁面為 PNG「複製目前頁面為 PNG」會將完整頁面影像放入剪貼簿,可直接貼入支援圖片的應用程式。影像採目前預覽解析度,包含命中標示與捲動區外的內容,不包含工具列或文字選取底色;不建立磁碟檔案。沒有文字層的頁面亦可複製,載入期間按鈕會停用。

下表依工具列由左至右排列;滑鼠停留可查看目前設定,三態按鈕每按一次切換一個狀態。

狀態按鈕啟用後會持續顯示與滑鼠移入相同的底色。深色配色採初號機風格:深紫底色、螢光綠的選取與啟用狀態,搭配少量橘色焦點與連結;文件預覽保留原始頁面顏色。

工具列右側為「語言、配色」,其餘搜尋工具靠左排列。「關於 rgPDF」位於 Windows 主視窗左上角應用程式圖示的系統功能表(亦可按 Alt+Space 開啟);macOS 使用原生應用程式功能表,其他平台則位於 rgPDF 功能表,可查看版本、授權與原始碼連結。

工具列圖示 功能 操作說明
父子資料夾 包含子資料夾 切換是否遞迴搜尋子資料夾。
PDF Word PDF 與 Word 搜尋檔案類型 循環切換 PDF → Word(DOC/DOCX)→ 兩者。搜尋 Word 需已有 Windows Microsoft Word 或 LibreOffice。
Aa 區分大小寫 切換搜尋時是否區分大小寫。
規則表達式 規則表達式 切換 Regex;搜尋欄旁的說明圖示提供語法範例。
Line wrap 忽略排版換行 接合相鄰行的中文文字、保留英文詞間空格與原座標標示;預設關閉。
顏色色塊 螢光筆顏色 色塊顯示目前顏色;點選後可選預設色或自訂顏色。
垃圾桶 清除 Word 快取 確認後刪除轉換產生的 PDF,保留原始 Word 文件;搜尋或批次匯出 PDF 期間停用。
匯出 Word PDF 將 Word 檔匯出為 PDF Word logo 搭配向外箭頭;勾選檔案與輸出資料夾,沿用快取或轉檔後匯出。
系統語言 中文 英文 語言 循環切換跟隨系統 → 繁體中文 → English。
系統配色 淺色 深色 配色 循環切換跟隨系統 → 淺色 → 深色。

將滑鼠停留在圖示上即可查看功能說明。搜尋、顏色設定與預覽按鈕如下:

圖示 Tooltip/功能
瀏覽… 瀏覽…
搜尋 搜尋
取消 取消
搜尋樣式說明 搜尋樣式說明
自訂顏色… 自訂顏色…
上一頁 上一頁
下一頁 下一頁
縮小 縮小
放大 放大
符合寬度 符合寬度
符合頁面 符合頁面

搜尋設定會保存至下次啟動。啟動時會刪除 30 天未使用的轉換快取,若總量仍超過 500 MB,優先刪除最久未使用的項目。搜尋期間可按「取消」停止。

安裝最新版本

Windows 免安裝版

從 最新 GitHub Release下載有版本編號的 rgpdf-*-windows-x86_64.exe 與對應 .sha256 檔。執行檔目前未簽章,因此 Windows SmartScreen 可能顯示未知發布者警告;選擇執行前,請先確認 SHA-256 與發布頁提供的值相同。

免安裝版不需要 Python 或 uv。搜尋 PDF 不需其他軟體;搜尋 Word 則需要 Windows 上既有的 Microsoft Word,或已安裝 LibreOffice。

macOS App(Apple Silicon)

從最新 GitHub Release下載有版本編號的 rgpdf-*-macos-arm64.dmg 與對應 .sha256 檔。先核對下載檔:

shasum -a 256 rgpdf-*-macos-arm64.dmg

確認輸出與 .sha256 檔相同後,開啟 DMG,將 rgpdf.app 拖曳至 Applications。這個版本適用 Apple Silicon(M 系列)Mac,不需要安裝 Python 或 uv。

App 只有 ad-hoc 簽章且未經 Apple 公證。若 macOS 阻擋首次啟動,請在 Finder 的 Applications 中按住 Control 點按 rgpdf、選擇「打開」,再於確認視窗選擇「打開」。

使用 uv 安裝

先安裝 uv,再從 PyPI 安裝最新發布版本:

uv tool install rgpdf

執行程式:

rgpdf

更新已安裝的版本:

uv tool upgrade rgpdf

支援 Windows 與 macOS,所需 Python 環境由 uv 管理。

若要直接從 GitHub 安裝最新原始碼發布版本,請使用會移動的 latest 標籤:

uv tool install "git+https://github.com/codemee/rgpdf.git@latest"

開發

git clone https://github.com/codemee/rgpdf.git
cd rgpdf
uv sync
uv run pytest
uv run rgpdf

工具列圖示修改後,使用 uv run python scripts/generate_toolbar_icons.py 更新 README 圖片。

架構、匹配語意、並行處理與發布方式請參閱技術細節,版本歷程請參閱變更紀錄。

發布版本

GitHub Releases 提供 Windows 執行檔、macOS App、SHA-256 檢查碼與對應原始碼;Python 套件可從 PyPI 安裝。latest Git 標籤指向最新發布版本的原始碼。

發布流程與維護說明請參閱技術細節。

授權

rgPDF 依 GNU Affero General Public License version 3 授權。你可以依該授權條款使用、研究、修改及重新散布本程式;散布執行檔時,必須同時提供該版本的完整對應原始碼。

本程式依 AGPLv3 使用 PyMuPDF/MuPDF,並依 LGPLv3 使用 PySide6/Qt。詳見第三方授權聲明與發布授權檢查清單。

Metadata

Release files for rgpdf 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rgpdf 0.1.4
File Size Uploaded Provenance Actions
rgpdf-0.1.4.tar.gz 188.3 kB With provenance Details for rgpdf-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rgpdf 0.1.4
File Interpreter ABI Platform Actions
rgpdf-0.1.4-py3-none-any.whl Python 3 none any Details for rgpdf-0.1.4-py3-none-any.whl

Total release size: 263.0 kB

Release files / rgpdf-0.1.4.tar.gz

Download URL rgpdf-0.1.4.tar.gz
Size 188.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5737a54e03db1f40aba8f3d23f405f2d9061ce11d155da0f1c48b3a4c758b6a5
BLAKE2b-256 checksum
How to use checksums
fc46c9bddc6bef4f46f5588caedce5b19540504bd5b61ca9b449ff4ce93d7b15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / rgpdf-0.1.4-py3-none-any.whl

Download URL rgpdf-0.1.4-py3-none-any.whl
Size 74.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2ac1f53e339032b8be3a2b6a72f100b4d68611c9aeb46236820b0a451acd8bf
BLAKE2b-256 checksum
How to use checksums
4af3a313c51113991534012c8b890c876aa26dd1169769253d84bcfd83625b54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Security for rgpdf 0.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for rgpdf-0.1.4.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page