fnva 0.0.1

package/README.md

@@ -0,0 +1,261 @@
+# 环境切换工具 (nva)
+
+跨平台环境切换工具，支持 Java 和 LLM 环境配置管理。
+
+## 功能特性
+
+- ✅ **Java 环境管理**：快速切换不同版本的 JDK
+- ✅ **LLM 环境管理**：支持多 LLM 提供商配置切换
+- ✅ **跨平台支持**：Windows、macOS、Linux
+- ✅ **多 Shell 支持**：bash、zsh、fish、PowerShell、CMD
+- ✅ **自动扫描**：自动检测系统中的 Java 安装
+- ✅ **环境变量引用**：支持 `${VAR_NAME}` 格式引用系统环境变量
+
+## 安装
+
+### 通过 npm 安装（推荐）
+
+```bash
+# 全局安装
+npm install -g nva
+
+# 或使用 yarn
+yarn global add nva
+
+# 或使用 pnpm
+pnpm add -g nva
+```
+
+安装完成后，可以直接使用 `nva` 命令。
+
+### 从源码构建
+
+#### 本地构建（当前平台）
+
+```bash
+git clone <repository-url>
+cd cool-utils
+npm run build
+```
+
+编译后的二进制文件位于 `platforms/<platform>/nva`。
+
+#### 构建所有平台
+
+项目使用 GitHub Actions 自动构建所有平台的二进制文件。当创建版本标签时，会自动构建并发布到 npm。
+
+**手动触发构建：**
+1. 在 GitHub 上创建新的 Release 标签（例如 `v0.1.0`）
+2. GitHub Actions 会自动构建所有平台
+3. 构建完成后自动发布到 npm
+
+**本地构建所有平台（需要交叉编译工具）：**
+```bash
+npm run build:all
+```
+
+注意：需要安装 `cross` 工具：`cargo install cross`
+
+### 添加到 PATH
+
+将二进制文件复制到系统 PATH 中，或创建符号链接：
+
+```bash
+# Linux/macOS
+sudo ln -s $(pwd)/target/release/nva /usr/local/bin/nva
+
+# 或添加到 ~/.bashrc 或 ~/.zshrc
+export PATH="$PATH:$(pwd)/target/release"
+```
+
+## 使用方法
+
+### Java 环境管理
+
+#### 列出所有 Java 环境
+
+```bash
+nva java list
+```
+
+#### 扫描系统中的 Java 安装
+
+```bash
+nva java scan
+```
+
+#### 添加 Java 环境
+
+```bash
+nva java add --name jdk-17 --home /usr/lib/jvm/java-17-openjdk --description "OpenJDK 17"
+```
+
+#### 切换到 Java 环境
+
+```bash
+# 自动检测 shell
+eval "$(nva java use jdk-17)"
+
+# 指定 shell
+eval "$(nva java use jdk-17 --shell bash)"
+```
+
+#### 删除 Java 环境
+
+```bash
+nva java remove jdk-17
+```
+
+### LLM 环境管理
+
+#### 列出所有 LLM 环境
+
+```bash
+nva llm list
+```
+
+#### 查看支持的提供商
+
+```bash
+nva llm providers
+```
+
+支持的提供商：
+- `openai` - OpenAI API
+- `anthropic` - Anthropic Claude API
+- `azure-openai` - Azure OpenAI
+- `google-gemini` - Google Gemini
+- `cohere` - Cohere API
+- `mistral` - Mistral AI
+- `ollama` - Ollama (本地部署)
+
+#### 添加 LLM 环境
+
+```bash
+# OpenAI
+nva llm add \
+  --name openai-dev \
+  --provider openai \
+  --api-key "${OPENAI_API_KEY}" \
+  --model gpt-4 \
+  --temperature 0.7
+
+# Anthropic
+nva llm add \
+  --name anthropic-prod \
+  --provider anthropic \
+  --api-key "${ANTHROPIC_API_KEY}" \
+  --model claude-3-opus-20240229
+
+# Ollama (本地)
+nva llm add \
+  --name ollama-local \
+  --provider ollama \
+  --base-url http://localhost:11434 \
+  --model llama2
+```
+
+#### 切换到 LLM 环境
+
+```bash
+# 自动检测 shell
+eval "$(nva llm use openai-dev)"
+
+# 指定 shell (PowerShell)
+nva llm use openai-dev --shell powershell | Invoke-Expression
+```
+
+#### 删除 LLM 环境
+
+```bash
+nva llm remove openai-dev
+```
+
+## 配置文件
+
+配置文件位置：
+- **Linux/macOS**: `~/.nva/config.toml`
+- **Windows**: `%USERPROFILE%\.nva\config.toml`
+
+首次运行时会自动创建配置文件。
+
+### 配置示例
+
+查看 `config/config.toml.example` 获取完整配置示例。
+
+```toml
+[[java_environments]]
+name = "jdk-17"
+java_home = "/usr/lib/jvm/java-17-openjdk"
+description = "OpenJDK 17"
+
+[[llm_environments]]
+name = "openai-dev"
+provider = "openai"
+api_key = "${OPENAI_API_KEY}"
+base_url = "https://api.openai.com/v1"
+model = "gpt-4"
+temperature = 0.7
+```
+
+## 环境变量引用
+
+在配置文件中可以使用 `${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 "$(nva java use jdk-17)"'
+alias java11='eval "$(nva java use jdk-11)"'
+
+# 快速切换 LLM 环境
+alias llm-openai='eval "$(nva llm use openai-dev)"'
+alias llm-anthropic='eval "$(nva llm use anthropic-prod)"'
+```
+
+### Fish
+
+在 `~/.config/fish/config.fish` 中添加：
+
+```fish
+function java17
+    nva java use jdk-17 | source
+end
+
+function llm-openai
+    nva llm use openai-dev | source
+end
+```
+
+### PowerShell
+
+在 `$PROFILE` 中添加：
+
+```powershell
+function Switch-Java {
+    param([string]$Name)
+    nva java use $Name | Invoke-Expression
+}
+
+function Switch-Llm {
+    param([string]$Name)
+    nva llm use $Name | Invoke-Expression
+}
+```
+
+## 许可证
+
+MIT License
+

