# BRAIN Template Decoder - Mac 版本

专为 Mac 用户设计的便携安装包，无需复杂配置即可使用。

## 📦 系统要求

- macOS 10.14 (Mojave) 或更高版本
- 仅需首次安装 Python 3.9+（如果没有的话）

## 🚀 快速开始

### 步骤 1: 解压文件
将此文件夹解压到任意位置（建议：应用程序文件夹或文档文件夹）

### 步骤 2: 运行启动脚本

**方法 A: 双击运行（推荐）**
1. 找到 `一键启动.command` 文件
2. 双击运行即可

**方法 B: 终端运行**
1. 打开"终端"应用（在"应用程序" → "实用工具"中）
2. 输入以下命令：
   ```bash
   cd /path/to/BrainDecoder_Mac  # 替换为实际路径
   chmod +x 一键启动.sh
   ./一键启动.sh
   ```

### 首次运行说明

首次运行时，脚本会：
1. ✅ 检查 Python 是否已安装
2. ✅ 自动创建虚拟环境
3. ✅ 安装所有必需依赖（约 2-5 分钟）
4. ✅ 启动服务器
5. ✅ 自动打开浏览器

之后每次运行都会直接启动，无需等待安装。

## 🔧 如果没有安装 Python

脚本会提示您安装 Python，有两种方式：

### 方式 1: Homebrew（推荐，适合开发者）
```bash
# 1. 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 Python
brew install python@3.11
```

### 方式 2: 官方安装包（简单直接）
1. 访问：https://www.python.org/downloads/macos/
2. 下载 Python 3.11 或 3.12 的 macOS 安装包
3. 双击 .pkg 文件安装
4. 重新运行启动脚本

## 💡 使用说明

启动成功后：
- 🌐 浏览器会自动打开 http://127.0.0.1:5000
- 🎯 在网页中使用所有功能
- 🛑 按 Ctrl+C 可停止服务器

## 📁 文件结构

```
BrainDecoder_Mac/
├── 一键启动.sh          # 启动脚本
├── 一键启动.command      # 双击启动（如有）
├── README_Mac.md         # 本说明文件
├── APP/                  # 应用主目录
│   ├── 运行打开我.py     # 主程序
│   ├── requirements.txt  # 依赖列表
│   ├── templates/        # 网页模板
│   ├── static/           # 静态资源
│   └── ...
└── .venv/               # 虚拟环境（首次运行后创建）
```

## ❓ 常见问题

### Q: 双击启动脚本没反应？
A: 需要先给脚本添加执行权限：
```bash
chmod +x 一键启动.sh
```

### Q: 提示"无法打开"或"来自身份不明的开发者"？
A: 右键点击脚本 → 选择"打开" → 点击"打开"确认

### Q: 端口 5000 已被占用？
A: 关闭其他使用 5000 端口的程序，或者修改配置文件中的端口

### Q: 安装依赖时网络慢或超时？
A: 可以使用国内镜像源，编辑 `APP/mirror_config.txt` 文件

### Q: 想要完全卸载？
A: 直接删除整个文件夹即可，不会在系统中留下其他文件

## 🔐 安全说明

- 本应用仅在本地运行（127.0.0.1），不会暴露到互联网
- 所有数据保存在本地，不会上传到任何服务器
- 首次运行会创建虚拟环境，不会影响系统 Python

## 📞 获取帮助

如有问题或建议，请联系开发团队或查看项目文档。

---

**版本**: 1.0.0  
**更新日期**: 2026-01-05