english-learn-cards

🎴 SRS 间隔重复英语闪卡记忆

基于 SQLite 的本地闪卡系统,采用 SM-2 间隔重复算法,通过剑桥词典 API 获取音频,适合注重隐私的个人英语词汇深度学习。

收藏
6k
安装
1.2k
版本
v0.1.1
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

English Learn Cards 是一款开源的英语词汇闪卡学习工具,采用 SQLite 本地存储与 SM-2 间隔重复算法(SRS),为学习者提供科学高效的单词记忆方案。该技能通过 Python CLI 工具 (words.py) 实现完整的学习闭环,包括卡片创建、复习调度、评分记录及音频获取等功能,可与 OpenClaw 代理配合在任何聊天平台使用。

核心用法方面,用户通过命令行与系统交互:init 初始化数据库结构,add 添加生词及释义,due 查看当日待复习卡片,grade 根据记忆效果进行 0-3 级评分。系统依据评分自动计算下次复习间隔,实现自适应学习节奏。配合 --fill-audio 参数可自动从剑桥词典 API 获取单词发音链接,增强多模态记忆效果。该设计平台无关,可集成至 Slack、Discord、Telegram 等聊天平台,通过对话式交互降低使用门槛。

显著优点包括:首先,数据完全本地存储(默认路径 ~/clawd/memory/),杜绝云端隐私泄露风险,满足敏感数据自控需求;其次,采用经过验证的 SM-2 间隔重复算法,科学优化长期记忆保持率;第三,代码完全开源可审计,Python 实现简洁透明,无黑盒操作;第四,平台解耦架构使其可适配多种聊天界面,灵活性极高;第五,参数化 SQL 查询与严格的输入验证(argparse)确保运行稳定,无注入风险。

潜在局限在于:作为 T3 级个人项目,长期维护稳定性与商业软件存在差距;纯本地 SQLite 架构不支持多设备同步或团队协作,仅限单机使用;自动获取音频功能依赖剑桥词典 API 的可用性与网络连接;需要一定的命令行操作基础,对纯 GUI 用户存在学习门槛;环境变量配置(ENGLISH_LEARN_CARDS_DB)对新手可能不够直观,存在误配置风险。

适合人群主要为:注重数据隐私、偏好自托管解决方案的学习者;需要定制化学习流程、不满商业 App 数据收集政策的进阶英语用户;具备基础技术能力、习惯命令行操作效率的开发者群体;以及需要在隔离环境(如无互联网的内网)中使用离线学习工具的场景。

使用风险常规层面包括:依赖 requests 库需保持更新以避免潜在安全漏洞;SQLite 数据库文件需定期备份防止磁盘故障导致学习记录丢失;环境变量配置错误可能导致数据存储位置混乱或权限问题;网络请求超时或剑桥词典 API 变更可能影响音频获取功能。总体而言,该工具在功能性与隐私保护间取得了良好平衡,适合技术意识较强的个人用户。

安全解读

功能概述

English Learn Cards 是一款轻量级英语词汇学习工具,采用经典的闪卡(Flashcard)模式结合科学记忆算法,帮助用户高效积累词汇量。

核心用法

  • 卡片管理:通过 CLI 工具 words.py 完成所有数据库操作,包括初始化、添加单词、查询待复习卡片等
  • SRS 复习:支持 0-3 四级评分系统,基于类 SM-2 算法自动计算下次复习时间
  • 音频支持:自动从 Cambridge Dictionary 获取单词发音音频
  • 平台无关:可配合任意聊天平台(Slack/Discord/Telegram 等)使用,需配置对应 Agent Prompt

显著优点

1. 隐私优先:所有学习数据存储于本地 SQLite 数据库,无云端同步,杜绝数据泄露风险
2. 算法科学:基于 SuperMemo SM-2 间隔重复算法,根据记忆效果动态调整复习间隔

3. 轻量便携:纯 Python 实现,仅依赖标准库 + requests,可在任何支持 Python 的环境运行

4. 可控透明:代码开源、结构清晰,用户完全掌控数据路径与使用方式

潜在局限

  • 无内置图形界面,依赖命令行或需额外配置聊天机器人交互
  • 需手动管理环境变量与数据库路径
  • 音频资源依赖外部 API,离线环境下不可用
  • 缺乏多设备同步功能

适合人群

  • 注重隐私、希望本地管理学习数据的英语学习者
  • 已使用 OpenClaw 等 Agent 平台的用户
  • 习惯命令行操作或愿意配置聊天机器人工作流的技术用户

常规风险

  • 长期学习数据需自行备份,误删数据库将丢失全部进度
  • Cambridge Dictionary API 变更可能导致音频功能失效
  • 评分主观性可能影响 SRS 算法效果,需用户诚实反馈记忆状态

english-learn-cards 内容

prompt-examples文件夹
scripts文件夹
手动下载zip · 9.9 kB
AGENT_PROMPT_TEMPLATE.mdtext/markdown
请选择文件