跳转到内容

第 2 章 学习平台:智学伴 / 知了的长期产品方向

来自《个人产品实践》 · 原稿更新 2026-11-09 · 服务器只读阅读视图

2.1 为什么做:解决“今天知道答案,明天还是不会”

早期“知了”与“智学伴”的学习产品构想,都围绕今日计划、AI 教学、练习、错题、学习证据、复盘和家长反馈。

真正目标不是一个更会解题的聊天机器人,而是:知道学生学过什么、哪里会错、下一次应该从哪开始。具体名称和产品阶段按最新项目仓库核对,不能把历史命名视作多个已交付产品。

2.2 我希望的一条完整学习闭环

图解:学习闭环的中心,是学生真实作答

学习闭环的中心,是学生真实作答(概念示意)

读图: 图描述本章的产品目标,不是“所有功能已经上线”的架构图。计划完成、AI 总结和学生独立掌握必须分开记录。

历史情况 → 今日目标 → AI 解释 → 学生真实练习
→ 记录结果和错因 → 更新状态 → 次日继续

“看过教材”“完成任务”与“真正掌握”不是同一个事实。错题和画像必须尽量由学生确认或真实学习事件支撑;AI 的猜测不能冒充已掌握。

**我的学习产品有过“AI 把七项逾期任务一次标成完成”的事故。**后端校验了归属与参数,却没要求真实作答或巩固证据。正确的学习闭环要让任务完成有明确权威证据;学生说“今天任务做完了”仍应能安排新学习,但模型不能为了清空逾期项而擅自调用 complete_task_item。另外,“嗯”“可以”也不是创建计划的授权:先保存服务端草案,再由独立确认卡和服务端状态校验完成创建。

家庭任务奖励、旧计划显示和家长报告的记录,见附录 A.2.1 至 A.2.3。

统一学习记忆的旧方案(待学习、待确认落地)。当时的判断是“只抄 3 个轻量点,不抄重型树引擎”:统一检索笔记、错题和计划,保存笔记到错题/计划的显式关系边,让 Agent 按需决定是否记忆。原 P1 先用标签、全文与时效打分,不急着加向量;关系边仍须按学生隔离。文档列了实现清单和估时,不能据此认定已上线;下一步先核对当前代码与实际召回证据。

来源:调研-来源-知了-记忆-holaOS借鉴方案。

2.3 已有实现与待解决问题分开记录

本地学习平台仓库有 React 前端、FastAPI 后端以及试卷、学习计划、任务会话、学生给家长报进度等功能文档。2026-07-25 的历史记录显示,部分学习摘要、移动化试卷和家长报进度已经通过当时的验收;这不能当作今天所有功能仍正常的证据。

还需要长期关注学生主动性、未完成计划滚动、实际练习证据是否更新画像,以及 AI 内容与真实教材是否区分清楚。

资料:学习平台代码仓库 · 产品愿景、学习闭环与历史调研 · 息壤杯与作品方案。

桌面客户端能下载,不代表旧版本会自动更新。 2026-06 的 StudyBuddy 分发记录里,发布既要上传安装包,也要更新与文件名对应的 latest.yml / latest-mac.yml。当时 v0.1.0 没有自动更新代码,需要先手动安装 v0.1.1;已验证的是更新清单可访问、版本号正确,真正的 v0.1.1 → v0.1.2 升级还要等下一次发布验证。Windows 与未签名 macOS 当时走了不同的安装流程,不能合成一句“两端自动更新已完成”。

自建更新服务要让安装包与元数据保持一致,再由旧客户端走完检测、下载、校验、安装和重启。元数据格式按实际 electron-builder / updater 版本核对,不能把旧清单字段直接当成所有版本的发布规范。

来源:旧库 90-归档/20-个人/参考资料与规范/项目运维/腾讯云静态站部署与安装包分发操作指南.md 第 237—292 行;electron-builder 官方自动更新文档。

