# BurnCloud - 大模型本地部署平台
BurnCloud 是一个基于 Rust 和 Dioxus 构建的现代化大语言模型本地部署平台，提供了直观的用户界面来管理和部署如 Qwen、DeepSeek、Llama 等大语言模型。
## 🎨 设计特性
- **Windows 11 Fluent Design** - 采用现代化的圆角设计和毛玻璃效果
- **响应式布局** - 适配不同屏幕尺寸的网格布局系统
- **直观导航** - 清晰的侧边栏导航和状态指示
- **实时监控** - 系统资源和模型运行状态的实时可视化
## 🚀 核心功能
### 1. 仪表盘 (Dashboard)
- 系统状态概览 (CPU、内存、GPU、磁盘)
- 模型运行状态监控
- API 调用统计
- 快速操作面板
### 2. 模型管理 (Model Management)
- 已安装模型列表和状态
- 在线模型仓库浏览
- 模型下载、启动、停止
- 模型信息和评分展示
### 3. 部署配置 (Deploy Configuration)
- 服务配置 (端口、绑定地址、API密钥)
- 资源配置 (GPU、内存、CPU核心)
- 量化设置和高级参数
- 一键部署功能
### 4. 服务监控 (Service Monitor)
- 实时系统资源监控
- 模型运行状态追踪
- 实时日志查看器
- 性能统计报告
### 5. API管理 (API Management)
- 交互式 API 测试工具
- 完整的 API 文档
- 调用统计和分析
- 兼容 OpenAI API 格式
### 6. 系统设置 (System Settings)
- 外观主题设置 (浅色/深色/跟随系统)
- 语言和字体配置
- 系统启动和更新设置
- 安全和访问控制
### 7. 自动更新 🆕
- 一键检查最新版本
- 自动下载和安装更新
- 支持 GitHub Releases
- 失败时提供手动下载链接
## 🛠️ 技术栈
- **前端框架**: [Dioxus](https://dioxuslabs.com/) - 现代化 Rust GUI 框架
- **路由**: Dioxus Router - 声明式路由系统
- **样式**: 自定义 Fluent Design CSS 系统
- **图标**: Unicode Emoji 表情符号
- **构建工具**: Cargo (Rust 包管理器)
## 📦 安装和运行
### 环境要求
- Rust 1.70+
- Windows 10/11 (推荐 Windows 11 以获得最佳视觉效果)
### 构建步骤
1. 克隆项目
```bash
git clone <repository-url>
cd burncloud
```
2. 安装依赖并构建
```bash
cargo build
```
3. 运行应用
```bash
cargo run
```
### 自动更新功能
支持从命令行检查和执行更新：
```bash
# 检查是否有新版本
cargo run -- update --check-only
# 执行更新到最新版本
cargo run -- update
# 查看所有可用命令
cargo run -- --help
```
> 📝 详细的自动更新文档请参考 [doc/README.md](doc/README.md)
## 🎯 界面预览
### 主界面布局
```
┌─────────────────────────────────────────────────────────────┐
│ BurnCloud - 大模型本地部署平台 [最小化] [□] [×] │
├─────────────────────────────────────────────────────────────┤
│ 侧边导航栏 │ 主内容区域 │
│ ┌─────────────┐ │ ┌─────────────────────────────────────┐ │
│ │ 🏠 仪表盘 │ │ │ │ │
│ │ 🧠 模型管理 │ │ │ 动态内容区域 │ │
│ │ ⚙️ 部署配置 │ │ │ │ │
│ │ 📊 监控日志 │ │ │ │ │
│ │ 🔗 API管理 │ │ │ │ │
│ │ 🔧 系统设置 │ │ │ │ │
│ └─────────────┘ │ └─────────────────────────────────────┘ │
│ │ │
├─────────────────────────────────────────────────────────────┤
```
### 核心页面功能
#### 模型管理界面
- 模型卡片展示：状态、版本、大小、评分
- 搜索和筛选功能
- 官方仓库模型浏览
- 一键下载和部署
#### 部署配置界面
- 可视化资源配置滑块
- 自动硬件检测和推荐
- 高级参数折叠面板
- 实时配置预览
#### 监控界面
- 多标签页设计：实时监控、日志查看、性能报告
- 进度条和图表可视化
- 模拟终端日志查看器
- 详细性能指标统计
## 🔧 开发说明
### 项目结构
```
src/
├── main.rs # 应用入口
├── app.rs # 路由配置
├── styles.rs # Fluent Design 样式系统
├── components/ # 可复用组件
│ ├── layout.rs # 主布局组件
│ ├── sidebar.rs # 侧边导航栏
│ └── title_bar.rs # 标题栏
└── pages/ # 页面组件
├── dashboard.rs # 仪表盘
├── models.rs # 模型管理
├── deploy.rs # 部署配置
├── monitor.rs # 服务监控
├── api.rs # API管理
└── settings.rs # 系统设置
```
### 样式系统
项目采用自定义的 Fluent Design CSS 变量系统：
- **颜色**: 完整的 Accent 和 Neutral 色彩体系
- **间距**: 统一的 spacing 规范 (xs, sm, md, lg, xl, xxl, xxxl)
- **圆角**: 四级圆角规范 (small, medium, large, xlarge)
- **阴影**: 三级阴影系统 (card, flyout, dialog)
- **动画**: 统一的过渡曲线和时长
### 响应式设计
- 采用 CSS Grid 实现灵活的响应式布局
- `auto-fit` 和 `minmax()` 确保不同屏幕尺寸的适配
- 组件级别的响应式断点处理
## 🎨 设计原则
1. **简洁直观** - 清晰的视觉层次，降低学习成本
2. **功能导向** - 突出核心功能，减少无关干扰
3. **一致体验** - 统一的设计语言和交互模式
4. **实时反馈** - 即时状态更新，透明的系统信息
## 📝 开发计划
- [ ] 实现真实的模型管理后端集成
- [ ] 添加模型下载进度追踪
- [ ] 实现 WebSocket 实时通信
- [ ] 添加深色主题支持
- [ ] 国际化支持 (i18n)
- [ ] 性能优化和内存管理
- [ ] 单元测试和集成测试
## 🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request
## 📄 许可证
MIT License - 详见 [LICENSE](LICENSE) 文件。
---
**BurnCloud** - 让大模型部署变得简单而优雅 🔥