iamt 1.1.27__py3-none-any.whl

iamt/modules/ubuntud/chrome.py

@@ -0,0 +1,111 @@
+"""Google Chrome 模块 - 在远程 Ubuntu 主机上安装和配置 Chrome 浏览器
+
+该模块通过 SSH 连接执行远程命令，实现 Chrome 浏览器的自动化部署。
+"""
+
+from fabric import Connection, task
+
+from .._utils.arch import normalize_arch
+from .._utils.github import download_file
+
+
+# region 模块常量配置
+
+# Chrome 下载 URL 模板
+CHROME_DOWNLOAD_URL_TEMPLATE = "https://dl.google.com/linux/direct/google-chrome-stable_current_{arch}.deb"
+
+# 架构映射 (dpkg -> Chrome 架构名称)
+CHROME_ARCH_MAP = {
+    "amd64": "amd64",
+    "arm64": "arm64",
+}
+
+# 环境变量 (使用英文输出避免中文乱码)
+ENV_LANG_C = {"LANG": "C", "LC_ALL": "C"}
+
+# endregion
+
+
+# region 辅助函数
+
+def _get_remote_arch(conn: Connection) -> str:
+    """获取远程主机的架构标识
+    
+    优先使用 hostvars 中已收集的架构信息，避免重复执行命令
+    
+    Args:
+        conn: Fabric 连接对象
+        
+    Returns:
+        Chrome 架构名称 (如 amd64, arm64)
+    """
+    # 优先从 hostvars 获取架构信息
+    if hasattr(conn, "hostvars") and conn.hostvars:
+        arch = conn.hostvars.get("architecture", "")
+        if arch:
+            dpkg_arch = normalize_arch(arch)
+            return CHROME_ARCH_MAP.get(dpkg_arch, "amd64")
+    
+    # 回退方案：直接执行命令获取
+    result = conn.run("uname -m", hide=True)
+    arch = result.stdout.strip()
+    dpkg_arch = normalize_arch(arch)
+    return CHROME_ARCH_MAP.get(dpkg_arch, "amd64")
+
+# endregion
+
+
+# region Task 函数
+
+@task
+def install_chrome(conn: Connection) -> None:
+    """下载并安装 Google Chrome 浏览器 (本地下载模式)
+    
+    先将 Chrome 安装包下载到本地，然后上传到服务器并安装。
+    适用于本地网络条件较好的场景。
+    
+    Args:
+        conn: Fabric 连接对象
+    """
+    arch = _get_remote_arch(conn)
+    print(f"[INFO] 目标架构: {arch}")
+    
+    remote_tmp_dir = "/tmp/chrome_install"
+    remote_deb = f"{remote_tmp_dir}/google-chrome-stable.deb"
+    
+    # region 下载并上传安装包
+    print("\n[任务] 下载 Google Chrome")
+    url = CHROME_DOWNLOAD_URL_TEMPLATE.format(arch=arch)
+    filename = f"google-chrome-stable_{arch}.deb"
+    deb_path = download_file(url, conn.artifacts_dir, filename)
+    
+    print("\n[任务] 上传安装包到远程主机")
+    conn.run(f"mkdir -p {remote_tmp_dir}", env=ENV_LANG_C)
+    conn.put(deb_path, remote_deb)
+    print(f"  上传完成: {remote_deb}")
+    # endregion
+    
+    # region 安装依赖和 Chrome
+    print("\n[任务] 安装 Google Chrome")
+    # 更新包索引
+    conn.sudo("apt-get update", env=ENV_LANG_C)
+    # 安装 .deb 包及其依赖
+    conn.sudo(f"apt-get install -y {remote_deb}", env=ENV_LANG_C)
+    print("  Chrome 已安装")
+    # endregion
+    
+    # region 清理临时文件
+    print("\n[任务] 清理临时文件")
+    conn.run(f"rm -rf {remote_tmp_dir}", env=ENV_LANG_C)
+    print("  清理完成")
+    # endregion
+    
+    # region 验证安装
+    print("\n[任务] 验证安装")
+    result = conn.run("google-chrome --version", hide=True)
+    print(f"  {result.stdout.strip()}")
+    # endregion
+    
+    print("\n[OK] Google Chrome 安装完成 (本地下载模式)")
+
+# endregion 