**前端的“会话丢了”曾并非数据被删。**任务会话更新更晚,前端初始化只按最近更新时间选会话,误把任务会话当学生主会话;点“新上下文”清除的应是本轮消息摘要,不应抹掉计划、错题、学生画像等业务事实。以后用主/任务会话类型、真实 session_id 与模型实际输入三个层面一起验收。刷新或返回时要恢复正确的会话 ID;跨任务提问应提供切换入口并保留原任务上下文。

冷启动验收的记录见附录 A.2.4。

2.4 我从产品中得到的教训

不要先做十几个 AI 功能,再要求学生理解怎么用。 先让学生知道“今天继续什么”;每个新能力必须改善学习、练习或复盘中的一个真实步骤,不然只增加负担。

2026-07 的一次产品反思:学生需要的未必是更多 AI 答案,而是自己确认过的错误原因和下一次改变。 AI 可以帮助讲解和整理,但错题应留原题、第一次怎么答、学生自己认可的错误理解、修正思路与复练结果。漂亮的 AI 总结不能替代学生真实掌握。它是产品判断,并非已有留存率实验证明。

**我在 2026-09-08 曾把两个目标分开。**原学习平台功能很多,但真实学生持续使用不足:它可以保留为能讲清 Agent、错题证据与微信反馈的开源技术作品;家人真正会用的东西先试“一个任务→提交证据→家长确认→奖励记录”的轻闭环,奖励记录不做真钱钱包。这个是当时阶段性取舍,不代表后续不再开发教育产品。判断是否成功要看真实持续使用,而不是提交次数。

上传摘要、通用化和学习空间隔离的记录,见附录 A.2.5 至 A.2.7。

2.5 真实验收:不能把练习完成等同于学习成功

2026-08-19 的验收记录有 11 个观察项,并非都是真正的 Bug。 Q-001 “出现相同教学内容”主要来自历史会话,当时未复现当前重复教学,因此不应继续算作真实故障。

真正影响学习闭环的主要是:

  • 计划依据(Q-003):归档旧计划未被查询工具返回,但 AI 仍给出看似合理的“沿用旧学习内容”草案。输出合理 ≠ 找到过真实历史证据。
  • 可操作入口(Q-005):试卷创建成功,界面却没显示“开始作答”;AI 指引学生点一个不存在的按钮。工具成功不等于用户能继续做题。
  • 作答与判分协议(Q-007):两空的填空题只有一个输入框,学生懂语法、写出合法答案,却因为标准答案包含省略号而被判错;错误统计进一步污染能力诊断。UI 输入、题型、判分、画像必须连成同一份证据链。
  • 结果回传(Q-009):学生已经提交正式试卷,任务老师却没有可读结果工具,要求学生重新输入答案。不是单纯“模型没选对工具”,而是任务会话缺少结果读取能力。
  • 掌握结论过早(Q-008、Q-011):一次高提示练习答对就说“已经掌握”,甚至把学科名称当知识点;应先区分“这道题答对了”和“跨题型稳定表现”,能力状态应有可追溯、可纠错的证据。
  • 移动体验和教学质量(Q-004、Q-010):窄屏标签溢出,教材标注虽清楚但练习提示过强、没有考查迁移。要用手机视口和真实迁移题验收。

2026-08-19 的处理状态: PR #154 已创建、CI 通过,但当时未合并、未部署。Q-005/006/007/009/011 有代码修复记录;Q-003/004/008/010 尚未覆盖。当前是否发布并修好,仍需查实际部署和用户流程。

这批记录最重要的不是 Bug 数量,而是我开始把“AI 说已经完成”拆成真实工具结果、页面入口、学生作答、判分证据和下一次学习决定,逐环核查。 **计划创建成功不等于教学好。**用户后来明确提出,同一个“一般过去时”知识点出现在两个计划里,老师第二次不应从零重讲;更该利用之前答题与复述证据调整难度。反过来,AI 提示太多会提高“作业正确率”却遮住真实掌握:可以标记哪一步由 AI 帮忙,并用隔天无提示迁移题复验,而不是把一次答对当学会。

