Skip to content

Repository files navigation

CDEP — Conversation-Driven English Protocol

对话驱动英语协议,非正式昵称:无痛学习法

CDEP 是一个 conversation-first(对话优先)、可迁移的渐进式英语学习协议。它让英语在用户与 AI 讨论真实兴趣时自然进入对话,而不是把聊天变成课程。首个版本优先服务单一用户的长期真实测试,可在不依赖 Worker、定时任务、数据库或平台专属 Agent 的普通 AI 对话框中运行。

实验状态:v0.1.0。 CDEP 尚无长期样本,也未经过学习科学验证。仓库中的“有效”描述只代表用户体验证据或待检验假设。

五分钟开始

  1. 先读两分钟版的 Conversation Compact用户契约
  2. 通用系统提示词 复制到任意 AI 的新对话或自定义指令中。
  3. 可选:一并提供 Profile 示例。Profile 是可修订快照,不是对用户能力的判决。
  4. 正常聊天。可以发送 context? 查询,也可以自然地问“刚才那个词是什么意思?”。
  5. 需要保存进度或换 AI 时,按 Lazy Update迁移流程 生成迁移包。

平台入口说明:ChatGPT · Claude · Gemini · Kimi。这些文件只做轻量适配,行为真源仍是通用提示词。

核心体验

  • AI 是对话伙伴,不是教师;自然聊天略优先于学习效率。
  • 英语比例渐进增加。刻意引入新词或语块时,首次默认使用 framework(框架),后续在语义合适时只用 framework
  • 已引入表达持续自然使用,但不为了复习而扭曲话题。
  • 通用表达(如 I thinkbecauseneed)通常比专业词获得更多自然机会;专业词只在相关主题出现。
  • 查询必须先完整复述原句,再处理发音、简短释义,然后立即回到原话题;不默认给例句或展开上课。
  • 不主动考试、评分、填空或练习;只有用户明确说 practice? 或主动要求时才进入轻量练习。
  • 用户可随时要求增加、减少、暂停或恢复英语,也可删除或重置学习数据。

完整承诺见 USER_CONTRACT.md

最小架构

组件 作用 真源
Conversation Compact 用户可直接感知的长期行为契约 CDEP_COMPACT.md
Profile 当前学习情况的轻量、可修订快照 Schema · Example
Event Log 追加式、可观察事实记录 Schema · Example
Lazy Update 由用户触发的批量分析与迁移 LAZY_UPDATE.md

日常聊天不承担数据库维护、遗忘曲线计算或复杂评分。Event Log 保存少量证据,Profile 摘要当前状态;发生冲突时,保留事件并以更近期、明确的用户反馈为依据修订 Profile。

数据与迁移

学习数据归用户所有。默认只在用户提供的文本、文件或当前会话中处理;CDEP 本身不包含云同步或后台上传。建议把真实个人数据放在被 .gitignore 排除的 data/private/,不要提交到公共仓库。

一个最小迁移包包括:

  • CDEP_COMPACT.md
  • GENERIC_SYSTEM_PROMPT.md
  • 当前 Profile
  • 可选的 Event Log 与近期对话摘要

详见 MIGRATION.md

设计边界

已接受:conversation-first、首次英中括注默认值、Profile + Event Log、Lazy Update、无后台依赖。决策记录见 decisions/

已拒绝进入 v0.1:复杂实时状态机、固定间隔复习算法、每轮新词配额、单一 CEFR 控制、把沉默等同掌握、不可解释记忆、强制练习和状态术语外显。

已延期:异步分析 Agent、自动定时复习、遗忘模型、CEFR 自动评估、多用户 SaaS、云同步、多 AI 写入冲突解决、自动语音识别/评分、通用技能模块。见 开放问题

验证与研究

设计历史只保留简明摘要,不把不同平台建议机械拼接:原始讨论 · Claude · Gemini · Kimi

参与贡献

请先阅读 CONTRIBUTING.md。新增主张必须标明是可观察事实、个人体验还是未验证假设;新功能不得悄悄改变用户契约。

License

MIT

About

A conversation-first, portable framework for gradual English learning with AI.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors