fnva 0.0.4 → 0.0.6

package/README.md

@@ -1,87 +1,141 @@
-# 环境切换工具 (fnva)
+# fnva - Fast Environment Version Alter
 
-跨平台环境切换工具，支持 Java 和 LLM 环境配置管理。
+跨平台环境管理工具，支持 Java、LLM 和 Claude Code 环境，具有默认环境设置和自动加载功能。
 
 ## 功能特性
 
 - ✅ **Java 环境管理**：快速切换不同版本的 JDK
 - ✅ **LLM 环境管理**：支持多 LLM 提供商配置切换
+- ✅ **Claude Code (CC) 环境管理**：专门为 Claude Code 设计的环境切换
+- ✅ **默认环境支持**：支持设置默认环境
+- ✅ **自动加载**：新 Shell 会话自动加载默认环境
+- ✅ **智能扫描**：高效扫描系统 Java 安装，支持自定义路径
 - ✅ **跨平台支持**：Windows、macOS、Linux
 - ✅ **多 Shell 支持**：bash、zsh、fish、PowerShell、CMD
-- ✅ **自动扫描**：自动检测系统中的 Java 安装
-- ✅ **环境变量引用**：支持 `${VAR_NAME}` 格式引用系统环境变量
+- ✅ **配置化扫描**：支持配置文件和环境变量自定义扫描路径
+- ✅ **高效去重**：智能去除重复的环境条目
 
 ## 安装
 
-### 通过 npm 安装（推荐）
+### 方式一：通过 npm 安装（推荐）
 
 ```bash
 # 全局安装
 npm install -g fnva
 
-# 或使用 yarn
+# 使用 yarn
 yarn global add fnva
 
-# 或使用 pnpm
+# 使用 pnpm
 pnpm add -g fnva
 ```
 
-安装完成后，可以直接使用 `fnva` 命令。
+### 方式二：从 Releases 下载二进制文件
 
-### 从源码构建
+1. 访问 [GitHub Releases](https://github.com/your-repo/fnva/releases)
+2. 下载对应平台的二进制文件：
+   - Windows: `fnva-win32-x64.exe`
+   - macOS: `fnva-darwin-x64` 或 `fnva-darwin-arm64`
+   - Linux: `fnva-linux-x64`
 
-#### 本地构建（当前平台）
+3. 将二进制文件重命名为 `fnva`（Windows 下为 `fnva.exe`）
+
+4. 添加到 PATH 环境变量（详见下面的配置步骤）
+
+### 方式三：从源码构建（开发者）
+
+**前置要求：**
+- **Rust** 1.70+
+- **系统依赖**：
+  - Linux: `pkg-config`, `libssl-dev`, `build-essential`
+  - macOS: Xcode Command Line Tools
+  - Windows: Microsoft Visual Studio C++ Build Tools
 
 ```bash
-git clone <repository-url>
-cd cool-utils
-npm run build
-```
+# 克隆仓库
+git clone git@github.com:Protagonistss/fnva.git
+cd fnva
 
-编译后的二进制文件位于 `platforms/<platform>/fnva`。
+# 构建
+cargo build --release
 
-#### 构建所有平台
+# 二进制文件位置：
+# Windows: target\release\fnva.exe
+# macOS/Linux: target/release/fnva
+```
 
-项目使用 GitHub Actions 自动构建所有平台的二进制文件。当创建版本标签时，会自动构建并发布到 npm。
+### 安装后配置
 
-**手动触发构建：**
-1. 在 GitHub 上创建新的 Release 标签（例如 `v0.1.0`）
-2. GitHub Actions 会自动构建所有平台
-3. 构建完成后自动发布到 npm
+#### 1. 验证安装
 
-**本地构建所有平台（需要交叉编译工具）：**
 ```bash
-npm run build:all
+fnva --version
 ```
 
-注意：需要安装 `cross` 工具：`cargo install cross`
+#### 2. Shell 集成
+
+为了获得最佳体验，需要配置 Shell 集成。这会让 fnva 在新的 Shell 会话中自动加载环境。
 
-### 添加到 PATH
+**PowerShell（推荐）：**
+```powershell
+# 添加到 PowerShell Profile
+fnva env env --shell powershell | Out-String | Invoke-Expression
 
-将二进制文件复制到系统 PATH 中，或创建符号链接：
+# 或手动添加到 $PROFILE
+echo 'fnva env env --shell powershell | Out-String | Invoke-Expression' >> $PROFILE
+```
 
+**Bash/Zsh：**
 ```bash
-# Linux/macOS
-sudo ln -s $(pwd)/target/release/fnva /usr/local/bin/fnva
+# 添加到 ~/.bashrc 或 ~/.zshrc
+echo 'eval "$(fnva env env --shell bash)"' >> ~/.bashrc
+# 或
+echo 'eval "$(fnva env env --shell zsh)"' >> ~/.zshrc
 
-# 或添加到 ~/.bashrc 或 ~/.zshrc
-export PATH="$PATH:$(pwd)/target/release"
+# 重新加载配置
+source ~/.bashrc  # 或 source ~/.zshrc
 ```
 
-## 使用方法
+**Fish：**
+```fish
+# 添加到 ~/.config/fish/config.fish
+echo 'fnva env env --shell fish | source' >> ~/.config/fish/config.fish
+```
 
-### Java 环境管理
+#### 3. 配置文件
 
-#### 列出所有 Java 环境
+首次运行时，fnva 会自动创建配置文件：
 
 ```bash
+# 配置文件位置
+Linux/macOS: ~/.fnva/config.toml
+Windows:     %USERPROFILE%\.fnva\config.toml
+```
+
+#### 4. 测试安装
+
+```bash
+# 列出所有环境类型
+fnva env list-types
+
+# 查看 Java 环境
 fnva java list
+
+# 查看 CC 环境
+fnva cc list
+
+# 查看 LLM 环境
+fnva llm list
 ```
 
-#### 扫描系统中的 Java 安装
+## 使用方法
+
+### Java 环境管理
+
+#### 列出所有 Java 环境
 
 ```bash
-fnva java scan
+fnva java list
 ```
 
 #### 添加 Java 环境
@@ -93,11 +147,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 环境
+
+```bash
+# 设置默认环境
+fnva java default jdk-21
+
+# 查看当前默认环境
+fnva java default
+
+# 清除默认设置
+fnva java default --unset
+```
+
+#### 查看当前激活的环境
+
+```bash
+fnva java current
 ```
 
 #### 删除 Java 环境
@@ -106,6 +185,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 环境
@@ -171,6 +296,126 @@ fnva llm use openai-dev --shell powershell | Invoke-Expression
 fnva llm remove openai-dev
 ```
 
+### Claude Code (CC) 环境管理
+
+专门为 Claude Code 设计的环境管理功能，支持多种 Claude Code 兼容服务的环境切换。
+
+#### 列出所有 CC 环境
+
+```bash
+fnva cc list
+```
+
+#### 添加 CC 环境
+
+```bash
+# 方法一：使用 JSON 配置
+fnva cc add glmcc '{
+  "provider": "anthropic",
+  "api_key": "your-api-key",
+  "base_url": "https://open.bigmodel.cn/api/anthropic",
+  "model": "glm-4.6",
+  "description": "GLM-4.6 Claude Code 环境"
+}'
+
+# 方法二：直接编辑配置文件
+# 编辑 ~/.fnva/config.toml，添加：
+# [[cc_environments]]
+# name = "glmcc"
+# provider = "anthropic"
+# api_key = "your-api-key"
+# base_url = "https://open.bigmodel.cn/api/anthropic"
+# model = "glm-4.6"
+# description = "GLM-4.6 Claude Code 环境"
+```
+
+#### 切换到 CC 环境
+
+```bash
+# PowerShell（推荐）
+fnva cc use glmcc --shell powershell | Invoke-Expression
+
+# Bash/Zsh
+eval "$(fnva cc use glmcc)"
+
+# Fish
+fnva cc use glmcc --shell fish | source
+
+# CMD
+fnva cc use glmcc --shell cmd > %TEMP%\fnva_cc.cmd && call %TEMP%\fnva_cc.cmd
+```
+
+#### Manage default CC environment
+
+```bash
+# Set default CC environment
+fnva cc default glmcc
+
+# Show current default CC environment
+fnva cc default
+
+# Unset default CC environment
+fnva cc default --unset
+```
+
+#### 查看当前激活的 CC 环境
+
+```bash
+fnva cc current
+```
+
+#### 删除 CC 环境
+
+```bash
+fnva cc remove glmcc
+```
+
+#### 预配置的 CC 环境
+
+fnva 提供了一些常用的 CC 环境配置：
+
+- **glmcc**: GLM-4.6 智谱 AI Claude Code 兼容服务
+- **anycc**: AnyCC 通用 Claude Code 代理服务
+- **kimicc**: Kimi AI Claude Code 兼容服务
+
+#### 环境变量说明
+
+CC 环境切换会设置以下环境变量：
+
+- `ANTHROPIC_AUTH_TOKEN`: Claude Code 认证令牌
+- `ANTHROPIC_BASE_URL`: Claude Code API 基础 URL
+- `ANTHROPIC_DEFAULT_SONNET_MODEL`: 默认使用的模型
+- `API_TIMEOUT_MS`: API 请求超时时间
+- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`: 禁用非必要网络流量
+
+#### 配置示例
+
+```toml
+[[cc_environments]]
+name = "glmcc"
+provider = "anthropic"
+api_key = "your-glm-api-key"
+base_url = "https://open.bigmodel.cn/api/anthropic"
+model = "glm-4.6"
+description = "GLM-4.6 Claude Code 环境"
+
+[[cc_environments]]
+name = "anycc"
+provider = "anthropic"
+api_key = "your-anycc-api-key"
+base_url = "https://your-anycc-proxy.com"
+model = "claude-sonnet-4-5"
+description = "AnyCC 代理服务"
+
+[[cc_environments]]
+name = "kimicc"
+provider = "anthropic"
+api_key = "your-kimi-api-key"
+base_url = "https://api.moonshot.cn/anthropic"
+model = "kimi-k2-turbo-preview"
+description = "Kimi AI Claude Code 环境"
+```
+
 ## 配置文件
 
 配置文件位置：
@@ -184,11 +429,13 @@ fnva llm remove openai-dev
 查看 `config/config.toml.example` 获取完整配置示例。
 
 ```toml
+# Java 环境配置
 [[java_environments]]
 name = "jdk-17"
 java_home = "/usr/lib/jvm/java-17-openjdk"
 description = "OpenJDK 17"
 
+# LLM 环境配置
 [[llm_environments]]
 name = "openai-dev"
 provider = "openai"
@@ -196,64 +443,51 @@ api_key = "${OPENAI_API_KEY}"
 base_url = "https://api.openai.com/v1"
 model = "gpt-4"
 temperature = 0.7
+max_tokens = 2000
+description = "OpenAI 开发环境"
+
+# Claude Code (CC) 环境配置
+[[cc_environments]]
+name = "glmcc"
+provider = "anthropic"
+api_key = "${GLM_API_KEY}"
+base_url = "https://open.bigmodel.cn/api/anthropic"
+model = "glm-4.6"
+description = "GLM-4.6 Claude Code 环境"
+
+[[cc_environments]]
+name = "anycc"
+provider = "anthropic"
+api_key = "sk-your-api-key"
+base_url = "https://your-proxy.com"
+model = "claude-sonnet-4-5"
+description = "AnyCC 代理服务"
+
+# 仓库配置
+[repositories]
+java = [
+    "https://mirrors.aliyun.com/eclipse/temurin-compliance/temurin",
+    "https://api.adoptium.net/v3"
+]
+maven = [
+    "https://maven.aliyun.com/repository/public",
+    "https://search.maven.org/solrsearch/select"
+]
 ```
 
-## 环境变量引用
-
-在配置文件中可以使用 `${VAR_NAME}` 格式引用系统环境变量：
-
-```toml
-[[llm_environments]]
-name = "openai-prod"
-provider = "openai"
-api_key = "${OPENAI_API_KEY}"  # 从系统环境变量读取
-```
-
-## Shell 集成
-
-### Bash/Zsh
-
-在 `~/.bashrc` 或 `~/.zshrc` 中添加：
-
-```bash
-# 快速切换 Java 环境
-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
-
-在 `~/.config/fish/config.fish` 中添加：
-
-```fish
-function java17
-    fnva java use jdk-17 | source
-end
-
-function llm-openai
-    fnva llm use openai-dev | 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 java list` | 列出 Java 环境 | `fnva java list` |
+| `fnva java use <name>` | 切换 Java 环境 | `fnva java use jdk21` |
+| `fnva java default <name>` | 设置默认 Java | `fnva java default jdk21` |
+| `fnva cc list` | 列出 CC 环境 | `fnva cc list` |
+| `fnva cc use <name>` | 切换 CC 环境 | `fnva cc use glmcc` |
+| `fnva cc default <name>` | 设置默认 CC 环境 | `fnva cc default glmcc` |
+| `fnva llm list` | 列出 LLM 环境 | `fnva llm list` |
+| `fnva llm use <name>` | 切换 LLM 环境 | `fnva llm use openai-dev` |
+| `fnva env switch <type> <name>` | 通用切换 | `fnva env switch java jdk17` |
 
 ## 许可证
 

package/bin/fnva.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function resolvePlatform() {
+  switch (process.platform) {
+    case 'win32':
+    case 'darwin':
+    case 'linux':
+      return process.platform;
+    default:
+      throw new Error(`Unsupported platform: ${process.platform}`);
+  }
+}
+
+function resolveArch() {
+  const arch = process.arch;
+  if (arch === 'x64') {
+    return 'x64';
+  }
+  if (arch === 'arm64') {
+    return 'arm64';
+  }
+  // Fallback to x64 for unknown architectures to keep previous behaviour.
+  return 'x64';
+}
+
+function buildBinaryPath() {
+  const platform = resolvePlatform();
+  const arch = resolveArch();
+  const scriptDir = __dirname;
+  const projectRoot = path.resolve(scriptDir, '..');
+  const platformDir = `${platform}-${arch}`;
+  const binaryName = platform === 'win32' ? 'fnva.exe' : 'fnva';
+  return path.join(projectRoot, 'platforms', platformDir, binaryName);
+}
+
+function run() {
+  const binaryPath = buildBinaryPath();
+
+  if (!fs.existsSync(binaryPath)) {
+    console.error(`Error: binary not found: ${binaryPath}`);
+    console.error('');
+    console.error("Please build the CLI binaries first, e.g. run 'npm run build' or 'npm run build:all'.");
+    process.exit(1);
+  }
+
+  const result = spawnSync(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+  });
+
+  if (result.error) {
+    console.error(`Failed to execute fnva: ${result.error.message}`);
+    process.exit(result.status ?? 1);
+  }
+
+  process.exit(result.status ?? 0);
+}
+
+run();

package/package.json

@@ -1,13 +1,11 @@
 {
   "name": "fnva",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "跨平台环境切换工具，支持 Java 和 LLM 环境配置",
   "author": "protagonistss",
   "license": "MIT",
   "bin": {
-    "fnva": "./bin/fnva",
-    "fnva.cmd": "./bin/fnva.cmd",
-    "fnva.exe": "./bin/fnva.bat"
+    "fnva": "./bin/fnva.js"
   },
   "scripts": {
     "prepublishOnly": "scripts/prepare-publish.sh",

package/platforms/skip.txt

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