iamt/modules/ubuntud/ibus.py

@@ -0,0 +1,53 @@
+"""IBus 输入法模块 - 在远程 Ubuntu 主机上安装和配置 IBus 输入法框架
+
+该模块通过 SSH 连接执行远程命令，实现 IBus 及中文输入法的自动化部署。
+"""
+
+from fabric import Connection, task
+
+
+# region 模块常量配置
+
+# 需要安装的 IBus 相关包
+IBUS_PACKAGES = [
+    "ibus",
+    "ibus-libpinyin",
+    "ibus-rime",
+]
+
+# 环境变量 (使用英文输出避免中文乱码)
+ENV_LANG_C = {"LANG": "C", "LC_ALL": "C"}
+
+# endregion
+
+
+# region Task 函数
+
+@task
+def install_ibus(conn: Connection) -> None:
+    """安装 IBus 输入法框架及中文输入法
+    
+    安装 ibus、ibus-libpinyin 和 ibus-rime，并重启 ibus 服务。
+    
+    Args:
+        conn: Fabric 连接对象
+    """
+    packages_str = " ".join(IBUS_PACKAGES)
+    
+    # region 安装 IBus 及输入法
+    print("[任务] 安装 IBus 输入法框架")
+    conn.sudo("apt-get update", env=ENV_LANG_C)
+    conn.sudo(f"apt-get install -y {packages_str}", env=ENV_LANG_C)
+    print("  IBus 及输入法已安装")
+    # endregion
+    
+    # region 重启 IBus
+    print("\n[任务] 重启 IBus 服务")
+    conn.run("ibus restart || true", env=ENV_LANG_C, warn=True)
+    print("  IBus 已重启")
+    # endregion
+    
+    print("\n[OK] IBus 输入法安装完成")
+    print("[提示] 请通过「设置 -> 键盘 -> 输入源」添加已安装的输入法")
+
+# endregion

iamt/modules/ubuntud/kiro.py

@@ -0,0 +1,41 @@
+from fabric import Connection, task
+
+from .._utils.github import download_file
+
+
+# region Kiro IDE 安装任务
+
+
+@task
+def install_kiro(conn: Connection, version: str = "0.8.86") -> None:
+    """下载、上传并安装 Kiro IDE deb 包
+    
+    Args:
+        conn: Fabric 连接对象
+        version: Kiro IDE 版本号，默认为 0.8.86
+    """
+    deb_filename = f"kiro-ide-{version}-stable-linux-x64.deb"
+    
+    # region 下载 deb 包到本地
+    print(f"\n[任务] 下载 Kiro IDE {version}")
+    download_url = f"https://prod.download.desktop.kiro.dev/releases/stable/linux-x64/signed/{version}/deb/{deb_filename}"
+    deb_path = download_file(download_url, conn.artifacts_dir, deb_filename)
+    # endregion
+    
+    # region 上传 deb 包到服务器
+    print("\n[任务] 上传 deb 包到服务器")
+    remote_deb_path = f"/tmp/{deb_filename}"
+    conn.put(deb_path, remote_deb_path)
+    print(f"  上传完成: {remote_deb_path}")
+    # endregion
+    
+    # region 安装 deb 包
+    print("\n[任务] 安装 Kiro IDE")
+    # 使用 dpkg 安装，如果有依赖问题则用 apt-get -f install 修复
+    conn.sudo(f"dpkg -i {remote_deb_path}", warn=True)
+    conn.sudo("apt-get install -f -y", warn=True)
+    print("  安装完成")
+    # endregion
+
+
+# endregion

iamt/modules/ubuntud/rime_ice.py

