📚 超级助理词汇导师（MCP）
一款基于人工智能的语言学习助手，旨在使用模型上下文协议管理您的个人词汇和语法数据库。该项目通过间隔重复、上下文练习和语法焦点跟踪，帮助用户将单词从“被动”识别转变为“主动”掌握。
______________________________________________________________________
🚀 入门指南
先决条件
- Python 3.8+
- 支持的主机环境 模型上下文协议（MCP） （例如浏览器上的Gemini）。
- 这 超级助理扩展 安装在浏览器中。
安装说明
- 安装依赖关系：
pip install -r requirements.txt- 安装扩展： 确保浏览器中的SuperAssistant扩展处于活动状态。
- 验证连接： 打开扩展设置并确保 主控程序, 自动插入，以及 自动执行 启用切换。
- 数据库初始化： 第一次运行服务器时，系统将自动准备
vocabulary和grammar_focus跟踪进度的表格。
- 启动服务器：
python server.py- 故障排除： 如果侧边栏显示“加载说明…”，请执行硬刷新(
Ctrl + F5)或者关闭和打开扩展以重置连接。
______________________________________________________________________
🛠 可用工具
助手使用以下功能与您的数据库交互：
词汇管理
| 功能 | 说明 |
|---|---|
get_learning_stats | 总结所有掌握水平（1-5）和主动语法目标的字数。 |
get_due_words(limit=5) | 根据下一个复习日期获取准备复习的单词。 |
update_word_rating(expression, new_rating) | 添加新单词或更新现有单词的评级/注释。支持批量操作。 |
get_words_by_rating(rating) | 检索特定难度级别（1-5）的所有单词。 |
get_random_words(limit=5) | 随机选择单词进行各种练习。 |
get_recent_words(limit=5) | 检索数据库中最近添加的单词。 |
delete_expression(expression) | 从词汇数据库中永久删除一个或多个表达式。 |
语法重点
| 功能 | 说明 |
|---|---|
add_grammar_subject(subject, mistake_context) | 添加或更新语法主题以进行集中练习。 |
delete_grammar_subject(subject) | 从焦点列表中删除语法主题。 |
get_grammar_targets(limit=3) | 检索高优先级语法科目以供复习。 |
______________________________________________________________________
📖 如何使用
1.开始会话
首先，向助理询问你的学习统计数据或适当的单词。助手将生成 Jsonl 像这样的块：
{"type": "function_call_start", "name": "get_learning_stats", "call_id": 1}
{"type": "description", "text": "Checking current vocabulary progress."}
{"type": "function_call_end", "call_id": 1}2.精通程度
单词根据掌握程度分为1-5级：
- 1：全新/难以记忆
- 2：熟悉但需要努力
- 3：中级/可用于简单句子
- 4：高级/自信使用
- 5：掌握/自然的词汇部分
3.间隔重复
下次审核日期将根据评分自动计算：
- 评分1→ 1 day
- 评级2→ 3 days
- 评分3→ 7 days
- 评分4→ 15 days
- 评分5→ 30 days
4.语法重点
跟踪需要注意的语法主题。每个主题都有一个优先级，随着重复错误的增加而增加。
______________________________________________________________________
🔧 配置
环境变量
ALLOWED_ORIGINS：逗号分隔的允许CORS源列表（默认值：http://localhost:3000)
数据库
- 地点：
data/lingo_vocab.db - 桌子：
vocabulary,grammar_focus - 特点：WAL模式用于并发，性能指标
______________________________________________________________________
🧪 测试
使用pytest运行单元测试：
python -m pytest tests/______________________________________________________________________
📋 API验证
所有工具都包括输入验证：
- 评级必须是整数1-5
- 限制必须为正整数
- 表达式不能为空
- 主题必须是非空字符串
______________________________________________________________________
🤝 贡献
- 遵循中的编码标准
.github/instructions/create-update-skill.instructions.md - 为新功能添加测试
- 更新API变更文档
- 逐步提交更改
______________________________________________________________________
