Skip to content

Randy-sin/dsespeaking

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

111 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DSE Speaking - AI练习助手

📱 项目概述

这是一款专为香港DSE英语口语考试(Paper 4)设计的iOS应用,通过AI技术帮助学生提升口语能力。应用模拟真实考试场景,提供小组讨论(Group Interaction)和个人回应(Individual Response)的全方位练习。


🎯 核心功能规划

第一阶段:核心功能(MVP - 最小可行产品)

1. AI小组讨论模拟 (AI Group Discussion)

功能描述:

  • 基于真实DSE考题,用户与2-3个AI角色进行小组讨论
  • AI角色具有不同的性格特点和语言水平,模拟真实考试环境
  • 完整模拟考试流程:10分钟准备 + 6-8分钟讨论

技术实现:

  • 集成Apple Speech Framework进行语音识别
  • 集成OpenAI GPT-4 或 Claude API进行AI对话
  • 使用AVFoundation进行文本转语音(TTS)
  • 实时转录用户发言并分析

用户体验流程:

  1. 选择练习模式(3人组/4人组)
  2. 获取题目并进入10分钟准备时间(可做笔记)
  3. 开始讨论,AI角色会主动发言、回应、提问
  4. 讨论结束后获得详细反馈

2. 个人回应练习 (Individual Response Practice)

功能描述:

  • 每日推送IR练习题目
  • 录制1分钟回答并获得AI评分和建议
  • 针对五大题型提供专项训练

题型分类:

  • Making Choices(作出选择)
  • Giving Suggestions(给予建议)
  • Recounting Personal Experience(分享个人经验)
  • Justifying an Action or Phenomenon(解释行为或现象)
  • Giving Opinions(发表意见)

技术实现:

  • 使用AVAudioRecorder录制音频
  • 语音识别转文本
  • AI分析内容、结构、语法、词汇、时间控制
  • 提供评分(Level 0-7)和具体改进建议

3. 词汇积累系统 (Vocabulary Bank)

功能描述:

  • 按话题分类的词汇库(School, Technology, Environment等)
  • 常用表达短语库(Opening, Agreeing, Disagreeing等)
  • 每日词汇学习和复习
  • 记忆曲线提醒系统

话题分类:

  • School(学校)
  • Social Media(社交媒体)
  • Technology(科技)
  • Environment(环境)
  • Workplace(职场)
  • Popular Culture(流行文化)
  • Sports(体育)
  • Hong Kong Culture(香港文化)

技术实现:

  • 使用SwiftData进行本地存储
  • 实现间隔重复算法(Spaced Repetition)
  • 词汇发音功能
  • 例句和用法说明

4. 学习进度追踪 (Progress Tracking)

功能描述:

  • 记录每次练习的评分和时间
  • 可视化展示进步曲线
  • 分析强项和弱项
  • 设定学习目标和提醒

数据指标:

  • 练习次数和时长
  • 各维度评分趋势(发音、词汇、互动、内容)
  • 词汇掌握量
  • 模拟考试成绩

第二阶段:增强功能

5. 真题题库系统 (Past Paper Bank)

功能描述:

  • 收录历年DSE真题
  • 按话题类型分类
  • 热门题目标注
  • 定期更新最新考题

题库分类:

  • 按年份(2012-2025)
  • 按话题(Education, Technology, Social Issues等)
  • 按难度(Easy, Medium, Hard)

6. 互动技巧训练 (Interaction Skills Training)

功能描述:

  • 专项训练Opening、Response、Help Others、Conclusion等技巧
  • 情景模拟练习(如:有人主导讨论、有人卡壳等)
  • 实用表达记忆卡片

训练模块:

  • 开场技巧(Greet & Start)
  • 同意观点(Agree with elaboration)
  • 礼貌反驳(Polite disagreement)
  • 帮助他人(Help struggling members)
  • 总结讨论(Conclude discussion)

7. 论述技巧训练 (Elaboration Skills Training)

功能描述:

  • 针对Why/How/Which问题的结构化训练
  • 提供论述模板和示例
  • 逻辑链条构建练习

训练内容:

  • Topic Sentence构建
  • 因果推理(往后推影响,往前推原因)
  • 例证使用(个人经历、新闻、数据)
  • 对比分析

8. AI实时反馈系统

功能描述:

  • 讨论过程中实时字幕
  • 关键错误即时提示(语法、发音)
  • 互动质量实时评估
  • 发言时长监控

9. 社区功能 (Community)

功能描述:

  • 与真人组队练习(匹配系统)
  • 分享练习录音获得反馈
  • 学习小组和打卡功能
  • 排行榜和成就系统

第三阶段:高级功能

10. 个性化学习路径 (Personalized Learning Path)

