跳到主要内容

技术栈

后端

  • FastAPI — Python 异步 Web 框架
  • SQLAlchemy — ORM,支持异步 SQLite/PostgreSQL
  • Pydantic v2 — 数据校验
  • python-jose + passlib — JWT 认证 + bcrypt 密码加密
  • boto3 — AWS S3 集成(教材存储)
  • httpx — 异步 HTTP 客户端

前端

  • React 19 + Vite — SPA + React Router
  • Tailwind CSS — 基于设计系统令牌的实用优先 CSS
  • Docusaurus — 文档站

AI / ML

  • vLLM(外部) — 远程 LLM 端点(Qwen3.6-35B-A3B-FP8)
  • RAG 管线 — 教材分块 → 语义标注 → 知识图谱 → 向量检索
  • 嵌入模型 — 远程服务(Qwen3-Embedding-4B-AWQ-INT4)
  • 语音识别 — 本地微调模型,支持教育术语纠错

基础设施

  • AWS S3zhiheng-806169617306(ap-east-1,教材与资源)
  • PostgreSQL 16 — 主数据库(Docker)
  • Nginx — 反向代理(前端 + API)
  • Docker Compose — 生产部署
  • Cloudflare Pages — 文档站托管
  • Cloudflare Worker — 基础认证网关

设计系统

  • DESIGN.md — 正式令牌规范(已校验、通过 WCAG 审核)
  • Tailwind 导出DESIGN.tailwind.json,用于前端集成
  • 参考风格 — 参考 Mintlify,适配中国教育场景