从零把系统装起来

先确认两件事

第一，电脑上要有 Python 3.10 或更高版本。打开命令行输入 python --version，能看到版本号就行；没有就去 python.org 下载，安装时记得勾选 “Add Python to PATH”。

第二，把项目解压到一个英文路径下，比如 D:\tuodan。中文路径和空格容易让依赖安装出问题。

1. 创建独立的运行环境

不要直接装在系统 Python 里。进入项目目录，创建虚拟环境并激活：

python -m venv venv

# Windows
venv\Scripts\activate

# macOS
source venv/bin/activate

激活成功后，命令行前面会出现 (venv)。

2. 安装依赖

pip install -r requirements.txt

装完后可以执行 pip list，看到 fastapi、uvicorn、sqlalchemy 就说明成功了。

3. 准备配置文件

把 .env.example 复制一份，改名为 .env。基础功能不需要填任何密钥，先保持默认就能启动。

要开 AI 或邮件，再填对应的项。具体看 AI 配置。

4. 启动

python main.py

看到服务启动日志后，在浏览器打开 http://localhost:8010。端口可以在 .env 的 PORT 里改。

5. 创建主账号

首次打开会进入创建主账号的页面。填名字、邮箱、密码，提交后就能登录。

邮箱要用真实存在的格式，比如 you@example.com。用 .local 这类保留域名会被校验拦下，报 422。

6. 验收：做完这四步再算装好

1. 能打开登录页，并成功创建主账号；
2. 新增一个客户并保存；
3. 刷新页面，客户还在；
4. 关掉程序重新启动，客户仍然在。