单词量测试（扇贝词库）

扇贝公开测词汇量接口 + 自动错词本（网页版没有的功能）。词库与题量由用户在页面里自选，无需 AI 预先询问或转述任何题目内容。

触发

测单词量 / 词汇量 / 错词本 / 错词集；测四六级、考研、雅思等词库水平。

依赖

Python 3.8+，pip install requests。

用法（唯一推荐：图形界面，AI 零转述）

后台运行（此命令常驻不退出）：

python <技能目录>/scripts/vocab_test.py quiz --dir ./vocabtest

1. stdout 首行是 QUIZ_URL: http://127.0.0.1:<端口>/，用 present_files 打开给用户即可；
2. 页面全自动：设置（选词库 + 题量）→ 逐词辨义（每答一词立即显示对错与正确答案）→ 结果页（正确率、逐词回顾、错词本 txt/csv 下载）。批改在服务端，正确答案不预先下发，AI 不要向用户转述单词或选项；
3. 用户答完后，读 --dir 下最新的 summary-*.json 向用户总结成绩并交付错词本文件；
4. 结束时 POST http://127.0.0.1:<端口>/api/quit 停服务。

可选预置：--category CET4 --count 30 或 --bank <bank.json> 跳过设置页。

备用（无浏览器时）

python <技能目录>/scripts/vocab_test.py run --category CET4        # 终端互动，逐词即时批改
python <技能目录>/scripts/vocab_test.py fetch --category CET4 --dir D   # 只拉题存 bank-*.json
python <技能目录>/scripts/vocab_test.py grade --bank D/bank-X.json --know 0,3,7 --answers 0:2,3:1 --dir D  # 判卷出错词本

注意

• 扇贝公开接口仅限个人低频学习使用，禁止批量抓取、商用分发。
• 题库随机抽样，结果反映当次抽样水平；题量 >50 时自动分批取题去重。