-
chakcy released this
2026-05-10 11:02:53 +08:00 | 1 commits to main since this release🎉 首次发布
VirtualBox Client 是一款基于 PySide6 构建的 Windows GUI 工具，通过 SSH 和 VirtualBox SDK 实现对 Ubuntu 20.04 虚拟机的全生命周期管理，支持 AI 智能任务执行、文件传输、脚本部署和图形化管理。
✨ 功能特性
- 🖥️ 虚拟机管理 — 启动、关闭、状态检测（VirtualBox SDK）
- 🔌 纯 SSH 模式 — 不依赖 VirtualBox，直接通过 SSH 管理远程服务器
- 🤖 AI 智能代理 — 接入大语言模型（OpenAI API），通过自然语言描述自动执行运维任务
- 📁 文件传输 — 支持上传/下载文件、上传整个文件夹
- 📂 工作区浏览器 — 树形文件管理器，支持浏览、新建、重命名、复制、删除、下载文件夹
- ⚡ 脚本执行 — 上传并执行 Shell 脚本，自动区分部署脚本（sudo）和普通脚本
- 🎨 图形界面 — 基于 PySide6 构建的现代化暗色主题 GUI
- 📋 日志面板 — 带等级标识的彩色日志输出，支持自动滚动
🚀 快速启动
# 同步依赖 uv sync # 启动 GUI uv run gui # 命令行示例 uv run example ### 📦 系统要求 - Python >= 3.14 - Windows 主控端 - 目标虚拟机：Ubuntu 20.04 - VirtualBox（VirtualBox 模式需要，可选） ### 🔧 环境搭建 复制 `.env.example` 为 `.env`，配置 SSH 连接信息和 LLM API Key 后即可使用。 ### 📁 项目结构 ```javascript src/virtualbox_client/ ├── gui.py # PySide6 图形界面 ├── scripts/ # 可执行脚本模块 │ ├── agent_task.py # AI 代理任务执行 │ ├── example.py # 使用示例 │ └── run_script.py # 脚本运行器 └── utils/ # 核心工具 ├── ssh_manager.py # 纯 SSH 管理器 ├── vbox_ssh_manager.py # VirtualBox + SSH 管理器 └── vm_agent.py # AI 代理核心⬇️ 附件说明
请下载
dist/目录下 PyInstaller 打包生成的virtualbox-client.exe文件，上传至此发布版本的附件中。--- **操作步骤：** 1. 登录 Gitea → 进入 `virtualbox_client` 仓库 2. 点击「Releases」→「New Release」 3. 标签选择：`v0.1.0` 4. 标题填写：**v0.1.0 — 初始版本：VirtualBox 虚拟机自动化管理工具** 5. 描述粘贴上方内容 6. 上传您用 PyInstaller 打包好的 EXE 文件到附件 7. 点击「Publish Release」即可自动批准：读取, 安全命令, MCP
Downloads