# onesMails

**Repository Path**: suwu/ones-mails

## Basic Information

- **Project Name**: onesMails
- **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-08-01
- **Last Updated**: 2025-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OneMails Desktop Application

这是一个使用 Electron 包装 OneMails 网站 (https://onemails.ai/login) 的桌面应用程序。

## 快速开始

应用已经构建完成，可以直接使用：

### 方法1：使用启动脚本（推荐）
双击运行项目根目录下的 `run-onemails.bat` 文件

### 方法2：直接运行可执行文件
进入 `dist\win-unpacked` 目录，双击 `OneMails.exe` 文件

## 功能特性

- 🖥️ 跨平台支持 (Windows, macOS, Linux)
- 🔒 安全的网页容器
- 🎨 原生应用体验
- ⚡ 快速启动和响应
- 🔄 自动更新支持 (可扩展)
- 📱 响应式界面

## 开发环境设置

如果需要修改或重新构建应用，请先安装依赖：

```bash
# 推荐使用 pnpm
pnpm install

# 或使用 npm
npm install
```

## 开发

### 启动开发模式
```bash
pnpm run dev
# 或 npm run dev
```

### 普通启动
```bash
pnpm start
# 或 npm start
```

## 构建

### 构建所有平台
```bash
npm run build
```

### 构建特定平台
```bash
# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux
```

### 打包但不分发
```bash
npm run pack
```

## 项目结构

```
OneMails-App/
├── src/
│   └── main.js          # 主进程文件
├── assets/
│   ├── icon.png         # Linux 图标
│   ├── icon.ico         # Windows 图标
│   └── icon.icns        # macOS 图标
├── dist/                # 构建输出目录
├── package.json         # 项目配置
└── README.md           # 项目说明
```

## 配置说明

### 应用配置
- **应用 ID**: `com.onemails.app`
- **产品名称**: `OneMails`
- **版本**: `1.0.0`

### 安全设置
- 禁用 Node.js 集成
- 启用上下文隔离
- 禁用远程模块
- 启用网页安全

### 窗口设置
- 默认尺寸: 1200x800
- 最小尺寸: 800x600
- 支持全屏
- 支持缩放

## 图标要求

请确保在 `assets/` 目录中放置以下图标文件：

- `icon.png` - 512x512 像素 PNG 格式 (Linux)
- `icon.ico` - 多尺寸 ICO 格式 (Windows)
- `icon.icns` - 多尺寸 ICNS 格式 (macOS)

## 自定义配置

### 修改目标网站
在 `src/main.js` 中修改以下行：
```javascript
mainWindow.loadURL('https://onemails.ai/login');
```

### 修改窗口尺寸
在 `src/main.js` 中的 `createWindow()` 函数中修改：
```javascript
mainWindow = new BrowserWindow({
  width: 1200,    // 修改宽度
  height: 800,    // 修改高度
  // ...
});
```

### 修改应用信息
在 `package.json` 中的 `build` 部分修改：
```json
{
  "build": {
    "appId": "com.yourcompany.yourapp",
    "productName": "Your App Name",
    // ...
  }
}
```

## 发布

构建完成后，可执行文件将在 `dist/` 目录中：

- **Windows**: `.exe` 安装程序
- **macOS**: `.dmg` 磁盘映像
- **Linux**: `.AppImage` 可执行文件

## 故障排除

### 常见问题

1. **图标不显示**
   - 确保图标文件存在于 `assets/` 目录
   - 检查图标文件格式和尺寸

2. **构建失败**
   - 检查 Node.js 版本 (推荐 16+)
   - 清除 node_modules 并重新安装依赖

3. **网站加载失败**
   - 检查网络连接
   - 确认目标网站可访问

### 调试

启用开发者工具：
```bash
npm run dev
```

或在应用中按 `Ctrl+Shift+I` (Windows/Linux) 或 `Cmd+Option+I` (macOS)

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！