Skip to content

WordForge 是什么

WordForge 是一个自适应算法驱动的英语词汇学习平台,由 Rust 后端 + SolidJS 管理后台 + 独立的用户学习端(wordforge-web,单独仓库)组成。核心是内置的 AMAS(Adaptive Mastery Acquisition System,自适应掌握度习得系统),它在每一次答题事件后实时调整后续选词、间隔与节奏。

设计目标

  • 数据先行:每次答题都进入 AMAS 事件流,记忆模型、ELO、疲劳信号同步更新,下一次选词立刻反映在结果上。
  • 可观测、可回滚:所有 AMAS 配置变更落 amas_config_versions 表,三档来源(管理员手动 / LLM 建议 / LLM 自动)共享同一审计 + 回滚通道。
  • 就地运行:单二进制 + SQLite(WAL)默认部署,无需 Redis / 消息队列;自更新走 GitHub Releases tarball,原子替换 + 数据库 VACUUM INTO 备份。
  • 可调不可乱调:所有可调参数走 tuning_whitelist,区间硬约束在代码里,越界值在 LLM/手动两条路径都会被拒。

关键特性

模块说明
AMAS16 个子配置 / 6 类决策算法(ensemble、heuristic、IGE、SWD、MDM、SSP)+ ELO + 疲劳衰减
智能选词基于遗忘概率(MDM)、难度匹配(ELO)、学习阶段(冷启动 → 稳定)三维评估
疲劳感知MediaPipe + WebAssembly 摄像头检测,疲劳信号注入 AMAS 强度调节
LLM 调参顾问每 20 分钟跑一次 DeepSeek,综合近期指标产出 patch 建议,白名单 + 成本上限 + 灰度自动应用
配置热加载amas_config.tomlnotify watcher 盯着,500ms 防抖 + validate → reload_config() 原子生效
管理后台用户、广播、AMAS 调参、版本对比、监控、自更新;SolidJS + Tailwind v4 + TanStack Query
API 服务axum 0.7 统一对外,给管理后台与移动/Web 学习端复用

仓库定位

本仓库是服务端 + 管理后台一体的 monorepo。最终发布产物是单个二进制 learning-backend,把前端构建产物 static/ 内嵌作 fallback 静态资源。用户学习端 Web 已拆分到独立项目 wordforge-web,本仓库只对历史用户路径保留过渡页。

下一步

WordForge — 智能英语学习平台