# wordx

**Repository Path**: panxu11/wordx

## Basic Information

- **Project Name**: wordx
- **Description**: 记单词
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wordx

轻量级记单词 App，按 `prd-vocabulary-app-mvp.md` 的 MVP 范围实现。

## 当前已实现

- Flutter 源码结构
- 本地 JSON 词库加载
- 单词列表
- 单词搜索
- 单词详情
- 单词和例句 TTS 发音封装
- 本地收藏与收藏列表
- 空状态、错误状态
- 基础设置页
- WordModel 解析测试

## 技术栈

- Flutter / Dart
- Riverpod
- go_router
- flutter_tts
- shared_preferences

## 目录结构

```text
lib/
├── app/
├── core/
├── features/word/
└── services/speech/
assets/data/words.json
```

## 本地运行

当前机器需要先安装 Flutter SDK。安装后在项目根目录执行：

```bash
flutter pub get
flutter create --platforms=android .
flutter run
```

如果后续需要 iOS：

```bash
flutter create --platforms=ios .
```

## 测试

```bash
flutter test
```

## 词库扩展

内置词库位于：

```text
assets/data/words.json
```

追加单词时保持以下结构：

```json
{
  "id": "word_000001",
  "text": "apple",
  "phoneticUk": null,
  "phoneticUs": null,
  "meanings": [
    {
      "partOfSpeech": "n.",
      "definition": "a round fruit with red or green skin",
      "translation": "苹果"
    }
  ],
  "examples": [
    {
      "text": "I eat an apple every morning.",
      "translation": "我每天早上吃一个苹果。",
      "audioUrl": null
    }
  ],
  "difficulty": 1,
  "tags": ["basic"]
}
```

MVP 发布前建议将词库扩展到 PRD 要求的不少于 500 个常用词。