3.3 KiB

Raw Blame History

BRAIN Template Decoder - Mac 版本

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

📦 系统要求

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

🚀 快速开始

步骤 1: 解压文件

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

步骤 2: 运行启动脚本

方法 A: 双击运行（推荐）

找到 一键启动.command 文件
双击运行即可

方法 B: 终端运行

打开"终端"应用（在"应用程序" → "实用工具"中）

输入以下命令：

cd /path/to/BrainDecoder_Mac  # 替换为实际路径
chmod +x 一键启动.sh
./一键启动.sh

首次运行说明

首次运行时，脚本会：

✅ 检查 Python 是否已安装
✅ 自动创建虚拟环境
✅ 安装所有必需依赖（约 2-5 分钟）
✅ 启动服务器
✅ 自动打开浏览器

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

🔧 如果没有安装 Python

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

方式 1: Homebrew（推荐，适合开发者）

# 1. 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 Python
brew install python@3.11

方式 2: 官方安装包（简单直接）

访问：https://www.python.org/downloads/macos/
下载 Python 3.11 或 3.12 的 macOS 安装包
双击 .pkg 文件安装
重新运行启动脚本

💡 使用说明

启动成功后：

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

📁 文件结构

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

❓ 常见问题

Q: 双击启动脚本没反应？

A: 需要先给脚本添加执行权限：

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

3.3 KiB Raw Blame History