知行益家 - P1增强模块功能设计
项目名称：知行益家
文档版本：V1.0
创建日期：2026-03-31
设计阶段：P1增强模块（连续打卡、专注训练、AI审核、DAN测评、勋章墙）
一、连续打卡模块
1.1 核心规则
| 规则 |
说明 |
| 统计范围 |
当日所有任务 |
| 计算方式 |
所有任务按时完成才算"打卡成功" |
| 断签重置 |
有一天未完成则连续天数归零 |
| 无任务日 |
不计入连续（保持规则一致性） |
| 任务取消 |
不影响连续 |
| 家长暂停 |
暂停期间不计入 |
| 补卡 |
不允许 |
1.2 里程碑奖励
| 里程碑 |
奖励积分 |
| 连续3天 |
+5分 |
| 连续7天 |
+15分 |
| 连续14天 |
+30分 |
| 连续30天 |
+100分 |
| 连续100天 |
+500分 |
1.3 数据结构
【连续打卡记录】
├── id # 主键
├── child_id # 孩子ID
├── current_streak # 当前连续天数
├── max_streak # 历史最长连续天数
├── last_check_in_date # 最后打卡日期
├── total_check_in_days # 累计打卡天数
└── updated_at # 更新时间
1.4 展示设计
首页展示：
🔥 已连续 X 天
周视图：
┌───┬───┬───┬───┬───┬───┬───┐
│ 一 │ 二 │ 三 │ 四 │ 五 │ 六 │ 日 │
├───┼───┼───┼───┼───┼───┼───┤
│ ✅│ ✅│ ✅│ ✅│ ✅│ ✅│ ✅│
└───┴───┴───┴───┴───┴───┴───┘
里程碑进度条：
下个里程碑：连续14天 (+30分)
████████░░░░░░░░ 7/14
二、专注训练模块
2.1 训练模式
| 模式 |
时长选项 |
说明 |
| 简单模式 |
10/15/20分钟 |
一口气专注完成 |
| 番茄钟模式 |
25分钟+5分钟休息 |
可连续多轮 |
2.2 核心规则
| 规则 |
说明 |
| 计时方式 |
手机倒计时，孩子自行控制 |
| 退出限制 |
家长可设置不可退出 |
| 自评打分 |
完成后1-5星自评 |
| 积分规则 |
星数=积分（1-5分） |
| 满分奖励 |
5星额外+1分（共6分） |
| 每日上限 |
默认3次/天，家长可调整（1-10次） |
2.3 流程设计
选择训练时长 → 开始训练（倒计时界面）
→ 完成/放弃
→ 完成：自评1-5星 → 获得积分
→ 放弃（家长设置）：0分
2.4 数据结构
【专注训练记录】
├── id # 主键
├── child_id # 孩子ID
├── duration # 训练时长（分钟）
├── mode # 模式（simple/pomodoro）
├── stars # 自评星数（1-5）
├── points # 获得积分
├── completed_at # 完成时间
└── created_at # 创建时间
三、AI审核模块
3.1 审核流程
孩子完成任务 → 拍照上传 → 可选语音说明
→ AI分析照片
→ 通过（置信度>80%）：自动发放积分
→ 疑似通过（50-80%）：家长一键确认
→ 需人工（<50%）：家长详细审核
→ 家长可修改AI审核结果
3.2 三档结果逻辑
| 档位 |
置信度 |
处理方式 |
| 通过 ✅ |
>80% |
自动发放积分 |
| 疑似通过 ❓ |
50-80% |
家长一键确认 |
| 需人工 ⚠️ |
<50% |
家长详细审核 |
3.3 阈值配置
| 设置项 |
选项 |
说明 |
| 审核严格度 |
宽松/一般/严格 |
影响AI判断阈值 |
| 自动通过 |
开/关 |
是否允许AI自动通过 |
| 需人工范围 |
按分类/按任务 |
哪些任务必须人工审核 |
3.4 数据结构
【审核记录】
├── id # 主键
├── task_id # 关联任务
├── child_id # 孩子ID
├── photo_url # 照片地址
├── voice_url # 语音地址（可选）
├── ai_result # AI结果（pass/review/unknown）
├── ai_confidence # AI置信度（0-100）
├── ai_suggestion # AI建议说明
├── parent_result # 家长结果（pass/reject）
├── parent_comment # 家长备注
├── review_type # 审核类型（ai/manual）
├── reviewed_at # 审核时间
└── created_at # 创建时间
四、DAN测评模块
4.1 DAN等级体系
| 等级 |
年龄段 |
发展特点 |
| A1 |
幼儿园小班（3-4岁） |
注意力短，游戏为主 |
| A2 |
幼儿园中班（4-5岁） |
规则意识萌芽 |
| A3 |
幼儿园大班（5-6岁） |
幼小衔接 |
| B1 |
小学一年级 |
习惯养成期 |
| B2 |
小学二年级 |
基本学习能力 |
| B3 |
小学三年级 |
转折期 |
| B4 |
小学四年级 |
自主学习 |
| B5 |
小学五年级 |
学业压力增加 |
| B6 |
小学六年级 |
小升初 |
4.2 解析流程
拍照/上传报告 → 大模型解析图片 → 提取DAN等级
→ 解析成功：匹配模板 → 生成推荐任务
→ 解析失败：手动录入等级
→ 家长可编辑模板 → 一键启用创建任务
4.3 各等级推荐任务
| 等级 |
学习类 |
生活类 |
运动类 |
| A1 |
5分钟绘本 |
穿衣服、收玩具 |
户外玩耍15分钟 |
| A2 |
10分钟绘本、画画 |
自己吃饭、简单家务 |
跳绳10分钟 |
| A3 |
拼音练习、简单计算 |
整理书包、洗碗 |
跑步10分钟 |
| B1 |
写字练习、口算 |
打扫房间、叠衣服 |
跳绳20分钟 |
| B2 |
乘法口诀、抄写 |
洗衣服、做简单饭 |
跑步15分钟 |
| B3 |
英语练习、科学实验 |
独立完成作业 |
球类运动30分钟 |
| B4 |
思维训练、小作文 |
自主复习 |
运动30分钟 |
| B5 |
专题复习、错题整理 |
管理学习计划 |
运动40分钟 |
| B6 |
综合复习、模拟测试 |
时间规划 |
运动40分钟 |
4.4 数据结构
【DAN测评记录】
├── id # 主键
├── child_id # 孩子ID
├── report_url # 报告图片地址
├── dan_level # DAN等级
├── parse_status # 解析状态（成功/失败/手动）
├── details # 详细信息（JSON）
├── assessment_date # 测评日期
└── created_at # 创建时间
【任务模板】
├── id # 主键
├── dan_level # 对应等级
├── title # 任务名称
├── points # 建议积分
├── category # 分类
├── estimated_duration # 预计时长
├── is_default # 是否默认启用
└── created_at # 创建时间
五、勋章墙模块
5.1 勋章列表
| 勋章名称 |
解锁条件 |
图标 |
| 🌟 初次尝试 |
完成第一个任务 |
⭐ |
| 🔥 三日火焰 |
连续3天按时完成 |
🔥 |
| 🏆 一周达人 |
连续7天按时完成 |
🏆 |
| 📚 百题斩 |
完成100个任务 |
📖 |
| 🎯 精准打击 |
连续10个任务提前完成 |
🎯 |
| 💪 坚持不懈 |
连续30天按时完成 |
💪 |
| 🧠 专注大师 |
完成50次专注训练 |
🧠 |
| ⭐ 积分富豪 |
累计获得1000积分 |
💰 |
| 🏅 全勤宝宝 |
一周所有任务全部完成 |
🏅 |
| 🎖️ 完美主义 |
单月任务完成率100% |
🎖️ |
5.2 条件类型
| 条件类型 |
说明 |
示例 |
task_complete |
完成任务数 |
完成100个任务 |
streak_days |
连续打卡天数 |
连续7天 |
early_complete |
提前完成数 |
连续10个提前完成 |
focus_training |
专注训练次数 |
完成50次 |
total_points |
累计积分 |
获得1000积分 |
weekly_perfect |
周全勤 |
一周全部完成 |
5.3 数据结构
【勋章定义】
├── id # 主键
├── name # 勋章名称
├── description # 描述
├── icon # 图标
├── condition_type # 条件类型
├── condition_value # 条件数值
└── sort_order # 排序
【用户勋章】
├── id # 主键
├── child_id # 孩子ID
├── badge_id # 勋章ID
├── unlocked_at # 解锁时间
└── created_at # 创建时间
六、设计决策汇总
| 决策点 |
选择 |
| 连续打卡-无任务日 |
不计入连续 |
| 连续打卡-补卡 |
不允许 |
| 专注训练-满分奖励 |
5星额外+1分 |
| AI审核-档位 |
三档（通过/疑似通过/需人工） |
| DAN测评-解析失败 |
降级为手动录入 |
| 勋章数量 |
10+个基础勋章 |
本文档为P1增强模块功能设计。
