vscode-offline 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

vscode_offline/app.py

@@ -1,11 +1,11 @@
 from __future__ import annotations
 
 import logging
-import os
 from argparse import ArgumentParser, Namespace
 from pathlib import Path
 
 from vscode_offline.download import (
+    download_vscode_client,
     download_vscode_extensions,
     download_vscode_server,
 )
@@ -14,56 +14,51 @@ from vscode_offline.install import (
     install_vscode_extensions,
     install_vscode_server,
 )
-from vscode_offline.loggers import logger
 from vscode_offline.utils import (
+    get_default_code_version,
     get_host_platform,
-    get_vscode_cli_bin,
-    get_vscode_commit_from_code_version,
-    get_vscode_commit_from_server_installer,
     get_vscode_extensions_config,
-    get_vscode_server_home,
+    get_vscode_version_from_server_installer,
 )
 
 
 def cmd_download_server(args: Namespace) -> None:
-    if args.commit is None:
-        args.commit = get_vscode_commit_from_code_version()
-        if args.commit is None:
-            logger.info(
-                "Cannot determine commit from `code --version`, please specify --commit manually."
+    if args.code_version is None:
+        args.code_version = get_default_code_version()
+        if args.code_version is None:
+            raise ValueError(
+                "Cannot determine version from `code --version`, please specify `--version` when downloading."
             )
-            raise ValueError("Please specify --commit when installing.")
 
     download_vscode_server(
-        args.commit,
-        output=args.installer / f"server-{args.commit}",
-        target_platform=args.target_platform,
+        args.code_version,
+        output=args.installer / f"server-{args.code_version.replace(':', '-')}",
+        platform=args.platform,
     )
     extensions_config = Path(args.extensions_config).expanduser()
     download_vscode_extensions(
-        extensions_config, args.target_platform, args.installer / "extensions"
+        extensions_config,
+        target_platforms=[args.platform],
+        output=args.installer / "extensions",
     )
 
 
 def cmd_install_server(args: Namespace) -> None:
     host_platform = get_host_platform()
-    if args.commit is None:
+    if args.code_version is None:
         try:
-            args.commit = get_vscode_commit_from_server_installer(
+            args.code_version = get_vscode_version_from_server_installer(
                 args.installer, host_platform
             )
         except Exception as e:
             raise ValueError(
-                f"{e}, please specify `--commit` when installing."
+                f"{e}, please specify `--version` when installing."
             ) from None
 
-    install_vscode_server(
-        args.commit,
-        cli_installer=args.installer / f"server-{args.commit}",
-        vscode_cli_bin=get_vscode_cli_bin(args.commit),
+    vscode_server_home = install_vscode_server(
+        server_installer=args.installer / f"server-{args.code_version}",
         platform=host_platform,
     )
-    vscode_server_home = get_vscode_server_home(args.commit)
     install_vscode_extensions(
         Path(vscode_server_home) / "bin/code-server",
         vsix_dir=args.installer / "extensions",
@@ -75,19 +70,68 @@ def cmd_install_server(args: Namespace) -> None:
 def cmd_download_extensions(args: Namespace) -> None:
     extensions_config = Path(args.extensions_config).expanduser()
     download_vscode_extensions(
-        extensions_config, args.target_platform, args.installer / "extensions"
+        extensions_config,
+        target_platforms=[args.platform],
+        output=args.installer / "extensions",
     )
 
 
 def cmd_install_extensions(args: Namespace) -> None:
     host_platform = get_host_platform()
     install_vscode_extensions(
-        os.fspath("code"),
+        args.code,
         vsix_dir=args.installer / "extensions",
         platform=host_platform,
     )
 
 
+def cmd_download_client(args: Namespace) -> None:
+    if args.code_version is None:
+        args.code_version = get_default_code_version()
+        if args.code_version is None:
+            raise ValueError(
+                "Cannot determine version from `code --version`, please specify `--version` manually."
+            )
+
+    download_vscode_client(
+        args.code_version,
+        output=args.installer / f"client-{args.code_version.replace(':', '-')}",
+        platform=args.platform,
+    )
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config,
+        target_platforms=[args.platform],
+        output=args.installer / "extensions",
+    )
+
+
+def cmd_download_all(args: Namespace) -> None:
+    if args.code_version is None:
+        args.code_version = get_default_code_version()
+        if args.code_version is None:
+            raise ValueError(
+                "Cannot determine version from `code --version`, please specify `--version` manually."
+            )
+
+    download_vscode_server(
+        args.code_version,
+        output=args.installer / f"server-{args.code_version.replace(':', '-')}",
+        platform=args.server_platform,
+    )
+    download_vscode_client(
+        args.code_version,
+        output=args.installer / f"client-{args.code_version.replace(':', '-')}",
+        platform=args.client_platform,
+    )
+    extensions_config = Path(args.extensions_config).expanduser()
+    download_vscode_extensions(
+        extensions_config,
+        target_platforms=[args.server_platform, args.client_platform],
+        output=args.installer / "extensions",
+    )
+
+
 def make_argparser() -> ArgumentParser:
     parent_parser = ArgumentParser(add_help=False)
 
@@ -108,12 +152,12 @@ def make_argparser() -> ArgumentParser:
     )
     download_server_parser.set_defaults(func=cmd_download_server)
     download_server_parser.add_argument(
-        "--commit",
+        "--code-version",
         type=str,
-        help="The commit hash of the VS Code Server to download, must match the version of the VSCode client.",
+        help="The version of the VS Code Server to download, must match the version of the VS Code Client.",
     )
     download_server_parser.add_argument(
-        "--target-platform",
+        "--platform",
         type=str,
         required=True,
         help="The target platform of the VS Code Server to download.",
@@ -132,9 +176,9 @@ def make_argparser() -> ArgumentParser:
     )
     install_server_parser.set_defaults(func=cmd_install_server)
     install_server_parser.add_argument(
-        "--commit",
+        "--code-version",
         type=str,
-        help="The commit hash of the VS Code Server to install.",
+        help="The version of the VS Code Server to install.",
     )
 
     download_extensions_parser = subparsers.add_parser(
@@ -144,10 +188,10 @@ def make_argparser() -> ArgumentParser:
     )
     download_extensions_parser.set_defaults(func=cmd_download_extensions)
     download_extensions_parser.add_argument(
-        "--target-platform",
+        "--platform",
         type=str,
         required=True,
-        help="The target platform of the VSCode extensions to download.",
+        help="The target platform of the VS Code extensions to download.",
     )
     download_extensions_parser.add_argument(
         "--extensions-config",
@@ -158,17 +202,71 @@ def make_argparser() -> ArgumentParser:
 
     install_extensions_parser = subparsers.add_parser(
         "install-extensions",
-        help="Install VSCode extensions",
+        help="Install VS Code extensions",
         parents=[parent_parser],
     )
     install_extensions_parser.set_defaults(func=cmd_install_extensions)
-    download_extensions_parser.add_argument(
+    install_extensions_parser.add_argument(
         "--code",
         type=str,
         default="code",
         help="Path to the `code` binary.",
     )
 
+    download_client_parser = subparsers.add_parser(
+        "download-client",
+        help="Download VS Code and extensions",
+        parents=[parent_parser],
+    )
+    download_client_parser.set_defaults(func=cmd_download_client)
+    download_client_parser.add_argument(
+        "--code-version",
+        type=str,
+        help="The version of the VS Code to download, must match the version of the VS Code Client.",
+    )
+    download_client_parser.add_argument(
+        "--platform",
+        type=str,
+        required=True,
+        help="The target platform of the VS Code to download.",
+    )
+    download_client_parser.add_argument(
+        "--extensions-config",
+        type=Path,
+        default=get_vscode_extensions_config(),
+        help="Path to the extensions configuration file. Will search for extensions to download.",
+    )
+
+    download_all_parser = subparsers.add_parser(
+        "download-all",
+        help="Download VS Code server, client and extensions, all in one command",
+        parents=[parent_parser],
+    )
+    download_all_parser.set_defaults(func=cmd_download_all)
+    download_all_parser.add_argument(
+        "--code-version",
+        type=str,
+        help="The version of the VS Code to download, defaults to `code --version` at current environment.",
+    )
+    download_all_parser.add_argument(
+        "--server-platform",
+        type=str,
+        default="linux-x64",
+        help="The target platform of the VS Code Server to download, defaults to linux-x64.",
+    )
+    download_all_parser.add_argument(
+        "--client-platform",
+        type=str,
+        default="win32-x64",
+        help="The target platform of the VS Code to download, defaults to win32-x64.",
+    )
+    download_all_parser.add_argument(
+        "--extensions-config",
+        type=Path,
+        default=get_vscode_extensions_config(),
+        help="Path to the extensions configuration file. Will search for extensions to download.",
+    )
+
     return parser
 
 

vscode_offline/download.py

@@ -2,17 +2,22 @@ from __future__ import annotations
 
 import json
 import os
+from collections.abc import Sequence
 from gzip import GzipFile
+from io import DEFAULT_BUFFER_SIZE
+from pathlib import Path
 from urllib.error import HTTPError
 from urllib.request import urlopen
 
 from vscode_offline.loggers import logger
-from vscode_offline.utils import get_cli_os_arch
+from vscode_offline.utils import get_cli_platform, get_filename_from_headers
 
-_CHUCK_SIZE = 4 * 1024 * 1024  # 4MiB
 
-
-def _download_file(url: str, filename: str) -> None:
+def _download_file(
+    url: str,
+    directory: str | os.PathLike[str],
+    filename: str | None = None,
+) -> os.PathLike[str]:
     with urlopen(url) as resp:
         content_encoding = resp.headers.get("Content-Encoding")
         if content_encoding in {"gzip", "deflate"}:
@@ -23,39 +28,56 @@ def _download_file(url: str, filename: str) -> None:
         else:
             raise ValueError(f"Unsupported Content-Encoding: {content_encoding}")
 
-        with reader, open(filename, "wb") as fp:
+        if filename:
+            file_path = Path(directory).joinpath(filename)
+        else:
+            filename = get_filename_from_headers(resp.headers)
+            if not filename:
+                raise ValueError(
+                    "Cannot get filename from HTTP headers, please specify argument `filename`."
+                )
+            logger.info(f"Get filename `{filename}` from HTTP headers.")
+            file_path = Path(directory).joinpath(filename)
+            if file_path.exists():
+                logger.info(f"File {file_path} already exists, skipping download.")
+                return file_path
+
+        tmp_file_path = Path(directory).joinpath(f"{filename}.tmp")
+        with reader, tmp_file_path.open("wb") as fp:
             while True:
-                chunk = reader.read(_CHUCK_SIZE)
+                chunk = reader.read(DEFAULT_BUFFER_SIZE)
                 if not chunk:
                     break
                 fp.write(chunk)
 
+        if os.path.exists(file_path):
+            os.remove(file_path)
+        os.rename(tmp_file_path, file_path)
+
+        logger.info(f"Saved to {file_path} .")
+        return file_path
+
 
 def download_file(
     url: str,
-    filename: str,
+    directory: str | os.PathLike[str],
+    filename: str | None = None,
 ) -> None:
-    if os.path.exists(filename):
-        logger.info(f"File {filename} already exists, skipping download.")
-        return
-
-    logger.info(f"Downloading {url}")
-    tmp_filename = f"{filename}.tmp"
+    if filename:
+        file_path = Path(directory).joinpath(filename)
+        if file_path.exists():
+            logger.info(f"File {file_path} already exists, skipping download.")
+            return
 
+    logger.info(f"Downloading {url} ...")
     for i in range(3):
         try:
-            _download_file(url, tmp_filename)
+            _download_file(url, directory, filename)
             break
         except Exception as e:
             if isinstance(e, HTTPError) and e.code == 404:
                 raise
-            logger.info(f"Attempt {i + 1} failed: {e}")
-
-    if os.path.exists(filename):
-        os.remove(filename)
-    os.rename(tmp_filename, filename)
-
-    logger.info(f"Saved to {filename}")
+            logger.info(f"Attempt {i + 1} times failed: {e}")
 
 
 def download_extension(
@@ -68,15 +90,14 @@ def download_extension(
     url = f"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage"
     if platform:
         url = f"{url}?targetPlatform={platform}"
-    filename = f"{publisher}.{name}-{version}"
-    if platform:
-        filename = f"{filename}@{platform}"
-    filename = f"{filename}.vsix"
-    download_file(url, f"{output}/{filename}")
+    filename = f"{publisher}.{name}-{version}{f'@{platform}' if platform else ''}.vsix"
+    download_file(url, output, filename)
 
 
 def download_vscode_extensions(
-    extensions_config: os.PathLike[str], target_platform: str, output: str = "."
+    extensions_config: os.PathLike[str],
+    target_platforms: Sequence[str],
+    output: str = ".",
 ) -> None:
     logger.info(f"Reading extensions config from {extensions_config}")
     with open(extensions_config) as fp:
@@ -87,18 +108,42 @@ def download_vscode_extensions(
         identifier = extension["identifier"]
         publisher, name = identifier["id"].split(".")
         version = extension["version"]
-        try:
-            download_extension(publisher, name, version, target_platform, output=output)
-        except HTTPError as e:
-            if e.code != 404:
+
+        requires_fallback_download = False
+        for target_platform in target_platforms:
+            try:
+                download_extension(
+                    publisher, name, version, target_platform, output=output
+                )
+            except HTTPError as e:
+                if e.code == 404:
+                    requires_fallback_download = True
+                    continue
                 raise
+        if requires_fallback_download:
             download_extension(publisher, name, version, output=output)
 
 
+def _download_vscode(
+    version: str,
+    output: str,
+    platform: str,
+) -> None:
+    """Download VS Code for the given version and target platform."""
+
+    # filename is like
+    # "VS CodeSetup-x64-1.104.3.exe" for windows VS Code,
+    # "vscode-server-linux-x64.tar.gz" for linux VS Code Server,
+    # "vscode_cli_alpine_x64_cli.tar.gz" for linux VS Code CLI.
+    download_file(
+        f"https://update.code.visualstudio.com/{version}/{platform}/stable", output
+    )
+
+
 def download_vscode_server(
-    commit: str,
+    version: str,
     output: str,
-    target_platform: str,
+    platform: str,
 ) -> None:
     """Download VS Code Server and CLI for the given commit and target platform.
 
@@ -107,13 +152,16 @@ def download_vscode_server(
         https://blog.csdn.net/qq_69668825/article/details/144224417
     """
     os.makedirs(output, exist_ok=True)
-    download_file(
-        f"https://update.code.visualstudio.com/commit:{commit}/server-{target_platform}/stable",
-        f"{output}/vscode-server-{target_platform}.tar.gz",
-    )
-    target_os_arch = get_cli_os_arch(target_platform)
-    target_os_arch_ = target_os_arch.replace("-", "_")
-    download_file(
-        f"https://update.code.visualstudio.com/commit:{commit}/cli-{target_os_arch}/stable",
-        f"{output}/vscode_cli_{target_os_arch_}_cli.tar.gz",
-    )
+    _download_vscode(version, output, f"server-{platform}")
+    cli_platform = get_cli_platform(platform)
+    _download_vscode(version, output, f"cli-{cli_platform}")
+
+
+def download_vscode_client(
+    version: str,
+    output: str,
+    platform: str,
+) -> None:
+    """Download VS Code Client for the given version and target platform."""
+    os.makedirs(output, exist_ok=True)
+    _download_vscode(version, output, platform)

vscode_offline/install.py

@@ -1,13 +1,18 @@
 from __future__ import annotations
 
 import os
+import re
 import subprocess
 from collections.abc import Set as AbstractSet
 from pathlib import Path
 from tempfile import TemporaryDirectory
 
 from vscode_offline.loggers import logger
-from vscode_offline.utils import get_cli_os_arch, get_vscode_server_home
+from vscode_offline.utils import (
+    get_cli_platform,
+    get_vscode_cli_bin,
+    get_vscode_server_home,
+)
 
 # These extensions are excluded because they are not needed in a VS Code Server.
 SERVER_EXCLUDE_EXTENSIONS = frozenset(
@@ -64,26 +69,40 @@ def install_vscode_extensions(
         logger.info(f"Installed {vsix_file}")
 
 
+_code_version_output_pattern = re.compile(rb"\(commit ([0-9a-f]{40,})\)")
+
+
+def _extract_commit_from_code_version_output(code_version_output: bytes) -> str:
+    m = _code_version_output_pattern.search(code_version_output)
+    if not m:
+        raise ValueError("Cannot determine commit hash from code version")
+    return m.group(1).decode("utf-8")
+
+
 def install_vscode_server(
-    commit: str,
-    cli_installer: str,
-    vscode_cli_bin: os.PathLike[str],
+    server_installer: str,
     platform: str,
-) -> None:
-    cli_os = get_cli_os_arch(platform)
-    cli_os_ = cli_os.replace("-", "_")
+) -> os.PathLike[str]:
+    cli_platform = get_cli_platform(platform)
+    cli_platform_ = cli_platform.replace("-", "_")
 
-    vscode_cli_tarball = Path(cli_installer) / f"vscode_cli_{cli_os_}_cli.tar.gz"
+    code_cli_tarball = Path(server_installer) / f"vscode_cli_{cli_platform_}_cli.tar.gz"
     with TemporaryDirectory() as tmpdir:
-        subprocess.check_call(["tar", "-xzf", vscode_cli_tarball, "-C", tmpdir])
-        tmpfile = Path(tmpdir) / "code"
-        if os.path.exists(vscode_cli_bin):
-            os.remove(vscode_cli_bin)
-        os.makedirs(os.path.dirname(vscode_cli_bin), exist_ok=True)
-        os.rename(tmpfile, vscode_cli_bin)
-    logger.info(f"Extracted vscode_cli_{cli_os_}_cli.tar.gz to {vscode_cli_bin}")
-
-    vscode_server_tarball = Path(cli_installer) / f"vscode-server-{platform}.tar.gz"
+        subprocess.check_call(["tar", "-xzf", code_cli_tarball, "-C", tmpdir])
+        tmp_code_cli = Path(tmpdir) / "code"
+        version_output = subprocess.check_output(
+            ["code", "--version"], executable=tmp_code_cli, cwd=tmpdir
+        )
+        commit = _extract_commit_from_code_version_output(version_output)
+        logger.info(f"Extracted commit from `code --version`: {commit}")
+        code_cli = get_vscode_cli_bin(commit)
+        if os.path.exists(code_cli):
+            os.remove(code_cli)
+        os.makedirs(os.path.dirname(code_cli), exist_ok=True)
+        os.rename(tmp_code_cli, code_cli)
+    logger.info(f"Extracted vscode_cli_{cli_platform_}_cli.tar.gz to {code_cli}")
+
+    vscode_server_tarball = Path(server_installer) / f"vscode-server-{platform}.tar.gz"
     vscode_server_home = get_vscode_server_home(commit)
     os.makedirs(vscode_server_home, exist_ok=True)
     subprocess.check_call(
@@ -97,3 +116,4 @@ def install_vscode_server(
         ]
     )
     logger.info(f"Extracted vscode-server-{platform}.tar.gz to {vscode_server_home}")
+    return vscode_server_home

vscode_offline/utils.py

@@ -4,6 +4,8 @@ import os
 import shutil
 import subprocess
 import sys
+from collections.abc import Mapping
+from email.parser import HeaderParser
 from pathlib import Path
 
 from vscode_offline.loggers import logger
@@ -30,7 +32,7 @@ def get_vscode_extensions_config() -> os.PathLike[str]:
     return p  # default to this path
 
 
-def get_vscode_commit_from_server_installer(
+def get_vscode_version_from_server_installer(
     installer: os.PathLike[str], platform: str
 ) -> str:
     directories = list(
@@ -45,14 +47,16 @@ def get_vscode_commit_from_server_installer(
             f"No matching installer found in {installer} for platform {platform}"
         )
 
-    commit = directories[0].parent.name[len("server-") :]
-    logger.info(f"Getting commit from {platform} installer: {commit}")
-    return commit
+    version = directories[0].parent.name[len("server-") :]
+    logger.info(f"Getting version from {platform} installer: {version}")
+    return version
 
 
-def get_vscode_commit_from_code_version() -> str | None:
-    """Get the current VS Code commit hash by running `code --version`.
-    Returns None if `code` is not found or the output is unexpected.
+def get_default_code_version() -> str | None:
+    """Get the current VS Code version by running `code --version`.
+
+    Returns:
+        `None` if `code` is not found or the output is unexpected.
     """
     executable = shutil.which("code")
     if executable is None:
@@ -70,34 +74,30 @@ def get_vscode_commit_from_code_version() -> str | None:
 
     # The commit hash is usually on the second line
     commit = lines[1].strip().decode("utf-8")
-    logger.info(f"Getting commit from `code --version`: {commit}")
-
-    return lines[1].strip().decode("utf-8")
+    version = f"commit:{commit}"
+    logger.info(f"Getting version from `code --version`: {version}")
 
-
-def get_target_platform_from_installer(cli_installer: str) -> str | None:
-    directories = list(Path(cli_installer).glob("vscode-server-*.tar.gz"))
-    if len(directories) == 1:
-        return directories[0].name[len("vscode-server-") : -len(".tar.gz")]
-    return None
+    return version
 
 
 # Mapping from target platform to CLI OS and architecture used in download URLs
-_cli_os_arch_mapping = {
+_cli_platform_mapping = {
     "linux-x64": "alpine-x64",
     "linux-arm64": "alpine-arm64",
+    "linux-armhf": "linux-arm64",
+    "win32-x64": "win32-x64",
 }
 
 
-def get_cli_os_arch(platform: str) -> str:
+def get_cli_platform(platform: str) -> str:
     """Get the CLI OS and architecture for the given target platform."""
-    if platform not in _cli_os_arch_mapping:
+    if platform not in _cli_platform_mapping:
         raise ValueError(f"Unsupported target platform: {platform}")
-    return _cli_os_arch_mapping[platform]
+    return _cli_platform_mapping[platform]
 
 
 def get_host_platform() -> str:
-    """Get the host platform in the format used by VS Code Server install."""
+    """Get the host platform in the format used by VS Code install."""
     if os.name == "nt":
         if "amd64" in sys.version.lower():
             return "win32-x64"
@@ -111,3 +111,21 @@ def get_host_platform() -> str:
         elif machine in ("aarch64", "arm64"):
             return "linux-arm64"
     raise ValueError(f"Unsupported host platform: {osname}-{machine}")
+
+
+def get_filename_from_headers(headers: Mapping[str, str]) -> str | None:
+    """Get the filename from HTTP headers.
+
+    Args:
+        headers: The HTTP headers.
+    """
+    content_disposition = headers.get("Content-Disposition")
+    header_str = ""
+    if content_type := headers.get("Content-Type"):
+        header_str += f"Content-Type: {content_type}\n"
+    if content_disposition := headers.get("Content-Disposition"):
+        header_str += f"Content-Disposition: {content_disposition}\n"
+    if not header_str:
+        return None
+    header = HeaderParser().parsestr(header_str)
+    return header.get_filename()

{vscode_offline-0.1.3.dist-info → vscode_offline-0.1.5.dist-info}/METADATA

@@ -1,25 +1,24 @@
 Metadata-Version: 2.4
 Name: vscode-offline
-Version: 0.1.3
+Version: 0.1.5
 Summary: Download and install VS Code Server for offline environments
-Author: Chuck Fan
+Project-URL: Homepage, https://github.com/fanck0605/vscode-offline
 Author-email: Chuck Fan <fanck0605@qq.com>
 License-Expression: MIT
 License-File: LICENSE
 Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Operating System :: Microsoft :: Windows
 Classifier: Topic :: Utilities
 Requires-Python: >=3.9
-Project-URL: Homepage, https://github.com/fanck0605/vscode-offline
 Description-Content-Type: text/markdown
 
 # vscode-offline
@@ -37,38 +36,40 @@ pip install -U vscode-offline
 1. 自动识别并下载所有 `.vsix` 文件（包括间接依赖）
 2. 一键安装 VS Code Server 以及所有插件
 
-## VS Code Server 安装
+## VS Code 离线安装
 
-（1）在联网环境安装好 VSCode 和你需要的插件。
+（1）在联网环境安装好 VS Code 和你需要的插件，如 [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh), [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) 等。
 
-（2）执行如下命令，将会自动下载 VS Code Server，和目前安装的所有的插件
+（2）执行如下命令，下载 VS Code 安装包，和目前安装的所有的插件
 
-> `--commit` 可以指定对应 VSCode 的 Commit，默认自动获取当前环境 VSCode 的 Commit。
->
-> 手动查看方式：*帮助* -> *关于* -> *Commit*，
+```shell
+vscode-offline download-all --installer ./vscode-offline-installer
+```
+
+（3）复制 `./vscode-offline-installer` 到内网 Windows 机器，安装 `client-<version>` 下的 VS Code，然后执行如下命令安装所有插件
 
 ```shell
-vscode-offline download-server --target-platform linux-x64 --installer ./vscode-offline-installer
+vscode-offline install-extensions --installer ./vscode-offline-installer
 ```
 
-（3）复制 `./vscode-offline-installer` 到内网服务器
+（4）复制 `./vscode-offline-installer` 到内网 Linux 服务器，执行如下命令安装 VS Code Server 和所有插件
 
 ```shell
 vscode-offline install-server --installer ./vscode-offline-installer
 ```
 
-## VS Code 插件安装
+## 指定 VS Code 版本号
 
-（1）联网环境执行如下命令，将会自动下载 VSCode 目前安装的所有的插件
+如果你想下载或安装指定版本的 VS Code，可以先通过 `code --version` 获取当前版本，然后通过 --code-version 参数指定版本号，例如：
 
 ```shell
-vscode-offline download-extensions --target-platform win32-x64 --installer ./vscode-offline-installer
+vscode-offline download-all --code-version 1.104.3
 ```
 
-（2）复制 `./vscode-offline-installer` 到内网机器
+也支持使用 commit hash 作为版本号，例如：
 
 ```shell
-vscode-offline install-extensions --installer ./vscode-offline-installer
+vscode-offline download-all --code-version commit:385651c938df8a906869babee516bffd0ddb9829
 ```
 
 ## 贡献

vscode_offline-0.1.5.dist-info/RECORD

@@ -0,0 +1,11 @@
+vscode_offline/__init__.py,sha256=dr6Jtj0XT9eQEC4fzNigEYsAIEfCsaom3HDbUsS-2O4,57
+vscode_offline/app.py,sha256=Rm-uSkJrRmJVmyjiubPpRQTofttQdTADsGyEeZDSeY0,9142
+vscode_offline/download.py,sha256=blu2WjG8zhuBrHrrV-v-FUf2fXbIt7fVSX8DoUX_Ikk,5442
+vscode_offline/install.py,sha256=SZ3UTg-fkzJrfwMGyvjyayyGHGKbymm6bkUs0ayZsKQ,4214
+vscode_offline/loggers.py,sha256=vX91NMtNo1xfxq5y4BCtm_uhCTKtCODqBJHNvcT7JdQ,104
+vscode_offline/utils.py,sha256=vpVSmE4JN0O-ezpzNJo9R9Y3YjzmzslhRVTG5H_-We0,4038
+vscode_offline-0.1.5.dist-info/METADATA,sha256=-ssOm2fHDRr25iLf5hcm4G7BYbMhrwobwrouzwuOWMY,2803
+vscode_offline-0.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+vscode_offline-0.1.5.dist-info/entry_points.txt,sha256=XyuZLe7bgm2RmZp9oh9qCxcrAwHypD8XrTnm4G0_CzM,55
+vscode_offline-0.1.5.dist-info/licenses/LICENSE,sha256=pUIXFkLeTS986b7dopOVLyuw72fJsUxhl8H3rEMIycA,1053
+vscode_offline-0.1.5.dist-info/RECORD,,

vscode_offline-0.1.5.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

{vscode_offline-0.1.3.dist-info → vscode_offline-0.1.5.dist-info}/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 vscode-offline = vscode_offline:main
-

vscode_offline-0.1.3.dist-info/RECORD

@@ -1,11 +0,0 @@
-vscode_offline/__init__.py,sha256=dr6Jtj0XT9eQEC4fzNigEYsAIEfCsaom3HDbUsS-2O4,57
-vscode_offline/app.py,sha256=MLYg_2q3pudTL0zBAWTRSjVM_8zDccLIZt0s00xvT7Q,5686
-vscode_offline/download.py,sha256=hImUW23npX0hgNMcJ2E3nRLbW8fvzeIFEovg0mWzm9U,3763
-vscode_offline/install.py,sha256=UNgLnMAAZEOtX4s8v6QlmuIHPf3aeuXrCWfC6_TEM-0,3488
-vscode_offline/loggers.py,sha256=vX91NMtNo1xfxq5y4BCtm_uhCTKtCODqBJHNvcT7JdQ,104
-vscode_offline/utils.py,sha256=XknMz1aBMyyTvWG-szE_0eMG3KOdpl9aAeX3E5BrDAI,3542
-vscode_offline-0.1.3.dist-info/licenses/LICENSE,sha256=pUIXFkLeTS986b7dopOVLyuw72fJsUxhl8H3rEMIycA,1053
-vscode_offline-0.1.3.dist-info/WHEEL,sha256=-neZj6nU9KAMg2CnCY6T3w8J53nx1kFGw_9HfoSzM60,79
-vscode_offline-0.1.3.dist-info/entry_points.txt,sha256=zIMeh_ENKKzlt9lDao8icofSI0TeCQxH8eCwxIRI2G8,56
-vscode_offline-0.1.3.dist-info/METADATA,sha256=hjeP62mRkggLHpIypE8RgSNXUceC9PYGYBWCrhvabak,2492
-vscode_offline-0.1.3.dist-info/RECORD,,

vscode_offline-0.1.3.dist-info/WHEEL

@@ -1,4 +0,0 @@
-Wheel-Version: 1.0
-Generator: uv 0.8.22
-Root-Is-Purelib: true
-Tag: py3-none-any