fnva 0.0.4 → 0.0.5

package/README.md

@@ -1,73 +1,50 @@
-# 环境切换工具 (fnva)
+# fnva - Fast Node Version Manager for Java
 
-跨平台环境切换工具，支持 Java 和 LLM 环境配置管理。
+类似 fnm 的跨平台 Java 环境管理工具，支持默认环境设置和自动加载。
 
 ## 功能特性
 
 - ✅ **Java 环境管理**：快速切换不同版本的 JDK
+- ✅ **默认环境支持**：类似 fnm，支持设置默认 Java 环境
+- ✅ **自动加载**：新 Shell 会话自动加载默认环境
+- ✅ **智能扫描**：高效扫描系统 Java 安装，支持自定义路径
 - ✅ **LLM 环境管理**：支持多 LLM 提供商配置切换
 - ✅ **跨平台支持**：Windows、macOS、Linux
 - ✅ **多 Shell 支持**：bash、zsh、fish、PowerShell、CMD
-- ✅ **自动扫描**：自动检测系统中的 Java 安装
+- ✅ **配置化扫描**：支持配置文件和环境变量自定义扫描路径
+- ✅ **高效去重**：智能去除重复的 Java 环境条目
 - ✅ **环境变量引用**：支持 `${VAR_NAME}` 格式引用系统环境变量
 
 ## 安装
 
-### 通过 npm 安装（推荐）
-
-```bash
-# 全局安装
-npm install -g fnva
-
-# 或使用 yarn
-yarn global add fnva
-
-# 或使用 pnpm
-pnpm add -g fnva
-```
-
-安装完成后，可以直接使用 `fnva` 命令。
-
-### 从源码构建
-
-#### 本地构建（当前平台）
+### 从源码构建（推荐）
 
 ```bash
 git clone <repository-url>
-cd cool-utils
-npm run build
+cd fnva
+cargo build --release
 ```
 
-编译后的二进制文件位于 `platforms/<platform>/fnva`。
-
-#### 构建所有平台
-
-项目使用 GitHub Actions 自动构建所有平台的二进制文件。当创建版本标签时，会自动构建并发布到 npm。
+### 通过 Cargo 安装
 
-**手动触发构建：**
-1. 在 GitHub 上创建新的 Release 标签（例如 `v0.1.0`）
-2. GitHub Actions 会自动构建所有平台
-3. 构建完成后自动发布到 npm
-
-**本地构建所有平台（需要交叉编译工具）：**
 ```bash
-npm run build:all
+cargo install --path .
 ```
 
-注意：需要安装 `cross` 工具：`cargo install cross`
-
 ### 添加到 PATH
 
-将二进制文件复制到系统 PATH 中，或创建符号链接：
+将二进制文件复制到系统 PATH 中：
 
 ```bash
 # Linux/macOS
-sudo ln -s $(pwd)/target/release/fnva /usr/local/bin/fnva
+sudo cp target/release/fnva /usr/local/bin/fnva
 
 # 或添加到 ~/.bashrc 或 ~/.zshrc
 export PATH="$PATH:$(pwd)/target/release"
 ```
 
+Windows 用户需要将 `target\release\fnva.exe` 添加到 PATH 环境变量中。
+
 ## 使用方法
 
 ### Java 环境管理
@@ -78,12 +55,6 @@ export PATH="$PATH:$(pwd)/target/release"
 fnva java list
 ```
 
-#### 扫描系统中的 Java 安装
-
-```bash
-fnva java scan
-```
-
 #### 添加 Java 环境
 
 ```bash
@@ -93,11 +64,36 @@ fnva java add --name jdk-17 --home /usr/lib/jvm/java-17-openjdk --description "O
 #### 切换到 Java 环境
 
 ```bash
-# 自动检测 shell
+# Bash / Zsh
 eval "$(fnva java use jdk-17)"
 
-# 指定 shell
-eval "$(fnva java use jdk-17 --shell bash)"
+# Fish
+fnva java use jdk-17 --shell fish | source
+
+# PowerShell
+fnva java use jdk-17 --shell powershell | Invoke-Expression
+
+# CMD
+fnva java use jdk-17 --shell cmd > %TEMP%\fnva_use.cmd && call %TEMP%\fnva_use.cmd
+```
+
+#### 设置默认 Java 环境（类似 fnm）
+
+```bash
+# 设置默认环境
+fnva java default jdk-21
+
+# 查看当前默认环境
+fnva java default
+
+# 清除默认设置
+fnva java default --unset
+```
+
+#### 查看当前激活的环境
+
+```bash
+fnva java current
 ```
 
 #### 删除 Java 环境
@@ -106,6 +102,52 @@ eval "$(fnva java use jdk-17 --shell bash)"
 fnva java remove jdk-17
 ```
 
+#### 扫描系统中的 Java 安装
+
+```bash
+fnva java scan
+```
+
+**扫描功能详解：**
+
+**基础扫描：**
+- 自动检测系统标准 Java 安装路径
+- 扫描用户主目录下的 `.fnva/java-packages`
+- 检查 PATH 环境变量中的 Java 可执行文件
+
+**自定义扫描路径：**
+
+1. **配置文件方式**（推荐）：
+   ```toml
+   # ~/.fnva/config.toml
+   custom_java_scan_paths = [
+       "D:\\tools\\java",
+       "/opt/custom/java",
+       "/home/user/my-jdks"
+   ]
+   ```
+
+2. **环境变量方式**：
+   ```bash
+   # 临时添加扫描路径
+   export FNVA_SCAN_PATHS="/path/to/jdk1:/path/to/jdk2"
+   fnva java scan
+
+   # Windows
+   set FNVA_SCAN_PATHS=D:\tools\java;E:\other\java
+   fnva java scan
+   ```
+
+**扫描性能：**
+- 🔒 **安全**：只扫描指定路径，不进行全盘搜索
+- ⚡ **快速**：使用高效的去重算法，避免重复处理
+- 🎯 **精确**：智能识别 Java 安装，过滤无效路径
+
+**支持的扫描路径：**
+- Windows：`C:\Program Files\Java`、`C:\Program Files\Eclipse Adoptium` 等
+- macOS：`/Library/Java/JavaVirtualMachines`、`/opt/homebrew/Caskroom` 等
+- Linux：`/usr/lib/jvm`、`/opt/java`、`/usr/local/java` 等
+
 ### LLM 环境管理
 
 #### 列出所有 LLM 环境
@@ -209,20 +251,51 @@ provider = "openai"
 api_key = "${OPENAI_API_KEY}"  # 从系统环境变量读取
 ```
 
