simonkoson
3.1 KiB
3.1 KiB
双机同步开发指南
单位 4090D（主力开发机） ↔ 家里电脑，通过 Gitea 云端仓库同步。 仓库地址：
http://101.42.29.217:3000/simonkoson/tps-dashboard.git
到家后第一次（克隆 + 环境搭建）
如果家里电脑还没有这个项目，先克隆：
git clone http://101.42.29.217:3000/simonkoson/tps-dashboard.git
cd tps-dashboard
然后搭建环境：
# 1. 创建 Python 虚拟环境
python -m venv .venv
.\.venv\Scripts\Activate.ps1
# 2. 安装后端依赖
pip install fastapi uvicorn sqlmodel python-dotenv psycopg2-binary bcrypt==4.0.1 itsdangerous==2.2.0 python-multipart==0.0.9 openai python-docx
# 3. 安装前端依赖
cd frontend
npm install
cd ..
配置环境变量（两个 .env 文件，都不在 git 里，需要手动创建）：
# backend/.env — 从单位机器上复制内容，包含：
# DATABASE_URL=postgresql://...
# SECRET_KEY=...
# MINIMAX_EMBED_API_KEY=...
# MINIMAX_GROUP_ID=...
# DEEPSEEK_API_KEY=...
# ai-labeling/.env — 包含：
# MIMO_API_KEY=...
注意：数据库连接指向腾讯云 PostgreSQL，两台机器连的是同一个数据库，不需要本地装 PostgreSQL。
每次开工（不管在哪台机器）
cd E:\tps-dashboard # 或者家里对应的路径
git pull origin main # 拉取对方机器推送的最新代码
如果有新的前端依赖（别人装了新 npm 包），还需要：
cd frontend && npm install && cd ..
如果有新的 Python 依赖，激活虚拟环境后 pip install。
启动开发服务器
开两个 PowerShell 窗口：
窗口 1 — 后端：
cd E:\tps-dashboard
.\.venv\Scripts\Activate.ps1
cd backend
python -m uvicorn app.main:app --reload --port 8000
窗口 2 — 前端：
cd E:\tps-dashboard\frontend
npm run dev
浏览器访问 http://localhost:5173（或 5174）。
收工推送（每次下班前必做）
cd E:\tps-dashboard
git add -A
git status # 检查一眼，确认没有不该提交的文件（.env 等）
git commit -m "你的提交信息"
git push origin main
常见问题
pull 时报冲突
说明两台机器改了同一个文件。先看冲突内容：
git diff
手动解决冲突后：
git add .
git commit -m "resolve merge conflict"
git push origin main
忘记 push 就换了机器
在另一台机器上 git pull 会发现没有新内容。回到原来的机器先 push，再回来 pull。
.env 文件丢失
.env 不进 git，换机器需要手动复制。建议用安全的方式（如加密 U 盘或密码管理器）在两台机器间同步 .env 内容。
给 Claude Code 的指令
如果你在家里用 Claude Code 开新 session，让它先执行：
请先阅读 CLAUDE.md 和 docs/dual_machine_sync.md，了解项目背景和双机开发环境。
然后阅读 docs/git_workflow.md 第 7 章了解 git 工作流。
我现在在家里的电脑上，代码已经 pull 到最新。请帮我启动开发环境并确认一切正常。