核心功能与用法
English Learn Cards 是一套轻量级、可移植的英语词汇学习工作流，采用 SQLite 本地存储 + 类 SM-2 间隔重复算法（SRS）。用户通过配套的 CLI 脚本 words.py 完成全部操作：初始化数据库、添加单词卡片、查询到期复习、执行 0-3 分级评分。
典型工作流程：
1. words.py add <word> — 添加新词，自动填充释义与音频字段
2. words.py render <word> --fill-audio — 生成富媒体卡片预览
3. words.py due — 列出当日需复习卡片
4. words.py grade <card_id> <0-3> — 根据回忆难度评分，算法自动调整下次复习间隔
显著优点
- 完全离线：SQLite 本地存储，无云端依赖，数据隐私可控
- 算法成熟：基于 SM-2 间隔重复，科学优化记忆曲线
- 跨平台抽象：核心逻辑与聊天平台解耦，Slack/Discord/WhatsApp/Telegram 等均可通过配套 Agent Prompt 适配
- 确定性输出：CLI 封装避免大模型直接操作数据库导致的格式不稳定问题
潜在局限与风险
- 手动运维：无自动同步机制，多设备需自行解决数据迁移
- 无图形界面：纯命令行交互，对非技术用户门槛较高
- 音频依赖外部服务：
--fill-audio需网络请求，存在 API 可用性风险 - 评分主观性：0-3 分级完全依赖用户自我评估，缺乏客观校验
适合人群
技术背景用户、自托管爱好者、需要定制化英语学习流程的进阶学习者，以及希望将词汇复习集成到现有聊天工作流的团队。
常规风险
- 数据库路径通过环境变量配置，误设可能导致数据丢失
- 需严格遵循
.gitignore规则，避免意外提交 SQLite 文件或敏感脚本 - 跨平台 Prompt 适配质量取决于用户自行编写的 Agent 配置，官方仅提供模板