Skip to content

README.ja.md

Latest commit

 

History

History
160 lines (121 loc) · 13.8 KB

README.ja.md

File metadata and controls

160 lines (121 loc) · 13.8 KB
Raw

English · 简体中文 · 日本語

PDFMathReader アプリアイコン PDFMathReader

Electron compile

あらゆる言語の科学文書を、リアルタイム翻訳付きで、どのプラットフォームでも読むことができます。PDFMathTranslate を基盤としています。

デモ

機能

  • レイアウト保持: 数式や表、重要な情報を保持し、原文のレイアウトをできる限り維持して翻訳します。
  • リアルタイム翻訳: 閲覧中にレイアウト解析と翻訳を進め、文書全体の処理完了を待たずに読めます。
  • 翻訳設定: 翻訳エンジン、サービス、言語を選び、文書全体または近くのページを翻訳できます。
  • 対訳表示: 検出された段落をクリックして原文と訳文を切り替えられます。
  • 柔軟な閲覧: サムネイル、ズーム、縦横スクロール、1・2・4 ページのレイアウトに対応しています。
  • 複数文書の管理: PDF を独立したウィンドウで開き、再び開くと閲覧位置と表示設定が復元されます。
  • 閲覧リンク: 検索結果と元の閲覧位置を双方向リンクで保存し、簡単に行き来できます。
  • ハイライトと注釈: 重要な箇所をハイライトし、注釈を追加して読書メモを残せます。

最近の更新

日付 機能の変更 貢献者
2026-10-03 カスタムメニューと左側の赤・黄・緑のウィンドウボタンを追加 @reycn
2026-10-03 実行可能な CI パッケージを提供し、閲覧画面のレイアウトアニメーションを改善 @reycn
2026-10-03 依存関係・Electron・アイコンのキャッシュで CI を高速化 @reycn
2026-10-03 Windows のコントロールとページ表示のショートカットを改善 @reycn
2026-10-03 Windows の PDF コンテキストメニューと「開く」項目を追加 @reycn
2026-10-03 段落のグループ化・プレビュー・文書アニメーションを改善 @reycn
2026-10-03 Intel Mac・32 ビット Windows・Linux ARMv7 のビルドを追加 @reycn

クイックスタート

プラットフォーム macOS Windows Linux
スクリーンショット PDFMathReader の閲覧画面 PDFMathReader の閲覧画面 Linux 上の PDFMathReader の閲覧画面
ダウンロードリンク GitHub Actions GitHub Actions GitHub Actions
インストール方法 macOS の ZIP を展開し、PDFMathReader.app を /Applications に移動して開きます。 PDFMathReader-win32-x64.exe をダブルクリックします（32 ビット Windows では ia32 版）。 CPU に合った .tar.gz を展開し、アプリのフォルダーで ./PDFMathReader を実行します。
補足 「アプリが壊れている」と表示される場合は、信頼できる配布元であることを確認し、ターミナルで sudo xattr -dr com.apple.quarantine /Applications/PDFMathReader.app を実行します。求められたら Mac のログインパスワードを入力し（表示されません）、アプリを再度開いてください。 ランタイムを含むポータブル版です。起動すると PDF の Open with PDFMathReader メニューが登録されます。ファイルを移動したら再度起動してください。 CPU アーキテクチャに合ったパッケージを選んでください。

開発

