Update: masked_技术说明书.md

masked/masked_技术说明书.md

@@ -0,0 +1,78 @@
+# 蔬果萌学社
+
+## 一、总体框架
+
+本系统面向 3–8 岁儿童，结合计算机视觉、3D 建模和大模型技术，构建一个围绕“蔬菜水果”为核心载体的综合早教平台，支持语文、数学和英语三大学科模式。孩子通过拍摄或选择真实蔬果，系统自动完成识别与建模，并由 3D 虚拟老师进行分龄化、互动式教学，引导孩子在玩中学习。
+
+整体架构可以分为五个层次：
+
+- 感知层：负责蔬果图像采集与识别。
+- 资源层：管理蔬果 3D 模型、多媒体素材和早教知识库。
+- 智能层：基于大模型与检索增强（RAG）或本地训练 LLM，生成针对儿童的自然语言讲解与对话。
+- 表达与交互层：通过 3D 虚拟老师与卡通化界面，完成讲解、问答、拖拽、小游戏等多种交互。
+- 监测与推荐层：采集学习行为数据，构建注意力与兴趣评估模型，动态调整内容难度和交互节奏。
+
+------
+
+## 二、功能设计
+
+### 2.1 蔬果识别
+
+蔬果识别模块负责对摄像头采集或相册中选取的图像进行分析，自动判断其中包含的蔬菜、水果类别，并输出对应的类别 ID 及置信度。针对家庭环境中姓名的复杂背景与光照变化，模型将采用轻量化目标检测或分类网络，并结合专门采集的家庭场景蔬果数据进行训练与优化。
+
+识别结果不仅用于展示蔬果名称，还将作为后续各模块的统一索引：包括 3D 模型加载、语文科普卡片检索、数学题目生成以及英语词汇与句型调用。通过建立“类别 ID → 多模态素材”的映射关系，实现从“一张照片”到“多学科教学资源”的自动联动。
+
+### 2.2 3D 建模与展示
+
+3D 建模模块为每一种蔬果提供独立的三维模型资产，包括完整外观、基本材质以及简单的演示动画，例如旋转展示、切开展示、内部结构高亮等。所有模型采用统一格式（如 FBX/GLTF），存储在本地或云端素材库中，通过蔬果类别 ID 实现快速加载与切换。
+
+在交互层面，3D 模型不仅用于“看”，还用于“操作”：孩子可以拖拽水果到不同区域进行加减法练习，可以缩放观察不同部位，也可以在虚拟老师的引导下完成“分类”“配对”等小游戏。3D 场景整体采用卡通化、色彩柔和的风格，与幼儿 UI 保持一致，提升沉浸感和趣味性。
+
+### 2.3 早教讲解（语文 / 数学 / 英语）
+
+早教讲解模块是系统的核心教学子系统，围绕同一个蔬果对象，从语文、数学和英语三个维度提供多角度内容。
+
+- 语文模式：
+  语文模式中，系统会展示蔬果的中文名称、拼音、笔画顺序以及相关常用词组，并结合适龄化的科普内容（如产地、季节、营养特点、小故事）进行讲解。虚拟老师采用简短句、慢语速和儿童化表达，引导孩子跟读和识别，必要时可进行简单的语音对比与鼓励反馈。​
+- 数学模式：
+  数学模式重点通过“数量–实物–符号”的联结，帮助儿童建立基础数感。孩子可以拖拽物体到不同篮子中，系统实时显示数量变化，并以动画形式展示简单加减法过程，如“2 个苹果 + 1 个苹果 = 3 个苹果”。随着年龄增长，题目难度可以从 1–10 的数认知与比较，逐步过渡到 20 以内加减及简单应用题。​
+- 英语模式：
+  英语模式以蔬果单词为切入点，结合发音、拼写和简短句型学习。如“apple、banana”等高频水果词汇，配合“This is an apple.”、“I like apples.”等固定表达，让孩子通过看图、听音、跟读、选项等玩法完成初步口语与听力训练。虚拟老师在讲解过程中使用中英结合方式，降低理解门槛。​
+
+### 2.4 交互功能与注意力设计
+
+交互功能模块通过多种输入方式与游戏化机制提升孩子的参与度和持续注意力。系统支持点击、拖拽、长按、滑动等多种触控操作，并配合音效、粒子特效与角色表情变化，为每一次操作提供即时反馈。
+
+考虑到 3–8 岁儿童注意力持续时间有限，系统将学习单元拆分为 5–8 分钟内可完成的小任务，并在适当时机插入轻量化小游戏或过渡动画，避免长时间单一内容造成疲劳。同时，后端根据孩子的停留时长、错误率、频繁退出等行为数据，动态调整难度和推荐内容，使“既不太难，也不太无聊”成为常态体验。
+
+------
+
+## 三、关键技术
+
+### 3.1 视觉识别与类别映射
+
+在视觉层面，系统采用基于深度学习的图像识别模型对蔬果进行检测与分类，模型可选轻量化目标检测（例如 YOLO 系列的简化版本）或针对蔬果场景优化的分类网络. 训练数据包括多角度、多光照、多背景的家庭场景图片，以增强模型的鲁棒性和泛化能力。
+
+识别结果会映射到统一的“蔬果类别表”，该表中为每个类别预先定义名称、拼音、英文单词、3D 模型路径以及若干知识卡片 ID。通过这一映射机制，实现视觉层与语文、数学、英语内容的跨模态联动，为后续的 3D 展示与智能讲解提供稳定入口。
+
+### 3.2 3D 资产管理与渲染技术
+
+3D 模块依托统一的渲染引擎（如 Unity / Unreal / WebGL 方案）加载蔬果模型与虚拟老师形象，并通过预设的动画片段与脚本控制来实现旋转、切开、闪烁高亮等效果。为降低设备负载，将对模型进行多级细节（LOD）管理和贴图压缩，并在移动端采用合适的帧率与渲染策略。
+
+在交互层，系统通过射线检测或碰撞检测实现点击与拖拽事件，利用物体状态数据与数学逻辑模块进行联动，例如实时根据“篮子中的模型数量”生成对应算式与反馈。虚拟老师的口型和动作则通过动画时间轴与语音播放时间进行同步，提升拟人感。
+
+### 3.3 大模型与检索增强（RAG）/ 本地 LLM
+
+智能讲解部分由大语言模型驱动，通过检索增强（RAG）或本地训练的轻量 LLM，将预先整理的早教知识库与实时识别到的蔬果信息结合起来，为孩子生成自然、生动且准确的说明与对话。知识库包括：
+
+- 标准化的词汇、拼音、句型与数学题库；
+- 经审核的科普知识与故事文案；
+- 不同年龄段对应的语言复杂度与信息深度标注。
+
+具体流程为：当识别到某一蔬果并进入对应学科模式时，系统先在向量数据库中检索该蔬果相关的知识片段，将检索结果与当前任务上下文一并输入大模型，大模型输出适合儿童的讲解文案与互动问答脚本。在有隐私或离线需求场景下，可将大模型替换为部署在本地的精简版本，并通过精简提示模板控制输出长度与风格。
+
+### 3.4 注意力监测与个性化推荐算法
+
+系统在后台持续记录孩子的操作行为，包括各模块的停留时间、完成率、错误次数、是否频繁跳过或退出、对某类水果或玩法的偏好等指标，并据此构建注意力与兴趣的简单画像。通过对比不同年龄段的预期注意力范围与实际表现，可以判断某模块是否过难、过于枯燥或节奏不合适，从而驱动内容与难度的动态调整。
+
+在推荐层面，系统会优先呈现那些历史上能让孩子停留更久、完成度更高且情绪反应更积极（如更少乱点、更多自主操作）的内容，同时自动降低或重构表现持续低迷的活动。例如，当检测到连续多次在数学模式中快速退出时，可暂时缩短数学任务时长，并插入更多与拖拽、配对相关的趣味玩法，以重建孩子的参与意愿。