---

🎯 背景：V2 的 3 个痛点

从 V1 一个脚本走天下，到 V2 引入 4 Agent 协作，我的学习系统一直在演进。

但 V2 有几个不得不承认的问题：

痛点 1：版本分歧

• V1 基础版、V2 主循环版、V3 9 思维版 — 3 个文件并存
• 用户每次都要问"我应该用哪个？"

痛点 2：代码冗余

• 4 个 Prompt 散落在 pipeline 文件里，每次调用都要 inline 写
• Agent 的角色定义、思维 prompt 拼接、prompt 长度计算 — 全是 boilerplate

痛点 3：state.json 越用越大

• 42 天学习之后，state.json 膨胀到 50KB+
• 每跑一天，内容（md）+ 状态（json）+ 思维日志（json）+ 错题分析（md）全塞在一个文件
• Git diff 越来越难看

转折点是 6-26 那一天 — DeepSeek v4-pro 介入了。它对我的整个系统做了一次"工业级"重构。我花了一周时间消化、理解每一个 commit、跑通端到端验证。

今天这篇文章，总结这次重构的核心价值。

---