iamt 1.1.27__py3-none-any.whl

iamt/modules/ubuntud/v2rayN.py

@@ -0,0 +1,127 @@
+"""v2rayN 模块 - 在远程 Ubuntu 主机上安装 v2rayN
+
+该模块通过 SSH 连接执行远程命令，实现 v2rayN 的自动化部署。
+v2rayN 是一个基于 V2Ray 内核的图形化客户端。
+"""
+
+from fabric import Connection, task
+
+from .._utils.arch import normalize_arch
+from .._utils.github import download_file, resolve_version
+
+
+# region 模块常量配置
+
+# v2rayN GitHub releases URL 模板
+# 注意：v2rayN Linux 版本只提供 64 位版本
+V2RAYN_RELEASE_URL_TEMPLATE = "https://github.com/2dust/v2rayN/releases/download/{version}/v2rayN-linux-64.deb"
+
+# v2rayN latest release 重定向 URL (用于获取最新版本号)
+V2RAYN_LATEST_RELEASE_URL = "https://github.com/2dust/v2rayN/releases/latest"
+
+# 环境变量 (使用英文输出避免中文乱码)
+ENV_LANG_C = {"LANG": "C", "LC_ALL": "C"}
+
+# endregion
+
+
+# region 辅助函数
+
+def _check_arch_compatibility(conn: Connection) -> None:
+    """检查远程主机架构是否支持 v2rayN
+    
+    v2rayN Linux 版本仅支持 x86_64 架构
+    
+    Args:
+        conn: Fabric 连接对象
+        
+    Raises:
+        RuntimeError: 如果架构不支持
+    """
+    # 优先从 hostvars 获取架构信息
+    if hasattr(conn, "hostvars") and conn.hostvars:
+        arch = conn.hostvars.get("architecture", "")
+        if arch:
+            dpkg_arch = normalize_arch(arch)
+            if dpkg_arch != "amd64":
+                raise RuntimeError(f"v2rayN Linux 版本仅支持 x86_64 架构，当前架构: {arch}")
+            return
+    
+    # 回退方案：直接执行命令获取
+    result = conn.run("uname -m", hide=True)
+    arch = result.stdout.strip()
+    dpkg_arch = normalize_arch(arch)
+    if dpkg_arch != "amd64":
+        raise RuntimeError(f"v2rayN Linux 版本仅支持 x86_64 架构，当前架构: {arch}")
+
+
+def _download_v2rayn_deb(dest_dir: str, version: str) -> str:
+    """下载 v2rayN .deb 包到本地
+    
+    Args:
+        dest_dir: 下载目标目录
+        version: v2rayN 版本号
+        
+    Returns:
+        下载后的 .deb 包路径
+    """
+    url = V2RAYN_RELEASE_URL_TEMPLATE.format(version=version)
+    filename = f"v2rayN-linux-64-{version}.deb"
+    return download_file(url, dest_dir, filename)
+
+# endregion
+
+
+# region Task 函数
+
+@task
+def install_v2rayn(conn: Connection, version: str = "latest") -> None:
+    """下载并安装 v2rayN (本地下载模式)
+    
+    先将 v2rayN 安装包下载到本地，然后上传到服务器并安装。
+    适用于本地网络条件较好的场景。
+    
+    注意：v2rayN Linux 版本仅支持 x86_64 架构
+    
+    Args:
+        conn: Fabric 连接对象
+        version: v2rayN 版本号，默认 "latest" 自动获取最新版本
+    """
+    # 解析版本号
+    actual_version = resolve_version(version, V2RAYN_LATEST_RELEASE_URL, strip_v=False)
+    
+    # 检查架构兼容性
+    _check_arch_compatibility(conn)
+    print(f"[INFO] v2rayN 版本: {actual_version}")
+    
+    remote_tmp_dir = "/tmp/v2rayn_install"
+    remote_deb = f"{remote_tmp_dir}/v2rayn.deb"
+    
+    # region 下载并上传压缩包
+    print("\n[任务] 下载 v2rayN")
+    deb_path = _download_v2rayn_deb(str(conn.artifacts_dir), actual_version)
+    
+    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 安装依赖和 v2rayN
+    print("\n[任务] 安装 v2rayN")
+    # 更新包索引
+    conn.sudo("apt-get update", env=ENV_LANG_C)
+    # 安装 .deb 包及其依赖
+    conn.sudo(f"apt-get install -y {remote_deb}", env=ENV_LANG_C)
+    print("  v2rayN 已安装")
+    # endregion
+    
+    # region 清理临时文件
+    print("\n[任务] 清理临时文件")
+    conn.run(f"rm -rf {remote_tmp_dir}", env=ENV_LANG_C)
+    print("  清理完成")
+    # endregion
+    
+    print("\n[OK] v2rayN 安装完成")
+
+# endregion