试卷作答的设计见附录 A.2.8。

2.6 掌握度:完成、独立作答、迁移与保持是四种不同证据

之前的实际验收已经说明“一次答对就说已经掌握”会误导学生。旧 Wiki 又提出了一个更具体的知识点级证据账本:题目映射、答对/答错、重复犯错、间隔复练都要关联到稳定的知识点 ID,而不是直接把学生自评或模型的形容词保存成事实。

学生当下的表现 能证明什么 还不能证明什么
讲解、任务或计划完成 这一流程走完了 真正独立会做
当前题目答对 在这个题型、提示条件下答对 换题型也能做
跨题型、跨章节作答正确 有更广的迁移证据 长期不会忘
隔几天复练正确 在该间隔上表现仍保持 永久稳定掌握

掌握度算法可以先从加权正确率和错误事件做可解释基线,再比较时间衰减和 BKT/IRT 等方法。但旧稿并未确定可靠权重、知识点映射质量、置信度校准或足够样本,不能先造出一个看似精确的 0~100 分数再宣称科学。真正上线前应保存原始事件、状态更新时间和公式版本;让旧数据可以重算,分清学生自评和客观作答。

反馈也不能只说“还没掌握”:更好的话是“这道题你做对了;我们过几天再换种题型试试”。既要告诉孩子具体进步,也要准确说明证据范围。

来源:旧 Wiki“知识点掌握度计算公式”“进度状态机”“完成、掌握与长期保持”“单场景表现反馈”四份问题笔记;这些是候选设计,并不是现在产品已经使用 BKT 的证明。

知识点稳定 ID 的记录见附录 A.2.9。

2.7 “修改 30 个文件”不是验收指标:一次做好一个真实功能

2026-08-21 的学习平台任务里,曾经开了很多并行 PR 和 worktree,却发现所谓“30+ 文件聚合”的改动,有 29 个文件只是插入一行无意义的占位注释。Git diff 显示“文件数很多”,但用户要求的实际功能一项没有因此完成。当时这些占位改动被判定作废,改成一次做好一个可验证的产品功能,再进入下一项。

真正验收 AI 素材处理,应该看学生上传一个真实文本型 PDF → 模型是否产生标题/标签/摘要 → 学生能否查看和纠正 → 扫描版无法解析时是否有准确提示,而不是统计 diff 改了几个文件、开了多少 PR、或者看测试跑了几次。手机端还需检查 320/390/414 等视口的实际操作路径。

交接状态也要可信:2026-08-21 的文档仍记录新聚合范围、代码提交和部署有待确认,因此这里只保留“虚假文件数验收”的反例,不宣称这项功能后来已经全面上线。

来源:40-AI任务交接/2026/08/21-xcc学习平台-30文件真聚合重思.md,历史工作交接,不是最新发布状态。

2.8 临时修好了不等于代码被保存:用户旅程与 Git 一起验

另一份 2026-07-25 学生/家长绑定与学习计划交接,出现过局部测试短暂通过,后来外部工作区切换导致未提交改动丢失的情况。历史单测证据能说明某个临时目录在当时通过,但不能证明当前分支仍有修复;未保存的 diff 一旦丢失,验收就必须重新定位和实施。

产品侧要验的是完整路径:草案商量 → 学生确认 → 计划持久化 → 顶部继续学习 → 正确进入目标任务会话。只看到数据库多了一条计划,或 AI 告诉用户“已创建”,不等于学生真的能点下一步。更不能让通用按钮直接把计划项 ID 带到错误的会话里启动练习。

交付清单里要同时有真正能走通的页面、相关测试、差异与提交 ID、是否合并、是否部署及用户 Live Test。测试、提交、部署和上线验收各是一道独立门槛;任何环节缺失都不自动补成“完成”。

来源:40-AI任务交接/2026/07/25-智学伴-家长绑定与计划流程修复.md;这是 2026-07 的失败/待办记录,后续状态必须按最新仓库另验。

测试与验收状态分开记录的做法见附录 A.2.10。