api

interviewpilot-api

InterviewPilot 后端服务（FastAPI + SQLite）。

核心能力

• 资产管理：简历 / 录屏 / 知识库上传与删除
• 分析流水线：转写 -> 问答切分 -> 报告合成 -> 关联落库
• 任务可观测：阶段进度、耗时、执行器、预计剩余时间（ETA）
• 模拟面试：基于简历 + 报告 + 知识库生成问题

本地运行

cd apps/api
python -m venv .venv
.\.venv\Scripts\activate
pip install -e .[dev,local-asr]
Copy-Item .env.example .env
uvicorn retro_app.main:app --reload --port 8000

访问：

• API：http://localhost:8000
• Swagger：http://localhost:8000/docs

关键配置

• RETRO_API_BASE：https://api.deepseek.com/v1
• RETRO_API_KEY：DeepSeek API Key（必填）
• RETRO_LLM_MODEL：deepseek-chat
• RETRO_LOCAL_ASR_MODEL：tiny|base|small|medium|large-v3
• RETRO_LOCAL_ASR_DEVICE：cpu|cuda
• RETRO_STRICT_REAL_QA：是否严格要求真实转写问答

模型缓存说明

本地 ASR 模型不会放入仓库；首次运行自动下载并缓存到：

• 默认目录：apps/api/data/models

也可在 .env 中修改：

RETRO_LOCAL_MODEL_CACHE_DIR=./data/models