iamt/modules/ubuntud/vscode.py

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

iamt/modules/uv/roles/role.py

@@ -0,0 +1,56 @@
+from rich.console import Console
+
+from ..uv import (
+    Connection,
+    create_uv_install_dir,
+    install_uv,
+    setup_uv_path,
+    configure_uv,
+)
+from ..._utils.steps import Step, run_steps
+
+console = Console()
+
+
+def setup_uv(c: Connection) -> None:
+    """在远程服务器上安装配置 uv
+    
+    执行以下步骤:
+    1. 创建 uv 安装目录 (~/.local/bin)
+    2. 下载并安装 uv 二进制文件
+    3. 配置 PATH 环境变量
+    4. 生成 uv 配置文件 (使用国内镜像源)
+    
+    Args:
+        c: Fabric 连接对象
+    """
+    steps: list[Step] = [
+        ("创建 UV 安装目录", create_uv_install_dir),
+        ("安装 UV", install_uv),
+        ("配置 PATH 环境变量", setup_uv_path),
+        ("生成 UV 配置文件", configure_uv),
+    ]
+    run_steps(c, steps)
+    console.print("[bold green]✓ UV 安装配置完成[/bold green]")
+
+
+def setup_uv_remote(c: Connection) -> None:
+    """在远程服务器上安装配置 uv
+    
+    执行以下步骤:
+    1. 创建 uv 安装目录 (~/.local/bin)
+    2. 下载并安装 uv 二进制文件
+    3. 配置 PATH 环境变量
+    4. 生成 uv 配置文件 (使用国内镜像源)
+    
+    Args:
+        c: Fabric 连接对象
+    """
+    steps: list[Step] = [
+        ("创建 UV 安装目录", create_uv_install_dir),
+        ("安装 UV", install_uv),
+        ("配置 PATH 环境变量", setup_uv_path),
+        ("生成 UV 配置文件", configure_uv),
+    ]
+    run_steps(c, steps)
+    console.print("[bold green]✓ UV 安装配置完成[/bold green]")

iamt/modules/uv/templates/uv.toml

@@ -0,0 +1,5 @@
+python-install-mirror = "https://ghfast.top/https://github.com/astral-sh/python-build-standalone/releases/download"
+
+# [[index]]
+# url = "https://pypi.tuna.tsinghua.edu.cn/simple"
+# default = true

iamt/modules/uv/uv.py

