面向自托管的英语学习与 AI 私教项目。当前网站源码为 3.4,配套 AI 网关为 2.2。
- 持续学习、听说读写练习、分级语料与个人词汇本。
- 基于作答证据的知识图谱、复习建议和学习档案。
- AI 私教、逐步显示回复、任务排队、重试与长期学习记忆。
- 可选 OpenAI 兼容接口、Gemini / Vertex AI 和独立网关。
- 账号隔离、持久化记录与备份维护工具。
| 目录 | 用途 |
|---|---|
flow/ |
Python 网站后端、无需构建的前端和测试 |
flow/public/ |
页面、样式与 JavaScript |
flow-gateway/ |
可选 AI 网关及其部署脚本 |
validation/ |
验证工具 |
网站使用 Python 3.11 或以上及 SQLite;核心网站不需要 Node.js。Vertex 模式的附加依赖见 flow/requirements-vertex.txt。
部署脚本面向指定 Linux / systemd 环境。运行前核对域名、路径与服务配置,升级已有实例时保留并备份实际数据库和密钥。
cd flow
python3 -m unittest discover -s tests -v原交付包的验证记录保存在 VALIDATION.md,是历史交付记录,不代表本次整理已重新运行测试,也不代表真实模型认证和生产环境已经验收。
真实数据库、账户资料、学习记录、录音、备份、环境配置、API 密钥和云凭据不纳入公开仓库。只保留示例配置。
教学语料与导入词典应与用户运行数据区分管理;第三方来源内容的许可不随程序源码许可证自动授予。维护者已确认随包词典数据为原创或已获得公开再分发授权,因此本仓库保留该词典。此确认不额外授予超出原有授权的使用权。
原创程序源码采用 MIT 许可证。教学内容、导入词典及第三方材料不在该源码许可授权范围内;其使用和再分发须遵循各自授权。
自动检查:网站、网关及前端行为测试。测试结果以对应提交的 Actions 记录为准。