You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
116 lines
3.3 KiB
116 lines
3.3 KiB
# 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
|
|
|