快速开始与部署说明。

优先使用 macOS 启动器；如果希望直接检查和控制运行环境，也可以使用手动 Bash/Python 路径。

快速开始

  1. 下载 macOS 版。
  2. 打开 Team Chat Launcher。
  3. 启动本地 Hub。
  4. 创建或加入团队。
  5. 添加联系人。
  6. 开始在局域网内聊天。

安装说明

解压 macOS 下载文件，可按需把 App 移入 Applications，然后从 Finder 打开。如果 macOS 要求确认打开来自互联网的 App，请在 Finder 中打开并按照系统提示操作。

手动部署

高级用户可以直接使用 Bash/Python 路径。这些命令让运行方式保持可见，适合自定义部署。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python3 -m src.network.hub --host 0.0.0.0 --port 8080
python3 -m src.app.main --profile alice --transport network --hub 127.0.0.1:8080

故障排查

App 打不开

确认 zip 已完整解压，然后从 Finder 打开 App，并按需完成 macOS 确认提示。

浏览器 404

从项目根目录使用官网预览脚本，确保静态服务器指向 website 目录。

Hub 无法启动

检查 Python 依赖、选择的项目根目录，以及 Hub 端口是否已被占用。

无法发现局域网设备

确认设备在同一网络内，并允许 Hub TCP 端口和 UDP 发现端口通过防火墙。

文件发送失败

确认临时文件服务正在运行，并且客户端可以访问 Hub 主机。

权限 / 防火墙问题

允许 App 和 Python 运行时通过本机防火墙提示，然后重新尝试连接 Hub。