-## Shell 集成
+## Shell 集成（fnm 风格）
+
+### PowerShell（推荐）
+
+在你的 PowerShell Profile 中添加以下内容以启用 fnm 风格的自动环境切换：
+
+```powershell
+# fnva 环境集成（类似 fnm env）
+fnva env env --shell powershell | Out-String | Invoke-Expression
+```
+
+#### 功能特性
+
+- **自动加载默认环境**：新 PowerShell 会话自动加载设置的默认 Java 环境
+- **环境持久化**：重启 PowerShell 后自动恢复上次的 Java 环境
+- **智能切换函数**：提供 `fnva java use` 交互式切换功能
+- **Shell 函数集成**：自动添加 PowerShell 函数用于环境切换
+
+#### 使用示例
+
+```powershell
+# 1. 设置默认环境
+fnva java default jdk21
+
+# 2. 重启 PowerShell 后会自动加载默认环境
+# 显示: "Loading default Java environment: jdk21"
+
+# 3. 交互式切换
+fnva java use jdk17
+
+# 4. 查看当前环境
+fnva java current
+```
 
 ### Bash/Zsh
 
 在 `~/.bashrc` 或 `~/.zshrc` 中添加：
 
 ```bash
-# 快速切换 Java 环境
+# fnva 环境集成
+eval "$(fnva env env --shell bash)"
+
+# 或使用别名快速切换
 alias java17='eval "$(fnva java use jdk-17)"'
 alias java11='eval "$(fnva java use jdk-11)"'
-
-# 快速切换 LLM 环境
-alias llm-openai='eval "$(fnva llm use openai-dev)"'
-alias llm-anthropic='eval "$(fnva llm use anthropic-prod)"'
 ```
 
 ### Fish
@@ -230,31 +303,79 @@ alias llm-anthropic='eval "$(fnva llm use anthropic-prod)"'
 在 `~/.config/fish/config.fish` 中添加：
 
 ```fish
+# fnva 环境集成
+fnva env env --shell fish | source
+
+# 或定义函数
 function java17
     fnva java use jdk-17 | source
 end
 
-function llm-openai
-    fnva llm use openai-dev | source
+function java11
+    fnva java use jdk-11 | source
 end
 ```
 
-### PowerShell
+## 工作原理
 
-在 `$PROFILE` 中添加：
+### 默认环境管理
 
-```powershell
-function Switch-Java {
-    param([string]$Name)
-    fnva java use $Name | Invoke-Expression
-}
-
-function Switch-Llm {
-    param([string]$Name)
-    fnva llm use $Name | Invoke-Expression
-}
+fnva 类似 fnm 的工作方式：
+
+1. **设置默认环境**：
+   ```bash
+   fnva java default jdk21
+   ```
+
+2. **Shell 集成**：在 Shell Profile 中添加环境切换脚本
+
+3. **自动加载**：新 Shell 会话自动检测并加载默认环境
+
+4. **环境持久化**：环境配置保存在 `~/.fnva/config.toml` 中
+
+### 配置文件位置
+
+- **Linux/macOS**: `~/.fnva/config.toml`
+- **Windows**: `%USERPROFILE%\.fnva\config.toml`
+
+#### 配置示例
+
+**基础配置：**
+```toml
+default_java_env = "jdk21.0.6"
+
+[[java_environments]]
+name = "jdk21.0.6"
+java_home = "E:\\env\\jdks\\jdk-21.0.6"
+description = "Java 21.0.6 LTS"
 ```
 
+**自定义扫描路径配置：**
+```toml
+# 自定义 Java 扫描路径
+custom_java_scan_paths = [
+    "D:\\tools\\java",
+    "/opt/custom/java",
+    "/home/user/my-jdks"
+]
+```
+
+**环境变量支持：**
+```bash
+# Linux/macOS
+export FNVA_SCAN_PATHS="/path/to/jdk1:/path/to/jdk2"
+
+# Windows
+set FNVA_SCAN_PATHS=D:\tools\java;E:\other\java
+```
+
+**支持的扫描路径类型：**
+- 系统标准 Java 安装目录
+- 用户主目录下的 `.fnva/java-packages`
+- 配置文件中的自定义路径
+- 环境变量 `FNVA_SCAN_PATHS` 指定的路径
+- PATH 环境变量中的 Java 可执行文件
+
 ## 许可证
 
 MIT License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fnva",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "跨平台环境切换工具，支持 Java 和 LLM 环境配置",
   "author": "protagonistss",
   "license": "MIT",

package/platforms/skip.txt

@@ -0,0 +1 @@
+Skipping cross-compiled build for aarch64-unknown-linux-gnu