开发文档

当你需要的是实现上下文,而不是操作者说明时,从这里进入。

本节包含

  • 架构总览:快速把前端、后端、worker、Provider 与存储拓扑放回同一张脑图里。
  • 后端开发:理解 FastAPI、Celery、SQLAlchemy、services、infra 与运行策略契约。
  • Browser Harness 开发:梳理 signed pack、导入 API、运行时约束与 UI 交接点。
  • 前端开发:了解 React、Vite、TanStack Query、壳层布局与操作者表面的设计要求。
  • 国际化:在保证可操作性的前提下,让英文与中文文案长期保持同步。
  • 数据库与迁移:跟踪 schema、迁移边界,以及 Compose 启动对数据库的实际假设。
  • 测试指南:把本地质量门槛对齐到 CI,而不是把基础错误留给 GitHub Actions。
  • LightEval 配置:查看 Provider、Dataset 与 Run 元数据怎样映射进 LightEval 执行配置。
  • 贡献流程:使用当前文档工具链、commit 规范和 review 预期来修改仓库。