GitHub 发布检查清单

发布前请逐项确认：

仓库卫生

• [ ] 已执行 git status，没有 .env、venv/、uploads/ 被 staged
• [ ] .gitignore 已包含密钥与本地数据目录
• [ ] README.md 与 .env.example 已更新，不含真实密钥

首次推送命令

git init
git add .
git status
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/<你的用户名>/<仓库名>.git
git push -u origin main

云端 Secret 清单（在平台配置，不要写入代码）

• DATABASE_URL
• JWT_SECRET
• ARK_API_KEY
• DEEPSEEK_API_KEY（家族树抽取）
• VOLC_APP_ID / VOLC_ACCESS_TOKEN（语音）
• MEDIAKIT_OCR_API_KEY（若用 OCR）
• AUTH_REQUIRED=1
• HOST=0.0.0.0

部署后验证

1. GET https://你的域名/api/health 返回 JSON
2. 打开 /login 能注册或登录（若已 seed 演示账号）
3. /familytree-test 四表抽取（需 DeepSeek/方舟 Key）
4. /tower-tree 塔状树可显示

可选后续

• 添加 GitHub Release 与版本 Tag
• 配置 Dependabot 更新 Python 依赖
• 将 uploads/ 迁到 S3 / 对象存储（多实例部署时必需）