@@ -0,0 +1,173 @@
+"""Rime Ice 模块 - 在远程 Ubuntu 主机上安装 rime-ice 输入法配置
+
+该模块通过 SSH 连接执行远程命令，实现 rime-ice 配置的自动化部署。
+rime-ice 是一个开源的 Rime 输入法配置方案。
+"""
+
+from datetime import datetime
+from pathlib import Path
+from fabric import Connection, task
+
+from .._utils.github import download_file
+
+
+# region 模块常量配置
+
+# rime-ice 仓库下载 URL
+RIME_ICE_DOWNLOAD_URL = "https://github.com/iDvel/rime-ice/archive/refs/heads/main.zip"
+
+# 环境变量 (使用英文输出避免中文乱码)
+ENV_LANG_C = {"LANG": "C", "LC_ALL": "C"}
+
+# 模板目录
+TEMPLATES_DIR = Path(__file__).parent / "templates"
+
+# endregion
+
+
+# region 辅助函数
+
+def _find_rime_config_dir(conn: Connection) -> str | None:
+    """查找 rime 配置目录
+    
+    按优先级检查常见的 rime 配置目录位置
+    
+    Args:
+        conn: Fabric 连接对象
+        
+    Returns:
+        rime 配置目录路径，未找到返回 None
+    """
+    user_home = conn.hostvars.get("user_home", "~")
+    
+    # 常见的 rime 配置目录位置
+    candidates = [
+        f"{user_home}/.local/share/fcitx5/rime",  # fcitx5
+        f"{user_home}/.config/ibus/rime",          # ibus
+        f"{user_home}/.config/fcitx/rime",         # fcitx4
+    ]
+    
+    for path in candidates:
+        result = conn.run(f"test -d {path} && echo exists", hide=True, warn=True)
+        if result.ok and "exists" in result.stdout:
+            return path
+    
+    return None
+
+
+def _get_rime_parent_dir(rime_dir: str) -> str:
+    """获取 rime 配置目录的父目录"""
+    return "/".join(rime_dir.rsplit("/", 1)[:-1]) or "/"
+
+# endregion
+
+
+# region Task 函数
+
+@task
+def install_rime_ice(conn: Connection) -> None:
+    """安装 rime-ice 输入法配置
+    
+    执行以下步骤：
+    1. 查找 rime 配置目录
+    2. 备份现有 rime 文件夹 (格式: 日期_rime_bak)
+    3. 创建新的空 rime 文件夹
+    4. 下载 rime-ice 仓库并上传到远程服务器
+    5. 解压并复制内容到 rime 文件夹
+    
+    Args:
+        conn: Fabric 连接对象
+    """
+    # region 查找 rime 配置目录
+    print("\n[任务] 查找 rime 配置目录")
+    rime_dir = _find_rime_config_dir(conn)
+    if rime_dir is None:
+        print("  [错误] 未找到 rime 配置目录，请先安装 fcitx5-rime 或 ibus-rime")
+        return
+    print(f"  找到配置目录: {rime_dir}")
+    # endregion
+    
+    # region 备份现有 rime 文件夹
+    print("\n[任务] 备份现有 rime 配置")
+    parent_dir = _get_rime_parent_dir(rime_dir)
+    backup_name = f"{datetime.now().strftime('%Y%m%d')}_rime_bak"
+    backup_path = f"{parent_dir}/{backup_name}"
+    
+    # 检查是否已存在同名备份
+    result = conn.run(f"test -d {backup_path} && echo exists", hide=True, warn=True)
+    if result.ok and "exists" in result.stdout:
+        print(f"  [警告] 备份目录已存在: {backup_path}，将覆盖")
+        conn.run(f"rm -rf {backup_path}", env=ENV_LANG_C)
+    
+    conn.run(f"mv {rime_dir} {backup_path}", env=ENV_LANG_C)
+    print(f"  备份完成: {backup_path}")
+    # endregion
+    
+    # region 创建新的空 rime 文件夹
+    print("\n[任务] 创建新的 rime 配置目录")
+    conn.run(f"mkdir -p {rime_dir}", env=ENV_LANG_C)
+    print(f"  创建完成: {rime_dir}")
+    # endregion
+    
+    # region 下载并上传 rime-ice
+    print("\n[任务] 下载 rime-ice")
+    local_zip = download_file(
+        RIME_ICE_DOWNLOAD_URL,
+        conn.artifacts_dir,
+        "rime-ice-main.zip",
+    )
+    
+    print("\n[任务] 上传 rime-ice 到远程主机")
+    remote_tmp_dir = "/tmp/rime_ice_install"
+    remote_zip = f"{remote_tmp_dir}/rime-ice-main.zip"
+    
+    conn.run(f"mkdir -p {remote_tmp_dir}", env=ENV_LANG_C)
+    conn.put(local_zip, remote_zip)
+    print(f"  上传完成: {remote_zip}")
+    # endregion
+    
+    # region 解压并复制内容
+    print("\n[任务] 解压并安装 rime-ice")
+    conn.run(f"unzip -q -o {remote_zip} -d {remote_tmp_dir}", env=ENV_LANG_C)
+    # 复制 rime-ice-main 目录下的所有内容到 rime 配置目录
+    conn.run(f"cp -r {remote_tmp_dir}/rime-ice-main/* {rime_dir}/", env=ENV_LANG_C)
+    print(f"  安装完成: {rime_dir}")
+    # endregion
+    
+    # region 复制用户自定义配置文件
+    print("\n[任务] 复制用户自定义配置文件")
+    if "ibus" in rime_dir:
+        custom_file = TEMPLATES_DIR / "ibus" / "ibus_rime.custom.yaml"
+        if custom_file.exists():
+            conn.put(str(custom_file), f"{rime_dir}/ibus_rime.custom.yaml")
+            print("  已复制: ibus_rime.custom.yaml")
+        else:
+            print(f"  [警告] 自定义配置文件不存在: {custom_file}")
+    # endregion
+    
+    # region 重启输入法框架
+    print("\n[任务] 重启输入法框架")
+    # 根据配置目录判断使用的输入法框架
+    if "fcitx5" in rime_dir:
+        conn.run("fcitx5 -r -d 2>/dev/null || true", env=ENV_LANG_C, warn=True)
+        print("  fcitx5 已重启")
+    elif "ibus" in rime_dir:
+        conn.run("ibus restart 2>/dev/null || true", env=ENV_LANG_C, warn=True)
+        print("  ibus 已重启")
+    elif "fcitx" in rime_dir:
+        conn.run("fcitx -r -d 2>/dev/null || true", env=ENV_LANG_C, warn=True)
+        print("  fcitx 已重启")
+    # endregion
+    
+    # region 清理临时文件
+    print("\n[任务] 清理临时文件")
+    conn.run(f"rm -rf {remote_tmp_dir}", env=ENV_LANG_C)
+    print("  清理完成")
+    # endregion
+    
+    print("\n[OK] rime-ice 安装完成")
+    print(f"  配置目录: {rime_dir}")
+    print(f"  备份位置: {backup_path}")
+    print("  请重新部署 rime 输入法以使配置生效")
+
+# endregion

