openclacky 0.9.11 → 0.9.13

data/scripts/install.sh

@@ -99,19 +99,39 @@ detect_shell() {
 }
 
 # Network-aware installer source selection
-SLOW_THRESHOLD_MS=2500
-NETWORK_REGION="global"
+SLOW_THRESHOLD_MS=5000
+NETWORK_REGION="global"     # "china" | "global" | "unknown"
 USE_CN_MIRRORS=false
-DEFAULT_RUBYGEMS_URL="https://rubygems.org"
+
+# --- Upstream (global) defaults ---
 GITHUB_RAW_BASE_URL="https://raw.githubusercontent.com"
 HOMEBREW_INSTALL_SCRIPT_URL="${GITHUB_RAW_BASE_URL}/Homebrew/install/HEAD/install.sh"
 OPENCLACKY_INSTALL_SCRIPT_URL="${GITHUB_RAW_BASE_URL}/clacky-ai/openclacky/main/scripts/install.sh"
-TUNA_MIRROR_BASE_URL="https://mirrors.tuna.tsinghua.edu.cn"
-CN_CDN_BASE_URL="https://oss.1024code.com"
+DEFAULT_RUBYGEMS_URL="https://rubygems.org"
+DEFAULT_NPM_REGISTRY="https://registry.npmjs.org"
 DEFAULT_MISE_INSTALL_URL="https://mise.run"
+
+CN_CDN_BASE_URL="https://oss.1024code.com"       # reverse proxy for raw.githubusercontent.com
+
+# --- CN source URLs ---
+CN_HOMEBREW_INSTALL_SCRIPT_URL="${CN_CDN_BASE_URL}/Homebrew/install/HEAD/install.sh"
 CN_MISE_INSTALL_URL="${CN_CDN_BASE_URL}/mise.sh"
 CN_RUBY_PRECOMPILED_URL="${CN_CDN_BASE_URL}/ruby/ruby-{version}.{platform}.tar.gz"
+CN_RUBYGEMS_URL="https://mirrors.aliyun.com/rubygems/"
+CN_NPM_REGISTRY="https://registry.npmmirror.com"
+CN_NODE_MIRROR_URL="https://cdn.npmmirror.com/binaries/node/"
+
+# --- Homebrew CN mirrors (Aliyun) ---
+CN_HOMEBREW_BREW_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/brew.git"
+CN_HOMEBREW_CORE_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/homebrew-core.git"
+CN_HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew/homebrew-bottles"
+CN_HOMEBREW_API_DOMAIN="https://mirrors.aliyun.com/homebrew-bottles/api"
+
+# --- Active values (overridden by detect_network_region) ---
 MISE_INSTALL_URL="$DEFAULT_MISE_INSTALL_URL"
+RUBYGEMS_INSTALL_URL="$DEFAULT_RUBYGEMS_URL"
+NPM_REGISTRY_URL="$DEFAULT_NPM_REGISTRY"
+NODE_MIRROR_URL=""           # empty = mise default (nodejs.org)
 RUBY_VERSION_SPEC="ruby@3"
 
 # Probe a single URL; echoes the round-trip time in milliseconds, or "timeout".
@@ -174,62 +194,126 @@ _print_probe_result() {
     fi
 }
 