@@ -0,0 +1,315 @@
+"""UV 模块 - 在远程 Linux 主机上安装和配置 uv Python 包管理器
+
+该模块通过 SSH 连接执行远程命令，实现 uv 的自动化部署和配置。
+"""
+
+from pathlib import Path
+
+from fabric import Connection, task
+
+from .._utils.github import download_file, resolve_version
+
+
+# region 模块常量配置
+
+# 模板目录路径
+TEMPLATES_DIR = Path(__file__).parent / "templates"
+
+# UV 下载 URL 模板
+UV_DOWNLOAD_URL_TEMPLATE = "https://github.com/astral-sh/uv/releases/download/{version}/uv-{platform}.tar.gz"
+
+# UV 最新版本获取 URL
+UV_LATEST_RELEASE_URL = "https://github.com/astral-sh/uv/releases/latest"
+
+# 平台映射 (本地系统 -> uv 发布平台名称)
+UV_PLATFORM_MAP = {
+    ("Linux", "x86_64"): "x86_64-unknown-linux-gnu",
+    ("Linux", "aarch64"): "aarch64-unknown-linux-gnu",
+    ("Darwin", "x86_64"): "x86_64-apple-darwin",
+    ("Darwin", "arm64"): "aarch64-apple-darwin",
+    ("Windows", "AMD64"): "x86_64-pc-windows-msvc",
+}
+
+# 远程主机架构映射
+UV_REMOTE_PLATFORM_MAP = {
+    "x86_64": "x86_64-unknown-linux-gnu",
+    "aarch64": "aarch64-unknown-linux-gnu",
+    "arm64": "aarch64-unknown-linux-gnu",
+}
+
+# 默认安装目录 (相对于用户家目录)
+UV_INSTALL_DIR = ".local/bin"
+
+# 环境变量 (使用英文输出避免中文乱码)
+ENV_LANG_C = {"LANG": "C", "LC_ALL": "C"}
+
+# endregion
+
+
+# region 辅助函数
+
+def _get_remote_platform(conn: Connection) -> str:
+    """获取远程主机的平台标识
+    
+    Args:
+        conn: Fabric 连接对象
+        
+    Returns:
+        uv 发布平台名称 (如 x86_64-unknown-linux-gnu)
+    """
+    result = conn.run("uname -m", hide=True)
+    arch = result.stdout.strip()
+    return UV_REMOTE_PLATFORM_MAP.get(arch, "x86_64-unknown-linux-gnu")
+
+
+def _download_uv_tarball(version: str, target_platform: str, dest_dir: str) -> str:
+    """下载 uv 压缩包到本地
+    
+    Args:
+        version: uv 版本号
+        target_platform: 目标平台标识
+        dest_dir: 下载目标目录
+        
+    Returns:
+        下载后的压缩包路径
+    """
+    url = UV_DOWNLOAD_URL_TEMPLATE.format(version=version, platform=target_platform)
+    filename = f"uv-{version}-{target_platform}.tar.gz"
+    return download_file(url, dest_dir, filename)
+
+# endregion
+
+
+# region Task 函数
+
+@task
+def create_uv_install_dir(conn: Connection, install_dir: str | None = None) -> str:
+    """创建 uv 安装目录
+    
+    默认在当前用户家目录下创建 .local/bin 目录
+    
+    Args:
+        conn: Fabric 连接对象
+        install_dir: 安装目录路径 (可选)，默认为 ~/.local/bin
+        
+    Returns:
+        安装目录的完整路径
+    """
+    if install_dir is None:
+        install_dir = f"~/{UV_INSTALL_DIR}"
+    
+    # 展开 ~ 为实际路径
+    result = conn.run(f"echo {install_dir}", hide=True)
+    full_path = result.stdout.strip()
+    
+    conn.run(f"mkdir -p {install_dir}", env=ENV_LANG_C)
+    print(f"[OK] UV 安装目录已创建: {full_path}")
+    
+    return full_path
+
+
+@task
+def extract_uv_tarball(conn: Connection, tarball_path: str, extract_dir: str) -> None:
+    """解压 uv 压缩包
+    
+    Args:
+        conn: Fabric 连接对象
+        tarball_path: 压缩包路径
+        extract_dir: 解压目标目录
+    """
+    print("\n[任务] 解压压缩包")
+    conn.run(f"tar -xzf {tarball_path} -C {extract_dir}", env=ENV_LANG_C)
+    print("  解压完成")
+
+
+@task
+def install_uv_binaries(conn: Connection, extracted_dir: str, install_dir: str) -> None:
+    """安装 uv 二进制文件
+    
+    从解压目录复制 uv 和 uvx 到安装目录
+    
+    Args:
+        conn: Fabric 连接对象
+        extracted_dir: 解压后的二进制文件目录
+        install_dir: 安装目录路径
+    """
+    print("\n[任务] 安装 uv 二进制文件")
+    
+    # 展开安装目录路径
+    result = conn.run(f"echo {install_dir}", hide=True)
+    full_install_dir = result.stdout.strip()
+    
+    # 确保安装目录存在
+    conn.run(f"mkdir -p {full_install_dir}", env=ENV_LANG_C)
+    
+    # 安装 uv
+    conn.run(f"cp {extracted_dir}/uv {full_install_dir}/uv", env=ENV_LANG_C)
+    conn.run(f"chmod +x {full_install_dir}/uv", env=ENV_LANG_C)
+    print(f"  uv 已安装到: {full_install_dir}/uv")
+    
+    # 安装 uvx
+    conn.run(f"cp {extracted_dir}/uvx {full_install_dir}/uvx", env=ENV_LANG_C)
+    conn.run(f"chmod +x {full_install_dir}/uvx", env=ENV_LANG_C)
+    print(f"  uvx 已安装到: {full_install_dir}/uvx")
+
+
+@task
+def cleanup_uv_temp(conn: Connection, temp_dir: str) -> None:
+    """清理 uv 安装临时文件
+    
+    Args:
+        conn: Fabric 连接对象
+        temp_dir: 临时目录路径
+    """
+    print("\n[任务] 清理临时文件")
+    conn.run(f"rm -rf {temp_dir}", env=ENV_LANG_C)
+    print("  清理完成")
+
+
+@task
+def install_uv(conn: Connection, version: str = "latest", install_dir: str | None = None) -> None:
+    """下载并安装 uv (本地下载模式)
+    
+    1. 下载 uv 压缩包到本地
+    2. 上传压缩包到远程主机
+    3. 解压并安装二进制文件
+    4. 清理临时文件
+    
+    Args:
+        conn: Fabric 连接对象
+        version: uv 版本号，默认为 "latest" 表示安装最新版本
+        install_dir: 安装目录路径 (可选)，默认为 ~/.local/bin
+    """
+    version = resolve_version(version, UV_LATEST_RELEASE_URL)
+    if install_dir is None:
+        install_dir = f"~/{UV_INSTALL_DIR}"
+    
+    target_platform = _get_remote_platform(conn)
+    print(f"[INFO] 目标平台: {target_platform}")
+    
+    remote_tmp_dir = "/tmp/uv_install"
+    remote_tarball = f"{remote_tmp_dir}/uv.tar.gz"
+    extracted_dir = f"{remote_tmp_dir}/uv-{target_platform}"
+    
+    # region 下载并上传压缩包
+    print(f"\n[任务] 下载 uv {version}")
+    tarball_path = _download_uv_tarball(version, target_platform, str(conn.artifacts_dir))
+    
+    print("\n[任务] 上传压缩包到远程主机")
+    conn.run(f"mkdir -p {remote_tmp_dir}", env=ENV_LANG_C)
+    conn.put(tarball_path, remote_tarball)
+    print(f"  上传完成: {remote_tarball}")
+    # endregion
+    
+    extract_uv_tarball(conn, remote_tarball, remote_tmp_dir)
+    install_uv_binaries(conn, extracted_dir, install_dir)
+    cleanup_uv_temp(conn, remote_tmp_dir)
+    
+    print(f"\n[OK] uv {version} 安装完成 (本地下载模式)")
+
+
+@task
+def install_uv_remote(conn: Connection, version: str = "latest", install_dir: str | None = None) -> None:
+    """下载并安装 uv (远程下载模式)
+    
+    直接在远程主机上下载压缩包，适用于远程主机网络条件较好的场景。
+    
+    1. 在远程主机上下载 uv 压缩包
+    2. 解压并安装二进制文件
+    3. 清理临时文件
+    
+    Args:
+        conn: Fabric 连接对象
+        version: uv 版本号，默认为 "latest" 表示安装最新版本
+        install_dir: 安装目录路径 (可选)，默认为 ~/.local/bin
+    """
+    version = resolve_version(version, UV_LATEST_RELEASE_URL)
+    if install_dir is None:
+        install_dir = f"~/{UV_INSTALL_DIR}"
+    
+    target_platform = _get_remote_platform(conn)
+    print(f"[INFO] 目标平台: {target_platform}")
+    
+    download_url = UV_DOWNLOAD_URL_TEMPLATE.format(version=version, platform=target_platform)
+    print(f"[INFO] 下载地址: {download_url}")
+    
+    remote_tmp_dir = "/tmp/uv_install"
+    remote_tarball = f"{remote_tmp_dir}/uv.tar.gz"
+    extracted_dir = f"{remote_tmp_dir}/uv-{target_platform}"
+    
+    # region 在远程主机上下载压缩包
+    print(f"\n[任务] 在远程主机上下载 uv {version}")
+    conn.run(f"mkdir -p {remote_tmp_dir}", env=ENV_LANG_C)
+    conn.run(f"curl -fsSL -o {remote_tarball} '{download_url}'", env=ENV_LANG_C)
+    print(f"  下载完成: {remote_tarball}")
+    # endregion
+    
+    extract_uv_tarball(conn, remote_tarball, remote_tmp_dir)
+    install_uv_binaries(conn, extracted_dir, install_dir)
+    cleanup_uv_temp(conn, remote_tmp_dir)
+    
+    print(f"\n[OK] uv {version} 安装完成 (远程下载模式)")
+
+
+@task
+def setup_uv_path(conn: Connection, install_dir: str | None = None, shell_rc: str = ".bashrc") -> None:
+    """将 UV 安装目录添加到 PATH 并更新 shell 配置文件
+    
+    在用户的 shell 配置文件 (如 .bashrc) 中添加 PATH 配置
+    
+    Args:
+        conn: Fabric 连接对象
+        install_dir: 安装目录路径 (可选)，默认为 ~/.local/bin
+        shell_rc: shell 配置文件名 (可选)，默认为 .bashrc
+    """
+    if install_dir is None:
+        install_dir = f"$HOME/{UV_INSTALL_DIR}"
+    
+    # region 检查是否已配置
+    rc_file = f"~/{shell_rc}"
+    result = conn.run(f"grep -q '{UV_INSTALL_DIR}' {rc_file} 2>/dev/null", warn=True, hide=True)
+    
+    if result.ok:
+        print(f"[OK] PATH 已配置在 {shell_rc} 中，跳过")
+        return
+    # endregion
+    
+    # region 添加 PATH 配置
+    path_config = f'\n# UV PATH\nexport PATH="{install_dir}:$PATH"\n'
+    conn.run(f"echo '{path_config}' >> {rc_file}", env=ENV_LANG_C)
+    print(f"[OK] PATH 配置已添加到 ~/{shell_rc}")
+    # endregion
+
+
+@task
+def configure_uv(conn: Connection, template: str = "uv.toml") -> None:
+    """为当前用户添加 UV 配置文件
+    
+    1. 确保 ~/.config/uv/ 目录存在
+    2. 根据模板在 ~/.config/uv/ 目录下生成 uv.toml 配置文件
+    
+    Args:
+        conn: Fabric 连接对象
+        template: 模板文件名 (可选)，默认为 uv.toml
+    """
+    # region 创建配置目录
+    config_dir = "~/.config/uv"
+    conn.run(f"mkdir -p {config_dir}", env=ENV_LANG_C)
+    print(f"[OK] 配置目录已创建: {config_dir}")
+    # endregion
+    
+    # region 读取模板并写入配置文件
+    template_path = TEMPLATES_DIR / template
+    config_content = template_path.read_text(encoding="utf-8")
+    
+    # 展开配置目录路径
+    result = conn.run(f"echo {config_dir}", hide=True)
+    full_config_dir = result.stdout.strip()
+    config_file = f"{full_config_dir}/uv.toml"
+    
+    # 使用 tee 写入配置文件
+    conn.run(f"tee {config_file} > /dev/null << 'EOF'\n{config_content}EOF", env=ENV_LANG_C)
+    print(f"[OK] UV 配置文件已写入: {config_file} (模板: {template})")
+    # endregion
+
+# endregion

iamt/modules/vagrant/templates/Vagrantfile

@@ -0,0 +1,25 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Specs = [
+  { "name"=>"{{hostname}}","ip"=>"{{ hostip }}", "cpu"=>"{{hostcpu}}", "mem"=>"{{hostmem}}", "image"=>"{{hostimg}}","forwarded_port"=>"{{hostport}}"  },
+   
+]
+
+Vagrant.configure("2") do |config|
+    Specs.each_with_index do |spec, index|
+        config.vm.define spec["name"] do |node|
+
+            node.vm.box = spec["image"]
+            node.vm.network "forwarded_port", guest: 22, host: spec["forwarded_port"], id: "ssh"
+            node.vm.network "private_network", ip: spec["ip"]
+            node.vm.hostname = spec["name"]
+
+            node.vm.provider "virtualbox" do |v|
+                v.memory = spec["mem"]
+                v.cpus = spec["cpu"]
+            end
+
+        end
+    end
+end