iamt/modules/ubuntud/roles/role.py

@@ -0,0 +1,28 @@
+from rich.console import Console
+
+from ..v2rayN import Connection, install_v2rayn
+from ..vscode import install_vscode
+from ..kiro import install_kiro
+from ..chrome import install_chrome
+from ..ibus import install_ibus
+from ..._utils.steps import Step, run_steps
+from ...github.ghcli import install_gh
+
+console = Console()
+
+
+def setup_ubuntu_desktop(c: Connection):
+    """配置 Ubuntu 桌面开发环境
+    
+    安装 v2rayN、VSCode、Kiro、Chrome
+    """
+    steps: list[Step] = [
+        # ("安装 v2rayN", install_v2rayn),
+        ("安装 VSCode", install_vscode),
+        # ("安装 Kiro IDE", install_kiro),
+        ("安装 Google Chrome", install_chrome),
+        ("安装 ghcli",install_gh),
+        # ("安装中文输入法",install_ibus)
+    ]
+    run_steps(c, steps)
+    console.print("[bold green]✓ Ubuntu 桌面开发环境配置完成[/bold green]")

iamt/modules/ubuntud/templates/ibus/ibus_rime.custom.yaml

@@ -0,0 +1,3 @@
+patch:
+  style:
+    horizontal: true