功能描述:

  • 入学测试评估当前水平
  • AI生成个性化学习计划
  • 智能推荐练习内容
  • 动态调整难度

11. 模拟考试系统 (Mock Exam System)

功能描述:

  • 完整模拟真实考试流程
  • 严格计时和评分
  • 详细成绩报告
  • 与真实考试对标

12. 发音矫正系统 (Pronunciation Coach)

功能描述:

  • 音素级别的发音分析
  • 常见错误音标识
  • 发音对比和纠正练习
  • 语调和重音训练

13. 考官视角分析 (Examiner's Perspective)

功能描述:

  • 从考官角度分析表现
  • 评分标准详细解读
  • 高分技巧和常见失分点
  • Level 5/6/7的具体要求

14. 离线模式 (Offline Mode)

功能描述:

  • 下载题库和词汇到本地
  • 离线录音和本地保存
  • 联网后同步和分析
  • 节省流量

🏗️ 技术架构

前端技术栈

  • UI框架: SwiftUI(iOS 17+)
  • 架构模式: MVVM + Combine
  • 数据持久化: SwiftData
  • 路由管理: NavigationStack

核心技术

  • 语音识别: Apple Speech Framework
  • 文本转语音: AVSpeechSynthesizer
  • 录音: AVAudioRecorder
  • AI集成: OpenAI API / Claude API
  • 网络请求: URLSession + async/await
  • 本地通知: UserNotifications Framework

数据模型设计

// 用户模型
User {
    id: UUID
    name: String
    level: Int (0-7)
    totalPracticeTime: TimeInterval
    createdAt: Date
}

// 练习记录
PracticeSession {
    id: UUID
    type: SessionType (GroupDiscussion, IndividualResponse)
    topic: String
    duration: TimeInterval
    score: Int (0-7)
    transcript: String
    feedback: String
    createdAt: Date
}

// 题目
Topic {
    id: UUID
    title: String
    description: String
    category: TopicCategory
    questions: [String]
    difficulty: Difficulty
    year: Int?
}

// 词汇
Vocabulary {
    id: UUID
    word: String
    definition: String
    examples: [String]
    category: TopicCategory
    nextReviewDate: Date
    reviewCount: Int
}

// AI角色
AICharacter {
    id: UUID
    name: String
    personality: String (active, moderate, shy)
    level: Int (3-6)
    avatar: String
}

🎨 UI/UX设计原则

设计风格(参考OpenAI、Notion、Linear)

  • 极简主义: 去除一切不必要的装饰元素
  • 黑白灰配色: 米白色背景 + 纯黑文字 + 灰度层次
  • 大量留白: 让内容自然呼吸
  • 克制优雅: 微妙的边框、极淡的阴影
  • 专注内容: 学习内容永远是焦点

配色系统

  • 背景: #FAFAFA(米白色)
  • 文本: #262626(深灰黑)→ #A3A3A3(中灰)→ #E5E5E5(浅灰)
  • 边框: #E5E5E5(极淡灰色,几乎看不见)
  • 强调: 纯黑(深色模式为纯白)
  • 原则: 无彩色、无渐变、无鲜艳色彩

核心界面

  1. 首页Dashboard: 显示今日任务、学习进度、推荐练习
  2. 练习选择页: 小组讨论 / 个人回应 / 词汇学习
  3. 讨论界面: 题目展示、计时器、AI角色头像、实时字幕
  4. 录音界面: 波形显示、计时、录音控制
  5. 反馈页面: 评分、详细分析、改进建议
  6. 词汇库: 分类浏览、搜索、学习进度
  7. 统计页面: 图表展示、历史记录、成就系统

交互设计

  • 流畅动画: 页面切换使用自然的过渡动画
  • 即时反馈: 用户操作有明确的视觉反馈
  • 手势支持: 滑动、长按等手势操作
  • 无障碍: 支持VoiceOver、动态字体

📅 开发路线图

Phase 1: 基础框架(2-3周)

  • 项目初始化
  • 基础UI框架搭建(TabView、NavigationStack)
  • 数据模型设计和SwiftData配置
  • 网络层封装
  • 语音识别和录音功能集成

Phase 2: 核心功能开发(4-6周)

  • 个人回应练习功能
  • AI评分和反馈系统
  • 词汇库基础功能
  • 学习进度追踪
  • 题库系统

Phase 3: 小组讨论功能(3-4周)

  • AI角色设计和对话逻辑
  • 多轮对话管理
  • 实时讨论界面
  • 讨论记录和回放

Phase 4: 增强功能(3-4周)

  • 每日学习提醒
  • 高级统计分析
  • 发音评估
  • 互动技巧训练

Phase 5: 测试和优化(2-3周)

  • 功能测试
  • 用户测试
  • 性能优化
  • UI/UX优化

Phase 6: 发布准备(1-2周)

  • App Store素材准备
  • 隐私政策和用户协议
  • 提交审核
  • 营销准备

💡 关键技术难点和解决方案

1. AI对话的自然性

难点: AI角色的回应需要符合DSE考试场景,不能过于机械

解决方案:

  • 设计详细的Prompt,包含角色设定、回应风格、互动规则
  • 引入不同personality的AI角色(积极主动型、稳健型、害羞型)
  • 控制AI发言长度和频率,避免主导讨论
  • 让AI能够引用其他角色观点、提出问题、寻求澄清

2. 语音识别准确度

难点: 需要准确识别香港学生的英语发音

解决方案:

  • 使用Apple Speech Framework的locale设置为en-HK
  • 对专业术语和常见词汇做本地词典优化
  • 提供手动修正转录文本的功能
  • 收集用户数据逐步优化

3. 评分的准确性

难点: AI评分需要贴近真实考试评分标准

解决方案:

  • 严格按照HKDSE评分标准设计评分算法
  • 分维度评分:Pronunciation & Delivery, Communication Strategies, Vocabulary & Language Patterns, Ideas & Organization
  • 使用GPT-4进行语义分析和内容评估
  • 提供详细的评分依据和改进建议
  • 定期根据真实考试标准调整

4. 性能优化

难点: 实时语音识别和AI对话需要快速响应

解决方案:

  • 使用流式API减少等待时间
  • 本地缓存常用数据和词汇
  • 异步处理和并发优化
  • 合理使用后台任务

5. 隐私和安全

难点: 录音和用户数据的隐私保护

解决方案:

  • 遵循Apple隐私指南
  • 明确告知用户数据使用方式
  • 录音数据加密存储
  • 提供数据删除功能
  • 可选的本地处理模式

📊 商业模式规划

免费版功能

  • 每日3次个人回应练习
  • 基础词汇库(500词)
  • 有限的AI小组讨论(每周2次)
  • 基础进度追踪

订阅版功能(Premium)

  • 无限制练习次数
  • 完整词汇库(2000+词)
  • 无限AI小组讨论
  • 真题题库完整访问
  • 详细数据分析
  • 离线模式
  • 优先客服支持

定价策略

  • 月订阅:HK$ 88/月
  • 季订阅:HK$ 228/季(节省15%)
  • 年订阅:HK$ 688/年(节省35%)
  • 买断制:HK$ 1,288(终身使用)

🎯 成功指标 (KPIs)

用户指标

  • 日活跃用户 (DAU)
  • 月活跃用户 (MAU)
  • 用户留存率(Day 1, Day 7, Day 30)
  • 平均会话时长

学习效果指标

  • 用户平均练习次数
  • 评分提升趋势
  • 词汇掌握量增长
  • 模拟考试通过率

商业指标

  • 免费转付费转化率
  • 订阅续费率
  • 用户生命周期价值 (LTV)
  • 获客成本 (CAC)

🚀 未来展望

潜在扩展方向

  1. 其他科目支持: 扩展到DSE中文口语、其他语言考试
  2. AI导师功能: 一对一个性化辅导
  3. 硬件集成: Apple Watch配套应用,AirPods优化
  4. AR功能: 使用ARKit模拟真实考场环境
  5. 国际化: 支持IELTS、TOEFL等国际考试

技术升级计划

  1. 本地AI模型: 使用Apple Silicon进行本地推理,减少延迟
  2. 高级语音分析: 情感识别、流畅度分析
  3. 社交功能增强: 真人匹配、线上学习小组
  4. 游戏化: 引入更多游戏元素提升参与度

📝 开发规范

代码规范

  • 遵循Swift API Design Guidelines
  • 使用SwiftLint进行代码检查
  • 函数和变量命名清晰、有意义
  • 添加详细的代码注释(中英文)

Git规范

  • 使用语义化的commit message
  • 功能分支开发,主分支保护
  • 定期代码review

文档规范

  • 每个功能模块有对应的文档
  • API文档使用Xcode注释
  • 用户使用文档和FAQ

📚 参考资源

官方文档

DSE资源

  • HKDSE English Language Examination Reports
  • Past Paper Analysis
  • 评分标准详解

第三方服务


🔄 更新日志

Version 0.1.0 (2025-09-30)

  • 项目初始化
  • 完成项目规划文档
  • 确定技术架构

👥 团队与贡献

开发团队:

  • iOS开发工程师
  • AI工程师
  • UI/UX设计师
  • 教育专家顾问

特别感谢:

  • DSE考试专家提供的专业指导
  • 测试用户的宝贵反馈

📄 许可证

本项目采用 MIT License


最后更新: 2025年9月30日

About

ios app

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors