# truai

**Repository Path**: star45/truai

## Basic Information

- **Project Name**: truai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-26
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tauri + Vue 3 数据上传系统

一个基于 Tauri 和 Vue 3 开发的跨平台桌面应用程序，用于数据上传和日志管理。

## 项目特性

- 📤 **文件上传**：支持多种格式文件上传
- 📋 **日志管理**：应用日志、API日志、上传日志分类查看
- ⚙️ **系统设置**：API配置、日志设置、系统配置
- 📱 **跨平台**：支持 Windows、macOS、Linux
- 🌐 **现代化 UI**：基于 Vue 3 + Vite 开发
- 🚀 **高性能**：Rust 后端 + Web 前端结合

## 技术栈

- **前端框架**：Vue 3
- **构建工具**：Vite
- **桌面框架**：Tauri
- **路由管理**：Vue Router
- **CSS 预处理器**：CSS (原生)
- **开发语言**：JavaScript + Rust

## 项目结构

```
ff-excel-app/
├── src/                  # 前端源代码
│   ├── components/       # Vue 组件
│   │   ├── AppHeader.vue # 顶部导航栏组件
│   │   ├── AppFooter.vue # 底部版权信息组件
│   │   └── Menu.vue      # 菜单组件
│   ├── pages/            # 页面组件
│   │   ├── HomePage.vue  # 首页
│   │   ├── AboutPage.vue # 关于页面
│   │   ├── LogViewer.vue # 日志查看器
│   │   ├── RecordsPage.vue # 记录页面
│   │   └── SettingsPage.vue # 设置页面
│   ├── router/           # 路由配置
│   │   └── index.js      # 路由定义
│   ├── utils/            # 工具函数
│   │   ├── db.js         # 数据库工具
│   │   ├── logger.js     # 日志工具
│   │   └── tray.js       # 托盘工具
│   ├── app.vue           # 根组件
│   └── main.js           # 入口文件
├── src-tauri/            # Tauri 后端代码
│   ├── src/              # Rust 源代码
│   ├── Cargo.toml        # Rust 依赖配置
│   └── tauri.conf.json   # Tauri 配置文件
├── public/               # 静态资源
├── scripts/              # 脚本文件
│   └── start.js          # 启动脚本
├── index.html            # HTML 入口文件
├── vite.config.js        # Vite 配置
├── package.json          # 前端依赖配置
└── README.md             # 项目说明文档
```

## 安装依赖

### 前置要求

- Node.js 18+ 
- Rust 1.75+ (用于 Tauri 开发)
- 系统依赖 (根据 Tauri 文档安装)

### 安装步骤

```bash
# 安装前端依赖
npm install

# 或使用 pnpm (推荐)
pnpm install
```

## 开发模式

### 启动前端开发服务器

```bash
# 使用默认端口 (9090)
npm run dev

# 或指定端口
PORT=9090 npm run dev
```

### 启动 Tauri 开发模式

```bash
# 同时启动前端和 Tauri 应用
npm run tauri dev
```

应用将在开发模式下启动，支持热重载。

## 生产打包

### 构建前端资源

```bash
npm run build
```

### 打包 Tauri 应用

```bash
# 打包当前平台的应用
npm run tauri build

# 打包特定平台
# Windows
npm run tauri build --target x86_64-pc-windows-msvc

# macOS
npm run tauri build --target aarch64-apple-darwin

# Linux
npm run tauri build --target x86_64-unknown-linux-gnu
```

打包后的应用将位于 `src-tauri/target/release/bundle/` 目录下。

## 配置文件

### 路由配置

路由配置文件位于 `src/router/index.js`，包含所有页面路由和菜单元信息。

### Tauri 配置

Tauri 配置文件位于 `src-tauri/tauri.conf.json`，用于配置应用名称、窗口设置、权限等。

### 启动脚本配置

启动脚本配置位于 `scripts/start.js`，用于处理端口占用和自动重试逻辑。

## 菜单系统

菜单系统基于路由配置动态生成，支持多级菜单和路由联动。

### 菜单项配置

在路由配置中添加 `meta.menu` 属性来定义菜单项：

```javascript
{
  path: '/',
  name: 'home',
  component: () => import('../pages/HomePage.vue'),
  meta: {
    menu: {
      label: '首页',
      icon: '🏠',
      order: 1
    }
  }
}
```

### 菜单属性

- `label`：菜单项显示文本
- `icon`：菜单项图标（支持 emoji）
- `order`：菜单项排序（数字越小越靠前）
- `hidden`：是否隐藏菜单项

## 开发指南

### 添加新页面

1. 在 `src/pages/` 目录下创建新的 Vue 组件
2. 在 `src/router/index.js` 中添加路由配置
3. 配置菜单元信息（可选）

### 添加新组件

1. 在 `src/components/` 目录下创建新的 Vue 组件
2. 在需要使用的页面中导入并使用

### 调试

- **前端调试**：打开浏览器开发者工具 (Ctrl+Shift+I)
- **后端调试**：使用 Rust 调试工具或查看日志文件

## 日志系统

日志文件位于应用数据目录：

- **Windows**：`%APPDATA%/ff-excel-app/logs/`
- **macOS**：`$HOME/Library/Logs/ff-excel-app/`
- **Linux**：`$XDG_STATE_HOME/ff-excel-app/logs/` 或 `$HOME/.local/state/ff-excel-app/logs/`

## 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 许可证

MIT License - 查看 [LICENSE](LICENSE) 文件获取详细信息

## 常见问题

### 端口被占用

如果开发服务器端口被占用，可以通过以下方式解决：

1. 修改 `vite.config.js` 中的默认端口
2. 修改 `scripts/start.js` 中的端口配置
3. 使用环境变量指定端口：`PORT=9090 npm run dev`

### Tauri 构建失败

确保已安装所有必要的系统依赖，参考 [Tauri 文档](https://tauri.app/v1/guides/getting-started/prerequisites)。

### 组件初始化错误

如果遇到组件初始化错误，尝试使用动态导入替代直接导入，例如：

```javascript
// 错误写法
import HomePage from '../pages/HomePage.vue'

// 正确写法
component: () => import('../pages/HomePage.vue')
```

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 项目 Issues：[GitHub Issues](https://github.com/your-repo/ff-excel-app/issues)
- 开发者：管理员

## 更新日志

### v0.1.0 (2025-12-18)

- 初始版本发布
- 实现文件上传功能
- 实现日志管理功能
- 实现系统设置功能
- 集成菜单组件
- 支持路由懒加载

---

**开发愉快！** 🚀