skill-atlas-cli 0.1.4

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "skill-atlas-cli",
+  "version": "0.1.4",
+  "description": "skill-atlas CLI - 虾小宝 SKILL ATLAS 命令行工具",
+  "homepage": "https://skillatlas.cn/",
+  "type": "module",
+  "main": "bin/cli.js",
+  "bin": {
+    "skill-atlas": "bin/cli.js",
+    "skillatlas": "bin/cli.js",
+    "skill-atlas-cli": "bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "start": "node bin/cli.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "plugin",
+    "package.json",
+    "README.md",
+    "setup.sh"
+  ],
+  "keywords": [
+    "skill-atlas",
+    "skillatlas",
+    "虾小宝"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "cac": "^7.0.0",
+    "chalk": "^5.6.2",
+    "consola": "^3.4.2",
+    "semver": "^7.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "picocolors": "^1.1.1",
+    "simple-git": "^3.32.3",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.6.0",
+    "xdg-basedir": "^5.1.0"
+  },
+  "engines": {
+    "node": ">=20.19"
+  }
+}

package/setup.sh

@@ -0,0 +1,397 @@
+#!/usr/bin/env bash
+
+# ==============================================================================
+# skill-atlas 安装脚本
+#
+# 用于帮助用户检测环境并安装或升级 skill-atlas CLI
+# ==============================================================================
+
+set -euo pipefail
+
+PACKAGE_NAME="${PACKAGE_NAME:-skill-atlas}"
+NPM_BIN="${NPM_BIN:-npm}"
+MIN_NODE_VERSION="${MIN_NODE_VERSION:-20.19.0}"
+PREFERRED_COMMAND="${PREFERRED_COMMAND:-skill-atlas}"
+INSTALL_ALIASES="skill-atlas skillatlas skill-atlas-cli"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+OS_TYPE=""
+OS_NAME=""
+NODE_INSTALLED=false
+NODE_VERSION=""
+NODE_VERSION_OK=false
+INSTALLED_VERSION=""
+LATEST_VERSION=""
+NEED_INSTALL=true
+NEED_UPGRADE=false
+DETECTED_COMMAND=""
+
+print_banner() {
+  echo ""
+  echo -e "${CYAN}╔══════════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${CYAN}║${NC}                 ${BOLD}🚀 Skill-Atlas CLI 安装程序                ${CYAN}║${NC}"
+  echo -e "${CYAN}╚══════════════════════════════════════════════════════════════╝${NC}"
+  echo ""
+}
+
+print_step() {
+  echo -e "\n${BLUE}▶${NC} ${BOLD}$1${NC}"
+}
+
+print_success() {
+  echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+  echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+  echo -e "${RED}✗${NC} $1" >&2
+}
+
+print_info() {
+  echo -e "${CYAN}ℹ${NC} $1"
+}
+
+has_command() {
+  command -v "$1" >/dev/null 2>&1
+}
+
+is_interactive() {
+  [ -t 0 ] && [ -t 1 ]
+}
+
+version_ge() {
+  local v1=$1
+  local v2=$2
+  local lower
+
+  lower=$(printf '%s\n%s\n' "$v1" "$v2" | sort -V | head -n1)
+  [ "$lower" = "$v2" ]
+}
+
+print_path_hint() {
+  local npm_prefix
+  npm_prefix="$("$NPM_BIN" config get prefix 2>/dev/null || true)"
+
+  if [ -n "$npm_prefix" ] && [ -d "$npm_prefix/bin" ]; then
+    echo ""
+    print_info "如果安装后仍提示找不到命令，请确认以下目录已加入 PATH:"
+    echo "  $npm_prefix/bin"
+  fi
+}
+
+detect_os() {
+  print_step "检测操作系统..."
+
+  case "$(uname -s)" in
+    Darwin*)
+      OS_TYPE="macos"
+      OS_NAME="macOS $(sw_vers -productVersion 2>/dev/null || echo '')"
+      ;;
+    Linux*)
+      if [ -f /proc/version ] && grep -qi microsoft /proc/version 2>/dev/null; then
+        OS_TYPE="wsl"
+        OS_NAME="Windows (WSL)"
+      else
+        OS_TYPE="linux"
+        if [ -f /etc/os-release ]; then
+          # shellcheck disable=SC1091
+          . /etc/os-release
+          OS_NAME="${NAME:-Linux} ${VERSION_ID:-}"
+        else
+          OS_NAME="Linux"
+        fi
+      fi
+      ;;
+    MINGW*|MSYS*|CYGWIN*)
+      OS_TYPE="windows"
+      OS_NAME="Windows (Git Bash/MSYS)"
+      ;;
+    *)
+      OS_TYPE="unknown"
+      OS_NAME="Unknown"
+      ;;
+  esac
+
+  if [ "$OS_TYPE" = "unknown" ]; then
+    print_error "不支持的操作系统: $(uname -s)"
+    print_info "本脚本支持 macOS、Linux 和 Windows (WSL/Git Bash)"
+    exit 1
+  fi
+
+  print_success "操作系统: ${OS_NAME}"
+}
+
+check_npm() {
+  print_step "检测 npm 环境..."
+
+  if ! has_command "$NPM_BIN"; then
+    print_error "未找到 ${NPM_BIN}，请先安装 npm 后重试"
+    exit 1
+  fi
+
+  print_success "npm 命令: $(command -v "$NPM_BIN")"
+}
+
+check_node() {
+  print_step "检测 Node.js 环境..."
+
+  NODE_INSTALLED=false
+  NODE_VERSION=""
+  NODE_VERSION_OK=false
+
+  if has_command node; then
+    NODE_INSTALLED=true
+    NODE_VERSION="$(node -v | sed 's/^v//')"
+
+    if version_ge "$NODE_VERSION" "$MIN_NODE_VERSION"; then
+      NODE_VERSION_OK=true
+      print_success "Node.js 版本: v${NODE_VERSION} (满足要求 >= v${MIN_NODE_VERSION})"
+    else
+      print_warning "Node.js 版本: v${NODE_VERSION} (需要 >= v${MIN_NODE_VERSION})"
+    fi
+  else
+    print_warning "未检测到 Node.js"
+  fi
+}
+
+show_node_install_guide() {
+  echo ""
+  echo -e "  ${BOLD}Node.js 是什么?${NC}"
+  echo -e "  skill-atlas 是一个 Node.js 命令行工具，"
+  echo -e "  运行前需要 Node.js >= ${MIN_NODE_VERSION}。"
+  echo ""
+  echo -e "  ${BOLD}推荐安装方式：nvm${NC}"
+  echo -e "  nvm 是 Node.js 版本管理工具，可用于安装和切换 Node 版本。"
+  echo ""
+}
+
+install_nvm_and_node() {
+  print_step "安装 Node.js"
+  show_node_install_guide
+
+  if ! is_interactive; then
+    print_error "当前不是交互式终端，无法自动引导安装 Node.js"
+    print_info "请先手动安装 nvm 与 Node.js:"
+    echo "  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash"
+    echo "  export NVM_DIR=\"\$HOME/.nvm\""
+    echo "  [ -s \"\$NVM_DIR/nvm.sh\" ] && . \"\$NVM_DIR/nvm.sh\""
+    echo "  nvm install ${MIN_NODE_VERSION}"
+    exit 1
+  fi
+
+  read -r -p "  是否需要帮助安装 nvm 和 Node.js? [Y/n]: " install_choice < /dev/tty
+  install_choice=${install_choice:-Y}
+
+  if [[ ! "$install_choice" =~ ^[Yy]$ ]]; then
+    print_info "请手动安装 Node.js >= ${MIN_NODE_VERSION} 后重新执行本脚本"
+    exit 1
+  fi
+
+  if ! has_command curl; then
+    print_error "自动安装 nvm 需要 curl，请先安装 curl"
+    exit 1
+  fi
+
+  print_step "安装 nvm..."
+  if [ -d "$HOME/.nvm" ]; then
+    print_success "nvm 已安装"
+  else
+    echo -e "  执行: ${CYAN}curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash${NC}"
+    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
+    print_success "nvm 安装成功"
+  fi
+
+  export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
+  if [ -s "$NVM_DIR/nvm.sh" ]; then
+    # shellcheck disable=SC1090
+    . "$NVM_DIR/nvm.sh"
+  else
+    print_error "未找到 nvm.sh，请重新打开终端后重试"
+    exit 1
+  fi
+
+  print_step "安装 Node.js ${MIN_NODE_VERSION}..."
+  echo -e "  执行: ${CYAN}nvm install ${MIN_NODE_VERSION}${NC}"
+  nvm install "$MIN_NODE_VERSION"
+  nvm use "$MIN_NODE_VERSION"
+
+  NODE_VERSION="$(node -v | sed 's/^v//')"
+  NODE_VERSION_OK=true
+  print_success "Node.js ${NODE_VERSION} 安装成功"
+}
+
+find_available_command() {
+  local cmd
+  DETECTED_COMMAND=""
+
+  for cmd in $INSTALL_ALIASES; do
+    if has_command "$cmd"; then
+      DETECTED_COMMAND="$cmd"
+      return 0
+    fi
+  done
+
+  return 1
+}
+
+check_existing_installation() {
+  print_step "检查 ${PACKAGE_NAME} 安装状态..."
+
+  INSTALLED_VERSION=""
+  LATEST_VERSION=""
+  NEED_INSTALL=true
+  NEED_UPGRADE=false
+
+  if find_available_command; then
+    INSTALLED_VERSION="$("$DETECTED_COMMAND" --version 2>/dev/null || echo "")"
+
+    if [ -n "$INSTALLED_VERSION" ]; then
+      print_success "已安装命令: ${DETECTED_COMMAND}"
+      print_success "已安装版本: v${INSTALLED_VERSION}"
+      NEED_INSTALL=false
+    fi
+  else
+    print_info "未检测到已安装命令"
+  fi
+
+  print_info "检查 npm 最新版本..."
+  LATEST_VERSION="$("$NPM_BIN" view "$PACKAGE_NAME" version 2>/dev/null || echo "")"
+
+  if [ -z "$LATEST_VERSION" ]; then
+    print_warning "无法获取 npm 最新版本信息，将继续执行安装"
+    if [ -n "$INSTALLED_VERSION" ]; then
+      NEED_INSTALL=false
+    fi
+    return 0
+  fi
+
+  print_info "最新版本: v${LATEST_VERSION}"
+
+  if [ -z "$INSTALLED_VERSION" ]; then
+    NEED_INSTALL=true
+    NEED_UPGRADE=false
+    return 0
+  fi
+
+  if version_ge "$INSTALLED_VERSION" "$LATEST_VERSION"; then
+    print_success "当前已是最新版本或更高版本"
+    NEED_INSTALL=false
+    NEED_UPGRADE=false
+  else
+    print_warning "发现可升级版本"
+    NEED_INSTALL=false
+    NEED_UPGRADE=true
+  fi
+}
+
+install_package() {
+  local action="安装"
+
+  if [ "$NEED_INSTALL" = false ] && [ "$NEED_UPGRADE" = false ]; then
+    print_info "无需安装或升级"
+    return 0
+  fi
+
+  if [ "$NEED_UPGRADE" = true ]; then
+    action="升级"
+  fi
+
+  print_step "${action} ${PACKAGE_NAME}..."
+  echo ""
+  echo -e "  执行: ${CYAN}${NPM_BIN} install -g ${PACKAGE_NAME}${NC}"
+  echo ""
+
+  if "$NPM_BIN" install -g "$PACKAGE_NAME"; then
+    print_success "${PACKAGE_NAME} ${action}成功"
+  else
+    print_error "${PACKAGE_NAME} ${action}失败"
+    print_path_hint
+    exit 1
+  fi
+}
+
+verify_installation() {
+  print_step "验证安装..."
+
+  if find_available_command; then
+    local version
+    version="$("$DETECTED_COMMAND" --version 2>/dev/null || echo "unknown")"
+    print_success "安装成功，可执行命令: ${DETECTED_COMMAND}"
+    print_success "版本信息: ${version}"
+    return 0
+  fi
+
+  print_error "安装验证失败: 未检测到 CLI 命令"
+  print_path_hint
+  return 1
+}
+
+show_help() {
+  cat <<EOF
+用法: ./setup.sh [选项]
+
+选项:
+  -h, --help    显示帮助信息
+
+环境变量:
+  PACKAGE_NAME       要安装的 npm 包名，默认: skill-atlas
+  NPM_BIN            npm 命令名，默认: npm
+  MIN_NODE_VERSION   最低 Node.js 版本，默认: 20.19.0
+
+示例:
+  ./setup.sh
+  NPM_BIN=pnpm ./setup.sh
+EOF
+}
+
+main() {
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      -h|--help)
+        show_help
+        exit 0
+        ;;
+      *)
+        print_error "未知参数: $1"
+        show_help
+        exit 1
+        ;;
+    esac
+  done
+
+  print_banner
+  detect_os
+  check_npm
+  check_node
+
+  if [ "$NODE_VERSION_OK" = false ]; then
+    install_nvm_and_node
+  fi
+
+  check_existing_installation
+  install_package
+  verify_installation || exit 1
+
+  echo ""
+  echo -e "${CYAN}╔══════════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${CYAN}║${NC}                    ${BOLD}🎉 安装完成!${NC}                              ${CYAN}║${NC}"
+  echo -e "${CYAN}╚══════════════════════════════════════════════════════════════╝${NC}"
+  echo ""
+  print_info "快速开始:"
+  echo "  ${PREFERRED_COMMAND} --help"
+  echo "  ${PREFERRED_COMMAND} search [skillName]"
+  echo "  ${PREFERRED_COMMAND} install [skillName]"
+}
+
+main "$@"