gre-3000-vocab

## 概要 GRE鎮考3000は、GRE受験生向けに設計された純フロントエンドのGRE語彙学習プログレッシブWebアプリ（PWA）です。『GRE鎮考3000語（ランダム順）』の完全な単語帳（全3275エントリ、中国語の意味・発音記号・英語例文を含む）を内蔵し、エビングハウスの忘却曲線に基づいて復習間隔を調整し、ユーザーの効率的な単語暗記を支援します。 ## コア機能 - **毎日の新規単語**：デフォルトで毎日100語の新規単語を学習。設定で調整可能（50〜150語、10語単位）。新規単語はランダム順の単語表に従い、未学習の単語から選択されます。 - **エビングハウス間隔復習**：各カードには8段階（0〜7）があり、間隔は8分から15日まで。ユーザーの回答パフォーマンスに応じてease係数（初期値2.5、正解で+0.1、不正解で−0.2）を動的に調整。実際の待機時間＝基本間隔×（ease / 2.5）。 - **復習問題形式**：英単語を表示し、4つの中国語の意味から正解を1つ選択（正解1つ＋誤答3つ）。 - **オフライン対応**：単語帳はアプリに同梱され、初回起動後にService Workerがアプリシェルと単語データをキャッシュするため、以降はオフラインでも単語学習が可能。 - **PWAインストール対応**：スマートフォンのホーム画面に追加（iOS Safari / Android Chrome）し、独立したウィンドウで動作。 - **デスクトップアプリ**：macOS用インストーラー（Electronパッケージ）を提供。Linux版もローカルでビルド可能。 - **ショートカットキー**：新規単語ページではスペース/Enterで意味を展開、1/2/3で「知らない」「曖昧」「知っている」を選択。復習ページでは1〜4で回答選択、スペース/Enterで次の問題へ。 ## インターフェースとナビゲーション 下部に4つのエントリー： - **今日**：進捗ダッシュボード。当日の学習状況や連続学習日数などを表示。 - **学習**：新規単語学習ページ。単語が上、意味はデフォルトで折りたたまれ、カードクリックまたはスペースキーで展開。下部に3つのボタン：「知らない」「曖昧」「知っている」。 - **復習**：復習ページ。単語が上、4つの選択肢が縦に並ぶ。 - **単語帳**：「未学習」「復習中」「習得済み」でフィルタリング可能。単語をクリックして初めて意味が表示される。7日間の段階に入った単語は「習得済み」とみなされる。 ## 技術実装 - **フロントエンドフレームワーク**：Viteベースで構築され、React（または類似のフレームワーク。明記されていないが現代的なフロントエンド慣行に準拠）を使用。 - **PWAサポート**：vite-plugin-pwa（Workbox）を使用してWeb App ManifestとService Workerを生成し、オフラインキャッシュとインストール可能性を実現。 - **データ保存**：すべての学習進捗はブラウザのlocalStorage（キー名：gre3000.vocab.v1）に保存され、バックエンドサーバーに依存しない。 - **単語帳の解析**：元の単語帳は『GRE鎮考3000語（ランダム順）』のPDFから取得。Pythonスクリプト（pymupdf）を使用して表を解析し、透かしを除去し、改行で分割された単語を結合し、重複を排除してJSONファイルを生成。 ## 使用方法 ### オンライン利用 https://gre-3000-vocab.vercel.app にアクセスするだけで学習を開始できます。最適な体験のため、スマートフォンのホーム画面に追加することをお勧めします。 ### ローカル実行 ```bash git clone https://github.com/jayden-dong411/gre-3000-vocab.git cd gre-3000-vocab npm install npm run dev ``` 開発サーバーはデフォルトで http://127.0.0.1:43173 で実行されます。 ### プロダクションビルド ```bash npm run build npm run preview ``` ビルド成果物は dist/ ディレクトリにあり、任意の静的ホストにデプロイ可能です。 ### デスクトップアプリ GitHub ReleasesからmacOSインストーラーをダウンロードするか、ローカルで `npm run desktop` を実行してウィンドウを直接開きます。`npm run pack:mac` / `npm run pack:linux` でパッケージングして配布します。 ## 注意事項 - デバイスを変更しても学習進捗は同期されません（データがブラウザのローカルに保存されるため）。 - スマートフォンのホーム画面へのインストールにはHTTPSが必要です（localhostを除く）。 - macOSインストーラーはAppleの公証を受けていないため、初回起動時にシステムにブロックされる場合があります。ターミナルで `xattr -cr` コマンドを実行して解除してください。 ## まとめ GRE鎮考3000は、機能が充実し、設計が優れたGRE語彙学習ツールです。PWAのオフライン機能とインストール可能性を最大限に活用し、デスクトップアプリのサポートも提供しています。エビングハウス復習アルゴリズムはユーザーの回答パフォーマンスを考慮しており、固定間隔よりも柔軟です。単語帳の出典は明確で、解析プロセスも透明です。体系的にGRE語彙を暗記する必要がある受験生に適しています。