Add --version flag to install.sh to install a specific GitHub release (#659)

Agent-Logs-Url: https://github.com/version-fox/vfox/sessions/6ab6e3d5-ea72-4885-8cbd-5dd3cc02dcbd

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: bytemain <13938334+bytemain@users.noreply.github.com>

Author: Copilot

docs/guides/quick-start.md

@@ -80,6 +80,20 @@ This will:
 - Automatically create the directory if it doesn't exist
 - Provide instructions to add `~/.local/bin` to your `PATH`
 
+**Install a Specific Version**
+
+By default the script installs the latest GitHub release. To install a specific version, use the `--version` flag (with or without the leading `v`):
+
+```shell
+curl -sSL https://raw.githubusercontent.com/version-fox/vfox/main/install.sh | bash -s -- --version 0.5.6
+```
+
+`--version` can be combined with `--user`, for example:
+
+```shell
+curl -sSL https://raw.githubusercontent.com/version-fox/vfox/main/install.sh | bash -s -- --user --version 0.5.6
+```
+
 </TabItem>
 </Tabs>
 

docs/zh-hans/guides/quick-start.md

@@ -80,6 +80,20 @@ curl -sSL https://raw.githubusercontent.com/version-fox/vfox/main/install.sh | b
 - 如果目录不存在，会自动创建
 - 提供将 `~/.local/bin` 添加到 `PATH` 的说明
 
+**安装指定版本**
+
+默认情况下安装脚本会安装最新的 GitHub Release。如果想安装指定版本，可以使用 `--version` 参数（版本号可带或不带前缀 `v`）：
+
+```shell
+curl -sSL https://raw.githubusercontent.com/version-fox/vfox/main/install.sh | bash -s -- --version 0.5.6
+```
+
+`--version` 可以与 `--user` 组合使用，例如：
+
+```shell
+curl -sSL https://raw.githubusercontent.com/version-fox/vfox/main/install.sh | bash -s -- --user --version 0.5.6
+```
+
 </TabItem>
 </Tabs>
 

install.sh

@@ -3,19 +3,42 @@
 main() {
   # Parse command-line arguments
   USER_INSTALL=false
-  for arg in "$@"; do
-    case "$arg" in
+  VERSION=""
+  while [ $# -gt 0 ]; do
+    case "$1" in
       --user)
         USER_INSTALL=true
+        shift
+        ;;
+      --version)
+        if [ -z "$2" ]; then
+          echo "Error: --version requires a value (e.g. --version 0.5.6 or --version v0.5.6)"
+          exit 1
+        fi
+        VERSION="$2"
+        shift 2
+        ;;
+      --version=*)
+        VERSION="${1#--version=}"
+        if [ -z "$VERSION" ]; then
+          echo "Error: --version requires a value (e.g. --version=0.5.6)"
+          exit 1
+        fi
+        shift
         ;;
       *)
-        echo "Unknown argument: $arg"
-        echo "Usage: $0 [--user]"
+        echo "Unknown argument: $1"
+        echo "Usage: $0 [--user] [--version <version>]"
         exit 1
         ;;
     esac
   done
 
+  # Strip a leading 'v' from a user-supplied version (we add it back when needed)
+  if [ -n "$VERSION" ]; then
+    VERSION="${VERSION#v}"
+  fi
+
   # Detect if running in Termux
   IS_TERMUX=false
   case "${HOME:-}" in
@@ -55,8 +78,14 @@ main() {
     exit 1
   fi
 
-  # Get the latest version
-  if [ -n "${GITHUB_TOKEN}" ]; then
+  # Get the version: use the user-specified one if provided, otherwise fetch latest
+  if [ -n "$VERSION" ]; then
+    if [ -n "${GITHUB_TOKEN}" ]; then
+      API_RESPONSE=$(curl --silent --header "Authorization: Bearer ${GITHUB_TOKEN}" "https://api.github.com/repos/version-fox/vfox/releases/tags/v${VERSION}")
+    else
+      API_RESPONSE=$(curl --silent "https://api.github.com/repos/version-fox/vfox/releases/tags/v${VERSION}")
+    fi
+  elif [ -n "${GITHUB_TOKEN}" ]; then
     API_RESPONSE=$(curl --silent --header "Authorization: Bearer ${GITHUB_TOKEN}" "https://api.github.com/repos/version-fox/vfox/releases/latest")
   else
     API_RESPONSE=$(curl --silent "https://api.github.com/repos/version-fox/vfox/releases/latest")
@@ -69,11 +98,16 @@ main() {
     exit 1
   fi
 
-  VERSION=$(echo "$API_RESPONSE" | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/' | cut -c 2-)
-  if [ -z "$VERSION" ]; then
-    echo "Failed to get the latest version. Please check your network connection and try again."
+  RESOLVED_VERSION=$(echo "$API_RESPONSE" | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/' | cut -c 2-)
+  if [ -z "$RESOLVED_VERSION" ]; then
+    if [ -n "$VERSION" ]; then
+      echo "Failed to find vfox version v${VERSION} on GitHub. Please verify the version exists at https://github.com/version-fox/vfox/releases."
+    else
+      echo "Failed to get the latest version. Please check your network connection and try again."
+    fi
     exit 1
   fi
+  VERSION="$RESOLVED_VERSION"
   echo "Installing vfox v$VERSION ..."
 
   # Check if the OS is supported