# Dictation_ios

**Repository Path**: lyyarrow/dictation_ios

## Basic Information

- **Project Name**: Dictation_ios
- **Description**: 听写词语APP iOS版本
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 听写助手 (Dictation Assistant)

一款面向中小学生的智能听写 iOS App，通过拍照 OCR 自动提取课本字词，配合语音播报完成听写练习，支持错误收集与针对性复习。

## 功能概览

- 📷 **拍照识别**：对准课本页面拍照，自动 OCR 提取中/英文词语
- 🔊 **智能播报**：TTS 逐一朗读词语，可设置播报次数与语速
- 🎙️ **语音指令**：说「下一个」自动跳到下一词，解放双手
- ✏️ **听写纠错**：完成后勾选错误词语，自动保存
- 📒 **听写本管理**：多个听写本分别管理，支持仅错词重复听写
- 📊 **历史记录**：每次听写记录正确率、错误词，可回溯

## 技术栈

- SwiftUI (iOS 17+)
- SwiftData 数据持久化
- Vision 框架 OCR 文字识别
- AVSpeechSynthesizer 语音合成
- SFSpeechRecognizer 语音指令识别

## 创建 Xcode 项目

### 方法一：使用 XcodeGen（推荐）

```bash
# 安装 XcodeGen
brew install xcodegen

# 生成 Xcode 项目
cd DictationApp
xcodegen generate

# 打开项目
open DictationApp.xcodeproj
```

### 方法二：手动创建

1. 打开 Xcode → File → New → Project
2. 选择 iOS → App，命名 `DictationApp`
3. Interface 选 SwiftUI，Language 选 Swift
4. 删除自动生成的 ContentView.swift
5. 将 `Sources/` 目录下所有文件拖入 Xcode 项目
6. 在 Target Info 中添加以下 Privacy 描述：
   - `Privacy - Camera Usage Description`: 需要使用相机拍摄课本页面以识别听写词语
   - `Privacy - Microphone Usage Description`: 需要使用麦克风实现语音指令功能
   - `Privacy - Speech Recognition Usage Description`: 需要语音识别功能来实现语音指令控制听写

## 项目结构

```
Sources/
├── DictationApp.swift              # App 入口
├── Models/
│   ├── Notebook.swift              # 听写本模型
│   ├── Word.swift                  # 词语模型
│   └── DictationSession.swift      # 听写记录模型
├── Services/
│   ├── OCRService.swift            # Vision OCR 识别
│   ├── SpeechService.swift         # TTS 语音播报
│   └── VoiceCommandService.swift   # 语音指令监听
├── ViewModels/
│   └── DictationViewModel.swift    # 听写状态机
└── Views/
    ├── ContentView.swift           # 主 TabView
    ├── NotebookListView.swift      # 听写本列表
    ├── CreateNotebookView.swift    # 创建听写本
    ├── NotebookDetailView.swift    # 听写本详情
    ├── CameraOCRView.swift         # 拍照 OCR
    ├── WordEditView.swift          # 词语编辑
    ├── DictationView.swift         # 听写播报
    ├── ReviewView.swift            # 纠错评分
    └── SettingsView.swift          # 设置页
```

## 最低要求

- iOS 17.0+
- Xcode 15.0+
- 物理设备（相机/麦克风/语音识别需真机测试）