快速开始与部署说明。

优先使用 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。