From c323a91a1e5ae419520c868dd73e0a66ff8e5cd3 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
<161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Mon, 2 Mar 2026 07:03:54 +0000
Subject: [PATCH 1/2] docs: update README and highlight project characteristics
- Update macOS support status to "Supported"
- Highlight 300ms JDK scanning performance
- Add dedicated PERFORMANCE.md and PERFORMANCE_jp.md technical docs
- Provide full Chinese (README_zh.md) and Japanese (README_jp.md) translations
- Update landing page with Japanese support and latest status
- Emphasize Windows optimization and comparison with JEnv-for-Windows
Co-authored-by: WhyWhatHow <33270266+WhyWhatHow@users.noreply.github.com>
---
README.md | 24 +++---
README_jp.md | 175 ++++++++++++++++++++++++++++++++++++++
README_zh.md | 181 ++++++++++++++++++++++++++++++++++++++++
doc/PERFORMANCE.md | 60 +++++++++++++
doc/PERFORMANCE_jp.md | 60 +++++++++++++
landing-page/js/app.js | 93 ++++++++++++++++++++-
landing-page/js/i18n.js | 77 ++++++++++++++++-
7 files changed, 655 insertions(+), 15 deletions(-)
create mode 100644 README_jp.md
create mode 100644 README_zh.md
create mode 100644 doc/PERFORMANCE.md
create mode 100644 doc/PERFORMANCE_jp.md
diff --git a/README.md b/README.md
index 34ee3f0..5d66cfd 100644
--- a/README.md
+++ b/README.md
@@ -7,22 +7,24 @@
-**🚀 [Quick Start with Landing Page](https://jenv-win.vercel.app)** - One-click downloads with automatic platform detection (Windows/Linux/macOS) • Multi-language support (EN/中文) • Updated bi-weekly
+English | [中文](README_zh.md) | [日本語](README_jp.md)
+
+**🚀 [Quick Start with Landing Page](https://jenv-win.vercel.app)** - One-click downloads with automatic platform detection (Windows/Linux/macOS) • Multi-language support (EN/中文/日本語) • Updated bi-weekly
## Recent Updates (v0.6.7)
### 🚀 Performance Improvements
-- **Ultra-fast JDK scanning**: Reduced scanning time from 3 seconds to 300ms (90% improvement)
+- **Ultra-fast JDK scanning**: Reduced scanning time from 3 seconds to 300ms (90% improvement). [Read more about how we did it.](doc/PERFORMANCE.md)
- **Concurrent processing**: Implemented Dispatcher-Worker model with goroutines
- **Smart filtering**: Aggressive pre-filtering to skip unnecessary directories
- **Progress tracking**: Real-time scanning progress and detailed statistics
### ✅ Cross-Platform Support
+- **macOS support completed**: Full macOS compatibility (Intel/Apple Silicon)
- **Linux support completed**: Full Linux compatibility with multi-shell support
- **Windows optimization**: Enhanced path validation and compatibility fixes
-- **macOS preparation**: Infrastructure ready for macOS support (coming soon)
### 🔧 Technical Enhancements
- **Java path validation**: Improved Windows JDK detection reliability
@@ -83,7 +85,7 @@ different Java versions, add new Java installations, and manage your Java enviro
- **Cross-Platform Support**
- Windows support (✅ Complete)
- Linux support (✅ Complete)
- - macOS support (🚧 In Progress)
+ - macOS support (✅ Complete)
## Project Structure
```
@@ -266,17 +268,15 @@ Without root privileges, jenv will automatically use user-level configuration in
### Why was this project created?
-While Linux and macOS users have mature tools like `sdkman` and `jenv` for Java version management, Windows users have
-limited options. The existing [Jenv-forWindows](https://github.com/FelixSelter/JEnv-for-Windows) solution, while
-functional, faces performance issues on Windows 10 systems.
+While Linux and macOS users have mature tools like `sdkman` and the original `jenv` (bash-based) for Java version management, Windows users have historically had limited, often sub-optimal options. Existing solutions like [JEnv-for-Windows](https://github.com/FelixSelter/JEnv-for-Windows) can face significant performance bottlenecks on modern Windows systems.
-This project was born out of two motivations:
+This project was born out of two key motivations:
-1. To create a fast, efficient Java version manager specifically optimized for Windows
-2. To explore AI-assisted development using tools like `cursor` and `Trae` while learning Go programming from scratch
+1. **Bridging the Windows Gap**: To provide Windows developers with a robust, high-performance Java version manager that matches (or exceeds) the experience found on Unix-like systems.
+2. **Performance First**: Achieving near-instant JDK scanning and switching, regardless of system size or complexity.
+3. **Modern Engineering**: Exploring AI-assisted development (using `Cursor` and `Trae`) to build a modern, cross-platform tool in Go from the ground up.
-The goal is to provide Windows developers with a robust, performant solution for managing multiple Java environments,
-similar to what Linux and macOS users already enjoy.
+Our goal is to be the **de facto Java environment manager for Windows**, while providing a seamless, unified experience for developers who work across Windows, Linux, and macOS.
### How it works?
diff --git a/README_jp.md b/README_jp.md
new file mode 100644
index 0000000..8aa9883
--- /dev/null
+++ b/README_jp.md
@@ -0,0 +1,175 @@
+
+
+
+# Jenv: Java 環境マネージャー
+
+
+
+
+
+[English](README.md) | [中文](README_zh.md) | 日本語
+
+**🚀 [ランディングページでクイックスタート](https://jenv-win.vercel.app)** - プラットフォーム自動検出（Windows/Linux/macOS）によるワンクリックダウンロード • 多言語対応（EN/中文/日本語） • 隔週更新
+
+
+
+
+# Jenv: Java 版本管理工具
+
+
+
+
+
+[English](README.md) | 中文 | [日本語](README_jp.md)
+
+**🚀 [通过落地页快速开始](https://jenv-win.vercel.app)** - 一键下载，自动检测平台（Windows/Linux/macOS） • 多语言支持（EN/中文/日本語） • 每两周更新
+
+
目前支持:
- ✅ Windows 10/11
- ✅ Linux (多发行版)
- ✅ macOS (Apple Silicon & Intel)
'
}
+ ],
+ 'jp': [
+ {
+ question: 'JDK とは何ですか？必要ですか？',
+ answer: 'JDK (Java Development Kit) は、Java 用のソフトウェア開発キットです。Java プログラムを作成して実行するために必要です。
'
+ },
+ {
+ question: 'どの JDK バージョンを選べばよいですか？',
+ answer: '- JDK 8: レガシープロジェクト
- JDK 11: 初心者に推奨 ⭐
- JDK 17: モダンな機能
- JDK 21: 最新の LTS
'
+ },
+ {
+ question: 'なぜ JEnv が必要なのですか？',
+ answer: '以下のことが必要な場合：
- 複数の Java バージョンを保持する
- 異なるプロジェクトで JDK を素早く切り替える
- 手動の環境変数設定を避ける
JEnv を使えば非常に簡単になります。
'
+ },
+ {
+ question: 'どの OS がサポートされていますか？',
+ answer: '現在：
- ✅ Windows 10/11
- ✅ Linux (各種ディストリビューション)
- ✅ macOS (Apple Silicon & Intel)
'
+ }
]
};
@@ -629,8 +702,19 @@ function setupEventListeners() {
* Toggle language
*/
function toggleLanguage() {
- currentLang = currentLang === 'en' ? 'zh' : 'en';
- document.getElementById('lang-toggle').textContent = currentLang === 'en' ? '中文' : 'EN';
+ if (currentLang === 'en') {
+ currentLang = 'zh';
+ } else if (currentLang === 'zh') {
+ currentLang = 'jp';
+ } else {
+ currentLang = 'en';
+ }
+
+ const langBtn = document.getElementById('lang-toggle');
+ if (currentLang === 'en') langBtn.textContent = '中文';
+ else if (currentLang === 'zh') langBtn.textContent = '日本語';
+ else if (currentLang === 'jp') langBtn.textContent = 'EN';
+
document.documentElement.lang = currentLang;
// Re-translate page
@@ -675,6 +759,11 @@ async function init() {
currentLang = getLanguage();
document.documentElement.lang = currentLang;
+ const langBtn = document.getElementById('lang-toggle');
+ if (currentLang === 'en') langBtn.textContent = '中文';
+ else if (currentLang === 'zh') langBtn.textContent = '日本語';
+ else if (currentLang === 'jp') langBtn.textContent = 'EN';
+
// Load data
appData = await loadData();
diff --git a/landing-page/js/i18n.js b/landing-page/js/i18n.js
index be9a628..8446e04 100644
--- a/landing-page/js/i18n.js
+++ b/landing-page/js/i18n.js
@@ -147,6 +147,79 @@ const translations = {
// Mobile
mobileTitle: '请使用桌面浏览器访问',
mobileMessage: '为了获得最佳体验，请在桌面电脑上打开此页面'
+ },
+
+ jp: {
+ // Meta
+ title: 'JEnv - Java バージョン管理ツール',
+ description: '高速で簡単な Java バージョン管理ツール',
+
+ // Hero
+ detected: '検出',
+ tagline: '3ステップでJDKをインストール、手動のパス設定は不要',
+
+ // Typing effect messages
+ typingMessages: [
+ '300ms で JDK バージョンを切り替え',
+ '手動の環境変数設定は不要',
+ 'Windows、macOS、Linux で動作'
+ ],
+
+ // Quick Start
+ quickStart: '🚀 クイックスタート',
+ downloadJenv: 'JEnv をダウンロード',
+ downloadJdk: 'JDK をダウンロード',
+ install: 'インストールと使用',
+ version: 'バージョン',
+ downloading: '読み込み中...',
+ download: 'ダウンロード',
+ notAvailable: 'お使いのプラットフォームでは利用できません',
+
+ // JDK Selection
+ selectDistribution: 'ディストリビューションを選択',
+ selectDistributions: 'ディストリビューションを選択',
+ selectVersion: 'バージョン',
+ selectVersions: 'バージョンを選択',
+ yourPlatform: 'プラットフォーム',
+ autoDetected: '自動検出',
+ jdkHint: '💡 迷っていますか？JDK 11 はほとんどの初心者に最適です',
+ distHint: '💡 1つ以上の JDK ディストリビューションを選択してください',
+ versionHint: '💡 推奨: JDK 11 または 17',
+ selected: '選択済み',
+ packages: 'パッケージ',
+ downloadSelected: '選択したものをダウンロード',
+
+ // Features
+ whyJenv: 'なぜ JEnv なのか？',
+ feature1Title: '高速切り替え',
+ feature1Desc: 'シンボリックリンクベースで、300ms で JDK を切り替え',
+ feature2Title: 'Windows 最適化',
+ feature2Desc: 'Windows 10/11 に最適化、権限を自動処理',
+ feature3Title: 'モダンな体験',
+ feature3Desc: 'カラフルな CLI、ライト/ダークテーマをサポート',
+
+ // FAQ
+ faqTitle: 'よくある質問',
+
+ // Footer
+ footerText: 'JEnv - Java バージョン管理を簡単に',
+ license: 'ライセンス',
+ lastUpdated: '最終更新日',
+
+ // Actions
+ copy: 'コピー',
+ copied: 'クリップボードにコピーされました',
+ copyFailed: 'コピーに失敗しました。手動でコピーしてください',
+ downloadStarted: 'ダウンロードを開始しました...',
+
+ // Errors
+ loading: '読み込み中...',
+ errorLoading: 'データの読み込みに失敗しました。ページを更新してください',
+ initError: '初期化に失敗しました。ページを更新してください',
+
+ // Mobile
+ mobileTitle: 'デスクトップブラウザを使用してください',
+ mobileMessage: '最適な体験のために、デスクトップコンピュータでこのページを開いてください'
}
};
@@ -162,7 +235,9 @@ function t(key, lang = 'en') {
*/
function getLanguage() {
const browserLang = navigator.language || navigator.userLanguage;
- return browserLang.toLowerCase().includes('zh') ? 'zh' : 'en';
+ if (browserLang.toLowerCase().includes('zh')) return 'zh';
+ if (browserLang.toLowerCase().includes('ja')) return 'jp';
+ return 'en';
}
// Export for use in other scripts
From 8e3b1f8893eb707b9b4d7e687168ffbc3cbbada9 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
<161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Mon, 2 Mar 2026 07:11:33 +0000
Subject: [PATCH 2/2] docs: update version to v0.6.9 and enhance performance
documentation
- Update all README files (EN, ZH, JP) to version v0.6.9
- Add detailed PERFORMANCE_zh.md for Chinese users
- Enhance all performance docs with detailed architecture and sequence Mermaid diagrams
- Improve cross-linking between language-specific documentation files
- Ensure consistent highlighting of project characteristics across all languages
Co-authored-by: WhyWhatHow <33270266+WhyWhatHow@users.noreply.github.com>
---
README.md | 4 +-
README_jp.md | 4 +-
README_zh.md | 6 +-
doc/PERFORMANCE.md | 80 ++++++++++++++++++++++++---
doc/PERFORMANCE_jp.md | 80 ++++++++++++++++++++++++---
doc/PERFORMANCE_zh.md | 124 ++++++++++++++++++++++++++++++++++++++++++
6 files changed, 273 insertions(+), 25 deletions(-)
create mode 100644 doc/PERFORMANCE_zh.md
diff --git a/README.md b/README.md
index 5d66cfd..4d8b5cb 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
-
+
English | [中文](README_zh.md) | [日本語](README_jp.md)
@@ -13,7 +13,7 @@ English | [中文](README_zh.md) | [日本語](README_jp.md)
-## Recent Updates (v0.6.7)
+## Recent Updates (v0.6.9)
### 🚀 Performance Improvements
- **Ultra-fast JDK scanning**: Reduced scanning time from 3 seconds to 300ms (90% improvement). [Read more about how we did it.](doc/PERFORMANCE.md)
diff --git a/README_jp.md b/README_jp.md
index 8aa9883..d2178d1 100644
--- a/README_jp.md
+++ b/README_jp.md
@@ -5,7 +5,7 @@
-
+
[English](README.md) | [中文](README_zh.md) | 日本語
@@ -13,7 +13,7 @@
-## 最新のアップデート (v0.6.7)
+## 最新のアップデート (v0.6.9)
### 🚀 パフォーマンスの向上
- **超高速 JDK スキャン**: スキャン時間を 3 秒から 300ms に短縮（90% の向上）。[詳細はこちら](doc/PERFORMANCE_jp.md)
diff --git a/README_zh.md b/README_zh.md
index 19ee3bc..f21aee4 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -5,7 +5,7 @@
-
+
[English](README.md) | 中文 | [日本語](README_jp.md)
@@ -13,10 +13,10 @@
-## 最新更新 (v0.6.7)
+## 最新更新 (v0.6.9)
### 🚀 性能提升
-- **超快 JDK 扫描**：扫描时间从 3 秒缩短至 300ms（提升 90%）。[阅读更多技术细节](doc/PERFORMANCE.md)
+- **超快 JDK 扫描**：扫描时间从 3 秒缩短至 300ms（提升 90%）。[阅读更多技术细节](doc/PERFORMANCE_zh.md)
- **并发处理**：使用 goroutines 实现了 Dispatcher-Worker 模型
- **智能过滤**：积极的预过滤，跳过不必要的目录
- **进度追踪**：实时扫描进度和详细统计数据
diff --git a/doc/PERFORMANCE.md b/doc/PERFORMANCE.md
index 3e4e133..da19548 100644
--- a/doc/PERFORMANCE.md
+++ b/doc/PERFORMANCE.md
@@ -1,6 +1,6 @@
# High-Performance JDK Scanning in JEnv
-English | [日本語](PERFORMANCE_jp.md)
+English | [中文](PERFORMANCE_zh.md) | [日本語](PERFORMANCE_jp.md)
One of the standout features of JEnv is its ultra-fast JDK scanning capability. While traditional tools might take several seconds to traverse your file system looking for Java installations, JEnv typically completes this task in **under 300ms**—a 10x improvement over conventional methods.
@@ -15,6 +15,38 @@ Scanning a large disk (like `C:\` on Windows or `/` on Linux) for JDK installati
On a typical developer machine with hundreds of thousands of files, this can easily take 3-5 seconds or more.
+## Architecture Overview
+
+JEnv uses a multi-layered approach to maximize performance, combining concurrent processing with intelligent search space reduction.
+
+```mermaid
+graph TD
+ Start[jenv scan] --> Dispatcher[Dispatcher Goroutine]
+ Dispatcher --> TaskQueue[Task Queue]
+
+ subgraph Workers[Worker Pool]
+ W1[Worker 1]
+ W2[Worker 2]
+ WN[Worker N]
+ end
+
+ TaskQueue --> W1
+ TaskQueue --> W2
+ TaskQueue --> WN
+
+ W1 --> Filter{Aggressive Filter}
+ Filter -- Skip --> Dispatcher
+ Filter -- Proceed --> Validate{Validate JDK}
+
+ Validate -- Found --> Result[JDK Found]
+ Validate -- Not Found --> SubDirs[Extract Subdirs]
+
+ Result --> Dispatcher
+ SubDirs --> Dispatcher
+
+ Dispatcher --> FinalResult[Scan Result]
+```
+
## The Solution: Dispatcher-Worker Model
JEnv employs a sophisticated **Dispatcher-Worker** model implemented using Go's lightweight goroutines and channels.
@@ -22,12 +54,42 @@ JEnv employs a sophisticated **Dispatcher-Worker** model implemented using Go's
### 1. Concurrent Processing
Instead of scanning one directory at a time, JEnv spawns a pool of worker goroutines (typically `runtime.NumCPU() * 2`).
-- **Dispatcher**: Manages a queue of directories to be scanned. It feeds tasks to workers and collects results.
-- **Workers**: Pick up a directory path, check if it's a JDK, and if not, return its subdirectories to the dispatcher to be added to the queue.
-
-This allows JEnv to saturate the I/O pipeline and utilize multiple CPU cores to process directory metadata in parallel.
-
-### 2. Aggressive Pre-Filtering
+- **Dispatcher**: Manages a queue of directories to be scanned. It feeds tasks to workers and collects results. It maintains state and decides when the scan is complete.
+- **Workers**: Pick up a directory path, perform filtering and validation, and if subdirectories need scanning, they are passed back to the dispatcher.
+
+### 2. Scanning Sequence
+
+The interaction between components follows a highly parallelized pattern:
+
+```mermaid
+sequenceDiagram
+ participant D as Dispatcher
+ participant Q as Task Queue
+ participant W as Workers
+ participant FS as File System
+
+ D->>Q: Push initial directory
+ loop While tasks pending
+ Q->>W: Assign task
+ W->>W: Apply Filters
+ alt Path should be scanned
+ W->>FS: Read directory entries
+ FS-->>W: Entries
+ W->>W: Validate JDK (bin/javac)
+ alt JDK Found
+ W-->>D: Result: JDK info
+ else Subdirs found
+ W-->>D: Result: New tasks (subdirs)
+ D->>Q: Push subdirs to queue
+ end
+ else Path filtered
+ W-->>D: Task complete (skipped)
+ end
+ end
+ D->>D: Aggregate Results
+```
+
+### 3. Aggressive Pre-Filtering
The fastest way to scan a directory is to not scan it at all. JEnv uses a built-in "blacklist" of directories that are known *never* to contain JDKs.
Before a worker even opens a directory, it checks its name against patterns like:
@@ -38,10 +100,10 @@ Before a worker even opens a directory, it checks its name against patterns like
By skipping these massive directory trees, JEnv avoids millions of unnecessary syscalls.
-### 3. Smart Depth Limiting
+### 4. Smart Depth Limiting
JDKs are rarely buried 20 levels deep. JEnv uses an intelligent depth-limiting strategy (typically capped at 5 levels from the search root) to prevent the scanner from "getting lost" in deep application data folders, while still finding JDKs in standard locations.
-### 4. Optimized Path Validation
+### 5. Optimized Path Validation
JEnv doesn't just look for any file; it specifically validates the structure of a JDK (checking for `bin/javac`). This validation is highly optimized to minimize disk hits.
## Performance Benchmark
diff --git a/doc/PERFORMANCE_jp.md b/doc/PERFORMANCE_jp.md
index f3a6322..7cd81a9 100644
--- a/doc/PERFORMANCE_jp.md
+++ b/doc/PERFORMANCE_jp.md
@@ -1,6 +1,6 @@
# JEnv における高性能 JDK スキャン
-[English](PERFORMANCE.md) | 日本語
+[English](PERFORMANCE.md) | [中文](PERFORMANCE_zh.md) | 日本語
JEnv の際立った機能の 1 つは、その超高速な JDK スキャン機能です。従来のツールでは Java インストールを探すためにファイルシステムのトラバースに数秒かかることがありますが、JEnv は通常、このタスクを **300ms 未満**で完了します。これは従来のプロセスと比較して 10 倍の向上です。
@@ -15,6 +15,38 @@ JDK インストールを求めて大きなディスク（Windows の `C:\` や
数十万のファイルがある一般的な開発者のマシンでは、これに 3〜5 秒、あるいはそれ以上かかることが容易にあります。
+## アーキテクチャの概要
+
+JEnv は、並列処理とインテリジェントな検索空間の削減を組み合わせることで、パフォーマンスを最大化する多層的なアプローチを採用しています。
+
+```mermaid
+graph TD
+ Start[jenv scan] --> Dispatcher[Dispatcher Goroutine]
+ Dispatcher --> TaskQueue[Task Queue]
+
+ subgraph Workers[ワーカープール]
+ W1[ワーカー 1]
+ W2[ワーカー 2]
+ WN[ワーカー N]
+ end
+
+ TaskQueue --> W1
+ TaskQueue --> W2
+ TaskQueue --> WN
+
+ W1 --> Filter{積極的フィルタ}
+ Filter -- スキップ --> Dispatcher
+ Filter -- 続行 --> Validate{JDK 検証}
+
+ Validate -- 発見 --> Result[JDK 発見]
+ Validate -- 未発見 --> SubDirs[サブディレクトリ抽出]
+
+ Result --> Dispatcher
+ SubDirs --> Dispatcher
+
+ Dispatcher --> FinalResult[スキャン結果]
+```
+
## 解決策：Dispatcher-Worker モデル
JEnv は、Go の軽量な goroutine とチャネルを使用して実装された高度な **Dispatcher-Worker** モデルを採用しています。
@@ -22,12 +54,42 @@ JEnv は、Go の軽量な goroutine とチャネルを使用して実装され
### 1. 並列処理
ディレクトリを 1 つずつスキャンする代わりに、JEnv はワーカー goroutine のプール（通常は `runtime.NumCPU() * 2`）を生成します。
-- **Dispatcher（ディスパッチャー）**: スキャンするディレクトリのキューを管理します。ワーカーにタスクを供給し、結果を収集します。
-- **Worker（ワーカー）**: ディレクトリパスを取得し、それが JDK であるかを確認します。そうでない場合は、そのサブディレクトリをディスパッチャーに返し、キューに追加させます。
-
-これにより、JEnv は I/O パイプラインを飽和させ、複数の CPU コアを活用してディレクトリメタデータを並列に処理できます。
-
-### 2. 積極的なプリフィルタリング
+- **Dispatcher（ディスパッチャー）**: スキャンするディレクトリのキューを管理します。ワーカーにタスクを供給し、結果を収集します。スキャン全体の状態を維持し、完了を判断します。
+- **Worker（ワーカー）**: ディレクトリパスを取得し、フィルタリングと検証を行います。さらにスキャンが必要なサブディレクトリがある場合は、ディスパッチャーに返します。
+
+### 2. スキャンシーケンス
+
+コンポーネント間の相互作用は、高度に並列化されたパターンに従います：
+
+```mermaid
+sequenceDiagram
+ participant D as Dispatcher
+ participant Q as Task Queue
+ participant W as Workers
+ participant FS as File System
+
+ D->>Q: 初期ディレクトリをプッシュ
+ loop タスクが残っている間
+ Q->>W: タスクを割り当て
+ W->>W: フィルタを適用
+ alt パスをスキャンすべき場合
+ W->>FS: ディレクトリエントリを読み込む
+ FS-->>W: エントリ
+ W->>W: JDK 検証 (bin/javac)
+ alt JDK 発見
+ W-->>D: 結果: JDK 情報
+ else サブディレクトリ発見
+ W-->>D: 結果: 新規タスク (サブディレクトリ)
+ D->>Q: サブディレクトリをキューにプッシュ
+ end
+ else パスがフィルタリングされた場合
+ W-->>D: タスク完了 (スキップ)
+ end
+ end
+ D->>D: 結果を集約
+```
+
+### 3. 積極的なプリフィルタリング
ディレクトリをスキャンする最速の方法は、スキャンしないことです。JEnv は、JDK が含まれていないことがわかっているディレクトリの「ブラックリスト」を組み込んでいます。
ワーカーがディレクトリを開く前に、その名前を以下のパターンと照合します：
@@ -38,10 +100,10 @@ JEnv は、Go の軽量な goroutine とチャネルを使用して実装され
これらの巨大なディレクトリツリーをスキップすることで、JEnv は何百万もの不要な系统コールを回避します。
-### 3. スマートな深度制限
+### 4. スマートな深度制限
JDK が 20 レベルも深い場所に配置されることは稀です。JEnv はインテリジェントな深度制限戦略（通常、検索ルートから 5 レベルに制限）を使用して、スキャナーが深いアプリケーションデータフォルダで「迷子」になるのを防ぎつつ、標準的な場所にある JDK を確実に見つけます。
-### 4. 最適化されたパス検証
+### 5. 最適化されたパス検証
JEnv は単にファイルを探すだけではありません。JDK の構造を具体的に検証します（`bin/javac` の存在確認など）。この検証は、ディスクへのアクセスを最小限に抑えるよう高度に最適化されています。
## パフォーマンスベンチマーク
diff --git a/doc/PERFORMANCE_zh.md b/doc/PERFORMANCE_zh.md
new file mode 100644
index 0000000..5be51c4
--- /dev/null
+++ b/doc/PERFORMANCE_zh.md
@@ -0,0 +1,124 @@
+# JEnv 高性能 JDK 扫描机制
+
+[English](PERFORMANCE.md) | [日本語](PERFORMANCE_jp.md) | 中文
+
+JEnv 的核心亮点之一是其极速的 JDK 扫描能力。传统工具在遍历文件系统寻找 Java 安装路径时可能需要几秒钟，而 JEnv 通常在 **300 毫秒内** 即可完成——比常规方法快了 10 倍。
+
+本文将详细介绍实现这一性能的技术架构和优化策略。
+
+## 挑战
+
+在大型磁盘（如 Windows 的 `C:\` 或 Linux 的 `/`）中扫描 JDK 是一个 IO 密集型任务。传统的递归搜索存在以下问题：
+1. 访问每一个目录。
+2. 检查 `javac` 或其他 JDK 标志文件的存在。
+3. 串行操作，意味着每一步都会被磁盘延迟阻塞。
+
+在拥有数十万文件的典型开发机器上，这种方式轻松耗时 3-5 秒甚至更久。
+
+## 架构概览
+
+JEnv 采用多层优化方案，结合并发处理与智能搜索空间缩减，以实现性能最大化。
+
+```mermaid
+graph TD
+ Start[jenv scan] --> Dispatcher[Dispatcher Goroutine]
+ Dispatcher --> TaskQueue[Task Queue]
+
+ subgraph Workers[Worker Pool]
+ W1[Worker 1]
+ W2[Worker 2]
+ WN[Worker N]
+ end
+
+ TaskQueue --> W1
+ TaskQueue --> W2
+ TaskQueue --> WN
+
+ W1 --> Filter{Aggressive Filter}
+ Filter -- Skip --> Dispatcher
+ Filter -- Proceed --> Validate{Validate JDK}
+
+ Validate -- Found --> Result[JDK Found]
+ Validate -- Not Found --> SubDirs[Extract Subdirs]
+
+ Result --> Dispatcher
+ SubDirs --> Dispatcher
+
+ Dispatcher --> FinalResult[Scan Result]
+```
+
+## 核心方案：调度中心-工人模型 (Dispatcher-Worker)
+
+JEnv 利用 Go 语言轻量级的 Goroutines 和 Channels 实现了精妙的 **调度中心-工人** 并发模型。
+
+### 1. 并发处理
+JEnv 不会一次只扫描一个目录，而是启动一个工作协程池（通常为 `runtime.NumCPU() * 2`）。
+
+- **调度中心 (Dispatcher)**：管理待扫描目录的队列，向工人分配任务并收集结果。它维护扫描状态并决定何时结束扫描。
+- **工人 (Worker)**：获取目录路径，执行过滤和验证。如果发现子目录需要进一步扫描，则将其传回调度中心。
+
+这种模式让 JEnv 能够充分利用磁盘 I/O 带宽，并利用多核 CPU 并行处理目录元数据。
+
+### 2. 扫描时序
+
+各组件之间的交互遵循高度并行化的模式：
+
+```mermaid
+sequenceDiagram
+ participant D as Dispatcher
+ participant Q as Task Queue
+ participant W as Workers
+ participant FS as File System
+
+ D->>Q: 推送初始目录
+ loop 当仍有任务时
+ Q->>W: 分配任务
+ W->>W: 应用过滤规则
+ alt 路径应被扫描
+ W->>FS: 读取目录条目
+ FS-->>W: 条目列表
+ W->>W: 验证 JDK (bin/javac)
+ alt 发现 JDK
+ W-->>D: 返回结果: JDK 信息
+ else 发现子目录
+ W-->>D: 返回结果: 新任务 (子目录)
+ D->>Q: 将子目录推入队列
+ end
+ else 路径被过滤
+ W-->>D: 任务完成 (跳过)
+ end
+ end
+ D->>D: 汇总结果
+```
+
+### 3. 积极的预过滤 (Aggressive Pre-Filtering)
+扫描目录最快的方法就是“不扫描”。JEnv 内置了一份目录黑名单，这些目录被确定永远不会包含 JDK。
+
+在工人打开目录之前，会先根据以下模式检查目录名：
+- **系统目录**：`Windows`, `System32`, `$Recycle.Bin`, `/proc`, `/dev`。
+- **包管理器**：`node_modules`, `.m2`, `gradle`, `pip`, `anaconda`。
+- **IDE/编译产物**：`.git`, `.idea`, `.vscode`, `target`, `build`, `dist`。
+- **个人内容**：`Downloads`, `Documents`, `Pictures`, `Videos`。
+
+通过跳过这些庞大的目录树，JEnv 避免了数百万次不必要的系统调用。
+
+### 4. 智能深度限制
+JDK 很少会被埋在 20 层目录之下。JEnv 采用了智能深度限制策略（通常限制在搜索根目录下的 5 层内），防止扫描器在深层的应用数据文件夹中“迷失”，同时仍能准确找到标准路径下的 JDK。
+
+### 5. 优化的路径验证
+JEnv 不仅仅寻找文件，还会专门验证 JDK 的目录结构（如检查 `bin/javac`）。这一验证过程经过高度优化，旨在将磁盘访问次数降至最低。
+
+## 性能基准测试
+
+| 方法 | 耗时 (典型值) | 提升 |
+| :--- | :--- | :--- |
+| 常规递归扫描 | ~3,000ms | 基准 |
+| **JEnv (并发 + 过滤)** | **<300ms** | **快 90%** |
+
+## 总结
+
+通过将 Go 语言强大的并发原语与对 JDK 存储路径的先验知识相结合，JEnv 为管理 Java 环境提供了近乎瞬时的流畅体验。
+
+---
+
+*查看实现代码：[`src/internal/java/sdk.go`](../src/internal/java/sdk.go)。*