+# Probe a URL up to MAX_RETRIES times; returns the first successful ms or "timeout".
+_probe_url_with_retry() {
+    local url="$1"
+    local max_retries="${2:-2}"
+    local attempt result
+
+    for attempt in $(seq 1 "$max_retries"); do
+        result=$(_probe_url "$url")
+        if [ "$result" != "timeout" ] && ! _is_slow_or_unreachable "$result"; then
+            echo "$result"
+            return 0
+        fi
+        # keep last result for reporting
+    done
+    echo "$result"
+}
+
 detect_network_region() {
     print_step "Network pre-flight check..."
+    echo ""
 
-    local tuna_result cdn_result mise_result rubygems_result github_result
-    local tuna_good=false
-    local cdn_good=false
-    local upstream_good=false
+    # -----------------------------------------------------------------------
+    # Step 1: Region detection — google.com vs baidu.com
+    #   google reachable  → global
+    #   google unreachable + baidu reachable → china
+    #   both unreachable  → unknown (best-effort, fall through)
+    # -----------------------------------------------------------------------
+    print_info "Step 1: Detecting network region..."
+    local google_result baidu_result
+    google_result=$(_probe_url "https://www.google.com")
+    baidu_result=$(_probe_url "https://www.baidu.com")
+
+    _print_probe_result "google.com" "$google_result"
+    _print_probe_result "baidu.com"  "$baidu_result"
+
+    local google_ok=false baidu_ok=false
+    ! _is_slow_or_unreachable "$google_result" && google_ok=true
+    ! _is_slow_or_unreachable "$baidu_result"  && baidu_ok=true
+
+    if [ "$google_ok" = true ]; then
+        NETWORK_REGION="global"
+        print_success "Region: global (Google reachable)"
+    elif [ "$baidu_ok" = true ]; then
+        NETWORK_REGION="china"
+        print_success "Region: china (Baidu reachable, Google not)"
+    else
+        NETWORK_REGION="unknown"
+        print_warning "Region: unknown (both Google and Baidu unreachable)"
+    fi
+    echo ""
 
-    tuna_result=$(_probe_url "$TUNA_MIRROR_BASE_URL")
-    cdn_result=$(_probe_url "$CN_MISE_INSTALL_URL")
-    mise_result=$(_probe_url "$DEFAULT_MISE_INSTALL_URL")
-    rubygems_result=$(_probe_url "$DEFAULT_RUBYGEMS_URL")
-    github_result=$(_probe_url "$GITHUB_RAW_BASE_URL")
+    # -----------------------------------------------------------------------
+    # Step 2: Probe region-specific sources (retry 2× to avoid false alarms)
+    # -----------------------------------------------------------------------
+    print_info "Step 2: Probing installation sources (up to 2 retries each)..."
 
-    _print_probe_result "Tsinghua mirror" "$tuna_result"
-    _print_probe_result "Clacky CDN" "$cdn_result"
-    _print_probe_result "mise installer" "$mise_result"
-    _print_probe_result "RubyGems" "$rubygems_result"
-    _print_probe_result "GitHub raw content" "$github_result"
+    if [ "$NETWORK_REGION" = "china" ]; then
+        # CN sources: CDN (oss.1024code.com) + Aliyun + npmmirror
+        local cdn_result mirror_result
+        cdn_result=$(_probe_url_with_retry "$CN_MISE_INSTALL_URL")
+        mirror_result=$(_probe_url_with_retry "$CN_RUBYGEMS_URL")
 
-    if ! _is_slow_or_unreachable "$tuna_result"; then
-        tuna_good=true
-    fi
+        _print_probe_result "Chinese CDN (mise/Ruby)" "$cdn_result"
+        _print_probe_result "CN mirror (gem/brew)" "$mirror_result"
 
-    if ! _is_slow_or_unreachable "$cdn_result"; then
-        cdn_good=true
-    fi
+        local cdn_ok=false mirror_ok=false
+        ! _is_slow_or_unreachable "$cdn_result"    && cdn_ok=true
+        ! _is_slow_or_unreachable "$mirror_result" && mirror_ok=true
 
-    # "global" here means strategy fallback, not guaranteed global reachability.
-    # Treat upstream as healthy if at least one core endpoint is reachable and fast enough.
-    if ! _is_slow_or_unreachable "$mise_result" || \
-       ! _is_slow_or_unreachable "$rubygems_result" || \
-       ! _is_slow_or_unreachable "$github_result"; then
-        upstream_good=true
-    fi
+        # Step 3: warn on source failures, but do not abort
+        if [ "$cdn_ok" = false ]; then
+            print_warning "Chinese CDN is slow/unreachable. mise and Ruby precompiled binaries may fail."
+        fi
+        if [ "$mirror_ok" = false ]; then
+            print_warning "Aliyun mirror is slow/unreachable. gem/brew installs may be slow."
+        fi
+        if [ "$cdn_ok" = false ] && [ "$mirror_ok" = false ]; then
+            print_warning "All CN mirrors unreachable — falling back to global sources. Expect slow downloads."
+        fi
+
+        # Step 4: apply CN sources
+        if [ "$cdn_ok" = true ] || [ "$mirror_ok" = true ]; then
+            USE_CN_MIRRORS=true
+            MISE_INSTALL_URL="$CN_MISE_INSTALL_URL"
+            RUBYGEMS_INSTALL_URL="$CN_RUBYGEMS_URL"
+            NPM_REGISTRY_URL="$CN_NPM_REGISTRY"
+            NODE_MIRROR_URL="$CN_NODE_MIRROR_URL"
+            RUBY_VERSION_SPEC="ruby@3.4.8"
+            print_info "CN mirrors applied: CDN (mise/Ruby) + Aliyun (gem/brew) + npmmirror (npm/Node)"
+        else
+            USE_CN_MIRRORS=false
+            print_info "Falling back to global sources despite CN region detection."
+        fi
 
-    if [ "$tuna_good" = true ] && [ "$cdn_good" = true ]; then
-        NETWORK_REGION="china"
-        USE_CN_MIRRORS=true
-        MISE_INSTALL_URL="$CN_MISE_INSTALL_URL"
-        RUBY_VERSION_SPEC="ruby@3.4.8"
-        print_info "Using optimized installation sources for this network environment."
     else
-        NETWORK_REGION="global"
+        # Global sources: GitHub / RubyGems / npmjs / mise.run
+        local github_result rubygems_result npm_result mise_result
+        github_result=$(_probe_url_with_retry "$GITHUB_RAW_BASE_URL")
+        rubygems_result=$(_probe_url_with_retry "$DEFAULT_RUBYGEMS_URL")
+        npm_result=$(_probe_url_with_retry "$DEFAULT_NPM_REGISTRY")
+        mise_result=$(_probe_url_with_retry "$DEFAULT_MISE_INSTALL_URL")
+
+        _print_probe_result "GitHub raw"  "$github_result"
+        _print_probe_result "RubyGems"    "$rubygems_result"
+        _print_probe_result "npmjs.com"   "$npm_result"
+        _print_probe_result "mise.run"    "$mise_result"
+
+        # Step 3: warn on individual source failures
+        _is_slow_or_unreachable "$github_result"   && print_warning "GitHub is slow/unreachable. Homebrew and install script updates may fail."
+        _is_slow_or_unreachable "$rubygems_result" && print_warning "RubyGems is slow/unreachable. gem install may fail."
+        _is_slow_or_unreachable "$npm_result"      && print_warning "npmjs.com is slow/unreachable. npm install may fail."
+        _is_slow_or_unreachable "$mise_result"     && print_warning "mise.run is slow/unreachable. mise installation may fail."
+
         USE_CN_MIRRORS=false
         MISE_INSTALL_URL="$DEFAULT_MISE_INSTALL_URL"
+        RUBYGEMS_INSTALL_URL="$DEFAULT_RUBYGEMS_URL"
+        NPM_REGISTRY_URL="$DEFAULT_NPM_REGISTRY"
+        NODE_MIRROR_URL=""
         RUBY_VERSION_SPEC="ruby@3"
-        print_info "Detected global network. Using default upstream sources."
-    fi
-
-    if [ "$tuna_good" = false ] || [ "$cdn_good" = false ]; then
-        print_warning "Domestic mirrors are unavailable or too slow. Falling back to default upstream sources."
-    fi
-
-    if [ "$upstream_good" = false ]; then
-        print_warning "Default upstream sources are also unreachable or too slow. Installation may fail; check your network, proxy, or VPN settings."
+        print_info "Using global upstream sources."
     fi
 
     echo ""
@@ -261,6 +345,122 @@ check_ruby() {
     fi
 }
 
+# Configure CN mirrors permanently in config files so all subsequent tool
+# invocations (gem, npm, mise) automatically use the right source.
+# Called once after detect_network_region, only when USE_CN_MIRRORS=true.
+restore_mirrors() {
+    print_step "Restoring original mirror settings..."
+
+    # --- gem: restore ~/.gemrc ---
+    local gemrc="$HOME/.gemrc"
+    local gemrc_bak="$HOME/.gemrc_clackybak"
+    if [ -f "$gemrc_bak" ]; then
+        mv "$gemrc_bak" "$gemrc"
+        print_success "~/.gemrc restored from backup"
+    elif [ -f "$gemrc" ]; then
+        rm "$gemrc"
+        print_success "~/.gemrc removed (gem will use default rubygems.org)"
+    else
+        print_info "~/.gemrc — nothing to restore"
+    fi
+
+    # --- npm: restore ~/.npmrc ---
+    local npmrc="$HOME/.npmrc"
+    local npmrc_bak="$HOME/.npmrc_clackybak"
+    if [ -f "$npmrc_bak" ]; then
+        mv "$npmrc_bak" "$npmrc"
+        print_success "~/.npmrc restored from backup"
+    elif [ -f "$npmrc" ]; then
+        rm "$npmrc"
+        print_success "~/.npmrc removed (npm will use default registry)"
+    else
+        print_info "~/.npmrc — nothing to restore"
+    fi
+
+    # --- mise: unset node.mirror_url ---
+    local mise_bin=""
+    if command_exists mise; then
+        mise_bin="mise"
+    elif [ -x "$HOME/.local/bin/mise" ]; then
+        mise_bin="$HOME/.local/bin/mise"
+    fi
+    if [ -n "$mise_bin" ]; then
+        "$mise_bin" settings unset node.mirror_url 2>/dev/null && \
+            print_success "mise node.mirror_url unset"
+    else
+        print_info "mise not found — node.mirror_url skipped"
+    fi
+
+    # --- Homebrew CN mirrors: remove from shell rc file ---
+    if [ -n "$SHELL_RC" ] && [ -f "$SHELL_RC" ] && grep -q "HOMEBREW_BOTTLE_DOMAIN" "$SHELL_RC" 2>/dev/null; then
+        # Remove the comment line and the three export lines added by the installer
+        sed -i.bak '/# Homebrew CN mirrors (added by openclacky installer)/d' "$SHELL_RC"
+        sed -i.bak '/HOMEBREW_BREW_GIT_REMOTE/d' "$SHELL_RC"
+        sed -i.bak '/HOMEBREW_CORE_GIT_REMOTE/d' "$SHELL_RC"
+        sed -i.bak '/HOMEBREW_BOTTLE_DOMAIN/d' "$SHELL_RC"
+        rm -f "${SHELL_RC}.bak"
+        unset HOMEBREW_BREW_GIT_REMOTE HOMEBREW_CORE_GIT_REMOTE HOMEBREW_BOTTLE_DOMAIN
+        print_success "Homebrew CN mirrors removed from $SHELL_RC"
+    else
+        print_info "Homebrew CN mirrors — nothing to restore"
+    fi
+
+    echo ""
+    print_success "Done. All mirror settings restored to original."
+    echo ""
+}
+
+configure_cn_mirrors() {
+    [ "$USE_CN_MIRRORS" = true ] || return 0
+
+    print_step "Configuring CN mirrors (permanent)..."
+
+    # --- gem: write ~/.gemrc ---
+    local gemrc="$HOME/.gemrc"
+    if [ -f "$gemrc" ] && grep -q "${CN_RUBYGEMS_URL}" "$gemrc" 2>/dev/null; then
+        # Already configured by us — leave it alone
+        print_success "gem source already set → ${CN_RUBYGEMS_URL}  (~/.gemrc)"
+    else
+        # Existing file with different content — back it up then generate a clean one
+        if [ -f "$gemrc" ]; then
+            mv "$gemrc" "$HOME/.gemrc_clackybak"
+            print_info "Backed up existing ~/.gemrc → ~/.gemrc_clackybak"
+        fi
+        cat > "$gemrc" <<GEMRC
+:sources:
+  - ${CN_RUBYGEMS_URL}
+GEMRC
+        print_success "gem source → ${CN_RUBYGEMS_URL}  (~/.gemrc)"
+    fi
+
+    # --- npm: write ~/.npmrc ---
+    local npmrc="$HOME/.npmrc"
+    local npmrc_bak="$HOME/.npmrc_clackybak"
+    if [ -f "$npmrc" ] && grep -q "${NPM_REGISTRY_URL}" "$npmrc" 2>/dev/null; then
+        # Already configured by us — leave it alone
+        print_success "npm registry already set → ${NPM_REGISTRY_URL}  (~/.npmrc)"
+    else
+        # Back up existing file (once), then write clean config
+        if [ -f "$npmrc" ] && [ ! -f "$npmrc_bak" ]; then
+            cp "$npmrc" "$npmrc_bak"
+            print_info "Backed up existing ~/.npmrc → ~/.npmrc_clackybak"
+        fi
+        if command_exists npm; then
+            npm config set registry "$NPM_REGISTRY_URL" 2>/dev/null && \
+                print_success "npm registry → ${NPM_REGISTRY_URL}  (~/.npmrc)"
+        else
+            echo "registry=${NPM_REGISTRY_URL}" >> "$npmrc"
+            print_success "npm registry → ${NPM_REGISTRY_URL}  (~/.npmrc, pre-set)"
+        fi
+    fi
+
+    # --- mise Node mirror ---
+    # Applied inside install_mise_runtime() after mise binary is available.
+    # NODE_MIRROR_URL is already set; nothing to do here.
+
+    echo ""
+}
+
 # Install via RubyGems
 install_via_gem() {
     print_step "Installing via RubyGems..."
@@ -320,9 +520,20 @@ install_mise_runtime() {
     else
         print_success "mise already installed"
     fi
+
+    # Apply CN Node mirror permanently — covers any future `mise install node` too.
+    if [ "$USE_CN_MIRRORS" = true ] && [ -n "$NODE_MIRROR_URL" ]; then
+        ~/.local/bin/mise settings node.mirror_url="$NODE_MIRROR_URL" 2>/dev/null || true
+        print_info "mise Node mirror → ${NODE_MIRROR_URL}"
+    fi
 }
 
 install_ruby_via_mise() {
+    if check_ruby; then
+        print_success "Ruby already installed and compatible — skipping Ruby installation"
+        return 0
+    fi
+
     print_info "Installing Ruby 3 via mise..."
 
     if [ "$USE_CN_MIRRORS" = true ]; then
@@ -334,7 +545,6 @@ install_ruby_via_mise() {
     fi
 
     if ~/.local/bin/mise use -g "$RUBY_VERSION_SPEC"; then
-        # Reload mise in the current bash process
         eval "$(~/.local/bin/mise activate bash)"
         print_success "Ruby 3 installed successfully"
     else
@@ -348,33 +558,58 @@ install_macos_dependencies() {
     print_step "Installing macOS dependencies and Ruby..."
     echo ""
 
+    # Configure Homebrew CN mirrors before installing (CN mode only)
     if [ "$USE_CN_MIRRORS" = true ]; then
-        print_info "Detected mainland/restricted network on macOS"
-        print_info "Skipping Homebrew and build dependencies because Ruby will be installed from precompiled binaries"
-    else
-        # Install Homebrew (it will automatically install Xcode Command Line Tools if needed)
-        print_info "Checking Homebrew installation..."
-        if ! command_exists brew; then
-            print_info "Installing Homebrew..."
-            /bin/bash -c "$(curl -fsSL "$HOMEBREW_INSTALL_SCRIPT_URL")"
-
-            # Add Homebrew to PATH
-            echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
-            export PATH="/opt/homebrew/bin:$PATH"
-
-            print_success "Homebrew installed successfully"
+        print_info "Configuring Homebrew CN mirrors..."
+        export HOMEBREW_INSTALL_FROM_API=1
+        export HOMEBREW_API_DOMAIN="$CN_HOMEBREW_API_DOMAIN"
+        export HOMEBREW_BREW_GIT_REMOTE="$CN_HOMEBREW_BREW_GIT_REMOTE"
+        export HOMEBREW_CORE_GIT_REMOTE="$CN_HOMEBREW_CORE_GIT_REMOTE"
+        export HOMEBREW_BOTTLE_DOMAIN="$CN_HOMEBREW_BOTTLE_DOMAIN"
+
+        # Persist to shell rc file
+        if ! grep -q "HOMEBREW_BOTTLE_DOMAIN" "$SHELL_RC" 2>/dev/null; then
+            {
+                echo ""
+                echo "# Homebrew CN mirrors (added by openclacky installer)"
+                echo "export HOMEBREW_INSTALL_FROM_API=1"
+                echo "export HOMEBREW_API_DOMAIN=\"${CN_HOMEBREW_API_DOMAIN}\""
+                echo "export HOMEBREW_BREW_GIT_REMOTE=\"${CN_HOMEBREW_BREW_GIT_REMOTE}\""
+                echo "export HOMEBREW_CORE_GIT_REMOTE=\"${CN_HOMEBREW_CORE_GIT_REMOTE}\""
+                echo "export HOMEBREW_BOTTLE_DOMAIN=\"${CN_HOMEBREW_BOTTLE_DOMAIN}\""
+            } >> "$SHELL_RC"
+            print_success "Homebrew CN mirrors written to $SHELL_RC"
         else
-            print_success "Homebrew already installed"
+            print_success "Homebrew CN mirrors already configured in $SHELL_RC"
         fi
+    fi
 
-        # Install build dependencies for the default upstream Ruby toolchain path
-        print_info "Installing build dependencies..."
-        if brew install openssl@3 libyaml gmp rust; then
-            print_success "Build dependencies installed"
-        else
-            print_error "Failed to install build dependencies"
-            return 1
+    # Install Homebrew (it will automatically install Xcode Command Line Tools if needed)
+    print_info "Checking Homebrew installation..."
+    if ! command_exists brew; then
+        print_info "Installing Homebrew..."
+        local brew_install_url="$HOMEBREW_INSTALL_SCRIPT_URL"
+        if [ "$USE_CN_MIRRORS" = true ]; then
+            brew_install_url="$CN_HOMEBREW_INSTALL_SCRIPT_URL"
         fi
+        /bin/bash -c "$(curl -fsSL "$brew_install_url")"
+
+        # Add Homebrew to PATH
+        echo 'export PATH="/opt/homebrew/bin:$PATH"' >> "$SHELL_RC"
+        export PATH="/opt/homebrew/bin:$PATH"
+
+        print_success "Homebrew installed successfully"
+    else
+        print_success "Homebrew already installed"
+    fi
+
+    # Install build dependencies
+    print_info "Installing build dependencies..."
+    if brew install openssl@3 libyaml gmp; then
+        print_success "Build dependencies installed"
+    else
+        print_error "Failed to install build dependencies"
+        return 1
     fi
 
     # Install mise for Ruby version management
@@ -404,9 +639,9 @@ install_ubuntu_dependencies() {
     echo ""
 
     if [ "$USE_CN_MIRRORS" = true ]; then
-        print_info "Configuring apt mirror (Tsinghua)..."
+        print_info "Configuring apt mirror (Aliyun)..."
         local codename="${VERSION_CODENAME:-jammy}"
-        local mirror_base="${TUNA_MIRROR_BASE_URL}/ubuntu/"
+        local mirror_base="https://mirrors.aliyun.com/ubuntu/"
         local common_components="main restricted universe multiverse"
         sudo tee /etc/apt/sources.list > /dev/null <<EOF
 deb ${mirror_base} ${codename} ${common_components}
@@ -430,7 +665,7 @@ EOF
 
     # Install build dependencies
     print_info "Installing build dependencies..."
-    if sudo apt install -y build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev git; then
+    if sudo apt install -y build-essential libssl-dev libyaml-dev zlib1g-dev libgmp-dev git; then
         print_success "Build dependencies installed"
     else
         print_error "Failed to install build dependencies"
@@ -464,101 +699,6 @@ EOF
 }
 
 # Suggest Ruby installation
-suggest_ruby_installation() {
-    print_step "Ruby Installation Options"
-    echo ""
-
-    if [ "$OS" = "macOS" ]; then
-        print_info "Automatic Installation (Recommended)"
-        echo "  This script can automatically install Ruby and dependencies for you."
-        echo "  Uses mise - a fast, polyglot tool version manager."
-        echo ""
-        read -p "Would you like to install Ruby and dependencies automatically? [Y/n] " REPLY
-        echo ""
-        REPLY="${REPLY:-Y}"
-        if [[ $REPLY =~ ^[Yy]$ ]]; then
-            install_macos_dependencies
-            return $?
-        fi
-        echo ""
-        print_info "Manual Installation with mise:"
-        echo "  # Install Homebrew (it will install Xcode Command Line Tools automatically)"
-        echo "  /bin/bash -c \"\$(curl -fsSL ${HOMEBREW_INSTALL_SCRIPT_URL})\""
-        echo ""
-        echo "  # Install dependencies"
-        echo "  brew install openssl@3 libyaml gmp rust"
-        echo ""
-        echo "  # Install mise"
-        echo "  curl https://mise.run | sh"
-        echo "  echo 'eval \"\$(~/.local/bin/mise activate bash)\"' >> ~/.zshrc"
-        echo ""
-        echo "  # Install Ruby 3"
-        echo "  mise use -g ruby@3"
-
-    elif [ "$OS" = "Linux" ]; then
-        if [ "$DISTRO" = "ubuntu" ] || [ "$DISTRO" = "debian" ]; then
-            print_info "Automatic Installation (Recommended)"
-            echo "  This script can automatically install Ruby and dependencies for you."
-            echo "  Uses mise - a fast, polyglot tool version manager."
-            echo ""
-            read -p "Would you like to install Ruby and dependencies automatically? [Y/n] " REPLY
-            echo ""
-            REPLY="${REPLY:-Y}"
-            if [[ $REPLY =~ ^[Yy]$ ]]; then
-                install_ubuntu_dependencies
-                return $?
-            fi
-            echo ""
-            print_info "Manual Installation with mise (Ubuntu/Debian):"
-            echo "  # Update and install dependencies"
-            echo "  sudo apt update"
-            echo "  sudo apt install -y build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev git"
-            echo ""
-            echo "  # Install mise"
-            echo "  curl https://mise.run | sh"
-            echo "  echo 'eval \"\$(~/.local/bin/mise activate bash)\"' >> ~/.bashrc"
-            echo ""
-            echo "  # Install Ruby 3"
-            echo "  mise use -g ruby@3"
-        else
-            print_info "Manual Installation with mise (Other Linux):"
-            echo "  # Install build dependencies (adjust for your distribution)"
-            echo "  # Fedora/RHEL:"
-            echo "  sudo dnf install -y gcc make openssl-devel libyaml-devel zlib-devel gmp-devel git rust"
-            echo ""
-            echo "  # Install mise"
-            echo "  curl https://mise.run | sh"
-            echo "  echo 'eval \"\$(~/.local/bin/mise activate bash)\"' >> ~/.bashrc"
-            echo ""
-            echo "  # Install Ruby 3"
-            echo "  mise use -g ruby@3"
-        fi
-
-    elif [ "$OS" = "Windows" ]; then
-        print_info "Windows Subsystem for Linux (WSL) Installation (Recommended)"
-        echo "  ${DISPLAY_NAME} requires a Unix-like environment. We recommend using WSL."
-        echo ""
-        echo "  1. Open PowerShell or Windows Command Prompt in administrator mode"
-        echo "  2. Install WSL with Ubuntu 24.04:"
-        echo ""
-        echo "     wsl --install --distribution Ubuntu-24.04"
-        echo ""
-        echo "  3. Restart your computer if prompted"
-        echo "  4. Launch Ubuntu from the Start menu"
-        echo "  5. Run this installation script again inside Ubuntu:"
-        echo ""
-        echo "     curl -fsSL ${OPENCLACKY_INSTALL_SCRIPT_URL} | bash"
-        echo ""
-        print_info "Learn more about WSL: https://learn.microsoft.com/en-us/windows/wsl/install"
-    fi
-
-    echo ""
-    print_info "After installing Ruby, run this script again or use:"
-    echo "  gem install openclacky"
-    echo ""
-    print_info "Learn more about mise: https://mise.jdx.dev"
-}
-
 # Parse command-line arguments.
 #
 # Supported flags:
@@ -579,6 +719,9 @@ parse_args() {
             --command=*)
                 BRAND_COMMAND="${arg#--command=}"
                 ;;
+            --restore-mirrors)
+                RESTORE_MIRRORS=true
+                ;;
         esac
     done
     # Global display name: brand name if provided, otherwise fall back to OpenClacky
@@ -636,6 +779,12 @@ WRAPPER
 main() {
     parse_args "$@"
 
+    # --restore-mirrors: undo CN mirror config and exit
+    if [ "${RESTORE_MIRRORS:-false}" = true ]; then
+        restore_mirrors
+        exit 0
+    fi
+
     echo ""
     echo "${DISPLAY_NAME} Installation"
     echo ""
@@ -643,43 +792,38 @@ main() {
     detect_os
     detect_shell
     detect_network_region
+    configure_cn_mirrors
 
-    # Strategy 1: Check Ruby and install via gem
-    if check_ruby; then
-        if install_via_gem; then
-            setup_brand
-            show_post_install_info
-            exit 0
+    # Install dependencies and Ruby (always run, handles already-installed gracefully)
+    if [ "$OS" = "macOS" ]; then
+        if ! install_macos_dependencies; then
+            print_error "Failed to install dependencies"
+            exit 1
         fi
-    fi
-
-    # Strategy 2: Install Ruby on macOS/Ubuntu or suggest options
-    if [ "$OS" = "macOS" ] || [ "$OS" = "Linux" ]; then
-        print_warning "Ruby not found or version too old"
-        echo ""
-        if suggest_ruby_installation; then
-            # Try installing via gem after Ruby installation
-            if install_via_gem; then
-                setup_brand
-                show_post_install_info
-                exit 0
-            else
-                print_error "Failed to install ${DISPLAY_NAME}"
+    elif [ "$OS" = "Linux" ]; then
+        if [ "$DISTRO" = "ubuntu" ] || [ "$DISTRO" = "debian" ]; then
+            if ! install_ubuntu_dependencies; then
+                print_error "Failed to install dependencies"
                 exit 1
             fi
         else
-            # User declined or installation failed
-            print_info "Ruby installation was not completed"
+            print_error "Unsupported Linux distribution: $DISTRO"
             print_info "Please install Ruby manually and run: gem install openclacky"
-            print_info "For more information, visit: https://github.com/clacky-ai/openclacky"
             exit 1
         fi
     else
-        print_error "Could not install ${DISPLAY_NAME} automatically"
-        echo ""
-        suggest_ruby_installation
-        echo ""
-        print_info "For more information, visit: https://github.com/clacky-ai/openclacky"
+        print_error "Unsupported OS: $OS"
+        print_info "Please install Ruby manually and run: gem install openclacky"
+        exit 1
+    fi
+
+    # Install via gem
+    if install_via_gem; then
+        setup_brand
+        show_post_install_info
+        exit 0
+    else
+        print_error "Failed to install ${DISPLAY_NAME}"
         exit 1
     fi
 }
@@ -689,7 +833,6 @@ main() {
 install_chrome_devtools_mcp() {
     print_step "Installing chrome-devtools-mcp..."
 
-    # 尝试找到 npm；如果没有，通过 mise 安装 Node.js
     if ! command_exists npm; then
         local mise_bin=""
         if command_exists mise; then
@@ -704,6 +847,8 @@ install_chrome_devtools_mcp() {
             "$mise_bin" use -g node@22 > /dev/null 2>&1 || true
             eval "$("$mise_bin" activate bash 2>/dev/null)" 2>/dev/null || true
         fi
+    else
+        print_success "Node.js already installed — $(node --version 2>/dev/null)"
     fi
 
     if ! command_exists npm; then