コントリビュート
  • ツール： Bun で依存関係とスクリプトを管理し、Vue/Vite で UI を構築します。Electron と Express は Node.js で動作します。依存関係を変更したら bun.lock もコミットしてください。
  • テスト： bun run build の後に bun run test を実行します。CI スクリプトは node --test .github/scripts/*.test.* で検証します。動作変更には対象を絞った回帰テストを追加してください。テスト方針を参照。
  • CI： Code style が書式と lint を検証し、Packaging が macOS・Windows・Linux でビルドと起動を確認します。Release はバージョン更新時にデフォルトブランチの成功したビルドを公開します。
  • コードスタイル： コミット前に bun run style:fix を実行してください。Husky がステージ済みファイルを自動整形・検証し、未解決のエラーがあるとコミットを停止します。JS/Vue は Prettier/ESLint、Python は Ruff、Swift は swift-format を使います。セットアップと規則を参照。
ローカル開発

Bun 1.3.14 と Node.js 22.22.1 以降をインストールしてから、ソースからデスクトップアプリを起動します。

bun install --frozen-lockfile
bun run desktop

各 OS 上でビルドします。

# macOS（署名証明書が必要です。--unsigned で署名を省略できます）
bun run package:mac
# Windows
bun run package:win

ブラウザ開発では OPENAI_API_KEY を設定し、bun run dev を実行して 127.0.0.1:5173 を開きます。OPENAI_MODEL でモデルを指定できます。デスクトップの環境変数は Launch PDFMathReader.command で読み込めます。

bun run test
bun run build
詳細

PDFMathReader は Vue 3 と PDF.js で閲覧画面を構築し、Electron をデスクトップ環境、Express をローカルバックエンドとして使用します。Vite はフロントエンドの開発とビルド、pdf-lib は PDF の操作を担当します。

各デスクトップウィンドウには独立したレンダラーと、Electron utility process で動作するバックエンドがあります。メインプロセスはウィンドウ、メニュー、認証情報、最近の文書、設定を管理します。サンドボックス化された preload がデスクトップ IPC を提供し、バックエンドとは 127.0.0.1 上の認証付き HTTP で通信します。

描画、レイアウト解析、翻訳は独立して動作します。ページとサムネイルは仮想化され、PDF.js とレイアウト解析は必要に応じて読み込まれます。描画キャッシュのメモリ使用量には上限があります。文書はローカルバックエンドに一度だけアップロードされ、以後の要求は文書 ID を使用します。文書、言語、カーネルを変更すると古い翻訳処理をキャンセルします。

設定 エンジン 出力
Ultra fast PDF Inspector 元の PDF 上の段落オーバーレイ
Fast PDFMathTranslate 数式を保持した翻訳済み PDF ページ
Precise PDFMathTranslate-next より詳細な組版による翻訳済み PDF ページ

PDF の描画とレイアウト解析はローカルで行います。翻訳では文書テキストを OpenAI に送信し、API 料金が発生する場合があります。Fast と Precise は uv でインストールしたアプリ管理の個別 Python 環境で動作し、バックエンドのプロキシ経由で OpenAI にアクセスします。API キーはレンダラーに渡されません。

デスクトップのキーは Electron safeStorage と macOS Keychain による保護で暗号化されます。保存したキーは OPENAI_API_KEY より優先され、削除すると環境変数に戻ります。安全なストレージが利用できない場合、保存は無効になります。

デスクトップデータは ~/Library/Application Support/ 内のアプリディレクトリに保存されます。認証情報、最近の文書、翻訳とレイアウトのキャッシュ、カーネル環境が含まれます。ブラウザ開発時のキャッシュは .cache/translations/ にあります。キャッシュと一時 PDF には文書の内容が含まれる場合があります。開始ページの Clear は最近の文書履歴だけを削除します。

ブラウザ開発では Express と Vite が独立した Node.js プロセスで動作します。ネイティブメニュー、デスクトップ IPC、安全なキー保存はデスクトップアプリのみで利用できます。

制限事項
  • プラットフォーム対応: macOS がテスト済みのプラットフォームです。Windows と Linux にはプラットフォーム固有のスタイルがありますが、ネイティブランタイムの検証は保留中です。パッケージ化コマンドは macOS arm64 と Windows x64 を対象としています。
  • レイアウトの忠実度: Ultra fast は幾何学的な段落グループ化とテキストオーバーレイを使用します。複雑な表、回転したテキスト、特殊な背景、長い翻訳では、元のタイポグラフィを維持できない場合があります。数式カーネルの出力は、上流のレイアウト処理に依存します。
  • スキャン文書: スキャンされた PDF には OCR が必要ですが、このアプリは実装していません。
  • 翻訳の要件: 翻訳には OpenAI API key とネットワークアクセスが必要です。Fast と Precise には、uv を通じて別途インストールした数式カーネルが必要です。
  • 範囲: これはローカルリーダー兼翻訳アプリであり、完全な PDF 編集・書き出しツールではありません。
  • 検証: 自動テストでは、バックエンドとリーダーのサポートロジックを確認します。モックプロバイダーによるチェックでは、実際の OpenAI 翻訳品質や API キーの有効性は確認できません。

ライセンス

PDFMathReader は GNU Affero General Public License, version 3 に基づいてライセンスされています。全文は LICENSE を参照してください。 PDFMathTranslate と PDFMathTranslate-next も AGPL-3.0 プロジェクトです。ランタイムへのインストールでは、上流プロジェクトのライセンスファイルが保持され、その他の依存関係にはそれぞれのライセンスが適用されます。

謝辞

ご支援いただいた OpenAI、Anthropic、Warp、Immersive Translate、SiliconFlow に心より感謝いたします。