iamt/modules/ubuntud/v2ray-core.py

@@ -0,0 +1,238 @@
+"""V2Ray 模块 - 在远程 Linux 主机上安装和配置 V2Ray Core
+
+该模块通过 SSH 连接执行远程命令，实现 V2Ray Core 的自动化部署。
+注意: v2rayN 是 Windows GUI 客户端，Linux 服务器应安装 v2ray-core。
+# https://github.com/v2fly/v2ray-core
+"""
+
+import tempfile
+
+from fabric import Connection, task
+
+from .._utils.arch import normalize_arch
+from .._utils.github import download_file, resolve_version_via_api
+
+
+# region 模块常量配置
+
+# V2Ray Core 下载 URL 模板
+V2RAY_DOWNLOAD_URL_TEMPLATE = "https://github.com/v2fly/v2ray-core/releases/download/v{version}/v2ray-linux-{arch}.zip"
+
+# V2Ray latest release API URL
+V2RAY_LATEST_RELEASE_API = "https://api.github.com/repos/v2fly/v2ray-core/releases/latest"
+
+# 架构映射 (dpkg -> V2Ray 架构名称)
+V2RAY_ARCH_MAP = {
+    "amd64": "64",
+    "arm64": "arm64-v8a",
+    "armhf": "arm32-v7a",
+}
+
+# 默认安装目录
+V2RAY_INSTALL_DIR = "/usr/local/bin"
+V2RAY_CONFIG_DIR = "/usr/local/etc/v2ray"
+
+# 环境变量 (使用英文输出避免中文乱码)
+ENV_LANG_C = {"LANG": "C", "LC_ALL": "C"}
+
+# endregion
+
+
+# region 辅助函数
+
+def _get_remote_arch(conn: Connection) -> str:
+    """获取远程主机的架构标识
+    
+    优先使用 hostvars 中已收集的架构信息，避免重复执行命令
+    
+    Args:
+        conn: Fabric 连接对象
+        
+    Returns:
+        V2Ray 架构名称 (如 64, arm64-v8a)
+    """
+    # 优先从 hostvars 获取架构信息
+    if hasattr(conn, "hostvars") and conn.hostvars:
+        arch = conn.hostvars.get("architecture", "")
+        if arch:
+            dpkg_arch = normalize_arch(arch)
+            return V2RAY_ARCH_MAP.get(dpkg_arch, "64")
+    
+    # 回退方案：直接执行命令获取
+    result = conn.run("uname -m", hide=True)
+    arch = result.stdout.strip()
+    dpkg_arch = normalize_arch(arch)
+    return V2RAY_ARCH_MAP.get(dpkg_arch, "64")
+
+
+def _download_v2ray_zip(version: str, arch: str, dest_dir: str) -> str:
+    """下载 V2Ray Core 压缩包到本地
+    
+    Args:
+        version: 版本号
+        arch: 架构标识
+        dest_dir: 下载目标目录
+        
+    Returns:
+        下载后的压缩包路径
+    """
+    version_number = resolve_version_via_api(version, V2RAY_LATEST_RELEASE_API)
+    url = V2RAY_DOWNLOAD_URL_TEMPLATE.format(version=version_number, arch=arch)
+    filename = f"v2ray-{version_number}-linux-{arch}.zip"
+    return download_file(url, dest_dir, filename)
+
+# endregion
+
+
+# region Task 函数
+
+@task
+def install_v2ray(conn: Connection, version: str = "latest") -> None:
+    """下载并安装 V2Ray Core (本地下载模式)
+    
+    先将 V2Ray 安装包下载到本地，然后上传到服务器并安装。
+    适用于本地网络条件较好的场景。
+    
+    Args:
+        conn: Fabric 连接对象
+        version: 版本号，默认为 "latest"，也可以指定具体版本如 "5.12.1"
+    """
+    arch = _get_remote_arch(conn)
+    print(f"[INFO] 目标架构: {arch}")
+    print(f"[INFO] 安装版本: {version}")
+    
+    remote_tmp_dir = "/tmp/v2ray_install"
+    remote_zip = f"{remote_tmp_dir}/v2ray.zip"
+    
+    # region 下载并上传压缩包
+    print(f"\n[任务] 下载 V2Ray Core {version}")
+    with tempfile.TemporaryDirectory() as temp_dir:
+        zip_path = _download_v2ray_zip(version, arch, temp_dir)
+        
+        print("\n[任务] 上传压缩包到远程主机")
+        conn.run(f"mkdir -p {remote_tmp_dir}", env=ENV_LANG_C)
+        conn.put(zip_path, remote_zip)
+        print(f"  上传完成: {remote_zip}")
+    # endregion
+    
+    # region 解压并安装
+    print("\n[任务] 解压并安装 V2Ray Core")
+    # 确保 unzip 已安装
+    conn.sudo("bash -c 'apt-get update && apt-get install -y unzip'", env=ENV_LANG_C, hide=True)
+    
+    conn.run(f"unzip -o {remote_zip} -d {remote_tmp_dir}", env=ENV_LANG_C)
+    
+    # 创建配置目录
+    conn.sudo(f"mkdir -p {V2RAY_CONFIG_DIR}", env=ENV_LANG_C)
+    
+    # 安装二进制文件
+    conn.sudo(f"cp {remote_tmp_dir}/v2ray {V2RAY_INSTALL_DIR}/v2ray", env=ENV_LANG_C)
+    conn.sudo(f"chmod +x {V2RAY_INSTALL_DIR}/v2ray", env=ENV_LANG_C)
+    print(f"  v2ray 已安装到: {V2RAY_INSTALL_DIR}/v2ray")
+    
+    # 复制配置文件示例 (如果不存在)
+    result = conn.run(f"test -f {V2RAY_CONFIG_DIR}/config.json", warn=True, hide=True)
+    if result.failed:
+        conn.sudo(f"cp {remote_tmp_dir}/config.json {V2RAY_CONFIG_DIR}/config.json", env=ENV_LANG_C)
+        print(f"  配置文件已复制到: {V2RAY_CONFIG_DIR}/config.json")
+    else:
+        print("  配置文件已存在，跳过复制")
+    
+    # 复制 geoip 和 geosite 数据文件
+    conn.sudo(f"cp {remote_tmp_dir}/geoip.dat {V2RAY_CONFIG_DIR}/geoip.dat", env=ENV_LANG_C)
+    conn.sudo(f"cp {remote_tmp_dir}/geosite.dat {V2RAY_CONFIG_DIR}/geosite.dat", env=ENV_LANG_C)
+    print("  地理位置数据文件已安装")
+    # endregion
+    
+    # region 清理临时文件
+    print("\n[任务] 清理临时文件")
+    conn.run(f"rm -rf {remote_tmp_dir}", env=ENV_LANG_C)
+    print("  清理完成")
+    # endregion
+    
+    # region 验证安装
+    print("\n[任务] 验证安装")
+    result = conn.run(f"{V2RAY_INSTALL_DIR}/v2ray version", hide=True)
+    print(f"  {result.stdout.strip()}")
+    # endregion
+    
+    print(f"\n[OK] V2Ray Core {version} 安装完成 (本地下载模式)")
+    print(f"[提示] 配置文件位置: {V2RAY_CONFIG_DIR}/config.json")
+    print(f"[提示] 启动命令: {V2RAY_INSTALL_DIR}/v2ray run -c {V2RAY_CONFIG_DIR}/config.json")
+
+
+@task
+def install_v2ray_remote(conn: Connection, version: str = "latest") -> None:
+    """下载并安装 V2Ray Core (远程下载模式)
+    
+    直接在远程主机上下载安装包并安装。
+    适用于远程主机网络条件较好的场景。
+    
+    Args:
+        conn: Fabric 连接对象
+        version: 版本号，默认为 "latest"，也可以指定具体版本如 "5.12.1"
+    """
+    arch = _get_remote_arch(conn)
+    version_number = resolve_version_via_api(version, V2RAY_LATEST_RELEASE_API)
+    print(f"[INFO] 目标架构: {arch}")
+    print(f"[INFO] 安装版本: {version_number}")
+    
+    download_url = V2RAY_DOWNLOAD_URL_TEMPLATE.format(version=version_number, arch=arch)
+    print(f"[INFO] 下载地址: {download_url}")
+    
+    remote_tmp_dir = "/tmp/v2ray_install"
+    remote_zip = f"{remote_tmp_dir}/v2ray.zip"
+    
+    # region 在远程主机上下载压缩包
+    print(f"\n[任务] 在远程主机上下载 V2Ray Core {version}")
+    conn.run(f"mkdir -p {remote_tmp_dir}", env=ENV_LANG_C)
+    conn.run(f"curl -fsSL -o {remote_zip} '{download_url}'", env=ENV_LANG_C)
+    print(f"  下载完成: {remote_zip}")
+    # endregion
+    
+    # region 解压并安装
+    print("\n[任务] 解压并安装 V2Ray Core")
+    # 确保 unzip 已安装
+    conn.sudo("apt-get update && apt-get install -y unzip", env=ENV_LANG_C, hide=True)
+    
+    conn.run(f"unzip -o {remote_zip} -d {remote_tmp_dir}", env=ENV_LANG_C)
+    
+    # 创建配置目录
+    conn.sudo(f"mkdir -p {V2RAY_CONFIG_DIR}", env=ENV_LANG_C)
+    
+    # 安装二进制文件
+    conn.sudo(f"cp {remote_tmp_dir}/v2ray {V2RAY_INSTALL_DIR}/v2ray", env=ENV_LANG_C)
+    conn.sudo(f"chmod +x {V2RAY_INSTALL_DIR}/v2ray", env=ENV_LANG_C)
+    print(f"  v2ray 已安装到: {V2RAY_INSTALL_DIR}/v2ray")
+    
+    # 复制配置文件示例 (如果不存在)
+    result = conn.run(f"test -f {V2RAY_CONFIG_DIR}/config.json", warn=True, hide=True)
+    if result.failed:
+        conn.sudo(f"cp {remote_tmp_dir}/config.json {V2RAY_CONFIG_DIR}/config.json", env=ENV_LANG_C)
+        print(f"  配置文件已复制到: {V2RAY_CONFIG_DIR}/config.json")
+    else:
+        print("  配置文件已存在，跳过复制")
+    
+    # 复制 geoip 和 geosite 数据文件
+    conn.sudo(f"cp {remote_tmp_dir}/geoip.dat {V2RAY_CONFIG_DIR}/geoip.dat", env=ENV_LANG_C)
+    conn.sudo(f"cp {remote_tmp_dir}/geosite.dat {V2RAY_CONFIG_DIR}/geosite.dat", env=ENV_LANG_C)
+    print("  地理位置数据文件已安装")
+    # endregion
+    
+    # region 清理临时文件
+    print("\n[任务] 清理临时文件")
+    conn.run(f"rm -rf {remote_tmp_dir}", env=ENV_LANG_C)
+    print("  清理完成")
+    # endregion
+    
+    # region 验证安装
+    print("\n[任务] 验证安装")
+    result = conn.run(f"{V2RAY_INSTALL_DIR}/v2ray version", hide=True)
+    print(f"  {result.stdout.strip()}")
+    # endregion
+    
+    print(f"\n[OK] V2Ray Core {version} 安装完成 (远程下载模式)")
+    print(f"[提示] 配置文件位置: {V2RAY_CONFIG_DIR}/config.json")
+    print(f"[提示] 启动命令: {V2RAY_INSTALL_DIR}/v2ray run -c {V2RAY_CONFIG_DIR}/config.json")
+
+# endregion