rgPDF
繁體中文 · English
rgPDF 是一套跨平台桌面工具,可使用純文字或規則表達式搜尋具有文字層的 PDF 與 Word 文件。每筆命中會在找到時立即顯示,並可在非同步頁面預覽中查看精確且可自訂顏色的螢光筆標示。
名稱中的 rg 是向文字搜尋工具 ripgrep 致敬。
功能
- 可選擇搜尋 PDF、Word 文件(
.doc、.docx)或兩者,並可選擇是否包含子資料夾。 - 支援純文字、規則表達式及區分大小寫。
- 支援跨行、跨頁匹配與行尾英文斷字合併。
- 每找到一筆結果就立即顯示,搜尋期間介面仍可操作。
- 檔案、命中段落與 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 套用在此正規化後的文字上;預覽仍標示原本每行的字元位置。此設定會保存。
使用方式
按「瀏覽」選取資料夾,輸入文字或規則表達式後按「搜尋」。選取檔案及命中段落即可查看頁面與螢光標示。
「文件資料夾」下方的「主檔名篩選」可限制要搜尋的檔案,留空時不篩選。點擊輸入欄位左側的說明圖示,可查看語法說明與範例。此欄位比對不含最後一個副檔名的完整主檔名,不區分大小寫;支援 *(任意字串)、?(單一字元)、[abc]、[0-9] 與 [!abc]。例如 ch0* 會包含 ch01.pdf、ch02.docx,排除 ch1.pdf、ch2.docx;ch01 則只比對完全相同的主檔名。篩選會在讀取 PDF 或轉換 Word 前執行,並搭配檔案類型與子資料夾設定;此欄位會保存至下次啟動,不受文字搜尋的 Regex 與區分大小寫設定影響。
預覽窗格的「上一頁/下一頁」會逐頁瀏覽整份文件,包含未命中頁;選取命中項目窗格中的其他段落即可跳至其命中頁面。「符合頁面」會依預覽區域的寬度與高度完整顯示整頁,並隨窗格大小調整;「符合寬度」則可用較大尺寸閱讀。
下表依工具列由左至右排列;滑鼠停留可查看目前設定,三態按鈕每按一次切換一個狀態。
深色配色採初號機風格:深紫底色、螢光綠的選取與啟用狀態,搭配少量橘色焦點與連結;文件預覽保留原始頁面顏色。
| 工具列圖示 | 功能 | 操作說明 |
|---|---|---|
| 包含子資料夾 | 切換是否遞迴搜尋子資料夾。 | |
| 搜尋檔案類型 | 循環切換 PDF → Word(DOC/DOCX)→ 兩者。搜尋 Word 需已有 Windows Microsoft Word 或 LibreOffice。 | |
| 區分大小寫 | 切換搜尋時是否區分大小寫。 | |
| 規則表達式 | 切換 Regex;搜尋欄旁的說明圖示提供語法範例。 | |
| 忽略排版換行 | 接合相鄰行的中文文字、保留英文詞間空格與原座標標示;預設關閉。 | |
| 螢光筆顏色 | 選取預設色或自訂顏色。 | |
| 清除 Word 快取 | 確認後刪除轉換產生的 PDF,保留原始 Word 文件;搜尋期間停用。 | |
| 語言 | 循環切換跟隨系統 → 繁體中文 → 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.0.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| rgpdf-0.0.13.tar.gz | 151.2 kB | With provenance | Details for rgpdf-0.0.13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| rgpdf-0.0.13-py3-none-any.whl | Python 3 | none | any | Details for rgpdf-0.0.13-py3-none-any.whl |
Total release size: 209.3 kB
Release files / rgpdf-0.0.13.tar.gz
| Download URL | rgpdf-0.0.13.tar.gz |
|---|---|
| Size | 151.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f3ee9b98f96ea68e45d7f3721c28fe1094ca6d20467b3cee06ee0b065952202d
|
|
BLAKE2b-256 checksum How to use checksums |
2046111daa4cd5835b352c9ae59de90d248f2b222ccaecca62cd3bb20315810c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 20, 2026.
Transparency logRelease files / rgpdf-0.0.13-py3-none-any.whl
| Download URL | rgpdf-0.0.13-py3-none-any.whl |
|---|---|
| Size | 58.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac334f983131ad622490685ba686efa5bc2560ad495001964f011d510bffda65
|
|
BLAKE2b-256 checksum How to use checksums |
657280ba0a3d97a64488a68fde2e41f689c3f83761c97fae811c856a4c5cbe10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 20, 2026.
Transparency logSecurity for rgpdf 0.0.13
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.
Attestation for rgpdf-0.0.13.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 20, 2026.
Transparency logA 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.