vocabulary-builder

Vocabulary Builder 是一款专注于外语词汇系统性构建的个人学习工具，采用认知科学中的间隔重复（Spaced Repetition）理论，帮助用户从阅读、播客和日常接触中高效积累词汇。

核心用法
该 Skill 围绕"阅读-记录-复习"的闭环设计。当用户阅读书籍时，可实时记录生词并标注来源和页码；通过独特的"3步学习法"（确认发音→理解含义→造句应用）完成初次学习；随后系统自动按照"次日→3天→1周→2周→1月→3月"的间隔重复计划推送复习测验。支持英语和法语学习，法语单词可关联本地音频文件辅助发音练习。

显著优点
首先，纯本地存储设计（memory/vocabulary.md）确保学习数据完全私有化，无云端泄露风险。其次，结构化的词汇卡片模板包含音标、同义词、语境例句等多维信息，符合深度记忆原理。智能测验系统具备防打扰机制（夜间静音、避免连续推送），支持按需定制测验范围（特定书籍、时间段或页码）。进度追踪体系清晰，词汇在"活跃-长期复习-已掌握"三阶段间自动流转。

潜在缺点
作为纯文档型 Skill，缺乏云端同步能力，无法实现多设备学习进度共享。数据持久化完全依赖本地文件系统，若工作目录权限设置不当或文件误删，可能导致学习记录丢失。此外，该 Skill 由个人开发者维护（T3来源），长期更新和维护稳定性存疑。对法语学习者的音频文件支持需要用户手动管理文件路径，增加了使用门槛。

适合人群
适合具备一定自律性的深度阅读者、外语备考人员（如 GRE、雅思）以及需要系统性管理专业词汇的学术研究者。特别适合重视数据隐私、偏好离线学习或处于网络环境受限地区的用户。对于需要游戏化激励或社交化学习体验的用户可能略显单调。

使用风险
主要风险在于数据管理：Skill 会读写本地 markdown 文件，若工作目录权限配置错误可能导致读写失败或数据损坏。建议用户定期手动备份 vocabulary.md 文件。此外，虽然 Skill 本身无网络通信，但用户需确保放置音频文件的 docs/tts-fr/ 目录安全性。由于是提示词模板驱动的交互，其功能边界受限于 Claude 的核心能力，无法替代专业的语言学习应用。

核心用法

Vocabulary Builder 是一款面向深度阅读者的词汇积累工具，设计围绕「阅读场景→即时收录→系统复习」的完整学习闭环。

1. 阅读工作流

用户开启阅读时，Skill 会检查该书籍的词汇记录，提示上次学习到哪个单词、哪一页，避免重复或遗漏。随后可选择「先复习待学词汇」或「继续阅读并添加新词」。

2. 添加新词（标准化卡片）

每词强制包含：IPA 美式发音、简明释义、同义词、原文语境句。法语词汇额外支持音频文件挂载（用户自备 TTS 音频），英法严格分字段存储。

3. 三步学习法（单次会话完成）

完成三步后进入间隔重复队列。

• Step 1：看词自检发音（用户打字确认，无语音交互）
• Step 2：回忆释义
• Step 3：造句应用

4. 间隔重复调度

标准 SM-2 简化版：次日→3天→7天→14天→1月→3月。通过后将词移入「Mastered Words」。

5. 智能测验系统

• 防打扰机制：同一日内若用户未回应测验，不再推送；夜间 23:00-07:00 静默
• 优先级：到期复习词 > 新学未完成词 > 随机温故
• 随机算法：基于 Unix 时间戳取模，确保可复现的「伪随机」
• 按需测验：支持按书籍、页码范围、时间窗口、指定单词等维度灵活发起

6. 数据持久化

所有词汇存储于 memory/vocabulary.md，采用三级分区（Active / Long-Term / Mastered），顶部维护 Quiz State 追踪会话状态，便于人工审计与备份。

---

显著优点

| 维度 | 亮点 |

|------|------|

| **学习科学** | 严格遵循「提取练习+间隔重复」的认知科学原理，三步法强制输出而非被动输入 |

| **场景贴合** | 以「正在读的书」为上下文锚点，解决「背了单词却在阅读中认不出」的痛点 |

| **防沉迷设计** | 单词单测、夜间静音、未回复不轰炸，尊重用户注意力 |

| **数据主权** | 纯本地 Markdown，用户拥有完整数据，可随时导出或版本控制 |

| **多语言友好** | 英语为主，法语支持音频挂载，结构可扩展至其他语种 |

---

局限与注意事项

1. 无自动提醒：依赖用户主动发起或 cron 心跳触发，无系统级推送能力
2. 发音无校验：基于信任的打字确认，无法检测实际发音准确性
3. TTS 需自备：法语音频需用户手动放置到指定目录，无自动生成
4. 统计功能弱：无图表化进度视图，仅文本列表形式
5. 移动端体验：Markdown 长文本在窄屏设备上可读性受限

---

适合人群

• 外文书精读学习者：希望以「一书一库」方式积累词汇，而非泛背词表
• 自律型用户：能主动维护学习节奏，不需要游戏化或社交激励
• 隐私敏感者：拒绝云端同步，偏好本地可控的数据存储
• 多语言学习者：同时接触英法或其他语种，需结构化分类管理

---

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 数据丢失 | 中 | 本地文件无自动备份，误删或损坏无法恢复 |

| 进度伪造 | 低 | 用户可手动修改 Markdown 的完成标记，但仅影响自己 |

| 学习惯性中断 | 中 | 无外部提醒时，易因遗忘而中断复习节奏 |

| 来源可信度 | 低 | T3 个人开发者，未来更新需人工审阅（当前版本已认证安全） |

---

认证报告摘要：S 级安全，95 分，纯 Markdown 无代码执行，零外部依赖，GDPR/CCPA 合规。