咕咕知识笔记

面向哪些工作

咕咕知识笔记面向本草、方证与中医药知识学习者，将知识查阅和每日练习连接起来。学习者可以查找本草和方剂，阅读知识卡，完成闯关、闪卡和案例练习，并通过错题记录与学习计划继续复习。

产品沿用咕咕鸡、绿色按钮与暖色场景。首页、本草笔记、方证笔记、个人中心构成四个主要入口，学习进度、章节与 XP 提供连续的反馈。

核心能力

场景	输入与处理	用户结果
知识查阅	本草、方剂、分类与搜索关键词	查看条目、组成、功效与来源信息
首次学习	一张教学卡与三道题的留存设计	理解一个主题，看到首次成绩与订正结果
每日短练习	到期复习、需要巩固的内容与新知识	完成适量任务，并记录有效学习日
闪卡与闯关	回忆、翻卡、作答、解释与重练	保存掌握状态、错题和章节进度
七日同行	七个自然日内的学习记录	查看学习日与报告，自主开启下一周期
中断恢复	原会话、原题目与已确认答案	继续上次，保留已完成内容
当前页分享	当前路由及正常业务参数	分享本草、方证、关卡等当前页面

首周留存 PRD 的题量、周期与提醒属于产品设计参数。实际学习效果、D1/D7 和提醒能力需要对应生产数据与平台验证。后台指标区分未到期、无样本和零值，不使用页面访问代替学习完成。

学习数据如何使用

练习会话记录首次答案与订正答案，首次正确率保持原值。服务端确认合法完成后，累计 XP、学习日、连续天数与旅程；重复提交返回同一次结果。游客进度与账号合并保留原始会话来源，账号之间分别授权。

查源设计使用中药名称归一化、候选方剂检索和模型排序，输出带匹配说明的参考候选。HLD 中的 OCR、Qdrant 与多实例拓扑属于设计说明，应按实际模块验证情况启用。知识学习与参考资料不能作为诊疗、处方或用药依据。

使用的技术与架构

微信小程序与 H5 使用 uni-app、Vue 3 和 Pinia；PC 管理后台独立维护内容和运营资料。Node.js 业务 API 承担认证、知识、计划、进度与处方收藏；MySQL 保存业务记录，Redis 承担短期任务与缓存。Python Agent、向量检索和模型 API 属于查源设计边界。

下方架构图引用原 HLD，数据图引用首周留存设计与开发记录。图示说明组件责任及数据关系，使用条件以各模块当前验收为准。

当前状态与资料版本

本次读取项目聊天「分享功能」，确认已有认证会话修复与当前页分享的开发、构建和提交记录；该聊天明确说明尚未部署对应 H5 或重新发布小程序。当前本地目录同时包含后续留存开发和双端构建。

2026-09-10 的留存开发记录保存了逐功能检查；第二轮记录包含 MySQL 事务、旅程续期、指标和原 XP 规则的验证。提醒、微信运行时与真机结果继续按独立记录确认。介绍核验于 2026-10-14，本地源码基线为 7797f1a15a5f，包含未提交资料。

资料来源

依据项目聊天「分享功能」、产品需求文档、HLD、2026-09-09 首周留存 PRD、docs/retention/IMPLEMENTATION.md 和当前 H5 构建整理。项目来源与公开 GitHub 项目分别保存，当前介绍为本地审核材料。