英语学习速通工具

解决的问题

• 英语学习数据散落在网页或 App 里，Agent 想拿今日推荐、词库、测验结果时，往往只能靠用户截图或粘贴，难以形成学习闭环。
• 这个技能把账号、学习档案、词汇、文章、测验、写作、跟读、TTS 和打卡海报统一暴露成可调用的后端能力，让 Agent 能基于真实学习状态工作。

工作方式

• 后端是 Express，同一端口同时提供 REST API 和 MCP endpoint；生产环境使用 https://english.geeyo.com，本地开发监听 :3001。
• 推荐路径是先配置 MCP，再调用 account_login 缓存 userId；没有账号时，先在网页绑定，或通过 POST /api/users/ensure 创建匿名身份，并在请求头携带 x-user-id。
• MCP 暴露 22 个工具，按 Account、Profile & Learning、Vocabulary、Articles、Study Actions、Media 分组。
• 日常学习链路可以是：get_today 取今日文章 → vocab_list / vocab_review 复习词库 → tts 听文章 → copy_load / copy_submit 练写作 → quiz_submit 交测验 → checkin_poster 生成分享图 → get_profile 看变化。
• 未配置 MCP 时，REST fallback 对应同一套能力，例如 /api/today、/api/vocab、/api/tts、/api/copy、/api/quiz、/api/profile。

适用边界

• 依赖远端学习服务，不是本地词典或离线课程；Agent 需要处理登录失败、未设置 level、用户记录缺失等情况。
• get_today 在未设置 level 时会返回 needLevel: true，后续需调用 level_set。
• evaluate 目前是 stub，正式发音评估在下一阶段通过 ISE 提供；写作提交 copy_submit 每天最多加 5 分。