package/bin/nva

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+# nva - 跨平台环境切换工具
+# 根据当前平台和架构选择对应的二进制文件并执行
+
+# 获取脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 检测平台和架构
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+ARCH=$(uname -m)
+
+# 平台映射
+case "$OS" in
+  darwin)
+    PLATFORM="darwin"
+    ;;
+  linux)
+    PLATFORM="linux"
+    ;;
+  *)
+    echo "错误: 不支持的操作系统: $OS" >&2
+    exit 1
+    ;;
+esac
+
+# 架构映射
+case "$ARCH" in
+  x86_64)
+    CPU="x64"
+    ;;
+  arm64|aarch64)
+    CPU="arm64"
+    ;;
+  *)
+    echo "警告: 未识别的架构 $ARCH，使用 x64" >&2
+    CPU="x64"
+    ;;
+esac
+
+# 构建二进制文件路径
+PLATFORM_DIR="$PLATFORM-$CPU"
+BINARY_PATH="$PROJECT_ROOT/platforms/$PLATFORM_DIR/nva"
+
+# 检查二进制文件是否存在
+if [ ! -f "$BINARY_PATH" ]; then
+  echo "错误: 未找到二进制文件: $BINARY_PATH" >&2
+  echo "请运行 'npm run build' 构建二进制文件" >&2
+  exit 1
+fi
+
+# 执行二进制文件，传递所有参数
+exec "$BINARY_PATH" "$@"
+

package/bin/nva.cmd

@@ -0,0 +1,31 @@
+@echo off
+REM nva - Windows CMD 启动脚本
+
+setlocal
+
+REM 检测平台和架构
+set OS=win32
+if "%PROCESSOR_ARCHITECTURE%"=="AMD64" (
+    set ARCH=x64
+) else if "%PROCESSOR_ARCHITECTURE%"=="ARM64" (
+    set ARCH=arm64
+) else (
+    set ARCH=x64
+)
+
+REM 构建二进制文件路径
+set PLATFORM_DIR=%OS%-%ARCH%
+set BINARY_PATH=%~dp0..\platforms\%PLATFORM_DIR%\nva.exe
+
+REM 检查二进制文件是否存在
+if not exist "%BINARY_PATH%" (
+    echo 错误: 未找到二进制文件: %BINARY_PATH%
+    echo 请运行 'npm run build' 构建二进制文件
+    exit /b 1
+)
+
+REM 执行二进制文件
+"%BINARY_PATH%" %*
+
+endlocal
+

package/bin/nva.ps1

@@ -0,0 +1,30 @@
+# nva - Windows PowerShell 启动脚本
+
+param(
+    [Parameter(ValueFromRemainingArguments=$true)]
+    [string[]]$Arguments
+)
+
+# 检测平台和架构
+$os = "win32"
+$arch = if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") { "arm64" } else { "x64" }
+
+# 构建二进制文件路径
+$platformDir = "$os-$arch"
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$binaryPath = Join-Path $scriptDir ".." "platforms" $platformDir "nva.exe"
+
+# 检查二进制文件是否存在
+if (-not (Test-Path $binaryPath)) {
+    Write-Host "错误: 未找到二进制文件: $binaryPath" -ForegroundColor Red
+    Write-Host "请运行 'npm run build' 构建二进制文件" -ForegroundColor Yellow
+    exit 1
+}
+
+# 执行二进制文件
+& $binaryPath $Arguments
+
+if ($LASTEXITCODE) {
+    exit $LASTEXITCODE
+}
+

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "fnva",
+  "version": "0.0.1",
+  "description": "跨平台环境切换工具，支持 Java 和 LLM 环境配置",
+  "author": "protagonistss",
+  "license": "MIT",
+  "bin": {
+    "nva": "./bin/nva"
+  },
+  "scripts": {
+    "prepublishOnly": "scripts/prepare-publish.sh",
+    "build": "scripts/build-local.sh",
+    "build:all": "scripts/build-all.sh"
+  },
+  "files": [
+    "bin/",
+    "platforms/",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "keywords": [
+    "environment",
+    "java",
+    "llm",
+    "cli",
+    "tool",
+    "nva"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Protagonistss/cool-utils.git"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}
+